secubox-openwrt/package/secubox/secubox-app-mailserver/README.zh.md

SecuBox Mail Server

Languages: English | Francais | 中文

在 LXC 容器中运行的自定义邮件服务器（Postfix + Dovecot），支持 mesh 备份。

功能特性

• Postfix - 支持虚拟域的 SMTP 服务器
• Dovecot - 带 LMTP 投递的 IMAP/POP3
• Rspamd - 垃圾邮件过滤
• OpenDKIM - 邮件签名
• Mesh 备份 - 与其他 SecuBox 节点的 P2P 备份同步
• Webmail 集成 - 与 Roundcube 容器配合使用

安装

opkg install secubox-app-mailserver

快速开始

# 1. 配置域名
uci set mailserver.main.domain='example.com'
uci set mailserver.main.hostname='mail'
uci commit mailserver

# 2. 安装容器
mailctl install

# 3. 设置 DNS 记录（MX、SPF、DMARC）
mailctl dns-setup

# 4. 获取 SSL 证书
mailctl ssl-setup

# 5. 添加邮件用户
mailctl user add user@example.com

# 6. 启用并启动
uci set mailserver.main.enabled=1
uci commit mailserver
/etc/init.d/mailserver start

# 7. 配置 webmail
mailctl webmail configure

CLI 参考

服务控制

mailctl start      # 启动邮件服务器
mailctl stop       # 停止邮件服务器
mailctl restart    # 重启邮件服务器
mailctl status     # 显示状态

用户管理

mailctl user add user@domain.com    # 添加用户（提示输入密码）
mailctl user del user@domain.com    # 删除用户
mailctl user list                   # 列出所有用户
mailctl user passwd user@domain.com # 更改密码

别名

mailctl alias add info@domain.com user@domain.com
mailctl alias list

SSL 证书

mailctl ssl-setup    # 通过 DNS-01 获取 Let's Encrypt 证书
mailctl ssl-status   # 显示证书信息

DNS 集成

mailctl dns-setup    # 通过 dnsctl 创建 MX、SPF、DMARC 记录

Mesh 备份

mailctl mesh backup              # 为 mesh 同步创建备份
mailctl mesh restore <文件>       # 从备份恢复
mailctl mesh sync push           # 推送到 mesh peers
mailctl mesh sync pull           # 从 mesh peers 拉取
mailctl mesh add-peer <peer_id>  # 添加 mesh peer
mailctl mesh peers               # 列出已配置的 peers
mailctl mesh enable              # 启用 mesh 同步
mailctl mesh disable             # 禁用 mesh 同步

Webmail

mailctl webmail status      # 检查 Roundcube 状态
mailctl webmail configure   # 将 Roundcube 指向此服务器

诊断

mailctl logs         # 查看邮件日志（最后 50 行）
mailctl logs 100     # 查看最后 100 行
mailctl test user@external.com   # 发送测试邮件

UCI 配置

config mailserver 'main'
    option enabled '0'
    option hostname 'mail'
    option domain 'example.com'
    option postmaster 'postmaster'
    option data_path '/srv/mailserver'
    option container 'mailserver'

config ports 'ports'
    option smtp '25'
    option submission '587'
    option smtps '465'
    option imap '143'
    option imaps '993'
    option pop3 '110'
    option pop3s '995'

config features 'features'
    option spam_filter '1'
    option virus_scan '0'
    option dkim '1'
    option spf '1'
    option dmarc '1'
    option fail2ban '1'

config ssl 'ssl'
    option type 'letsencrypt'

config webmail 'webmail'
    option enabled '1'
    option container 'secubox-webmail'
    option port '8026'

config mesh 'mesh'
    option enabled '0'
    option backup_peers ''
    option sync_interval '3600'

数据结构

/srv/mailserver/
├── config/          # Postfix/Dovecot 配置
│   ├── vmailbox     # 虚拟邮箱映射
│   ├── valias       # 虚拟别名映射
│   └── users        # Dovecot 用户数据库
├── mail/            # Maildir 存储
│   └── example.com/
│       └── user/
│           ├── cur/
│           ├── new/
│           └── tmp/
└── ssl/             # SSL 证书
    ├── fullchain.pem
    └── privkey.pem

所需 DNS 记录

mailctl dns-setup 命令通过 dnsctl 创建以下记录：

类型	名称	值
A	mail	<公网IP>
MX	@	10 mail.example.com.
TXT	@	v=spf1 mx a:mail.example.com ~all
TXT	_dmarc	v=DMARC1; p=none; rua=mailto:postmaster@example.com
TXT	mail._domainkey	v=DKIM1; k=rsa; p=<公钥>

端口

端口	协议	描述
25	SMTP	邮件传输（服务器到服务器）
587	Submission	邮件提交（客户端到服务器）
465	SMTPS	安全 SMTP
143	IMAP	邮件访问
993	IMAPS	安全 IMAP
110	POP3	邮件下载（可选）
995	POP3S	安全 POP3（可选）
4190	Sieve	邮件过滤规则

依赖

• lxc - 容器运行时
• secubox-app-dns-provider - DNS 记录管理
• acme - SSL 证书自动化（可选）
• secubox-p2p - Mesh 备份同步（可选）