Files
trojanZ/迁移实施记录-2026-07-26.md
T

439 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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. 最终架构
```mermaid
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. 迁移前备份与检查
在变更前检查原容器和配置:
```bash
docker ps
docker inspect trojan
docker exec trojan cat /usr/local/etc/trojan/config.json
docker exec trojan systemctl cat trojan-web.service
```
已创建的备份目录:
```text
/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 配置调整为:
```json
{
"local_port": 8443,
"remote_port": 8081
}
```
管理后台 systemd unit 调整为:
```ini
ExecStart=/usr/local/bin/trojan web --host 127.0.0.1 --port 8081
```
重载和启动命令:
```bash
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 统一入口
安装并启用:
```bash
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`):
```nginx
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`。
每次配置改动后:
```bash
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。
```bash
cd /opt/gitea
docker compose up -d
docker compose ps
```
Caddy 管理 `git.*` 的 HTTPS 证书和自动续期;Nginx 对 Git 的 443 流量仅做 TLS 透传。Gitea 初始化时应填写:
```text
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。
变更前备份:
```text
/etc/ssh/sshd_config.pre-gitea-20260726-014417
```
安全操作:
```bash
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 节。
```bash
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 都自动启动,但:
```bash
docker exec trojan systemctl is-active trojan # inactive
docker exec trojan systemctl is-active trojan-web # inactive
```
此时没有 `8443` 和 `8081` 监听,因此 `www.hk.chermack.top` 不可用。
### 临时恢复
```bash
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`。
```ini
[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
```
启用并验证:
```bash
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. 日常检查与故障排查
```bash
# 统一入口、监听与容器
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`:
```bash
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 使用明确配置文件完成初始化:
```bash
gitea --work-path /data/gitea \
--config /data/gitea/conf/app.ini migrate
```
随后创建临时管理员 `admin`,具备管理员权限并设置为首次登录必须修改密码;`INSTALL_LOCK` 已设为 `true`。随机初始密码只保存在美国服务器:
```text
/root/gitea-initial-admin.txt
```
文件权限为 `0600 root:root`。登录并修改密码后应删除该凭据文件。
初始化前备份目录:
```text
/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 定时任务。关键证据:
```text
宿主机 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 端口本身健康:
```bash
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. 后续维护事项
1. 两台服务器的 `trojan-mariadb` 仍将 `3306` 映射到公网;为避免额外中断,迁移中未改动。确认无外部依赖后,应限制为 `127.0.0.1:3306` 或移除映射。
2. `www.*` 与 `git.*` 使用不同的证书管理者:前者为 Trojan 容器内 acme.sh,后者为 Caddy。
3. 两台服务器均已部署 `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 日,未成功执行。
两节点问题相同:
1. `trojan-manager-compat:2.0.3-hk/us` 使用 `systemctl.py`,PID 1 实际为 `tail`,容器内没有真实 systemd 定时调度。`trojan-acme-renew.timer` 虽 enabled,但状态为 dead;旧 acme.sh crontab 存在,cron 守护进程未运行。
2. 域名配置仍是 `Le_Webroot='no'` 的 standalone 验证。8082 已由 `trojan acme-http` 常驻服务监听,不能再启动 standalone 监听同一端口。
3. 旧脚本用 `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 配置及旧维护脚本:
```text
香港:/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 访问成功;测试文件已删除。
随后分别执行(美国替换域名):
```bash
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 分钟超时约束。检查流程为:
1. 读取正在运行的 TLS 证书指纹,启动/确认现有 ACME 文件服务。
2. 执行 `acme.sh --renew --ecc --webroot /var/lib/trojan-acme-webroot`;未到续期时间的返回码 2 按正常跳过处理。
3. 检查证书至少还有七天有效期、域名和证书/私钥公钥匹配,兼容 ECC 校验。
4. 若需要部署,写入配置实际引用的持久化路径;私钥权限设为 0600。
5. 运行中证书与源文件指纹不同时才重启核心,并验证实际 TLS 信任链、域名与指纹;失败返回非零,写入 journal。
定时器在**宿主机时区**每日 03:00、15:00 加 0–30 分钟随机延迟检查;开机五分钟后也检查,并通过 `Persistent=true` 补执行错过的日历任务。两台当前宿主机时区均为 CST(UTC+8)。启用命令:
```bash
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 隧道流量测试,未为验证而重启整台服务器。
日常检查:
```bash
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,保留已经恢复的新证书:
```bash
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。