Установка ejabberd под Linux: различия между версиями

Материал из Мир Jabber
Перейти к навигацииПерейти к поиску
м (А про рута-то и забыли)
 
(не показано 9 промежуточных версий этого же участника)
Строка 3: Строка 3:
Предполагается, что у Вас уже установлена операционная система, настроен доступ в Интернет, а доменное имя на DynDNS (допустим, это будет '''myjabber.ath.cx''') указывает на внешний адрес Вашего компьютера (либо тот, который доступен из Вашей локальной сети, если Вы настраиваете сервер без возможности подключения к нему из Интернета).
Предполагается, что у Вас уже установлена операционная система, настроен доступ в Интернет, а доменное имя на DynDNS (допустим, это будет '''myjabber.ath.cx''') указывает на внешний адрес Вашего компьютера (либо тот, который доступен из Вашей локальной сети, если Вы настраиваете сервер без возможности подключения к нему из Интернета).


[[Ejabberd]] может быть установлен на ваш сервер различными способами. Опишу три по убыванию предпочтительности:
[[Ejabberd]] может быть установлен на ваш сервер различными способами. Опишу три по нарастанию сложности:


# Установка из репозитория/портов. Идеальный по оптимизации и самый простой вариант.
# Установка из репозитория/портов. Идеальный по оптимизации и самый простой вариант.
# Предварительно собранные бинарные файлы с инсталлятором. Вариант не сложнее первого, но вряд ли оптимизирован именно под ваш дистрибутив.
# Сборка из исходного кода. Если этого пакета нет в репозиториях к вашему дистрибутиву, но очень хочется, чтобы сервер был оптимизированным и работал без ошибок - засучиваем рукава и переходим к соответствующему разделу. Тут вам понадобятся некоторые знания о Linux и/или помощь [[ru_wikipedia:Гуру|гуру]].
# Сборка из исходного кода. Если этого пакета нет в репозиториях к вашему дистрибутиву, но очень хочется, чтобы сервер был оптимизированным и работал без ошибок - засучиваем рукава и переходим к соответствующему разделу. Тут вам понадобятся некоторые знания о Linux и/или помощь [[ru_wikipedia:Гуру|гуру]].
# Предварительно собранные бинарные файлы с инсталлятором. Вариант весьма прост, но вряд ли оптимизирован именно под ваш дистрибутив.


Далее подробно рассмотрены эти варианты.
Далее подробно рассмотрены эти варианты.
Строка 13: Строка 13:
==Установка из репозитория==
==Установка из репозитория==
Дистрибутивов Linux великое множество, и нет никакой возможности рассмотреть детали установки в каждом из них. Упомянем наиболее популярные (предполагается наличие прав root):
Дистрибутивов Linux великое множество, и нет никакой возможности рассмотреть детали установки в каждом из них. Упомянем наиболее популярные (предполагается наличие прав root):
===openSuSE 11.4===
Сначала подключим репозиторий, посвящённый программам обмена сообщениями:
<nowiki>zypper addrepo http://download.opensuse.org/repositories/server:/messaging/openSUSE_11.4/ Messaging</nowiki>
:Потом установим сервер:
zypper install ejabberd


===Fedora===
===Fedora===
Строка 32: Строка 26:
  echo "net-im/ejabberd pam ssl zlib mod_muc mod_pubsub web" >> /etc/portage/package.use
  echo "net-im/ejabberd pam ssl zlib mod_muc mod_pubsub web" >> /etc/portage/package.use
  emerge ejabberd
  emerge ejabberd
==Установка готовых бинарников==
Установка из готовых бинарных пакетов делается за несколько простых шагов:
* Скачиваете подходящий '''run'''-файл по адресу https://www.process-one.net/en/ejabberd/archive/
* Запускаете командой '''sudo bash ejabberd-*.run'''
* Cледуете указаниям программы установки.


==Сборка из исходников==
==Сборка из исходников==
{{Hider hiding
|title=Пример для версии 2.0.5
|content=
Рассмотрим сборку stable-версии ejabberd-2.0.5.
Рассмотрим сборку stable-версии ejabberd-2.0.5.


Строка 93: Строка 97:


После всех этих манипуляций все нужные файлы разложены согласно традициям UNIX/Linux. Конфиги, в частности,- в /etc/ejabberd. Скрипт запуска - /sbin/ejabberdctl - отрабатывает команду start, что позволяет сразу добавить в rc.d, хотя лучше всё же написать правильный скрипт управления службой согласно правилам вашего дистрибутива.
После всех этих манипуляций все нужные файлы разложены согласно традициям UNIX/Linux. Конфиги, в частности,- в /etc/ejabberd. Скрипт запуска - /sbin/ejabberdctl - отрабатывает команду start, что позволяет сразу добавить в rc.d, хотя лучше всё же написать правильный скрипт управления службой согласно правилам вашего дистрибутива.
 
}}
==Установка готовых бинарников==
Рассмотрим установку stable-версии 2.1.8 для 32-битного Linux. Для начала нужно скачать инсталлятор:
wget http://www.process-one.net/downloads/ejabberd/2.1.8/ejabberd-2.1.8-linux-x86-installer.bin.gz
 
