# 节点导入指引

节点部署管理已迁入本仓库的 `edge-nodes/`，真实配置与交付产物位于 Git 忽略的 `edge-nodes/private/`。Proxy Station 应用运行时不自动读取该目录，节点仍通过 Web 界面批量粘贴分享链接导入。工作区说明见 [edge-nodes/README.md](../edge-nodes/README.md)。

最新登记、启用与订阅范围见 [当前生产状态](CURRENT-STATE.md)。已有库导入新节点前先读当前节点并预览，避免把整份交付清单重复导入；部署脚本、分享链接存在或重新生成交付页都不表示该节点应被启用。

## 从本仓库私有交付文档导入

每个节点目录 `edge-nodes/private/<id>-edge-node-docs/` 已生成好分享链接；以当前部署的 `scripts/node-links/` 为准，避免同时混入旧交付链接与重复副本。RN 当前使用 `rn2-edge-node-docs/`，旧 `rn-edge-node-docs/` 只作历史记录。

- `<proto>-<egress>.link`——VMess／Trojan／Shadowsocks 的分享链接文件（`vmess://`、`trojan://`、`ss://`）；当前生成器会生成本系统可解析的 Xray 风格 SS over WS 链接
- 旧交付若只有 Shadowsocks sing-box JSON（`ss-*-singbox.json`），用其中参数手动添加，或按 SIP002 + v2ray-plugin 格式自拼：
  `ss://base64url(chacha20-poly1305:密码)@域名:443?plugin=v2ray-plugin%3Btls%3Bmode%3Dwebsocket%3Bhost%3D域名%3Bpath%3D%2F路径#名称`
- Hysteria2 线路在 `scripts/node-links/` 下有 `hy2://` 或 `hysteria2://` 链接（含 `obfs=salamander&obfs-password=…`），两种 scheme 均可解析

操作：

1. 在仓库根目录收集当前舰队支持的链接（输出含凭据，只在本机使用）：

   ```bash
   for site in sg la rn2 jp; do
     for proto in vmess trojan ss hy2; do
       for egress in direct warp; do
         link="edge-nodes/private/$site-edge-node-docs/scripts/node-links/$proto-$egress.link"
         [ ! -f "$link" ] || cat "$link"
       done
     done
   done
   ```

   也可从 `edge-nodes/private/边缘节点交付文档.html` 挑选对应线路。
2. 打开 proxy-station「节点」页 →「批量导入」→ 粘贴（每行一条）→「解析预览」确认字段 →「导入」
3. TUIC／SOCKS5 线路不属于本系统当前支持的类型，单独使用，不导入。线上数据任务按 `update-db` 技能先备份再走管理 API

## 命名建议（影响地区组归类）

模板的地区策略组按**节点名正则**筛选（如 `坡|🇸🇬|新加坡|狮城|SG|Singapore`、`美|🇺🇸|美国|US`）。命名时带上地区词与出口词，例如：

- `🇸🇬 SG VMess Direct`、`🇸🇬 SG Trojan Warp`（命中 Singapore 组）
- `🇯🇵 JP VMess Direct`（命中 Japan 组）
- `🇺🇸 US LA Trojan Direct`、`🇺🇸 US RN VMess Warp`（命中 United States 组；只写 LA／RN 不会命中地区正则，当前也没有 Other 兜底组）

名称含 `direct`／`warp` 会自动打出口标签，线路矩阵按此归位（琥珀 = 直连，青 = WARP）。

保留完整出口词；客户端没有 Web 的出口标签。新节点 sortOrder 保持默认 0，All Nodes／🧠 AI Nodes 从同一来源按完整名称升序收纳。名字决定地区正则，region 填站点码用于 Web 分段，详见 [新增地区](ADDING-REGIONS.md)。

## 导入后核对

- 「节点」页线路矩阵：每个站点的协议 × 出口格子是否齐全
- 「策略组」页：地区组的「命中」行是否圈中了预期节点
- 「订阅」页预览：Surge 端确认 SS over WS 节点已被自动屏蔽（预期行为，Surge 不支持该组合）
- 保留已有停用状态；当前 RN、SS、HY2 的停用记录不通过导入或整理清单恢复。明确授权启用后再分别核对各端节点范围、UDP 能力、动态组引用与实际连接。
- 生产写入前在线备份，完成后 API 重读及真实 HTTPS 订阅校验，按 [Surge 变更验证](SURGE-CHANGES.md)执行；解析／导入成功不能代替设备连接验证。