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

Материал из Мир Jabber
Перейти к навигацииПерейти к поиску
(Переделал структуру, добавил описание установки из реп (из блокнота))
м (А про рута-то и забыли)
 
(не показано 28 промежуточных версий 5 участников)
Строка 1: Строка 1:
[[Ejabberd]] может быть установлен на ваш сервер различными способами. Опишу три по убыванию предпочтительности:
Рассмотрим установку сервера [[ejabberd]] на компьютеры под управлением одного из дистрибутивов GNU/Linux для использования в локальной сети с открытым доступом из Интернет и с использованием службы DynDNS.
 
Предполагается, что у Вас уже установлена операционная система, настроен доступ в Интернет, а доменное имя на DynDNS (допустим, это будет '''myjabber.ath.cx''') указывает на внешний адрес Вашего компьютера (либо тот, который доступен из Вашей локальной сети, если Вы настраиваете сервер без возможности подключения к нему из Интернета).
 
[[Ejabberd]] может быть установлен на ваш сервер различными способами. Опишу три по нарастанию сложности:


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


Далее подробно рассмотрены эти варианты.
__TOC__
==Установка из репозитория==
==Установка из репозитория==
Репозиториев Linux великое множество, и нет никакой возможности рассмотреть детали установки в каждом из них. Упомянем наиболее популярные (предполагается наличие прав root):
Дистрибутивов Linux великое множество, и нет никакой возможности рассмотреть детали установки в каждом из них. Упомянем наиболее популярные (предполагается наличие прав root):
 
===Fedora===
По умолчанию нужный репозиторий обычно подключен.
yum install ejabberd


===openSuSE 11.0===
===Debian-based дистрибутивы (Debian, *Ubuntu и другие)===
Сначала подключим репозиторий, посвящённый серверам обмена сообщениями:
Ejabberd входит в основную ветку репозитория, поэтому для установки просто скомандуйте:
  zypper addrepo http://download.opensuse.org/repositories/server:/messaging/openSUSE_11.0/ Messaging
  apt-get install ejabberd


Потом установим:
===Gentoo===
  zypper install ejabberd
Для установки ejabberd в Gentoo GNU/Linux выполните команды
echo "net-im/ejabberd pam ssl zlib mod_muc mod_pubsub web" >> /etc/portage/package.use
  emerge ejabberd


===Fedora Core 11===
==Установка готовых бинарников==
По умолчанию нужный репозиторий обычно подключен.
Установка из готовых бинарных пакетов делается за несколько простых шагов:
yum install ejabberd


