Files
pangolin/deploy
wangjia ff9a40277d feat(deploy/bootstrap): 节点幂等初始化脚本(加固+pangolin用户+监控+防火墙)
全新 Debian 12 一键初始化,后续新机复用。四块:
- 系统:apt 升级+基础包(含 python3-systemd)、时区、swap 补足、sysctl(BBR/fq/句柄/队列)
- Pangolin:建 pangolin 非特权系统用户(/var/lib/pangolin, nologin)
- 网络安全:ufw 默认拒入站、放行 SSH+443(tcp/udp);fail2ban sshd jail
  (精简 Debian 无 rsyslog/auth.log → backend=systemd 读 journald)
- SSH 加固:root 仅密钥、可选禁密码(仅当已有 authorized_keys 时生效,防锁死)
- 监控:pangolin-monitor(systemd timer,CPU/内存/磁盘/进程/出网 → Telegram,
  异常+心跳);deadman-watch(EC2 侧主动探活,补"宕机/不上报"告警)

已在 racknerd(107.172.55.251)实跑验证全部步骤通过。密钥/真实配置 gitignore。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-18 01:30:55 +08:00
..

Pangolin 部署(方案 C:分发层容器化)

把流量分发层(nginx)迁入 Docker,新增 Hysteria2,经 Gitea Actions 自动部署。 与现网 marzban/jiu/billing/blog 并存。设计见 ../docs/技术方案.md 与 计划 ~/.claude/plans/ci-cd-1-shimmering-panda.md

容器一览(部署后)

容器 用途 端口/网络
pangolin-edge(nginx) 分发层,接管 80/443,移植现网全部路由 host 网络
pangolin-singbox Hysteria2 加速线 host 网络,443/udp
pangolin-backup 数据库备份:xtrabackup+pg_dumpage 加密,S3 异地 host 网络
pangolin-certbot DNS-01(Cloudflare)证书续期,按需运行 无端口
pangolin-xray(本台不启用) REALITY,留给新节点 profile newnode

现网保留不动:marzban(线上 REALITY+面板)、jiu_mysqlblog-*,宿主 jiu.service/billing.service

部署目录

~/pangolin(即 /home/ec2-user/pangolin,ec2-user 所有,免 root)。

自动部署

push deploy/** → NAS runner → ssh ec2rsync deploy/ → ~/pangolin/deploy.sh(免 root,幂等)。 deploy.sh 总会拉起 singbox;edge 仅在宿主 nginx 已停时才启动(否则只校验配置)。

Gitea Secrets(仓库 Settings→Actions→Secrets)

EC2_SSH_KEYEC2_HOST=18.136.60.128EC2_USER=ec2-userCF_API_TOKEN。 并把 .gitea/workflows/deploy.ymlruns-on 改成你 runner 的 label。

一次性切换(nginx 宿主 → 容器,需 root 一次)

空闲时段执行(代理会秒级重连,Shadowrocket 自动恢复):

sudo bash /home/ec2-user/pangolin/scripts/cutover.sh

失败秒级回滚:

docker-compose -p pangolin stop edge && sudo systemctl start nginx

证书续期(自动,无需宿主 cron)

pangolin-edge 是自定义镜像(官方 nginx + certbot),容器内每 12h 自动 certbot renew(DNS-01/Cloudflare),续期后在本容器内 nginx -s reload。见 edge/pangolin-entrypoint.sh。无需宿主 cron、无需 docker socket。

# 手动验证续期可用(staging,不动正式证书)
docker exec pangolin-edge certbot renew --dry-run
# 首次签发/重配(仅手动,用独立 certbot 服务)
docker-compose -p pangolin run --rm certbot certonly --dns-cloudflare \
  --dns-cloudflare-credentials /etc/cloudflare.ini -d <域名> --cert-name <域名>

证书文件在 /etc/letsencrypt(rw 挂载进 edge);CF 凭据 secrets/cloudflare.ini 挂到 /etc/cloudflare.ini

取客户端导入串(Hy2,含口令)

ssh ec2 'cat ~/pangolin/secrets/clients.txt'

备份与灾备(RPO ≤ 15min / RTO ≤ 4h)

docs/备份与灾备.md 完整说明。快速命令:

# 初始化备份配置(首次)
cp backup/backup.env.example secrets/backup.env && vim secrets/backup.env
docker build -t pangolin-backup:local ./backup
docker-compose -p pangolin up -d backup

# 查看实时 RPO/RTO 状态
docker exec pangolin-backup /scripts/verify-rpo-rto.sh

# 手动触发全量备份
docker exec pangolin-backup bash -c '. /etc/backup-env.sh && /scripts/backup-full.sh'

# 月度 DR 演练(含私钥时解密验证)
docker exec pangolin-backup bash -c '. /etc/backup-env.sh && /scripts/dr-drill.sh'