dpl/docs/maintenance/NODE_ONBOARDING.md

46 lines
4.9 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.

# 节点与订阅网关接入
核对日期:2026-10-11。当前仅完成只读调查和方案草案;未部署节点、修改中转规则、DNS 或现有网关。凭据仅从 CoDocs 受保护连接资料获取,不写入本文。
## 已核实基线
- gateway-01 运行 SubSieve。宿主机 Nginx 接公网 80/443;subscribe-gateway 映射到本机 8080/8443;subscribe-admin 使用 64444。两个容器共享 sgw_gw_config、sgw_gw_logs。
- 现有设置接口使用单个 upstream_url、upstream_host、subscribe_path,并生成保护配置;没有在检查的接口与界面中发现多机场列表。不得把原上游改成 dpl。
- 网关主机约 1GB 内存,现场可用约 448MB、磁盘余量约 13GB。同机第二套实例具备部署条件,但需限制资源并检查实际负载;共享主机仍有共同故障风险。
- node-us01 的 XrayR 服务 active,占用 TCP 443。新节点使用独立服务、配置和空闲端口;禁止升级、重启或替换原 XrayR。
- 中转后台现有 23 条规则;原 us01 是 haiwi.lshan.eu.org:46101 → node-us01:443,开启。只能新增 dpl 专用规则,原规则保留。
- Namecheap 中 deeplink-subscribe.com 使用 BasicDNS;现场 Cloudflare 账户的完整 10 域名列表没有该域名。
- 本地面板代码包含 AnyTLS 和 VLESS/REALITY 配置与多种订阅生成。线上版本及节点后端能力须独立核验,不能据此宣布已兼容。
## 首节点拟定方案
订阅:客户端 → c2.deeplink-subscribe.com(Cloudflare HTTPS 代理)→ gateway-01 的新增域名站点 → dpl 专用 SubSieve 实例 → dpl 订阅接口。
流量:客户端 → 新增中转入口/端口 → node-us01 的 dpl 独立节点服务 → 目标网络。订阅网关不承载这条流量链路。
用户已确认首个节点采用 AnyTLS,显示名为“🇺🇸 美国 US - 01”。选择前核对面板 API、动态用户下发、计费与流量上报、节点后端版本以及实际客户端支持。AnyTLS 使用 us01.deeplink-subscribe.com 的有效证书与严格校验,客户端连接中转入口,SNI 保持该证书域名。普通 Cloudflare 橙云只用于 HTTPS 订阅,不直接代理这两种原生节点协议。
同机第二网关使用独立 Compose 项目、容器名称、卷、管理凭据和本机端口;绝不复用原 sgw 卷。不运行原项目 setup/update/down。宿主 Nginx 新增专用 server_name;检查通过后仅平滑重载,前后回归旧订阅。新实例内部端口待复核后分配,管理入口不直接开放公网。
域名在 Cloudflare 添加 zone,迁移必要现有记录,获取实际分配的 NS 后再修改 Namecheap。c2 指向网关并开启代理;源站使用有效证书与 Full (strict)。订阅路径绕过缓存、禁止交互式挑战;不能共享缓存带用户 token 的响应。开启代理可能改善入口路径,但不能保证所有地区可达,也不能据此认定历史故障原因。
## 每次新增节点流程
1. 明确机场、服务器、协议、套餐组、节点 ID、监听端口、中转入口和倍率;显示名称使用“🇺🇸 美国 US - 01”格式;服务、机器和中转规则使用 dpl 前缀。
2. 经白色机只读检查服务、TCP/UDP 端口、防火墙、资源与原机场节点基线。记录检查时间,不能复用过期的空闲端口判断。
3. 备份受影响配置和原状态到服务器受保护目录;确定只新增资源的清单及回滚操作。
4. 核对后端官方版本与面板 API 兼容性,生成独立服务配置;私钥/API 密钥只存受保护文件。脚本与非敏感模板按 Git 提交、推送、明确版本发布。
5. 新增面板节点但暂不对普通用户展示;部署独立节点服务,只操作该服务。检查语法、启动、端口和日志,不能只看 HTTP 200。
6. 在中转后台新增专用规则到新监听端口;核对规则名、入口和目标后保存,不编辑原规则。
7. 使用隔离测试用户检查订阅格式、导入、通过中转联网、出口 IP、DNS、流量上报、权限与超额限制;前后复核原机场服务。未做真实客户端测试时明确标记待验收。
8. 验收通过才展示新节点,更新本文节点登记及 STATUS;分别记录配置、测试、Git 发布和真实验收结果。
9. 回滚只停用本次新增节点/规则、停止新服务并撤回新域名配置;保留审计记录。不停止旧容器,不恢复整库覆盖后续业务。
## 节点登记
| 机场 | 节点 | 协议 | 落地端口 | 中转入口 | 面板 ID | 状态 |
| --- | --- | --- | --- | --- | --- | --- |
| dpl | 🇺🇸 美国 US - 01 / node-us01 | AnyTLS | 24443(待部署) | 拟新增47101,保留原46101 | 待创建 | 方案已授权,实施中 |
网关双实例、节点后端兼容性与真实联调均未验收。后续按实际结果补充可复用模板,不把方案草案当作可直接执行的部署脚本。