Распаковать его:
gunzip ejabberd-2.1.8-linux-x86-installer.bin.gz
 
И запустить:
chmod +x ejabberd-2.1.8-linux-x86-installer.bin
./ejabberd-2.1.8-linux-x86-installer.bin
 
Далее следуйте указаниям программы установки.


==Настройка==
==Настройка==
А дальше надо настроить сервер: что делать при загрузке, какие модули использовать, какие порты прослушивать, и т.п.
А дальше надо настроить сервер: что делать при загрузке, какие модули использовать, какие порты прослушивать, и т.п.


Настройка сервера сводится к редактированию файла конфигурации '''/etc/ejabberd/ejabberd.cfg''' (путь показан на примере Debian GNU/Linux, в других дистрибутивах или при самостоятельной сборке из исходных кодов путь может отличаться). Откройте этот файл от пользователя root в любом удобном для Вас текстовом редакторе, после чего найдите следующие строки:
Настройка сервера сводится к редактированию файла конфигурации '''/etc/ejabberd/ejabberd.yml''' (путь показан на примере Debian GNU/Linux, в других дистрибутивах или при самостоятельной сборке из исходных кодов путь может отличаться). Откройте этот файл от пользователя '''root''' в любом удобном для Вас текстовом редакторе, после чего найдите следующие секции: секцию '''acl''' и секцию '''hosts'''.
 
%% Admin user
{acl, admin, {user, "", "localhost"}}.<br>
%% Hostname
{hosts, ["example.com"]}.


В первом параметре задается [[Jabber ID]] администратора, а во втором - доменное имя сервера. Приведите эти строки примерно к такому виду:
В первом параметре задается [[Jabber ID]] администратора, а во втором - доменное имя сервера. Приведите эти строки примерно к такому виду:


%% Admin user
<pre>
{acl, admin, {user, "admin", "myjabber.ath.cx"}}.<br>
acl:
%% Hostname
  admin:
{hosts, ["myjabber.ath.cx"]}.
    user:
      - "admin": "myjabber.ath.cx"
## hosts: Domains served by ejabberd.
## You can define one or several, for example:
## hosts:
##  - "example.net"
##  - "example.com"
##  - "example.org"
hosts:
  - "myjabber.ath.cx"
</pre>


В данном случае [[JID]] администратора задан [xmpp:admin@myjabber.ath.cx admin@myjabber.ath.cx], а имя сервера, как уже условились выше - myjabber.ath.cx.
В данном случае [[JID]] администратора задан [xmpp:admin@myjabber.ath.cx admin@myjabber.ath.cx], а имя сервера, как уже условились выше - myjabber.ath.cx.


Теперь в том же файле найдите строки
Теперь в том же файле найдите секцию access_rules, а в ней - параметр register:
 
%% No username can be registered via in-band registration:
%% To enable in-band registration, replace 'deny' with 'allow'
{access, register, [{deny, all}]}.


и замените '''deny''' на '''allow''' - без этого пользователи сервера не смогут регистрироваться напрямую из своего Jabber-клиента.
<pre>
 
access_rules:
[[Изображение:Ejabber lin install login 01.png|thumb|left|Логин в веб-интерфейсе]]
  register:
    - allow
</pre>


и замените '''deny''' на '''allow''' - без этого пользователи сервера не смогут регистрироваться напрямую из своего Jabber-клиента.


Сохраните изменения и перезапустите ejabberd командой
Сохраните изменения и перезапустите ejabberd командой


  /etc/init.d/ejabberd restart
  /etc/init.d/ejabberd restart
{{-}}
[[Изображение:Ejabberd lin install 01.png|thumb|left|Сервисы и статистика сервера]]


<center>
<gallery>
Изображение:Ejabber lin install login 01.png|Логин в веб-интерфейсе
Изображение:Ejabberd lin install 01.png|Сервисы и статистика сервера
</gallery>
</center>


