louiz/biboumi

Biboumi Docker镜像

镜像概述

本镜像为biboumi的官方Docker镜像，biboumi是一款XMPP-IRC网关工具，允许用户通过XMPP客户端连接并访问IRC网络。镜像不内置XMPP服务器，需配合已运行的XMPP服务使用。

核心功能

• 实现XMPP与IRC协议的双向转换
• 支持Sqlite3和PostgreSQL两种数据库存储方式
• 通过环境变量或自定义配置文件灵活调整参数
• 可与Docker化XMPP服务器（如Prosody）或主机本地XMPP服务联动

使用场景

• 需要通过XMPP客户端访问IRC网络的个人用户
• 企业或团队搭建内部XMPP-IRC互通的通信环境
• 开发者在Docker生态中快速部署网关服务

配置说明

运行镜像

与Prosody容器联动

假设已运行Prosody容器并配置外部组件，启动命令：

docker run --link prosody:xmpp \
    -v $PWD/database:/var/lib/biboumi \
    -e BIBOUMI_PASSWORD=P4SSW0RD \
    -e BIBOUMI_HOSTNAME=irc.example.com \
    -e BIBOUMI_ADMIN=blabla \
    louiz/biboumi

连接主机XMPP服务器

若XMPP服务运行在主机，启动命令：

docker run --network=host \
    -v $PWD/database:/var/lib/biboumi \
    -e BIBOUMI_PASSWORD=P4SSW0RD \
    -e BIBOUMI_HOSTNAME=irc.example.com \
    -e BIBOUMI_ADMIN=blabla \
    -e BIBOUMI_XMPP_SERVER_IP=127.0.0.1 \
    louiz/biboumi

环境变量配置

主要可配置变量：

• BIBOUMI_HOSTNAME: 网关主机名
• BIBOUMI_PASSWORD: XMPP服务器通信密码
• BIBOUMI_ADMIN: 管理员账号
• BIBOUMI_XMPP_SERVER_IP: XMPP服务器IP（默认xmpp）
• BIBOUMI_DB_NAME: 数据库路径（Sqlite3）或URI（PostgreSQL）

也可挂载自定义配置文件覆盖默认设置：

docker run --link prosody:xmpp \
    -v $PWD/biboumi.cfg:/etc/biboumi/biboumi.cfg \
    louiz/biboumi

数据持久化

默认Sqlite3数据库路径为/var/lib/biboumi，需挂载主机目录保持数据：

-v /srv/biboumi/:/var/lib/biboumi

确保目录权限正确：

chown -R 1000:1000 database/
chmod 777 database/

与PostgreSQL联动

1. 启动PostgreSQL容器：

docker run --name postgres postgres:latest

2. 启动biboumi并链接PostgreSQL：

docker run --name biboumi \
    --link=postgres \
    -e BIBOUMI_DB_NAME=postgres://postgres@postgres/postgres \
    louiz/biboumi