热门搜索:
ntninja/modoboa
ntninja
Modoboa的非官方Docker镜像，用于简化邮件托管服务的部署与管理，集成Postfix、Dovecot等组件，支持DNSSEC/DANE安全验证及插件扩展。
12 次收藏下载次数: 0状态：社区镜像维护者：ntninja仓库类型：镜像最近更新：5 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
说明：此容器由docker-image-rebuilder每晚自动构建，当Modoboa上游或Alpine包更新时会接收更新。(Dockerfile)
Modoboa容器集
推荐运行环境
DNSSEC验证的DNS解析器
强烈推荐在主机系统上安装支持DNSSEC验证的递归DNS解析器（如Unbound）。内置Postfix配置会使用它对支持的远程服务器进行DANE验证，提升发送消息的安全性。此外，本地缓存DNS解析器可加速邮件处理（Postfix会为每条消息发起大量DNS查询）。
Unbound
安装unbound包，启动服务并将/etc/resolv.conf设置为nameserver 127.0.0.1。Unbound默认启用DNSSEC并自动更新信任锚。
dnsmasq（含多数发行版的NetworkManager）
若选择dnsmasq而非systemd-resolved，需确保上游DNS支持DNSSEC：
- 用
delv @<上游服务器> ietf.org验证，输出首行应为“; fully validated”； - 添加配置启用验证（独立服务：
/etc/dnsmasq.d/dnssec；NetworkManager集成：/etc/NetworkManager/dnsmasq.d/dnssec）：# 启用DNSSEC验证与缓存 dnssec # DNSSEC信任锚（来源：https://data.iana.org/root-anchors/root-anchors.xml） trust-anchor=.,20326,8,2,E06D44B80B8F1D39A95C0B0D7C65D08458E880409BBC683457104237C7F8EC8D - 独立服务需设置
/etc/resolv.conf为nameserver 127.0.0.1。
systemd-resolved（含部分发行版的NetworkManager）
- 确保上游DNS支持DNSSEC；
- 在
/etc/systemd/resolved.conf中添加DNSSEC=yes启用强制验证（systemd-resolved内置最新信任锚）； - 可按需启用DNS-over-TLS（配置超出本指南范围）。
安装配置
下载并解压快速启动示例目录：
shwget "https://gitlab.com/ntninja/docker-recipies/raw/master/modoboa/quickstart.zip" unzip quickstart.zip mv quickstart modoboa cd modoboa
目录包含docker-compose.yml文件，可根据需求调整。
Modoboa部署
运行以下命令部署新实例（每个容器仅支持一个实例）：
shelldocker-compose run modoboa deploy --collectstatic \ --domain <服务器主机名> --dburl default:<mysql|postgres>://[user:pass@][host:port]/dbname
需提前准备PostgreSQL/MySQL数据库，并确保与Modoboa服务在同一网络（PostgreSQL已测试，MySQL理论支持，SQLite可能存在问题）。
Dovecot配置
预生成Dovecot TLS Diffie-Hellman参数：
shellopenssl dhparam -out ./dovecot/config/dh.pem 4096
启动服务
执行docker-compose up后，Modoboa容器将在8080端口监听HTTP请求。安装后需在Modoboa→参数中设置以下项：
- Modoboa Core：管理→→文件系统处理：No（启用会导致sudo错误）；
- modoboa-sievefilters：SIEVE-过滤器→ManageSieve设置：服务器地址dovecot、端口4190、StartTLS No；IMAP设置：服务器地址dovecot、端口143、安全连接No；
- modoboa-stats：默认路径（
/var/log/mail.log&/tmp/modoboa）无需修改； - modoboa-webmail：Webmail→IMAP设置：服务器地址dovecot、端口143、安全连接No；SMTP设置：服务器地址postfix、端口587、安全连接None。
管理命令
通过docker-compose run modoboa ...执行管理脚本：
- 运行
modoboa-admin.py：docker-compose run modoboa admin <选项>； - 运行
python3 manage.py：docker-compose run modoboa manage <选项>； - 安装插件：
docker-compose run modoboa install <插件名>。
升级步骤
编辑docker-compose.yml中的版本号，停止服务后执行：
sh# 更新镜像 docker-compose pull # 更新Python插件 docker-compose run modoboa update # 迁移数据与刷新静态文件 docker-compose run modoboa manage migrate echo yes | docker-compose run modoboa manage collectstatic
升级注意事项
- Modoboa 1.15：Python版本从3.7升级到3.8，需重命名插件目录（
mv modoboa/data/packages-prefix/lib/python3.7 modoboa/data/packages-prefix/lib/python3.8），并修改settings.py中STATICFILES_DIRS路径为/usr/lib/python3.8/；添加DISABLE_DASHBOARD_EXTERNAL_QUERIES = False到settings.py； - Modoboa 1.14：禁用“文件系统处理***”设置；LDAP未测试；
- Modoboa 1.13：Postfix镜像改为
ntninja/modoboa-postfix:latest，需更新compose文件；Postfix配置新增DNSSEC/DANE验证支持。
获取帮助
可在GitLab仓库提交问题，或发送邮件至***。 ===END===
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull ntninja/modoboa:<标签>
更多 modoboa 镜像推荐
ntninja/modoboa-dovecot
ntninja
该Docker镜像由docker-image-rebuilder每晚自动构建，当上游Alpine包更新时会同步更新，更多信息请参见ntninja/modoboa镜像。
1万+ 次下载
2 年前更新
ntninja/wordpress-postgresql
ntninja
WordPress发布平台，包含PostgreSQL数据库后端支持的修改版本，通过安装PHP pgsql扩展、添加PostgreSQL for WordPress插件及启动脚本实现PostgreSQL兼容。
5 次收藏1万+ 次下载
2 年前更新
ntninja/alpine-postfix
ntninja
暂无描述
1 次收藏1万+ 次下载
2 年前更新
ntninja/wordpress
ntninja
暂无描述
23 次下载
5 年前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"