После этого создайте нового пользователя [xmpp:admin@myjabber.ath.cx admin@myjabber.ath.cx] используя Ваш Jabber-клиент. В [[Браузер сервисов|браузере сервисов]] для этой учетной записи будут доступны основные функции администрирования, а используя параметры этого аккаунта Вы сможете авторизоваться в веб-интерфейсе по адресу http://myjabber.ath.cx:5280/admin
После этого создайте нового пользователя [xmpp:admin@myjabber.ath.cx admin@myjabber.ath.cx] используя Ваш Jabber-клиент. В [[Браузер сервисов|браузере сервисов]] для этой учетной записи будут доступны основные функции администрирования, а используя параметры этого аккаунта Вы сможете авторизоваться в веб-интерфейсе по адресу http://myjabber.ath.cx:5280/admin
{{-}}


==Ссылки==
==Ссылки==


* [[Свой сервер: подробное руководство по установке ejabberd]]
* [http://ylsoftware.com/news/499 Настройка ведения логов в конференции]
* [http://ylsoftware.com/news/499 Настройка ведения логов в конференции]
* [http://linuxoid.in/RRD:_Статистика_онлайн-пользователей_для_ejabberd Графическая статистика онлайн-пользователей]
* [http://linuxoid.in/RRD:_Статистика_онлайн-пользователей_для_ejabberd Графическая статистика онлайн-пользователей]


[[Category:Свой сервер]]
[[Category:Свой сервер]]

Текущая версия на 15:42, 2 ноября 2023

Рассмотрим установку сервера ejabberd на компьютеры под управлением одного из дистрибутивов GNU/Linux для использования в локальной сети с открытым доступом из Интернет и с использованием службы DynDNS.

Предполагается, что у Вас уже установлена операционная система, настроен доступ в Интернет, а доменное имя на DynDNS (допустим, это будет myjabber.ath.cx) указывает на внешний адрес Вашего компьютера (либо тот, который доступен из Вашей локальной сети, если Вы настраиваете сервер без возможности подключения к нему из Интернета).

Ejabberd может быть установлен на ваш сервер различными способами. Опишу три по нарастанию сложности:

  1. Установка из репозитория/портов. Идеальный по оптимизации и самый простой вариант.
  2. Предварительно собранные бинарные файлы с инсталлятором. Вариант не сложнее первого, но вряд ли оптимизирован именно под ваш дистрибутив.
  3. Сборка из исходного кода. Если этого пакета нет в репозиториях к вашему дистрибутиву, но очень хочется, чтобы сервер был оптимизированным и работал без ошибок - засучиваем рукава и переходим к соответствующему разделу. Тут вам понадобятся некоторые знания о Linux и/или помощь гуру.

Далее подробно рассмотрены эти варианты.

Установка из репозитория[править]

Дистрибутивов Linux великое множество, и нет никакой возможности рассмотреть детали установки в каждом из них. Упомянем наиболее популярные (предполагается наличие прав root):

Fedora[править]

По умолчанию нужный репозиторий обычно подключен.

yum install ejabberd

Debian-based дистрибутивы (Debian, *Ubuntu и другие)[править]

Ejabberd входит в основную ветку репозитория, поэтому для установки просто скомандуйте:

apt-get install ejabberd

Gentoo[править]

Для установки ejabberd в Gentoo GNU/Linux выполните команды

echo "net-im/ejabberd pam ssl zlib mod_muc mod_pubsub web" >> /etc/portage/package.use
emerge ejabberd

Установка готовых бинарников[править]

Установка из готовых бинарных пакетов делается за несколько простых шагов:

  • Скачиваете подходящий run-файл по адресу https://www.process-one.net/en/ejabberd/archive/
  • Запускаете командой sudo bash ejabberd-*.run
  • Cледуете указаниям программы установки.

Сборка из исходников[править]

Пример для версии 2.0.5

Рассмотрим сборку stable-версии ejabberd-2.0.5.

Для начала нужно, чтобы на сервере был установлен компилятор gcc и необходимые библиотеки (включая devel-части). Проверьте, есть ли у вас:

  • GNU Make
  • GNU C compiler (GCC)
  • libexpat 1.95 или выше
  • OpenSSL 0.9.6 или выше
  • Zlib 1.2.3
  • GNU Iconv 1.8 или выше
  • flex/yacc

В разных дистрибутивах проверка и установка делается разными способами. Дистрибутивов много, описывать каждый смысла не имеет. Если вы не знаете, как это сделать на вашем сервере, обратитесь к документации или гуру по данному дистрибутиву.

Для простоты операций будем работать пользователем root в его домашнем каталоге. Не забудьте потом прибраться.

Итак, нам нужен исходный код ejabberd. Идём на официальный сайт и выбираем, что нужно. Лучше выбирать stable версию, но если вы очень любите новые фишки и не боитесь нестабильной работы, то берите beta, testing или SVN версии.

Я выбрал stable-версию 2.0.5 и скачал её:

wget http://www.process-one.net/downloads/ejabberd/2.0.5/ejabberd-2.0.5.tar.gz

Конечно же, у вас есть эта удобнейшая утилита - wget. ;)

Ещё нам понадобится свеженький Erlang - это компилятор языка, на котором написан ejabberd. Если Erlang есть в вашем репозитории, то лучше воспользоваться им. Если нет - покажу, как собрать его из исходных кодов.

Как программист, не удержусь от пояснения, зачем было использовать этот с виду громоздкий и неудобный язык. Он громоздок и неудобен действительно лишь с виду, для написания программ вроде hello world, однако предоставляет прекрасный инструментарий многопоточного и распределённого программирования. Это позволит вам единожды написанную и собранную программу использовать на огромных кластерах, состоящих из машин любой архитектуры, в которые будет проще простого добавить новые вычислительные мощности. Даже Java не обладает подобными возможностями. Именно поэтому ejabberd считается одним из самых быстрых и масштабируемых серверов протокола XMPP.

Но довольно лирики.

wget http://erlang.org/download/otp_src_R13B01.tar.gz

Если у вас наличествуют все инструменты, библиотеки и исходные коды, приступим.

Создадим временный каталог для наших сборок:

mkdir buildtmp

erlang

В моём случае скачанный архив называется otp_src_R13B01.tar.gz. Распаковываем его во временный каталог:

tar zxf otp_src_R13B01.tar.gz -C buildtmp

Переходим в каталог и собираем erlang:

cd buildtmp/otp_src_R13B01
./configure --prefix=/usr --sysconfdir=/etc
make
make install

Конечно же, следим за процессом, а не просто набираем команды. Программа сборки может сообщить об ошибке, но не каждый error или warning означает неисправимую ошибку. Например, процесс конфигурирования (команда configure) может сообщить, что не нашла компилятора java, библиотек odbc и wx, но это не является ошибкой. Просто соответствующие части erlang-а будут отключены. Перечисленные библиотеки нам не понадобятся для работы ejabberd.

После сборки вернёмся в домашний каталог командой cd.

ejabberd

В моём случае архив называется ejabberd-2.0.5.tar.gz. Распаковываем его во временный каталог:

tar zxf ejabberd-2.0.5.tar.gz -С buildtmp 

Переходим в каталог с исходниками и собираем ejabberd:

cd buildtmp/ejabberd-2.0.5/src
./configure
make
make install

После всех этих манипуляций все нужные файлы разложены согласно традициям UNIX/Linux. Конфиги, в частности,- в /etc/ejabberd. Скрипт запуска - /sbin/ejabberdctl - отрабатывает команду start, что позволяет сразу добавить в rc.d, хотя лучше всё же написать правильный скрипт управления службой согласно правилам вашего дистрибутива.

Настройка[править]

А дальше надо настроить сервер: что делать при загрузке, какие модули использовать, какие порты прослушивать, и т.п.

Настройка сервера сводится к редактированию файла конфигурации /etc/ejabberd/ejabberd.yml (путь показан на примере Debian GNU/Linux, в других дистрибутивах или при самостоятельной сборке из исходных кодов путь может отличаться). Откройте этот файл от пользователя root в любом удобном для Вас текстовом редакторе, после чего найдите следующие секции: секцию acl и секцию hosts.

В первом параметре задается Jabber ID администратора, а во втором - доменное имя сервера. Приведите эти строки примерно к такому виду:

acl:
  admin:
     user:
       - "admin": "myjabber.ath.cx"
## hosts: Domains served by ejabberd.
## You can define one or several, for example:
## hosts:
##   - "example.net"
##   - "example.com"
##   - "example.org"
hosts:
  - "myjabber.ath.cx"

В данном случае JID администратора задан admin@myjabber.ath.cx, а имя сервера, как уже условились выше - myjabber.ath.cx.

Теперь в том же файле найдите секцию access_rules, а в ней - параметр register:

access_rules:
  register:
    - allow

и замените deny на allow - без этого пользователи сервера не смогут регистрироваться напрямую из своего Jabber-клиента.

Сохраните изменения и перезапустите ejabberd командой

/etc/init.d/ejabberd restart

После этого создайте нового пользователя admin@myjabber.ath.cx используя Ваш Jabber-клиент. В браузере сервисов для этой учетной записи будут доступны основные функции администрирования, а используя параметры этого аккаунта Вы сможете авторизоваться в веб-интерфейсе по адресу http://myjabber.ath.cx:5280/admin

Ссылки[править]