ugeek/ejabberd

ejabberd Docker镜像文档

镜像概述

该镜像提供ejabberd XMPP服务器的容器化部署，支持Raspberry Pi、ARM及amd64架构，便于快速搭建即时通讯服务。ejabberd是一款功能全面的XMPP服务器，支持多用户聊天、消息路由、用户认证等核心功能。

核心功能与特性

• 支持XMPP协议，实现标准即时通讯功能
• 多架构支持：Raspberry Pi、ARM和amd64
• 内置Web管理界面，便于服务器配置与监控
• 支持用户注册、权限管理及日志记录

使用场景

适用于个人、小型团队或企业搭建内部即时通讯系统，也可作为XMPP服务端用于集成即时通讯功能的应用开发。

使用方法

不同架构的部署命令

Raspberry Pi

bash
docker run -ti -h xmpp --name xmpp -p 5222:5222 -p 5280:5280 -d ugeek/ejabberd:raspberry-pi

ARM架构

bash
docker run -ti -h xmpp --name xmpp -p 5222:5222 -p 5280:5280 -d ugeek/ejabberd:arm

amd64架构（ejabberd 20.01-1）

bash
docker run -ti -h xmpp --name xmpp -p 5222:5222 -p 5280:5280 -d ugeek/ejabberd

基本操作

创建容器

bash
docker run -ti -h xmpp --name xmpp -p 52222:5222 -p 5280:5280 -d ugeek/ejabberd:pi

编辑服务器名称

bash
docker exec -it xmpp vi /etc/ejabberd/ejabberd.yml

重启服务器

bash
docker exec -it xmpp service ejabberd restart

添加用户

bash
docker exec -it xmpp ejabberdctl register 用户名 服务器名称 "密码"

示例：

bash
docker exec -it xmpp ejabberdctl register angel ugeek_xmpp "contraseña"

配置说明

管理员配置

1. 编辑配置文件：

bash
docker exec -it xmpp vi /etc/ejabberd/ejabberd.yml

2. 找到acl部分，在admin的user字段中添加管理员用户名：

yaml
## Full path to a script that generates the image.
## captcha_cmd: "/usr/share/ejabberd/captcha.sh"

acl:
  admin:
     user:
       - "angel"  # 替换为管理员用户名

服务器名称配置

在配置文件中找到hosts字段，修改为实际服务器域名或名称：

yaml
## hosts: Domains served by ejabberd.
## You can define one or several, for example:
## hosts:
##   - "example.net"
##   - "example.com"
##   - "example.org"
hosts:
  - "ugeek_xmpp"  # 替换为实际服务器名称

访问管理网页

• 访问地址：https://服务器IP:5280/admin/
• 登录信息：
  • 用户名：管理员用户名@服务器名称（如angel@ugeek_xmpp）
  • 密码：添加用户时设置的密码

日志查看

bash
docker exec -it xmpp tail -f /var/log/ejabberd/ejabberd.log