{{ToDo|Е-щё ин-фор-мации! (С)}}
* Скачиваете подходящий '''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.


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


Итак, нам нужен исходный код ejabberd. Идём на [http://www.ejabberd.im официальный сайт] и выбираем, что нужно. Лучше выбирать stable версию, но если вы очень любите новые фишки и не боитесь глюков, то берите beta, testing или cvs версии.
Итак, нам нужен исходный код ejabberd. Идём на [http://www.ejabberd.im официальный сайт] и выбираем, что нужно. Лучше выбирать stable версию, но если вы очень любите новые фишки и не боитесь нестабильной работы, то берите beta, testing или [[ru_wikipedia:Subversion|SVN]] версии.


Я выбрал stable-версию 2.0.5 и скачал её:
Я выбрал stable-версию 2.0.5 и скачал её:
Строка 44: Строка 60:
Конечно же, у вас есть эта удобнейшая утилита - wget. ;)
Конечно же, у вас есть эта удобнейшая утилита - wget. ;)


Ещё нам понадобится свеженький [[ru_wikipedia:Erlang|Erlang]] - это компилятор языка, на котором написан ejabberd. Если Erlang есть в вашем репозитории, то лучше воспользоваться им. Если нет - покажу, как собрать его из [http://erlang.org/download.html исходных кодов]. Как программист, не удержусь от пояснения, зачем было использовать этот с виду громоздкий и неудобный язык. Он громоздок и неудобен действительно лишь с виду, для написания программ вроде hello world, однако предоставляет прекрасный инструментарий многопоточного и распределённого программирования. Это позволит вам единожды написанную и собранную программу использовать на огромных кластерах, состоящих из машин любой архитектуры, в которые будет проще простого добавить новые вычислительные мощности. Даже Java не обладает подобными возможностями. Именно поэтому ejabberd считается одним из самых быстрых и масштабируемых серверов протокола XMPP.
Ещё нам понадобится свеженький [[ru_wikipedia:Erlang|Erlang]] - это компилятор языка, на котором написан ejabberd. Если Erlang есть в вашем репозитории, то лучше воспользоваться им. Если нет - покажу, как собрать его из [http://erlang.org/download.html исходных кодов].
 
Как программист, не удержусь от пояснения, зачем было использовать этот с виду громоздкий и неудобный язык. Он громоздок и неудобен действительно лишь с виду, для написания программ вроде hello world, однако предоставляет прекрасный инструментарий многопоточного и распределённого программирования. Это позволит вам единожды написанную и собранную программу использовать на огромных кластерах, состоящих из машин любой архитектуры, в которые будет проще простого добавить новые вычислительные мощности. Даже Java не обладает подобными возможностями. Именно поэтому ejabberd считается одним из самых быстрых и масштабируемых серверов протокола XMPP.


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


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


===ejabberd===
===ejabberd===
Строка 73: Строка 90:
  tar zxf ejabberd-2.0.5.tar.gz -С buildtmp  
  tar zxf ejabberd-2.0.5.tar.gz -С buildtmp  


переходим в каталог с исходниками и собираем ejabberd:
Переходим в каталог с исходниками и собираем ejabberd:
  cd buildtmp/ejabberd-2.0.5/src
  cd buildtmp/ejabberd-2.0.5/src
  ./configure
  ./configure
Строка 79: Строка 96:
  make install
  make install


После всех этих манипуляций все нужные файлы разложены согласно традициям unix/linux. Конфиги, в частности,- в /etc/ejabberd. Скрипт запуска - /sbin/ejabberdctl - отрабатывает команду start, что позволяет сразу добавить в rc.d, хотя лучше всё же написать правильный скрипт управления службой согласно правилам вашего дистрибутива.
После всех этих манипуляций все нужные файлы разложены согласно традициям UNIX/Linux. Конфиги, в частности,- в /etc/ejabberd. Скрипт запуска - /sbin/ejabberdctl - отрабатывает команду start, что позволяет сразу добавить в rc.d, хотя лучше всё же написать правильный скрипт управления службой согласно правилам вашего дистрибутива.
}}
 
==Настройка==
А дальше надо настроить сервер: что делать при загрузке, какие модули использовать, какие порты прослушивать, и т.п.
 
Настройка сервера сводится к редактированию файла конфигурации '''/etc/ejabberd/ejabberd.yml''' (путь показан на примере Debian GNU/Linux, в других дистрибутивах или при самостоятельной сборке из исходных кодов путь может отличаться). Откройте этот файл от пользователя '''root''' в любом удобном для Вас текстовом редакторе, после чего найдите следующие секции: секцию '''acl''' и секцию '''hosts'''.
 
В первом параметре задается [[Jabber ID]] администратора, а во втором - доменное имя сервера. Приведите эти строки примерно к такому виду:
 
<pre>
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"
</pre>


===Установка готовых бинарников===
В данном случае [[JID]] администратора задан [xmpp:admin@myjabber.ath.cx admin@myjabber.ath.cx], а имя сервера, как уже условились выше - myjabber.ath.cx.
Для начала нужно скачать инсталлятор. Я рассмотрю stable-версию 2.0.5 для 32-битного linux:
wget http://www.process-one.net/downloads/ejabberd/2.0.5/ejabberd-2.0.5-linux-x86-installer.bin.gz


Пакет распаковывается:
Теперь в том же файле найдите секцию access_rules, а в ней - параметр register:
gunzip ejabberd-2.0.5-linux-x86-installer.bin.gz


И запускается:
<pre>
chmod +x ejabberd-2.0.5-linux-x86-installer.bin
access_rules:
./ejabberd-2.0.5-linux-x86-installer.bin
  register:
    - allow
</pre>


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


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


{{ToDo|Расписать настройку (это ж самое интересное :))}}
/etc/init.d/ejabberd restart


При грамотной настройке ваш сервер поможет людям общаться без опасности быть "подслушанными" спецслужбами и другими злоумышленниками. ;)
<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


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


* [http://www.ejabberd.im Официальный сайт ejabberd (англ.)]
* [[Свой сервер: подробное руководство по установке ejabberd]]
* [http://www.process-one.net/en/ejabberd/docs Официальная документация по ejabberd (англ.)]
* [http://erlang.org Официальный сайт Erlang (англ.))]
* [http://ylsoftware.com/news/499 Настройка ведения логов в конференции]
* [http://ylsoftware.com/news/499 Настройка ведения логов в конференции]
* [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

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