19 KiB
Trojan、Nginx、Caddy 与 Gitea 迁移实施记录
实施日期:2026-07-26
1. 服务器与域名
| 服务器 | Trojan 与管理后台 | Gitea | 宿主机 SSH | Git SSH |
|---|---|---|---|---|
43.154.35.111 |
www.hk.chermack.top |
git.hk.chermack.top |
22 |
2222 |
43.159.139.193 |
www.us.chermack.top |
git.us.chermack.top |
22 |
2222 |
2. 最终架构
flowchart LR
U[客户端] -->|HTTP :80| N[Nginx]
U -->|HTTPS :443 / SNI| N
N -->|www.* HTTP| W[Trojan 管理后台 :8081]
N -->|www.* TLS 透传| T[Trojan :8443]
T -->|非 Trojan 流量回落| W
N -->|git.* HTTP| C1[Caddy :8080]
N -->|git.* TLS 透传| C2[Caddy :9443]
C1 --> G[Gitea :3000]
C2 --> G
U -->|Git SSH :2222| G
公网 80/443 只由宿主机 Nginx 监听。Trojan 客户端和 Trojan 管理后台继续共用 www.* 域名,不新增 panel 域名:Nginx 将 www.* 的 TLS 按 SNI 透传到 Trojan;Trojan 对非 Trojan TLS 流量回落到本机管理后台。
3. 迁移前备份与检查
在变更前检查原容器和配置:
docker ps
docker inspect trojan
docker exec trojan cat /usr/local/etc/trojan/config.json
docker exec trojan systemctl cat trojan-web.service
已创建的备份目录:
/root/trojan-gitea-migration-backup-20260726-004630 # 香港
/root/trojan-gitea-migration-backup-20260726-014435 # 美国
/root/gitea-pre-reset-20260726-012207 # 香港 Gitea 重置前
香港服务器另保留了迁移前 Trojan 镜像快照。
4. Trojan 端口调整
容器内 Trojan 配置调整为:
{
"local_port": 8443,
"remote_port": 8081
}
管理后台 systemd unit 调整为:
ExecStart=/usr/local/bin/trojan web --host 127.0.0.1 --port 8081
重载和启动命令:
docker exec trojan systemctl daemon-reload
docker exec trojan systemctl enable trojan-web
docker exec trojan systemctl restart trojan
docker exec trojan systemctl restart trojan-web
预期监听:Trojan 为 0.0.0.0:8443,管理后台为 127.0.0.1:8081。这两个端口不应对公网开放。
5. Nginx 统一入口
安装并启用:
apt-get update
apt-get install -y nginx libnginx-mod-stream
systemctl enable --now nginx
nginx -t
443 使用 stream 和 ssl_preread 按 SNI 分流。香港示例(美国替换为 www.us.chermack.top 与 git.us.chermack.top):
map $ssl_preread_server_name $tls_backend {
www.hk.chermack.top 127.0.0.1:8443;
git.hk.chermack.top 127.0.0.1:9443;
default 127.0.0.1:8443;
}
server {
listen 443;
proxy_pass $tls_backend;
ssl_preread on;
}
80 的 www.* 虚拟主机反向代理到 127.0.0.1:8081,并将 /.well-known/acme-challenge/ 转发到 127.0.0.1:8082;git.* 反向代理到 Caddy 127.0.0.1:8080。
每次配置改动后:
nginx -t && systemctl reload nginx
6. Gitea 与 Caddy
/opt/gitea 使用 Docker Compose 运行:
- Gitea
1.27.0:127.0.0.1:3000->3000,2222->22; - PostgreSQL
16:仅 Docker 内网; - Caddy:
127.0.0.1:8080->80、127.0.0.1:9443->443,反向代理到 Gitea。
cd /opt/gitea
docker compose up -d
docker compose ps
Caddy 管理 git.* 的 HTTPS 证书和自动续期;Nginx 对 Git 的 443 流量仅做 TLS 透传。Gitea 初始化时应填写:
ROOT_URL: https://git.<地区>.chermack.top/
SSH 域名: git.<地区>.chermack.top
SSH 端口: 2222
香港 Gitea 曾按授权清空数据并重新初始化;再次重置前必须先备份 /opt/gitea/gitea 和 /opt/gitea/postgres。
7. 美国服务器 SSH 端口处理
美国服务器原 OpenSSH 监听 22、2222、2223,与 Gitea Git SSH 的 2222 冲突。已保留宿主机 SSH 22,移除宿主机的 2222/2223 监听,并将 2222 留给 Gitea。
变更前备份:
/etc/ssh/sshd_config.pre-gitea-20260726-014417
安全操作:
sshd -t
systemctl reload ssh
ss -ltnp | grep sshd
修改 SSH 配置时必须保持一条现有的 22 端口会话,验证完成后再断开。
8. Trojan 证书续期
Trojan 的 www.* 证书由容器内 acme.sh 管理;Caddy 管理 git.* 和后续增加的 minio.*。2026-10-24 已修正续期:宿主机真实 systemd 调度,使用现有 8082 文件服务完成 webroot 验证。原 standalone 方案与该常驻服务冲突,已废弃。完整过程见第 16 节。
docker exec trojan /root/.acme.sh/acme.sh --issue \
--server letsencrypt --webroot /var/lib/trojan-acme-webroot \
-d www.hk.chermack.top --keylength ec-256
docker exec trojan systemctl restart trojan
美国服务器替换为 www.us.chermack.top。上面的 --issue 用于初次签发或迁移验证方式;常规检查使用宿主机 trojan-certificate-renew.service 调用 --renew --ecc --webroot,按 acme.sh 的续期时间执行,避免频繁强制签发。不要依赖容器内的 .timer 或未运行的 cron。
9. 重启后不可用:原因与永久修复
现象
香港服务器重启后,Nginx、Trojan 容器、Gitea、Caddy 都自动启动,但:
docker exec trojan systemctl is-active trojan # inactive
docker exec trojan systemctl is-active trojan-web # inactive
此时没有 8443 和 8081 监听,因此 www.hk.chermack.top 不可用。
临时恢复
docker exec trojan systemctl start trojan
docker exec trojan systemctl start trojan-web
ss -ltnp | grep -E ':(8443|8081)'
永久兜底
容器内 unit 虽为 enabled,但容器启动时没有拉起服务。因此在香港宿主机新增并启用:/etc/systemd/system/trojan-container-services.service。
[Unit]
Description=Start Trojan services inside the trojan container
Requires=docker.service
After=docker.service network-online.target
Wants=network-online.target
[Service]
Type=oneshot
ExecStart=/usr/bin/docker exec trojan /bin/systemctl start trojan.service
ExecStartPost=/usr/bin/docker exec trojan /bin/systemctl start trojan-web.service
RemainAfterExit=yes
[Install]
WantedBy=multi-user.target
启用并验证:
systemctl daemon-reload
systemctl enable trojan-container-services.service
systemctl start trojan-container-services.service
systemctl is-enabled trojan-container-services.service
systemctl is-active trojan-container-services.service
docker exec trojan systemctl is-active trojan trojan-web
本次已验证该兜底服务为 enabled、active;Trojan 和 trojan-web 均为 active,且外部 HTTPS 访问 https://www.hk.chermack.top/ 成功。
美国服务器也已部署同名的宿主机兜底 unit,并完成验证:trojan-container-services.service 为 enabled、active;Trojan 监听 0.0.0.0:8443,管理后台监听 127.0.0.1:8081;https://www.us.chermack.top/ 与 https://git.us.chermack.top/ 外部访问均成功。
10. 日常检查与故障排查
# 统一入口、监听与容器
nginx -t
ss -ltnp | grep -E ':(80|443|8080|8081|8443|9443|2222)'
docker ps
# Trojan 及后台
docker exec trojan systemctl is-active trojan
docker exec trojan systemctl is-active trojan-web
# Web 链路
curl -kI https://www.hk.chermack.top/
curl -kI https://git.hk.chermack.top/
curl -kI https://www.us.chermack.top/
curl -kI https://git.us.chermack.top/
www.* 不可访问时,先检查 trojan-web 和 8081;Trojan 客户端也异常时,再检查 trojan 和 8443:
docker exec trojan systemctl restart trojan
docker exec trojan systemctl restart trojan-web
docker exec trojan journalctl -u trojan -u trojan-web --no-pager -n 200
docker logs --tail 200 trojan
11. 美国服务器 Gitea 初始化记录
初始化页面曾提示数据库密码无效。服务器内核验结果如下:
gitea容器的GITEA__database__*与gitea-db容器的POSTGRES_*用户、数据库和密码完全一致;- 使用 Gitea 容器实际注入的密码连接 PostgreSQL 成功;
/data/gitea/conf/app.ini中落盘的密码也与 PostgreSQL 一致;- 初始化页面已预填密码,错误由浏览器密码管理器覆盖表单密码或提交了其他密码造成,不是数据库密码失效。
为避免表单再次覆盖,已通过 Gitea CLI 使用明确配置文件完成初始化:
gitea --work-path /data/gitea \
--config /data/gitea/conf/app.ini migrate
随后创建临时管理员 admin,具备管理员权限并设置为首次登录必须修改密码;INSTALL_LOCK 已设为 true。随机初始密码只保存在美国服务器:
/root/gitea-initial-admin.txt
文件权限为 0600 root:root。登录并修改密码后应删除该凭据文件。
初始化前备份目录:
/root/gitea-us-pre-init-20260726-041434
最终验证结果:数据库中存在一个管理员且 must_change_password=true,Gitea 日志无初始化错误,https://git.us.chermack.top/user/login 从服务器内外访问均成功。
12. 美国管理后台周期性退出的根因(2026-07-26)
故障现象:https://www.us.chermack.top/ 失效,Nginx 80/443 和 Trojan 8443 正常,但 trojan-web 为 failed,127.0.0.1:8081 无监听。
现场排查排除了磁盘耗尽、内存 OOM、Docker 容器重启、Nginx/Caddy 和本次 ACME 定时任务。关键证据:
宿主机 cgroup:cgroup2fs
容器基础系统:CentOS 7 / systemd 219
容器 systemctl:systemctl.py 1.5.7113(Python 替代实现)
容器启动日志:Failed to allocate manager object, freezing
容器内状态:多个 trojan/web 僵尸进程,无 journal 日志
当前镜像的 PID 1 systemd 无法在宿主机 cgroup v2 环境中正常建立 manager;/usr/bin/systemctl 实际是一次性 Python 替代脚本,不是持续运行的服务管理器。因此 unit 中的 Restart=on-failure 不能可靠监督进程。宿主机现有 trojan-container-services.service 也是 Type=oneshot,只在开机时执行一次启动,运行中 Web 退出后不会再次拉起。
以前台方式直接运行以下命令持续 15 秒无异常,证明 Go Web 程序、数据库和 8081 端口本身健康:
docker exec trojan /usr/local/bin/trojan web \
--host 127.0.0.1 --port 8081
探针启动的进程随后继续运行,8081、本地 /auth/check 和公网 HTTPS 均恢复 200;但替代 systemctl 仍错误显示 failed,再次证明问题位于服务管理层。
临时永久化建议:由宿主机真实 systemd 使用前台 docker exec 直接监督 trojan-web(以及 Trojan core),设置 Restart=always 并将 stdout/stderr 写入宿主机 journal。最终解决方案是使用已规划的新镜像,移除 CentOS 7、冻结的容器 systemd 和运行时下载的 systemctl.py。
13. 后续维护事项
- 两台服务器的
trojan-mariadb仍将3306映射到公网;为避免额外中断,迁移中未改动。确认无外部依赖后,应限制为127.0.0.1:3306或移除映射。 www.*与git.*使用不同的证书管理者:前者为 Trojan 容器内 acme.sh,后者为 Caddy。- 两台服务器均已部署
trojan-container-services.service。重启服务器后,优先检查该服务及容器内两个 Trojan 服务状态。
16. 香港证书过期恢复与两节点自动续期修复(2026-10-24)
本节时间除标注 UTC 外均为北京时间。操作范围为香港 43.154.35.111 和美国 43.159.139.193 的 Trojan 证书与调度;未调整用户、数据库、业务域名、端口或代理分流架构。
16.1 现场证据与原因
香港 www.hk.chermack.top 旧证书于 2026-10-23 23:56:30 到期。美国 www.us.chermack.top 旧证书原定 2026-10-24 04:45:53 到期,检查时尚有约三小时,因此同批提前恢复。两台的源证书和运行中证书均仍为 7 月签发;acme.sh 记录的续期时间分别为 9 月 22 日和 9 月 24 日,未成功执行。
两节点问题相同:
trojan-manager-compat:2.0.3-hk/us使用systemctl.py,PID 1 实际为tail,容器内没有真实 systemd 定时调度。trojan-acme-renew.timer虽 enabled,但状态为 dead;旧 acme.sh crontab 存在,cron 守护进程未运行。- 域名配置仍是
Le_Webroot='no'的 standalone 验证。8082 已由trojan acme-http常驻服务监听,不能再启动 standalone 监听同一端口。 - 旧脚本用
openssl rsa -modulus校验 ECC 私钥,并将证书复制到/etc/trojan/certs/;实际 Trojan 配置直接读取/root/.acme.sh/<域名>_ecc/fullchain.cer和对应私钥。
Git 与 MinIO 的 Caddy 续期正常,检查时证书已更新至 12 月到期。本次不调整 Caddy。
16.2 备份与紧急恢复
操作前以 root 专用目录(0700)备份完整 ACME 状态、原 Trojan 配置及旧维护脚本:
香港:/opt/trojan/backups/certificate-renewal-20261023T175520Z
美国:/opt/trojan/backups/certificate-renewal-20261023T175606Z
acme-before.tar.gz # 包含账户与私钥,不得上传到 Git 或公开分享
config-before.json
renew-before
compat-init-before
crontab-before.txt
确认 Nginx 的 /.well-known/acme-challenge/ 指向 127.0.0.1:8082,并在 /var/lib/trojan-acme-webroot/.well-known/acme-challenge/ 写入临时验证文件,经域名 HTTP 访问成功;测试文件已删除。
随后分别执行(美国替换域名):
docker exec trojan /root/.acme.sh/acme.sh --issue \
--home /root/.acme.sh --server letsencrypt \
-d www.hk.chermack.top \
--webroot /var/lib/trojan-acme-webroot --keylength ec-256
docker exec trojan systemctl restart trojan
两次 HTTP-01 验证与签发均成功,配置已保存 Le_Webroot='/var/lib/trojan-acme-webroot'。仅重启 Trojan 核心加载证书,现有连接可能短暂重连;没有重启整个 Docker 容器、管理后台或数据库。
| 节点 | 新证书到期时间(北京时间) | 新证书序列号 |
|---|---|---|
| 香港 | 2027-01-22 00:57:01 | 051911FACC1E378D646BE88B9CDD34A1F19E |
| 美国 | 2027-01-22 00:57:47 | 06ECC2E3EBF581485D09EE5BEFB941C1FF72 |
16.3 自动续期的持久化部署
仓库新增文件及宿主机安装位置:
仓库文件(trojan-stack/scripts/ 下) |
两台宿主机安装位置 |
|---|---|
renew-certificate-host.py |
/usr/local/sbin/renew-trojan-certificate-host.py |
trojan-certificate-renew.service |
/etc/systemd/system/trojan-certificate-renew.service |
trojan-certificate-renew.timer |
/etc/systemd/system/trojan-certificate-renew.timer |
部署副本保留在 /opt/trojan/renewal-tools/。依赖宿主机已有的 Python 3、OpenSSL、Docker CLI 和真实 systemd,没有增加容器或替换镜像。
脚本从容器绑定目录映射和实际 config.json 读取域名、证书路径及 TLS 端口;文件锁防止并发,单次最长受 service 的 20 分钟超时约束。检查流程为:
- 读取正在运行的 TLS 证书指纹,启动/确认现有 ACME 文件服务。
- 执行
acme.sh --renew --ecc --webroot /var/lib/trojan-acme-webroot;未到续期时间的返回码 2 按正常跳过处理。 - 检查证书至少还有七天有效期、域名和证书/私钥公钥匹配,兼容 ECC 校验。
- 若需要部署,写入配置实际引用的持久化路径;私钥权限设为 0600。
- 运行中证书与源文件指纹不同时才重启核心,并验证实际 TLS 信任链、域名与指纹;失败返回非零,写入 journal。
定时器在宿主机时区每日 03:00、15:00 加 0–30 分钟随机延迟检查;开机五分钟后也检查,并通过 Persistent=true 补执行错过的日历任务。两台当前宿主机时区均为 CST(UTC+8)。启用命令:
systemd-analyze verify /etc/systemd/system/trojan-certificate-renew.service \
/etc/systemd/system/trojan-certificate-renew.timer
systemctl daemon-reload
systemctl enable --now trojan-certificate-renew.timer
systemctl start trojan-certificate-renew.service
已禁用旧容器 timer,并备份后移除旧 acme.sh cron 行,保留其他 cron 内容。systemctl.py 不支持停止 timer,但它原本没有活动调度进程;已确认旧 timer 为 disabled。仓库和运行容器中的 compat-init 已去掉对旧 timer 的启用,旧 renew-trojan-certificate 维护脚本也已修正为 webroot、通用公钥匹配和实际配置路径。
宿主机单元不随容器重启消失;将来重建容器仍需保留现有 bind mount、8082 ACME 服务和 Nginx 验证路由,并使用包含修正脚本的新镜像或重新同步维护脚本。现有镜像标签未重新构建。
16.4 验证结果与运维
- 两机真实宿主机 timer 均为
enabled、active (waiting);service 首次执行均为Result=success、ExecMainStatus=0。 - 实际签发完成后再次由 service 检查,均正常跳过未到期续签,TLS 指纹检查成功,没有重复重启核心。
- 本机经公网访问两个
www.*:均 HTTP 200、TLS 校验为 0;服务器经 Nginx 443/SNI 路由回归检查也均通过。 - 两个 Git 域名均为 HTTP 200;MinIO 匿名 S3 根路径为预期 403、TLS 校验为 0;相关容器仍健康。
- 验证覆盖 HTTP-01 真正签发、实际证书加载、调度执行及 HTTPS 路由;未使用用户代理凭据进行完整 Trojan 隧道流量测试,未为验证而重启整台服务器。
日常检查:
systemctl list-timers --all trojan-certificate-renew.timer
systemctl show trojan-certificate-renew.service -p Result -p ExecMainStatus
journalctl -u trojan-certificate-renew.service --since '7 days ago' --no-pager
systemctl start trojan-certificate-renew.service
# 美国将域名替换为 www.us.chermack.top
openssl s_client -connect 127.0.0.1:443 -servername www.hk.chermack.top \
</dev/null 2>/dev/null | openssl x509 -noout -dates -serial
当前已提供失败退出状态和持久日志,尚未配置邮件或聊天通知。acme.sh 当前下次续期计划为香港 2026-12-21T17:55:35Z、美国 2026-12-23T07:28:12Z,之后由各自 ACME 客户端按 CA 建议更新。
16.5 回滚与故障恢复
若新调度脚本出现问题,先暂停宿主机 timer,保留已经恢复的新证书:
systemctl disable --now trojan-certificate-renew.timer
journalctl -u trojan-certificate-renew.service -n 100 --no-pager
修正脚本后重新安装并执行 systemctl start trojan-certificate-renew.service,验证成功再 systemctl enable --now trojan-certificate-renew.timer。暂停期间没有自动续期,应及时恢复。
原脚本、cron、配置和 ACME 状态均可在上述备份目录取回;不要直接恢复旧 ACME 压缩包中的过期证书到生产路径。恢复旧配置前应先核对证书路径和有效期。本次业务配置与数据未改变,不需要回滚数据库、Nginx 或 Caddy。