Jabber: Unterschied zwischen den Versionen
Zeile 1: | Zeile 1: | ||
− | + | == ejabberd einrichten == | |
− | + | XMPP-Server gibt es an der Zahl viele. Ein populärer, freier XMPP-Server ist [ejabberd|https://www.ejabberd.im/]. ''Ejabberd'' ist unter Windows und Unix-Derivaten verfügbar. Neben diversen Modulen und Transports unterstützt ''ejabberd'' die Einrichtung von Clustern, so dass durch den Parallelbetrieb mehrerer Server eine hohe Ausfallsicherheit erzeugt werden kann. Im Folgenden wird die Installation und Einrichtung unter Debian Wheezy als Benutzer ''root'' beschrieben. | |
+ | Zunächst installieren wir das Paket mit dem Server: | ||
− | - | + | apt-get install ejabberd |
− | |||
− | + | Im Anchluss führen wir eine Grundkonfiguration durch: | |
− | |||
− | |||
− | + | dpkg-reconfigure ejabberd | |
− | + | Im Zuge der Grundkonfiguration geben wir die Domain ''<domain>'' des Servers, sowie einen Namen für den Administrator ''<administrator>'' sowie ein Passwort ein. Debconf nimmt im Anschluss automatisch die notwendigen Änderungen in der zentralen Konfigurationsdatei ''/etc/ejabberd/ejabberd.cfg'' vor. Dort sollten wir nach Abschluss der Grundkonfiguration den folgenden Abschnitt finden: | |
− | |||
− | |||
− | |||
− | |||
+ | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% | ||
+ | %% Options which are set by Debconf and managed by ucf | ||
+ | |||
+ | %% Admin user | ||
+ | {acl, admin, {user, "<administrator>", "<domain>"}}. | ||
+ | |||
+ | %% Hostname | ||
+ | {hosts, ["<domain>"]}. | ||
− | + | Da dies noch nicht ausreichend ist, öffnen wir die Konfigurationsdatei ''/etc/ejabberd/ejabberd.cfg'' im Anschluss mit dem Editor unserer Wahl und bessern an einigen Stellen nach. | |
+ | Damit wir als Administrator informiert werden, wenn der ''ejabberd''-Prozess außer Kontrolle gerät, aktivieren wir den Watchdog: | ||
− | {5280, ejabberd_http, [ | + | %% |
+ | %% watchdog_admins: If an ejabberd process consumes too much memory, | ||
+ | %% send live notifications to those Jabber accounts. | ||
+ | %% | ||
+ | {watchdog_admins, ["<admin>@<domain>"]}. | ||
+ | |||
+ | Weiterhin wollen wir ''ejabberd'' über die eingebaute Web-Oberfläche konfigurieren können: | ||
+ | |||
+ | {5280, ejabberd_http, [ | ||
{request_handlers, | {request_handlers, | ||
[ | [ | ||
Zeile 33: | Zeile 44: | ||
]} | ]} | ||
− | + | Benutzern soll es prinzipiell erlaubt sein, sich selbst zu registrieren: | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | %% No username can be registered via in-band registration: | |
+ | %% To enable in-band registration, replace 'deny' with 'allow' | ||
+ | % (note that if you remove mod_register from modules list then users will not | ||
+ | % be able to change their password as well as register). | ||
+ | % This setting is default because it's more safe. | ||
+ | {access, register, [{allow, all}]}. | ||
− | + | Statt Englisch möchten wir Deutsch als Standardsprache für alle Meldungen: | |
− | |||
− | |||
− | |||
+ | %% | ||
+ | %% language: Default language used for server messages. | ||
+ | %% | ||
+ | {language, "de"}. | ||
+ | Zuletzt stellen wir noch sicher, dass das Modul ''mod_register'' für die Benutzerregistrierung aktiviert ist und tragen unter ''registration_watchers'' unseren Administrator ein. In Zukunft sollten wir informiert werden, nachdem sich ein Benutzer registriert hat. | ||
{mod_register, [ | {mod_register, [ | ||
Zeile 68: | Zeile 78: | ||
%% these Jabber accounts. | %% these Jabber accounts. | ||
%% | %% | ||
− | {registration_watchers, ["admin@ | + | {registration_watchers, ["<admin>@<domain>"]}, |
− | + | Im Anschluss starten wir ''ejabberd'' erneut, damit die Änderungen übernommen werden: | |
− | + | service ejabberd restart | |
− | |||
− | |||
− | + | Im Normalfall sollte unser Rechner durch eine Firewall geschützt sein. Damit ejabberd funktionieren kann, müssen die Ports 5222, 5269 und 5280 für eingehende Verbindungen geöffnet werden. Falls die ''Uncomplicated Firewall'' verwendet wird, gelingt dies mit: | |
− | + | ufw allow 5222 # client connections | |
+ | ufw allow 5269 # server connections | ||
+ | ufw allow 5280 # web configuration interface | ||
− | [ | + | Ab sofort sollten sich Klienten registrieren und mit dem Server verbinden können. Die Administrationsoberfläche erreichen wir unter [http://box-1719.ff3l:5280/admin/]. Für den Login verwenden wir den zuvor angelegten Administrator sowie das zugehörige Passwort. Vorsicht: Die Verbindung ist nicht verschlüsselt! |
Version vom 29. März 2015, 11:58 Uhr
ejabberd einrichten
XMPP-Server gibt es an der Zahl viele. Ein populärer, freier XMPP-Server ist [ejabberd|https://www.ejabberd.im/]. Ejabberd ist unter Windows und Unix-Derivaten verfügbar. Neben diversen Modulen und Transports unterstützt ejabberd die Einrichtung von Clustern, so dass durch den Parallelbetrieb mehrerer Server eine hohe Ausfallsicherheit erzeugt werden kann. Im Folgenden wird die Installation und Einrichtung unter Debian Wheezy als Benutzer root beschrieben. Zunächst installieren wir das Paket mit dem Server:
apt-get install ejabberd
Im Anchluss führen wir eine Grundkonfiguration durch:
dpkg-reconfigure ejabberd
Im Zuge der Grundkonfiguration geben wir die Domain <domain> des Servers, sowie einen Namen für den Administrator <administrator> sowie ein Passwort ein. Debconf nimmt im Anschluss automatisch die notwendigen Änderungen in der zentralen Konfigurationsdatei /etc/ejabberd/ejabberd.cfg vor. Dort sollten wir nach Abschluss der Grundkonfiguration den folgenden Abschnitt finden:
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% Options which are set by Debconf and managed by ucf %% Admin user {acl, admin, {user, "<administrator>", "<domain>"}}. %% Hostname {hosts, ["<domain>"]}.
Da dies noch nicht ausreichend ist, öffnen wir die Konfigurationsdatei /etc/ejabberd/ejabberd.cfg im Anschluss mit dem Editor unserer Wahl und bessern an einigen Stellen nach. Damit wir als Administrator informiert werden, wenn der ejabberd-Prozess außer Kontrolle gerät, aktivieren wir den Watchdog:
%% %% watchdog_admins: If an ejabberd process consumes too much memory, %% send live notifications to those Jabber accounts. %% {watchdog_admins, ["<admin>@<domain>"]}.
Weiterhin wollen wir ejabberd über die eingebaute Web-Oberfläche konfigurieren können:
{5280, ejabberd_http, [ {request_handlers, [ {["pub", "archive"], mod_http_fileserver} ]}, %%captcha, http_bind, http_poll, web_admin ]}
Benutzern soll es prinzipiell erlaubt sein, sich selbst zu registrieren:
%% No username can be registered via in-band registration: %% To enable in-band registration, replace 'deny' with 'allow' % (note that if you remove mod_register from modules list then users will not % be able to change their password as well as register). % This setting is default because it's more safe. {access, register, [{allow, all}]}.
Statt Englisch möchten wir Deutsch als Standardsprache für alle Meldungen:
%% %% language: Default language used for server messages. %% {language, "de"}.
Zuletzt stellen wir noch sicher, dass das Modul mod_register für die Benutzerregistrierung aktiviert ist und tragen unter registration_watchers unseren Administrator ein. In Zukunft sollten wir informiert werden, nachdem sich ein Benutzer registriert hat.
{mod_register, [ %% %% After successful registration, the user receives %% a message with this subject and body. %% {welcome_message, {"Welcome!", "Welcome to a Jabber service powered by Debian. " "For information about Jabber visit " "http://www.jabber.org"}}, %% Replace it with 'none' if you don't want to send such message: %%{welcome_message, none},
%% %% When a user registers, send a notification to %% these Jabber accounts. %% {registration_watchers, ["<admin>@<domain>"]},
Im Anschluss starten wir ejabberd erneut, damit die Änderungen übernommen werden:
service ejabberd restart
Im Normalfall sollte unser Rechner durch eine Firewall geschützt sein. Damit ejabberd funktionieren kann, müssen die Ports 5222, 5269 und 5280 für eingehende Verbindungen geöffnet werden. Falls die Uncomplicated Firewall verwendet wird, gelingt dies mit:
ufw allow 5222 # client connections ufw allow 5269 # server connections ufw allow 5280 # web configuration interface
Ab sofort sollten sich Klienten registrieren und mit dem Server verbinden können. Die Administrationsoberfläche erreichen wir unter [1]. Für den Login verwenden wir den zuvor angelegten Administrator sowie das zugehörige Passwort. Vorsicht: Die Verbindung ist nicht verschlüsselt!