Это файл README для DJabberd, масштабируемого и расширяемого сервера Jabber/XMPP.

После установки обратитесь к 'perldoc DJabberd' для получения подробной информации.

Описание

DJabberd был ответом на потребности сервера LiveJournal в Jabber (XMPP). Нам требовалось:

• хорошая производительность для большого количества подключённых пользователей;
• возможность масштабирования до нескольких узлов;
• способность подключаться к LiveJournal во всех местах, а не только для аутентификации.

По сути, мы хотели получить швейцарский армейский нож серверов Jabber (подумайте о qpsmtpd или mod_perl), но ни одного такого не существовало ни на одном языке. Хотя некоторые популярные серверы Jabber позволяли нам использовать подключаемую аутентификацию, ни один из них не давал нам возможности получить доступ к хранилищу списков контактов, vcards, аватарам, статусам присутствия и т. д.

Поэтому мы создали DJabberd. Это сервер Jabber, где почти всё зависит от хуков, которые должны быть реализованы с помощью плагинов. Он сам выполняет основную спецификацию (включая SSL, StartTLS, взаимодействие между серверами и т.д.), но не поставляется с какими-либо средствами аутентификации, хранения данных или списков контактов и т. п. Вам нужно будет найти плагин, который сделает это за вас.

Вы сможете легко интегрировать DJabberd в существующие системы / пользовательскую базу с минимальными усилиями. Просто найдите плагин, который вам подходит (если идеального совпадения ещё не существует!), и настройте его.

Установка

Установка DJabberd следует стандартному процессу установки модуля Perl.

perl Makefile.PL make make test make install

Модуль не использует части C или XS, поэтому компилятор C не требуется.

Документация

Документация по DJabberd несколько недостаточна. Хотя 'perldoc DJabberd' даст вам основы и указания для хакеров, лучший способ начать — погрузиться в демонстрационное приложение.

В каталоге demo/ вы найдёте полнофункциональное демонстрационное приложение, которое состоит из:

• работающего сервера;
• 2 предварительно настроенных клиентов;
• эхо-бота, который находится в списке контактов всех клиентов.

Демонстрационное приложение содержит подробные комментарии, и рекомендуется прочитать исходный код и комментарии, чтобы понять, как оно работает.

Начните с чтения файла demo/demo.conf и следуйте именам классов оттуда.

Чтобы запустить сервер, введите следующие команды из того же каталога, что и этот файл README:

perl -Ilib -Idemo/lib djabberd --conffile demo/demo.conf

Теперь вы можете подключиться к нему, используя стандартные порты jabber на вашем локальном хосте. Прочитайте файл demo/demo.conf для дополнительных заметок.

Для дополнительной диагностики с сервера вы можете увеличить уровень отладки, установив следующую переменную среды:

set LOGLEVEL=DEBUG

В каталоге examples/ есть пример файла конфигурации djabberd.conf и программа 'sixatalk'. 'sixatalk' — это пример сервера на основе djabberd, интегрирующегося с каталогом LDAP.