Forward Email 自托管安装指南（适用于 Ubuntu）
概述
本指南提供了在 Ubuntu 系统上安装 Forward Email 自托管解决方案的逐步说明。该指南专门针对 Ubuntu 20.04、22.04 和 24.04 LTS 版本。
先决条件
开始安装前，请确保您具备：
- Ubuntu 服务器：20.04、22.04 或 24.04 LTS
- Root 权限：您必须能够以 root 身份运行命令（sudo 权限）
- 域名：您控制的域名，并具有 DNS 管理权限
- 干净的服务器：建议使用全新安装的 Ubuntu
- 网络连接：用于下载软件包和 Docker 镜像
系统要求
- 内存：最低 2GB（生产环境建议 4GB）
- 存储：最低 20GB 可用空间（生产环境建议 50GB 以上）
- CPU：最低 1 个虚拟 CPU（生产环境建议 2 个及以上）
- 网络：具有以下端口可访问的公网 IP 地址：
- 22（SSH）
- 25（SMTP）
- 80（HTTP）
- 443（HTTPS）
- 465（SMTPS）
- 993（IMAPS）
- 995（POP3S）
逐步安装
步骤 1：初始系统设置
首先，确保系统是最新的，并切换到 root 用户：
# 更新系统软件包
sudo apt update && sudo apt upgrade -y
# 切换到 root 用户（安装需要）
sudo su -
步骤 2：配置 DNS 解析器
配置系统使用 Cloudflare 的 DNS 服务器，以确保证书生成的可靠性：
# 如果 systemd-resolved 正在运行，则停止并禁用它
if systemctl is-active --quiet systemd-resolved; then
rm /etc/resolv.conf
systemctl stop systemd-resolved
systemctl disable systemd-resolved
systemctl mask systemd-resolved
fi
# 配置 Cloudflare DNS 解析器
tee /etc/resolv.conf > /dev/null <<EOF
nameserver 1.1.1.1
nameserver 2606:4700:4700::1111
nameserver 1.0.0.1
nameserver 2606:4700:4700::1001
nameserver 8.8.8.8
nameserver 2001:4860:4860::8888
nameserver 8.8.4.4
nameserver 2001:4860:4860::8844
EOF
第3步：安装系统依赖
安装 Forward Email 所需的软件包：
# 更新软件包列表
apt-get update -y
# 安装基本依赖
apt-get install -y \
ca-certificates \
curl \
gnupg \
git \
openssl \
docker-compose \
snapd
第4步：安装 Snap 软件包
通过 snap 安装 AWS CLI 和 Certbot：
# 安装 AWS CLI
snap install aws-cli --classic
# 安装 Certbot 和 DNS 插件
snap install certbot --classic
snap set certbot trust-plugin-with-root=ok
snap install certbot-dns-cloudflare
第5步：安装 Docker
安装 Docker CE 和 Docker Compose：
# 添加 Docker 官方 GPG 密钥
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | tee /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
# 添加 Docker 仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list
# 更新软件包索引并安装 Docker
apt-get update -y
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# 验证 Docker 安装
docker --version
docker compose version
第6步：配置 Docker 服务
确保 Docker 自动启动且正在运行：
# 启用并启动 Docker 服务
systemctl unmask docker
systemctl enable docker
systemctl start docker
# 验证 Docker 是否运行
docker info
如果 Docker 启动失败，尝试手动启动：
# 如果 systemctl 失败，使用此备选启动方法
nohup dockerd >/dev/null 2>/dev/null &
sleep 5
docker info
第7步：配置防火墙
设置 UFW 防火墙以保护服务器安全：
# 设置默认策略
ufw default deny incoming
ufw default allow outgoing
# 允许 SSH（重要 - 不要锁定自己！）
ufw allow 22/tcp
# 允许邮件相关端口
ufw allow 25/tcp # SMTP
ufw allow 80/tcp # HTTP（用于 Let's Encrypt）
ufw allow 443/tcp # HTTPS
ufw allow 465/tcp # SMTPS
ufw allow 993/tcp # IMAPS
ufw allow 995/tcp # POP3S
ufw allow 2993/tcp # IMAP（备用端口）
ufw allow 2995/tcp # POP3（备用端口）
ufw allow 3456/tcp # 自定义服务端口
ufw allow 4000/tcp # 自定义服务端口
ufw allow 5000/tcp # 自定义服务端口
# 允许本地数据库连接
ufw allow from 127.0.0.1 to any port 27017 # MongoDB
ufw allow from 127.0.0.1 to any port 6379 # Redis
# 启用防火墙
echo "y" | ufw enable
# 检查防火墙状态
ufw status numbered
第8步：克隆 Forward Email 仓库
下载 Forward Email 源代码：
# 设置变量
REPO_FOLDER_NAME="forwardemail.net"
REPO_URL="https://github.com/forwardemail/forwardemail.net.git"
ROOT_DIR="/root/$REPO_FOLDER_NAME"
# 克隆仓库
git clone "$REPO_URL" "$ROOT_DIR"
cd "$ROOT_DIR"
# 验证克隆是否成功
ls -la
第9步：设置环境配置
准备环境配置：
# 设置目录变量
SELF_HOST_DIR="$ROOT_DIR/self-hosting"
ENV_FILE_DEFAULTS=".env.defaults"
ENV_FILE=".env"
# 复制默认环境文件
cp "$ROOT_DIR/$ENV_FILE_DEFAULTS" "$SELF_HOST_DIR/$ENV_FILE"
# 创建 SSL 目录
mkdir -p "$SELF_HOST_DIR/ssl"
# 创建数据库目录
mkdir -p "$SELF_HOST_DIR/sqlite-data"
mkdir -p "$SELF_HOST_DIR/mongo-backups"
mkdir -p "$SELF_HOST_DIR/redis-backups"
第10步：配置您的域名
设置您的域名并更新环境变量：
# 将 'yourdomain.com' 替换为您的实际域名
DOMAIN="yourdomain.com"
# 更新环境文件的函数
update_env_file() {
local key="$1"
local value="$2"
if grep -qE "^${key}=" "$SELF_HOST_DIR/$ENV_FILE"; then
sed -i -E "s|^${key}=.*|${key}=${value}|" "$SELF_HOST_DIR/$ENV_FILE"
else
echo "${key}=${value}" >> "$SELF_HOST_DIR/$ENV_FILE"
fi
}
# 更新与域名相关的环境变量
update_env_file "DOMAIN" "$DOMAIN"
update_env_file "NODE_ENV" "production"
update_env_file "HTTP_PROTOCOL" "https"
update_env_file "WEB_HOST" "$DOMAIN"
update_env_file "WEB_PORT" "443"
update_env_file "CALDAV_HOST" "caldav.$DOMAIN"
update_env_file "CARDDAV_HOST" "carddav.$DOMAIN"
update_env_file "API_HOST" "api.$DOMAIN"
update_env_file "APP_NAME" "$DOMAIN"
update_env_file "SMTP_HOST" "smtp.$DOMAIN"
update_env_file "SMTP_PORT" "465"
update_env_file "IMAP_HOST" "imap.$DOMAIN"
update_env_file "IMAP_PORT" "993"
update_env_file "POP3_HOST" "pop3.$DOMAIN"
update_env_file "POP3_PORT" "995"
update_env_file "MX_HOST" "mx.$DOMAIN"
update_env_file "SMTP_EXCHANGE_DOMAINS" "mx.$DOMAIN"
update_env_file "SELF_HOSTED" "true"
update_env_file "WEBSITE_URL" "$DOMAIN"
update_env_file "AUTH_BASIC_ENABLED" "true"
第11步：生成 SSL 证书
选项 A：手动 DNS 验证（推荐大多数用户）
# 使用手动 DNS 验证生成证书
certbot certonly \
--manual \
--agree-tos \
--preferred-challenges dns \
-d "*.$DOMAIN" \
-d "$DOMAIN"
重要：当提示时，您需要在 DNS 中创建 TXT 记录。您可能会看到同一域名的多个挑战 - 请全部创建。添加第二个 TXT 记录时不要删除第一个。
选项 B：Cloudflare DNS（如果您使用 Cloudflare）
如果您的域名使用 Cloudflare 作为 DNS，您可以自动化证书生成：
# 创建 Cloudflare 凭据文件
cat > /root/.cloudflare.ini <<EOF
dns_cloudflare_email = "your-email@example.com"
dns_cloudflare_api_key = "your-cloudflare-global-api-key"
EOF
# 设置正确权限
chmod 600 /root/.cloudflare.ini
# 自动生成证书
certbot certonly \
--dns-cloudflare \
--dns-cloudflare-credentials /root/.cloudflare.ini \
-d "$DOMAIN" \
-d "*.$DOMAIN" \
--non-interactive \
--agree-tos \
--email "your-email@example.com"
复制证书
证书生成后，将它们复制到应用程序目录：
# 复制证书到应用 SSL 目录
cp /etc/letsencrypt/live/$DOMAIN*/* "$SELF_HOST_DIR/ssl/"
# 验证证书是否已复制
ls -la "$SELF_HOST_DIR/ssl/"
第12步：生成加密密钥
创建安全运行所需的各种加密密钥：
# 生成辅助加密密钥
helper_encryption_key=$(openssl rand -base64 32 | tr -d /=+ | cut -c -32)
update_env_file "HELPER_ENCRYPTION_KEY" "$helper_encryption_key"
# 生成用于邮件转发的 SRS 密钥
srs_secret=$(openssl rand -base64 32 | tr -d /=+ | cut -c -32)
update_env_file "SRS_SECRET" "$srs_secret"
# 生成 TXT 加密密钥
txt_encryption_key=$(openssl rand -hex 16)
update_env_file "TXT_ENCRYPTION_KEY" "$txt_encryption_key"
# 生成用于邮件签名的 DKIM 私钥
openssl genrsa -f4 -out "$SELF_HOST_DIR/ssl/dkim.key" 2048
update_env_file "DKIM_PRIVATE_KEY_PATH" "/app/ssl/dkim.key"
# 生成 webhook 签名密钥
webhook_signature_key=$(openssl rand -hex 16)
update_env_file "WEBHOOK_SIGNATURE_KEY" "$webhook_signature_key"
# 设置 SMTP 传输密码
update_env_file "SMTP_TRANSPORT_PASS" "$(openssl rand -base64 32)"
echo "✅ 所有加密密钥生成成功"
第13步：更新配置中的 SSL 路径
在环境文件中配置 SSL 证书路径：
# 更新 SSL 路径指向正确的证书文件
sed -i -E \
-e 's|^(.*_)?SSL_KEY_PATH=.*|\1SSL_KEY_PATH=/app/ssl/privkey.pem|' \
-e 's|^(.*_)?SSL_CERT_PATH=.*|\1SSL_CERT_PATH=/app/ssl/fullchain.pem|' \
-e 's|^(.*_)?SSL_CA_PATH=.*|\1SSL_CA_PATH=/app/ssl/chain.pem|' \
"$SELF_HOST_DIR/$ENV_FILE"
第14步：设置基本认证
创建临时基本认证凭据：
# 生成安全随机密码
PASSWORD=$(openssl rand -base64 16)
# 在环境文件中更新基本认证凭据
update_env_file "AUTH_BASIC_USERNAME" "admin"
update_env_file "AUTH_BASIC_PASSWORD" "$PASSWORD"
# 显示凭据（请保存！）
echo ""
echo "🔐 重要提示：请保存以下登录凭据！"
echo "=================================="
echo "用户名: admin"
echo "密码: $PASSWORD"
echo "=================================="
echo ""
echo "安装完成后，您需要这些凭据访问网页界面。"
echo ""
第15步：使用 Docker Compose 部署
启动所有 Forward Email 服务：
# 设置 Docker Compose 文件路径
DOCKER_COMPOSE_FILE="$SELF_HOST_DIR/docker-compose-self-hosted.yml"
# 停止所有现有容器
docker compose -f "$DOCKER_COMPOSE_FILE" down
# 拉取最新镜像
docker compose -f "$DOCKER_COMPOSE_FILE" pull
# 以后台模式启动所有服务
docker compose -f "$DOCKER_COMPOSE_FILE" up -d
# 等待服务启动
sleep 10
# 检查服务状态
docker compose -f "$DOCKER_COMPOSE_FILE" ps
第16步：验证安装
检查所有服务是否正常运行：
# 检查 Docker 容器
docker ps
# 检查服务日志是否有错误
docker compose -f "$DOCKER_COMPOSE_FILE" logs --tail=50
# 测试网页界面连接
curl -I https://$DOMAIN
# 检查端口是否监听
netstat -tlnp | grep -E ':(25|80|443|465|587|993|995)'
安装后配置
DNS 记录设置
您需要为您的域配置以下 DNS 记录：
MX 记录
@ MX 10 mx.yourdomain.com
A 记录
@ A YOUR_SERVER_IP
mx A YOUR_SERVER_IP
smtp A YOUR_SERVER_IP
imap A YOUR_SERVER_IP
pop3 A YOUR_SERVER_IP
api A YOUR_SERVER_IP
caldav A YOUR_SERVER_IP
carddav A YOUR_SERVER_IP
SPF 记录
@ TXT "v=spf1 mx ~all"
DKIM 记录
获取您的 DKIM 公钥：
# 提取 DKIM 公钥
openssl rsa -in "$SELF_HOST_DIR/ssl/dkim.key" -pubout -outform DER | openssl base64 -A
创建 DKIM DNS 记录：
default._domainkey TXT "v=DKIM1; k=rsa; p=YOUR_DKIM_PUBLIC_KEY"
DMARC 记录
_dmarc TXT "v=DMARC1; p=quarantine; rua=mailto:dmarc@yourdomain.com"
首次登录
- 打开您的网页浏览器并访问
https://yourdomain.com - 输入您之前保存的基本认证凭据
- 完成初始设置向导
- 创建您的第一个邮箱账户
备份配置
设置兼容 S3 的备份
配置自动备份到兼容 S3 的存储：
# 创建 AWS 凭据目录
mkdir -p ~/.aws
# 配置 AWS 凭据
cat > ~/.aws/credentials <<EOF
[default]
aws_access_key_id = YOUR_ACCESS_KEY_ID
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY
EOF
# 配置 AWS 设置
cat > ~/.aws/config <<EOF
[default]
region = auto
output = json
EOF
# 对于非 AWS S3（如 Cloudflare R2），添加端点 URL
echo "endpoint_url = YOUR_S3_ENDPOINT_URL" >> ~/.aws/config
设置备份定时任务
# 使备份脚本可执行
chmod +x "$ROOT_DIR/self-hosting/scripts/backup-mongo.sh"
chmod +x "$ROOT_DIR/self-hosting/scripts/backup-redis.sh"
# 添加 MongoDB 备份定时任务（每天午夜运行）
(crontab -l 2>/dev/null; echo "0 0 * * * $ROOT_DIR/self-hosting/scripts/backup-mongo.sh >> /var/log/mongo-backup.log 2>&1") | crontab -
# 添加 Redis 备份定时任务（每天午夜运行）
(crontab -l 2>/dev/null; echo "0 0 * * * $ROOT_DIR/self-hosting/scripts/backup-redis.sh >> /var/log/redis-backup.log 2>&1") | crontab -
# 验证定时任务是否添加成功
crontab -l
自动更新配置
为您的 Forward Email 安装设置自动更新：
# 创建自动更新命令
DOCKER_UPDATE_CMD="docker compose -f $DOCKER_COMPOSE_FILE pull && docker compose -f $DOCKER_COMPOSE_FILE up -d"
# 添加自动更新定时任务（每天凌晨1点运行）
(crontab -l 2>/dev/null; echo "0 1 * * * $DOCKER_UPDATE_CMD >> /var/log/autoupdate.log 2>&1") | crontab -
# 验证定时任务是否添加成功
crontab -l
维护与监控
日志位置
- Docker Compose 日志：
docker compose -f $DOCKER_COMPOSE_FILE logs - 系统日志：
/var/log/syslog - 备份日志：
/var/log/mongo-backup.log，/var/log/redis-backup.log - 自动更新日志：
/var/log/autoupdate.log
定期维护任务
- 监控磁盘空间：
df -h - 检查服务状态：
docker compose -f $DOCKER_COMPOSE_FILE ps - 查看日志：
docker compose -f $DOCKER_COMPOSE_FILE logs --tail=100 - 更新系统软件包：
apt update && apt upgrade - 续期证书：证书会自动续期，但请监控过期时间
证书续期
证书应自动续期，但您也可以手动续期：
# 手动续期证书
certbot renew
# 复制续期后的证书
cp /etc/letsencrypt/live/$DOMAIN*/* "$SELF_HOST_DIR/ssl/"
# 重启服务以使用新证书
docker compose -f "$DOCKER_COMPOSE_FILE" restart
故障排除
常见问题
1. Docker 服务无法启动
# 检查 Docker 状态
systemctl status docker
# 尝试备用启动方式
nohup dockerd >/dev/null 2>/dev/null &
2. 证书生成失败
- 确保端口 80 和 443 可访问
- 验证 DNS 记录指向您的服务器
- 检查防火墙设置
3. 邮件投递问题
- 验证 MX 记录是否正确
- 检查 SPF、DKIM 和 DMARC 记录
- 确保您的主机提供商未阻止端口 25
4. 无法访问 Web 界面
- 检查防火墙设置：
ufw status - 验证 SSL 证书：
openssl x509 -in $SELF_HOST_DIR/ssl/fullchain.pem -text -noout - 检查基本认证凭据
获取帮助
- 文档: https://forwardemail.net/self-hosted
- GitHub 问题: https://github.com/forwardemail/forwardemail.net/issues
- 社区支持: 查看项目的 GitHub 讨论
安全最佳实践
- 保持系统更新：定期更新 Ubuntu 和软件包
- 监控日志：设置日志监控和告警
- 定期备份：测试备份和恢复流程
- 使用强密码：为所有账户生成强密码
- 启用 Fail2Ban：考虑安装 fail2ban 以增强安全性
- 定期安全审计：定期审查您的配置
结论
您的 Forward Email 自托管安装现在应该已完成并在 Ubuntu 上运行。请记住：
- 正确配置您的 DNS 记录
- 测试邮件的发送和接收
- 设置定期备份
- 定期监控您的系统
- 保持安装更新
有关更多配置选项和高级功能，请参阅官方 Forward Email 文档：https://forwardemail.net/self-hosted#configuration。