zxyszx
5.6 KiB
NewSzxcn 邮箱指南
本指南介绍 NewSzxcn Email 的安装入口、首次配置、邮箱申请、无人收件、SSL 证书和日常更新。管理员密码等敏感信息不会保存在本文档中。
一键安装
建议使用 Debian 或 Ubuntu，并提前准备一个已经解析到服务器的邮件主机名，例如 mail.example.com。
bash <(curl -fsSL https://raw.githubusercontent.com/zxyszx/NewSzxcn-Email/main/install.sh)
安装脚本会依次询问防火墙配置、邮件服务器域名、管理员用户名和密码，以及 Web 部署方式。选择“自动配置 Nginx + SSL”时，脚本会安装 Nginx，并使用官方 acme.sh 申请 Let's Encrypt 证书。
安装完成后，请记录终端中显示的访问地址、管理员用户名和初始密码。初始密码仅在安装时显示；如果以后在后台修改密码，请以新密码为准。
登录入口
假设安装时填写的邮件服务器域名为 mail.example.com：
| 入口 | 地址 | 用途 |
|---|---|---|
| 邮箱前台 | https://mail.example.com/ |
收发邮件、申请邮箱和账号设置 |
| 管理后台 | https://mail.example.com/admin |
管理域名、账号、邮箱、DNS 和系统设置 |
管理员账号是安装时填写的用户名，默认为 admin。管理员用户名不是邮箱地址。
首次配置
1. 添加邮件域名
- 登录 NewSzxcn Email 管理后台。
- 进入“域名管理”，点击“添加域名”。
- 填写需要收发邮件的域名并保存。
- 点击该域名右侧的“DNS”，查看系统生成的记录。
- 前往域名服务商的 DNS 管理页面，逐项添加 MX、SPF、DKIM 和 DMARC 记录。
- 返回管理后台，点击“检测”。
- 所有记录检测通过后，即可使用该域名创建邮箱。
DNS 生效通常需要几分钟到数小时。系统只能检测记录，不能代替你修改域名服务商的 DNS。
2. 开启账号自助申请邮箱
- 进入“管理后台 -> 系统设置 -> 邮件”。
- 开启“账号自助申请邮箱”。
- 在“开放域名”中勾选允许用户申请邮箱的域名。
- 保存设置。
开启后，用户登录邮箱前台，进入“设置 -> 邮箱管理”，即可在账号配额范围内自行申请邮箱，无需管理员逐个分配。
如果账号还没有邮箱，邮箱前台会显示“还没有可用邮箱”。此时应点击“前往邮箱管理”，进入个人中心申请邮箱。
3. 开启无人收件
- 进入“管理后台 -> 系统设置 -> 邮件”。
- 开启“无人收件”并保存。
开启后，对于系统中已经添加并启用的邮件域名，即使收件地址尚未注册，服务器仍会接收邮件。例如已经启用 example.com 后，发送到 111@example.com 的邮件也会被保留。
无人收件不会自动创建邮箱，也不会把邮件分配给普通用户。只有管理员可以在邮箱前台左侧的“未知收件”中查看这些邮件。
SSL 证书与自动续期
选择“自动配置 Nginx + SSL”后，官方 acme.sh 会安装定时检查任务。证书接近到期时会自动续期，续期成功后自动重载 NewSzxcn Email 和 Nginx。
查看当前域名的证书和续期信息：
/root/.acme.sh/acme.sh --info --domain mail.example.com --ecc
查看证书实际到期时间：
openssl x509 -in /opt/newszxcn-email/certs/fullchain.pem -noout -enddate
手动申请、检查或重新安装证书：
sudo newszxcn-email certificate
证书续期计划由 acme.sh 和证书颁发机构动态决定，不应把预计续期日期写死在配置或文档中。
更新与运维
重新打开安装与运维菜单：
sudo ns
也可以执行 sudo newszxcn-email menu，或重新运行一键安装命令。
常用命令：
sudo newszxcn-email update
sudo newszxcn-email status
sudo newszxcn-email restart
sudo newszxcn-email logs
sudo newszxcn-email certificate
sudo newszxcn-email rollback
sudo newszxcn-email guide
命令行更新会创建完整回滚快照、校验 SQLite 数据库备份、拉取最新镜像并执行健康检查。rollback 命令会先备份当前数据库并要求确认，然后恢复上次更新前的镜像、数据库、Compose、环境、安装脚本和 Nginx 配置。回滚镜像会保持锁定，下一次执行更新时解除。
guide 命令会读取当前安装地址、管理员用户名、证书到期时间和 acme.sh 续期状态，重新生成仅 root 可读的 /root/newszxcn-email-guide.txt。
超级管理员也可以点击管理后台侧栏中的版本号，在版本更新页面检查并安装新版本。
必要端口
请同时检查服务器防火墙和云服务商安全组：
| 端口 | 用途 |
|---|---|
25/TCP |
邮件服务器之间收发邮件 |
80/TCP |
HTTP 跳转和证书签发验证 |
443/TCP |
邮箱前台和管理后台 |
465/TCP |
SMTP SSL 发信 |
587/TCP |
SMTP Submission 发信 |
993/TCP |
IMAP SSL 收信 |
995/TCP |
POP3 SSL 收信 |
部分云服务商默认封锁出站 25/TCP。网页可以正常打开并不代表公网邮件一定能够成功投递。
数据与备份
默认数据目录为 /opt/newszxcn-email。重要数据包括：
/opt/newszxcn-email/
|-- .env
|-- data/
|-- mail/
|-- dkim/
`-- certs/
执行服务器快照或异地备份时，应同时保存这些目录。不要公开 .env、证书私钥、数据库备份或管理员登录信息。