eric/proxy-station
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add telegram rules

Browse Source
This commit is contained in:
YANG JIANKUAN
2026-10-12 00:11:46 -07:00
parent 4c16575578 812d8a9441
commit f741aeeccd
107 changed files with 7627 additions and 384 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
docs/ADDING-REGIONS.md
View File

@@ -4,12 +4,16 @@
> 背景：策略组的地区筛选靠**节点名称正则**，不靠节点的 `region` 字段。所以节点命名是一切的前提。
## 当前状态（2026-09-14）
## 当前状态（2026-10-04）
节点登记／启用数量、完整策略组矩阵和服务规则归属集中见 [当前生产状态](CURRENT-STATE.md)。下面维护地区命名与扩展方法；新增站点不自动启用已有停用线路。
有美国、新加坡、日本三个地区的节点，策略组里对应 `🇺🇸 United States`、`🇸🇬 Singapore`、`🇯🇵 Japan` 三个地区组。
日本组于 2026-09-14 随 jp 站点（VMISS 东京，八条线路）按本文步骤重建，站点码 `JP`，已加入所有成员里含美国或新加坡的服务组（Proxy／Automatic／Streaming／Apple／AI／Bybit／Global Services）。约定：**凡是成员含美国或新加坡的组，都应同时含日本**；Speedtest／NoAuto 只含大陆与 Automatic，不在此列。
日本组于 2026-09-14 随 jp 站点（VMISS 东京，八条线路）按本文步骤重建，站点码 `JP`，当前加入的服务组为 Proxy／Automatic／Streaming／AI／Bybit。约定：**凡是成员含美国或新加坡的组，都应同时含日本**；NoAuto 当前只含大陆，不在此列。Speedtest 组及其专用规则已删除。
2026-10-04 已删除线上 Apple／Global Services 组及指向它们的专用规则，并删除 AI 的 Bing 规则；不再给这两个已删除的服务组添加地区。同日进一步将所有原先直接指向 Automatic 的 20 条规则改为 Proxy，包括 `global`／`global_plus`、CDN 及 Facebook 等；x.com／bing.com 当前自然匹配 `global` → Proxy，由用户在 Proxy 中选择出口。Automatic 改为 `url-test`，仅 Proxy 保留其成员引用；AI／Speedtest／NoAuto 已移除 Automatic。具体约束与验证见 [Proxy 与 Automatic 选择链](PROXY-AUTOMATIC-2026-10-04.md)。App Store DIRECT、Apple News 美国及 Apple Relay AI 例外继续保留。原始初始化模板仍有旧组和旧引用；已有生产数据以管理 API 为准，不通过规则 reset 恢复旧分流。
香港、台湾、英国、韩国的地区组**仍处于删除状态**——留着会是空组，在客户端里显示为无可用节点。
兜底的 `🌍 Other` 组也已删除：所有节点都能被现有三个地区组收纳，它恒为空。
当前组显示顺序为 Proxy、Automatic、All Nodes、美国、新加坡、日本、AI、🧠 AI Nodes、Streaming、Bybit、Mainland、NoAuto。🧠 AI Nodes 为独立收纳全部节点的 select 组，紧接 AI；其选择与 All Nodes 独立保存，见 [AI Nodes](AI-NODES-2026-10-04.md)。两组的节点按完整名称字符串升序输出；当前节点 sortOrder 统一为默认 0，新增节点保持默认值即可沿用名称排序。组显示顺序不决定分流优先级；实际规则保留协议防护与 Unbreak 例外在前，启用的 AI 规则集中置于广告及普通分流之前，见 [AI 与广告优先级](AI-PRIORITY-2026-10-04.md)。
## 一、给新节点命名（决定它能被哪个组收纳）
@@ -57,7 +61,7 @@ const STATION_LABELS: Record<string, string> = {
| 间隔 | `300` |
| 容差 | `50` |
「收纳全部节点」+「筛选正则」的组合会生成 `include-all-proxies=true, policy-regex-filter=…`（Surge）、`include-all-proxies: true, filter: …`（Clash）、`use=true, policy-regex-filter=…`（ShadowRocket），三端都是**动态筛选**——之后再加同地区节点会自动进组，不用改配置。
「收纳全部节点」+「筛选正则」的组合会生成 `include-all-proxies=true, policy-regex-filter=…`（Surge）、`include-all-proxies: true, filter: …`（Clash）、`policy-regex-filter=…`（ShadowRocket），三端都是**动态筛选**——之后再加同地区节点会自动进组，不用改配置。ShadowRocket 不使用 `use=true`，其正则从 App 内全部节点筛选。
各地区的正则（取自原模板，可直接复制）：
@@ -73,9 +77,9 @@ const STATION_LABELS: Record<string, string> = {
## 四、兜底组 `🌍 Other`（当前不存在）
原模板有一个 `🌍 Other` 组，用否定前瞻正则收纳「不属于任何已建地区组」的节点。**当前已删除**，因为现有节点都能被美/新两个组收纳，它恒为空。
原模板有一个 `🌍 Other` 组，用否定前瞻正则收纳「不属于任何已建地区组」的节点。**当前已删除**，因为现有节点都能被美/新/日三个组收纳，它恒为空。
只有当你加入的节点**不属于任何已建地区组**（比如加了德国节点但没建德国组）时，才需要重建它：
加入尚无地区组的节点时，优先按本文新建对应地区组。若确需恢复 Other，以下仅是历史模板示例，必须先核对目标客户端的正则能力与实际产物：
| 字段 | 值 |
|---|---|
@@ -87,6 +91,8 @@ const STATION_LABELS: Record<string, string> = {
^((?!港|🇭🇰|香港|HK|Hong|日|🇯🇵|日本|JP|Japan|坡|🇸🇬|新加坡|狮城|SG|Singapore|美|🇺🇸|美国|US|States|American|Remain|Expired|官网|如需|套餐|去除|剩余|距离|Reset|重置|流量).)+$
```
否定前瞻不能视为三个客户端都支持的正则；本系统会把 filterRegex 透传给 Clash 的 filter，不自动改写成等价的排除条件。当前简单地区正则的验证结果不覆盖这个历史示例，跨端恢复需先验证，必要时调整数据模型与生成器。
**如果重建了 Other，每次新增地区组都必须往这个否定前瞻里追加对应关键字**，否则新地区节点会同时出现在自己的组和 Other 里。
## 五、把新地区加进服务组的可选项
@@ -95,36 +101,33 @@ const STATION_LABELS: Record<string, string> = {
| 组 | 当前成员 | 建议 |
|---|---|---|
| `⚡️ Automatic` | SG、US | 加入所有地区组 |
| `🚀 Proxy` | Automatic、SG、US | 加入所有地区组 |
| `🎬 Streaming` | SG、US | 加入解锁能力强的地区（HK/TW/JP） |
| `🤖 AI` | Automatic、US、SG | 加入 JP、US 等 AI 服务可用地区 |
| `🌐 Global Services` | Automatic、US、SG | 同 AI |
| `🍎 Apple` | Mainland、US、JP | 按需加入 HK |
| `⚡️ Automatic`（url-test） | SG、US、JP | 加入所有地区组；仅由 Proxy 引用，不让规则直接指向它 |
| `🚀 Proxy` | Automatic、All Nodes、SG、US、JP | 加入所有地区组 |
| `🎬 Streaming` | SG、US、JP | 加入解锁能力强的地区（HK/TW/JP） |
| `🤖 AI` | US、SG、JP、🧠 AI Nodes | 加入 AI 服务可用地区；不加入 Automatic |
| `🧠 AI Nodes`（select） | 全部节点 | 保持 includeAllNodes，与 All Nodes 独立选择；新增节点自动进入，sortOrder 保持默认 0 |
| `🪙 Bybit` | DIRECT、SG、US、JP | 同 Proxy |
| `🎯 NoAuto` | Mainland | 不加入 Automatic |
成员的顺序就是客户端里的排列顺序，**第一个成员是该组的默认选中项**。
成员的顺序就是客户端里的排列顺序。对于 `select` 组，客户端没有有效的已保存选择时，**第一个成员是默认选中项**；Automatic 为 `url-test`，按测速结果与容差选择成员。
## 六、地区流媒体解锁规则（可选）
模板原有 `stream_hk`、`stream_jp`、`stream_tw`、`stream_kr`、`stream_eu` 等按地区解锁的规则集。删除地区组时，这些规则被改指向了 `🎬 Streaming`。
模板原有按地区解锁的规则集。当前 `stream_us` 的域名／IP 两条已指向美国，`stream_jp` 的两条已指向日本；`stream_hk`、`stream_tw`、`stream_kr`、`stream_eu` 的八条规则仍指向 `🎬 Streaming`，相关地区组当前不存在。
如果新建了对应地区组，可以在「规则」页把这些规则的策略改回该地区组，解锁效果更精准：
| 规则集 | 建议策略 |
|---|---|
| `stream_hk`（non_ip + ip 两条） | `🇭🇰 Hong Kong` |
| `stream_jp`（两条） | `🇯🇵 Japan` |
| `stream_jp`（两条） | `🇯🇵 Japan`，当前已应用 |
| `stream_tw`、`stream_kr`、`stream_eu` | 对应地区组 |
## 七、验证
1. 「策略组」页：新地区组的**命中**一栏应列出该地区的所有节点
2. 「节点」页：新站点应有独立分段，标题显示国旗
3. 命令行校验 Clash 产物：
```bash
curl -s "http://<host>/sub/<token>/clash" > /tmp/c.yaml && mihomo -t -f /tmp/c.yaml
```
3. 从真实 HTTPS 订阅入口获取各端产物，先确认下载成功及配置结构，再按 [订阅变更与验证](SURGE-CHANGES.md)运行 Surge CLI／规则集快照与独立目录的 `mihomo -t`；结构通过后仍需客户端连接验收。
4. 若重建过 `🌍 Other`，确认它的命中里**不再包含**新地区节点
## 删除某个地区（反向操作）

67
docs/AI-COLLABORATION.md Normal file
View File

@@ -0,0 +1,67 @@
# Codex 与 Claude Code 协作
项目开发约定以根目录 `AGENTS.md` 为唯一来源。原 `CLAUDE.md` 中的架构、协议适配、前端设计、数据与部署约定已迁入，并根据当前代码补充了初始化、环境变量、AI DNS 与验证说明。
最新生产盘点统一维护在 [CURRENT-STATE.md](CURRENT-STATE.md)，较长的 Session 变更证据保存在其链接的专题文档。AGENTS.md 维护持续适用的约束；专题记录保留原阶段数量，不能用旧快照替代新的 API 盘点。
## 指令入口
| 工具 | 项目指令 | 项目技能 |
|---|---|---|
| Codex | 原生读取根目录 `AGENTS.md` | `.agents/skills/<name>/SKILL.md` |
| Claude Code | `CLAUDE.md` 中的 `@AGENTS.md` 导入 | `.claude/skills/<name>/SKILL.md` |
Claude Code v2.1.277 起支持直接读取 `AGENTS.md`，但默认在当前目录或祖先目录已有 `CLAUDE.md`／`CLAUDE.local.md` 时优先读取 Claude 文件。保留 `CLAUDE.md` 的显式导入，使支持导入的旧版本与新版本都能读取同一份规则；无需修改用户全局配置。原生支持不可用的部分旧版本会话也可通过导入加载。
文件名使用大写、复数的 `AGENTS.md`。不要新增 `agent.md`、`AGENT.md`、`agents.jmd` 或复制一份独立的 Codex 规则。Claude 的 `@path` 是其导入语法，Codex 项目入口本身包含完整规则，无须依赖此语法。
新开会话时从仓库根目录启动工具。Claude Code 可用 `/memory` 或 `/context` 检查项目指令；Codex 可询问当前项目约定，并用 `/skills` 查看发现的技能。若当前会话未发现新技能，重开会话；不需要额外安装项目技能。全局个人指令与机器设置继续由各工具管理，不写入本仓库。
## 共用技能
保留现有 `.claude/skills/` 作为技能源目录，Codex 入口使用相对目录符号链接。Codex 官方支持扫描符号链接指向的技能目录，脚本及评估样例因此也共用一份：
```text
.claude/skills/
├── deploy/ # SKILL.md 与 scripts/deploy.sh
├── update-db/ # SKILL.md、scripts/api.sh 与 evals/
└── edge-node-multi-protocol/ # 节点部署脚本、参考资料与交付模板
.agents/skills/
├── deploy -> ../../.claude/skills/deploy
├── update-db -> ../../.claude/skills/update-db
└── edge-node-multi-protocol -> ../../.claude/skills/edge-node-multi-protocol
```
| 任务 | 技能 | Codex 显式调用 | Claude Code 显式调用 |
|---|---|---|---|
| 部署前端／后端到 LA | `deploy` | `$deploy` | `/deploy` |
| 线上数据盘点、导入预览或修改 | `update-db` | `$update-db` | `/update-db` |
| 边缘 VPS 部署、重建、协议维护与交付 | `edge-node-multi-protocol` | `$edge-node-multi-protocol` | `/edge-node-multi-protocol` |
自然语言请求也可以匹配技能。技能提供操作方法，具体外部操作范围仍以用户任务授权为准；阅读部署文档或修改代码不会自动触发上线。
脚本示例统一保留已有 `.claude/skills/` 路径，两种工具都可在仓库根目录执行。同一脚本也可从 `.agents/skills/` 链接路径执行。新增技能时只写一份源目录，并在 `.agents/skills/` 增加相对链接。
Git 应保存这些目录链接；在 Windows 上克隆时需要启用符号链接支持，推荐 WSL。若 checkout 将链接变成文本文件，Codex 无法自动发现技能，应恢复目录链接；不要复制出第二份技能。
## 维护与接续
- 架构或业务约束改动更新 `AGENTS.md`；较长的专题说明放入 `docs/` 并按任务引用。
- 生产任务先经 update-db 只读盘点，区分登记总量、启用数量、token 范围和客户端排除；当前节点、组成员与显示顺序集中更新 CURRENT-STATE.md，阶段性的数量／备份／验收仍保留在原专题文档。
- 运维流程改动更新 `.claude/skills/<name>/SKILL.md` 及其脚本；`.agents/skills/` 只维护链接。
- 节点与应用在本仓库统一维护，节点目录与当前舰队见 `edge-nodes/README.md`。通用工具可入库，真实配置／交付产物放 `edge-nodes/private/` 并用受控备份转交；原 `../edge-nodes/` 仅保留迁移前备份。旧工程指令保存在私有归档中，不作为当前约定。
- 普通开发从 `shared` 的类型／校验、`server` 的 API 与 IR、`web` 的状态与页面定位改动。新增客户端先扩展客户端类型与能力矩阵，再增加独立生成器和订阅端点。
- 修改规则模板只影响初始化，已有库的配置更新走管理 API；代码部署与数据更新分别执行。
- 本地验证按改动范围选择类型检查、单测或构建。临时启动与数据库验证在进程启动前设置临时 `DATA_DIR`，避免触碰真实节点数据。
- 接续时区分本地源码、已部署源码、生产数据库、客户端活动配置／模块及实际网络结果。未提交源码可能已经在用户授权下部署，部署记录不是新一轮上线授权；文档修改也不触发业务写入、订阅刷新或节点启用。
- All Nodes／AI Nodes 独立选择、零权重名称排序、Proxy 为唯一 Automatic 父组及 AI 规则优先级属于当前业务约定。改组名需跟踪 API 级联引用和客户端保存选择的迁移，不能仅看生成文本通过校验。
- 交接说明记录已完成改动、验证结果与未完成项；可复用的认识写入项目文件，不依赖某个工具的私有会话记忆。
## 官方依据
- [Codex：AGENTS.md 加载规则](https://developers.openai.com/codex/guides/agents-md)
- [Codex：技能目录与符号链接支持](https://developers.openai.com/codex/skills)
- [Claude Code：AGENTS.md 支持与共用导入](https://code.claude.com/docs/en/memory#agentsmd)
- [Claude Code：项目技能](https://code.claude.com/docs/en/skills)
支持行为核对于 2026-10-03；若工具升级后入口行为变化，按上述官方文档重新核对。

33
docs/AI-NODES-2026-10-04.md Normal file
View File

@@ -0,0 +1,33 @@
# 🧠 AI Nodes 独立节点选择（2026-10-04）
本记录包含创建、改名及排序两个阶段；完整最新盘点见 [当前生产状态](CURRENT-STATE.md)。登记节点为 30 个，其中 12 个启用、18 个停用；全节点组仍受启用状态、订阅范围与客户端能力过滤。
按用户要求，经生产管理 API 新增名为 `AI Nodes` 的启用 select 组，同日后续添加 emoji 改名为 `🧠 AI Nodes`，显示在 `🤖 AI` 下方。它与 `📋 All Nodes` 一样启用 `includeAllNodes`，没有正则和显式成员，直接收纳订阅范围内、该客户端支持的全部启用节点。
`🤖 AI` 的成员顺序现在为美国、新加坡、日本、🧠 AI Nodes；原 All Nodes 引用已替换为该独立组，改名时 API 级联更新引用。All Nodes 继续作为 Proxy 的选项。
两个组的节点列表相同，但组名和客户端策略身份独立，分别保存手动选择。用户在 AI 中选择 🧠 AI Nodes 后，再在 🧠 AI Nodes 中选择具体节点，即可让 AI 流量使用独立于 All Nodes 的节点选择。新增或停用节点时，两组由同一订阅生成流程更新，不维护两份静态节点清单。
当前组显示顺序：Proxy → Automatic → All Nodes → United States → Singapore → Japan → AI → 🧠 AI Nodes → Streaming → Bybit → Mainland → NoAuto。
## 名称排序与 emoji 优化
用户进一步要求给 AI Nodes 添加合适的 emoji，并将它与 All Nodes 中的节点按名称字符串排列。`🧠` 表示 AI 专用节点选择，和 `🤖 AI` 主服务策略组区分。
已有 IR 按节点 `sortOrder`、完整 `name` 升序读取。原排序权重偏向协议顺序，导致日本、新加坡节点交错；本次经节点管理 API 将 28 个非零权重改为默认 0，现有 30 个节点统一同权重，由完整名称决定顺序。节点名称、凭据、协议与开关不变，更新只影响 sortOrder 和 updatedAt。这也使节点声明及依赖同一节点来源的动态地区列表按名称排列。Web 节点页仍使用其既有站点、协议与出口排序。
Surge 的全部节点组继续静态展开支持的节点；Clash 从按名称排列的 proxies 动态收纳；Shadowrocket 的节点订阅原本已经按完整名称排序，conf 继续用 `policy-regex-filter=.*` 收纳 App 内节点。Shadowrocket 中其他订阅或 App 自定义排序的显示次序不由此服务控制。
新建或导入节点的 schema 默认 sortOrder 为 0，保持默认即可沿用名称排序；显式设置非零权重会先按权重排列。本次使用既有数据字段和生成流程，未修改或部署生成器代码。优化前另有在线备份：`/opt/proxy-station/data/backups/before-polish-ai-nodes-name-order-20261004-113612.db`，root 属主、600 权限。
优化后重读确认实体数量不变，规则与设置完全一致；组只发生名称及引用级联更新，节点只发生权重和更新时间调整。真实 HTTPS Surge 两组各 12 个支持的节点均按完整名称升序排列，Clash 的 proxies 来源与 Shadowrocket 节点订阅同样通过名称排序核对。Surge 官方 CLI、49/49 规则集快照与 `mihomo -t` 再次通过，域名遮蔽提示为 0。刷新本机同一托管配置后，有效配置及两个组的运行时选项都已确认顺序；为改名后的新客户端组身份恢复了之前选择的同一节点，原 All Nodes 选择与 AI 实际路径保持不变。
## 创建阶段的备份与验证
- 写入前 SQLite 在线备份：`/opt/proxy-station/data/backups/before-add-ai-nodes-selector-20261004-112540.db`，root 属主、600 权限。
- 重读确认 12 个组、21 个成员、30 个节点、130 条规则；仅新增 AI Nodes、替换 AI 的该项引用及调整显示顺序。其他原组内容保持一致，原节点、规则和设置与变更前相同。
- 从真实 HTTPS 入口读取 Surge、Clash、Shadowrocket conf，逐端确认 AI Nodes 与 All Nodes 的内容完全一致、AI 只引用 AI Nodes，且新组紧接 AI。Surge 当前两组各有 12 个客户端支持的节点，节点数不是数据库总节点数。
- Surge 官方 CLI、49/49 远程规则集快照校验及 Clash `mihomo -t` 通过；静态域名遮蔽提示为 0。
- 本机同一托管配置已确认生效，有效配置与运行时均提供独立 AI Nodes 手动选择组；其运行时节点选项与 All Nodes 完全一致，既有 AI 与 All Nodes 的已保存选择保持不变。没有通过切换节点来做独立性测试。
本次只修改生产数据与文档，未部署代码。Shadowrocket 仅检查订阅结构，未做手机真机编译或连接测试；其他设备刷新订阅后取得新组。

46
docs/AI-PRIORITY-2026-10-04.md Normal file
View File

@@ -0,0 +1,46 @@
# AI、广告与其他规则的优先级（2026-10-04）
本文保留删除 Speedtest、集中排列 AI 规则时的阶段记录。后续加入 Net.Coffee 规则及独立 `🧠 AI Nodes` 后，现状为 12 组、130 条规则、31 条启用 AI 规则；完整盘点见 [当前生产状态](CURRENT-STATE.md)。
用户要求删除 Speedtest 策略组及其规则，调整组显示顺序，并让 AI 优先于广告和普通分流。审阅现有宽泛 googleapis.com AI 规则与协议防护后，用户明确选择保留 STUN 阻断及 Google 更新／翻译直连例外。本次通过管理 API 删除与排序，未修改规则匹配范围、策略、参数或启用状态，未部署代码。
## 本阶段策略组显示顺序
Proxy → Automatic → All Nodes → United States → Singapore → Japan → AI → Streaming → Bybit → Mainland → NoAuto。
前六组相对顺序保持原状。Speedtest 组与其一条 Speedtest RULE-SET 已删除，测速服务继续匹配后续规则。组显示顺序不决定规则优先级；规则从上到下首条匹配生效，pre-matching 另有更高优先级，依据 [Surge 规则说明](https://manual.nssurge.com/rules/overview.html)。此次启用的顶层规则与已下载规则集都没有 pre-matching 参数。
## 本阶段实际连接规则顺序
1. STUN REJECT，以及 googlevideo.com 的 UDP REJECT-NO-DROP。
2. Unbreak DIRECT；保留包括 update.googleapis.com、translate.googleapis.com 等 Google 例外。当前规则集与 AI 域名样例的交叉检查没有发现其他 AI 服务域名被 Unbreak 覆盖。
3. 全部 30 条启用的 AI 规则集中排列，保留原有相对顺序。两条已停用的 AI 规则仍停用，全局 DOH 接管没有启用。
4. 原有业务例外，如 PayPal 指定美国、Bybit 的 inapps.appsflyer.com、api.amplitude.com 的 Proxy 等。
5. 广告与隐私规则。四条广告列表的相对顺序保持原状；IP 拦截集原有 no-resolve 参数保留，不新增泛化遥测放行。
6. 其余服务、地区、国内、CDN 和 global 等规则，彼此相对顺序保持原状。
7. 唯一启用 FINAL 末尾兜底，仍指向 NoAuto，并保留 dns-failed。
这是现有 AI 匹配范围的优先级调整，不将整个共享服务平台扩展为 AI。googleapis.com、api.github.com 及原有共享域名的范围沿用既有配置。外部规则集仍会动态更新，后续业务规则变更需重做覆盖审阅。
## DNS 与客户端范围
Surge 的 AI DNS 映射仍由连接规则派生；Unbreak 的默认 DNS 映射在 AI 映射之前，AI 域名使用 Cloudflare DoH 并随 AI 出口。手写 Host、节点引导 IP 和 General 均未改动，不改变全局 DNS 或端口 53 的路由。
STUN 的 PROTOCOL 规则仍仅在能表达它的客户端下发生效；现有 Clash／Shadowrocket 生成器跳过该应用协议类型，此次没有新增其他客户端的 STUN 防护。Host 不能表达协议／进程／IP 条件，生成配置与静态域名匹配也不能证明设备 DNS／WebRTC 没有泄漏。
## 本阶段备份与验证
写入前在线备份：`/opt/proxy-station/data/backups/before-remove-speedtest-ai-priority-20261004-105853.db`，root 属主、600 权限。敏感 API 快照和订阅仅保存在私有临时目录。
重读确认 11 个组、129 条规则、21 个组成员、30 个节点；除 Speedtest 删除与两个排序外，其余实体字段保持原状。当前没有直接指向 Automatic 的规则，只有 Proxy 引用它，Automatic 仍为 url-test。
候选 Surge 配置先通过官方 CLI，写入后从实际 HTTPS 入口读取三个客户端的订阅：
- 三端组显示顺序均与上述一致，Speedtest 组及引用已消失，AI 均位于广告规则之前。
- Surge／Shadowrocket 以当前规则集快照检查 126 个 AI 域名样例，全部首条域名匹配 AI；包括 Claude/OpenAI、附件/MCP、Statsig、已确认的 Datadog/Sentry/LiveKit 主机及 api.github.com。Google 更新／翻译例外为 DIRECT，x.com／bing.com 为 Proxy，doubleclick.net 仍 REJECT，Bybit 与 Amplitude 业务例外保持原策略。
- Surge self URL 正确，Host 中 Unbreak 在 AI 集之前，Statsig 的 AI DNS 映射正确；官方 CLI 与 49/49 规则集快照再次通过，静态域名遮蔽提示为 0。
- Clash 结构与 `mihomo -t` 通过，FINAL/MATCH 末尾兜底保留。
样例检查不模拟 IP、进程、协议、CNAME 或设备缓存。本阶段 Shadowrocket 未做真机编译，所有客户端均未做业务连接、测速或 DNS/WebRTC 实测；未切换本机活动配置或修改设备已保存选择。
同日后续已完成本机 Net.Coffee DNS 复测，见 [检测机制与结果](NET-COFFEE-DNS-2026-10-04.md)；随后创建独立 `🧠 AI Nodes`、统一节点默认权重为 0，并验证两组完整名称排序与保存选择，见 [AI Nodes](AI-NODES-2026-10-04.md)。这些后续验证不构成手机或其他业务路径的验收。

86
docs/AI-RULE-REVIEW-2026-10-04.md Normal file
View File

@@ -0,0 +1,86 @@
# 🤖 AI 规则审阅与精确补齐（2026-10-04）
本文按阶段保留规则补齐及后续删组、调整优先级的证据，数量与选择链均以各段发生时为准。最新规则、组与客户端产物见 [当前生产状态](CURRENT-STATE.md)，不按历史阶段恢复旧配置。
本次按用户提供的 [Claude 清单](https://ip.net.coffee/claude/site.html) 与 [ChatGPT 清单](https://ip.net.coffee/gpt/site.html) 审阅线上规则。用户选择「按 AI 专用域名精确补齐；共享服务只加入已确认的主机」。已有远程规则集继续自动更新，缺项通过管理 API 添加到同一 `🤖 AI` 策略。规则集 API 只读，不能修改第三方托管文件，也不通过直接写库替换它们。
## 原有覆盖
| 原有规则 | 审阅结果 |
|---|---|
| Sukka `non_ip/ai.conf` | 实际下载版本为 2026-10-03、53 条；已有 Anthropic、Claude、clau.de、ChatGPT、chat.com、Sora、oaistatic 等域名。`DOMAIN-KEYWORD,openai` 已覆盖所列 OpenAI/Azure/CDN 中包含 openai 的主机，但缺少 oaiusercontent、oaistatsig、MCP 和语音等域名。 |
| Blackmatrix7 `Bing.list` | 9 条，包含 Bing 搜索与相关服务；精确补齐时保留，随后按用户要求移除，见文末后续调整。不是 Claude/OpenAI 专项规则集。 |
| `DOMAIN-SUFFIX,googleapis.com` | 范围包括非 AI Google APIs；保留原业务行为。Unbreak 中靠前的 Google 更新、翻译等 DIRECT 例外继续优先。 |
| Apple Relay 两条后缀及 `apple-relay` 关键词 | 后缀与关键词重叠；保留现有 Apple Intelligence/Relay 行为。 |
| Dia 后缀与关键词 | 停用 `DOMAIN-KEYWORD,diabrowser.engineering`，保留 `DOMAIN-SUFFIX,diabrowser.engineering`，避免关键词匹配域名之外的同名片段。 |
| 已停用的全局 `PROTOCOL,DOH` | 继续停用；仅从 AI 域名规则生成 Surge DNS 映射。 |
原有 Sukka 集还包含 `api.github.com`、多种其他 AI 服务及历史域名。此次保持原引用，精确原则用于新增规则，不声称整个原有 AI 组已收敛为 Claude/OpenAI 专属。
## 新增的 24 条规则
以下全部指向 `🤖 AI`。22 条域名规则放在现有 `api.amplitude.com` 之后、第一条广告拦截规则集之前；保留更早的协议阻断、业务例外和 Unbreak。2 条 IP 兜底放在原有 AI/Bing 域名规则之后，均使用 `no-resolve`。其他原有规则的相对顺序保持不变，唯一启用的 FINAL 保持末尾。
| 类型 | 匹配值 |
|---|---|
| DOMAIN-SUFFIX | claudemcpclient.com |
| DOMAIN-SUFFIX | claudemcpcontent.com |
| DOMAIN-SUFFIX | claudeusercontent.com |
| DOMAIN-SUFFIX | oaiusercontent.com |
| DOMAIN-SUFFIX | crixet.com |
| DOMAIN-SUFFIX | oaistatsig.com |
| DOMAIN-SUFFIX | chatgpt.livekit.cloud |
| DOMAIN | servd-anthropic-website.b-cdn.net |
| DOMAIN | anthropic.com.cdn.cloudflare.net |
| DOMAIN | anthropic.auth0.com |
| DOMAIN | anthropic-com.ghost.io |
| DOMAIN | browser-intake-us5-datadoghq.com |
| DOMAIN | http-intake.logs.us5.datadoghq.com |
| DOMAIN | client-api.arkoselabs.com |
| DOMAIN | host.livekit.cloud |
| DOMAIN | turn.livekit.cloud |
| DOMAIN | o33249.ingest.sentry.io |
| DOMAIN | o207216.ingest.sentry.io |
| DOMAIN | browser-intake-datadoghq.com |
| DOMAIN | rum.browser-intake-datadoghq.com |
| DOMAIN-SUFFIX | statsig.anthropic.com |
| DOMAIN-KEYWORD | chatgpt-async-webps-prod- |
| IP-CIDR | 160.79.104.0/23 |
| IP-CIDR6 | 2607:6bc0::/48 |
`statsig.anthropic.com` 原本已经被 Anthropic 后缀覆盖，但更早的广告域名集包含它；这条是优先级例外，而非新增域名覆盖。`browser-intake-datadoghq.com` 及其 `rum` 主机也原先被广告域名集拦截，补充后优先交给 AI。用户选择接受这些已确认 AI 遥测主机，不据此放行所有遥测服务。
ChatGPT 动态 Azure 主机的范围参考 [v2fly OpenAI 原始清单](https://raw.githubusercontent.com/v2fly/domain-list-community/master/data/openai)。当前数据模型没有顶层 DOMAIN-WILDCARD；本次使用 ChatGPT 服务专用前缀关键词，避免添加整个 `webpubsub.azure.com` 后缀。关键词匹配不是锚定的完整域名正则，也会匹配其他包含相同字符串的主机；这是一项明确的表达能力限制。它可以在三个现有客户端产物中下发，并触发 Surge 域名 DNS 映射。
## 没有照搬的项目
- 不新增整个 `sentry.io`、`statsigapi.net`、`intercom.io`、`intercomcdn.com` 或泛化 `datadog`／`sentry`／`sift` 关键词；不将通用 `cdn.usefathom.com` 当作 AI 专属。这些会改变其他应用的流量。只添加上表确认的遥测主机；Claude CLI 的两个 Datadog 主机由 [官方网络要求](https://code.claude.com/docs/en/network-config#network-access-requirements) 确认，OpenAI 的两个 Sentry 与 rum 主机由 [官方网络建议](https://help.openai.com/en/articles/9247338-network-recommendations-for-chatgpt-errors-on-web-and-apps) 确认。
- Claude 页面提供的 `/21` 和 IPv6 `/32` 比 API 接收请求的网段宽。[Anthropic 官方 IP 文档](https://platform.claude.com/docs/en/api/ip-addresses) 将 inbound 标为 `160.79.104.0/23`、`2607:6bc0::/48`，而 `/21` 是服务端向外发起工具请求的出口范围。本次使用 inbound 范围，不加扩大覆盖的 ASN 兜底。
- 不添加全局 NTP 分流。页面称 NTP 返回代理所在地时区，这不符合 [RFC 5905](https://www.rfc-editor.org/rfc/rfc5905.html) 的 UTC 时间模型；转发 NTP 也不会修改设备时区。
- IPv6 `/48` 是路由兜底，不启用客户端或边缘 IPv6。边缘继续遵守 IPv4-only，命中规则不保证 IPv6 字面目标可以连接。
## 验证与限制
变更前、候选配置与写入后的实际 HTTPS Surge 订阅均通过官方 Surge CLI；每次 60/60 远程规则集快照下载成功并再次通过 CLI，静态域名遮蔽提示为 0。写入前在线备份，新增规则先以停用状态创建、提交全量顺序后逐条启用，再停用 Dia 关键词，逐条核对 HTTP 状态。
线上已重读确认规则从 116 增至 140，其中启用 138 条、启用的 AI 规则 31 条；其他原有规则字段与相对顺序、节点、组、设置及规则集引用均未改变。实际 HTTPS 的 Surge、Clash、Shadowrocket conf 均包含全部 24 条新增规则，节点与组产物与变更前一致，FINAL/MATCH 末尾兜底验证通过；Surge 的 self URL 和新增域名 DNS 映射正确。38 个 AI 域名样例的首条域名匹配均为 AI，3 个 Google Unbreak DIRECT 例外仍保留。Clash 实际订阅另通过独立临时目录的 `mihomo -t`；Shadowrocket 为结构验证，未做真机编译。文档变更通过 `git diff --check`。
备份：`/opt/proxy-station/data/backups/before-ai-claude-chatgpt-precision-20261004-102138.db`，已收紧为 root 属主、600 权限。含凭据的 API 快照及订阅仅保存在权限受控的私有临时目录，不写入仓库。本次只有生产数据与文档变更，没有代码部署。
本次候选校验还发现：`AND,((DOMAIN-SUFFIX,webpubsub.azure.com),(DOMAIN-KEYWORD,chatgpt-async-webps-prod-)),"🤖 AI"` 被本机 Surge CLI 拒绝，同一规则将末尾策略裸写为 `🤖 AI` 则通过。当前生成器为含空格的策略输出引号，因此本次没有写入这条 AND。以后修改逻辑规则生成器时，应单独补原生 CLI 用例并核实带空格策略的处理；本次不部署代码。
DNS 映射随新域名规则生成，手写 Host 例外继续优先；IP 规则不生成域名 DNS 映射。现有全局 STUN 阻断可能影响语音 WebRTC/TURN，添加语音域名不表示高级语音已经可用。CLI 和静态覆盖验证不能替代设备上的登录、附件、MCP、语音与 DNS/WebRTC 验收。策略组成员和设备已保存的出口选择均保持现状。
## 后续调整：移除 Apple／Global Services 与 Bing 专用分流
2026-10-04 按用户要求，经管理 API 删除 `🍎 Apple`、`🌐 Global Services` 两个组，以及指向它们的 9 条规则（apple_cdn、AppleTV、Apple、Twitter、Telegram 域名／IP／ASN、OneDrive、microsoft）；另删除 `🤖 AI` 的 Bing RULE-SET。没有将这些专用规则改挂其他策略，后续规则自然接管。用户明确选择保留 `global`／`global_plus` 的 Automatic 策略；当前规则集静态域名匹配确认 x.com、twitter.com、bing.com、www.bing.com 均由 `global` → Automatic。当前 Sukka AI 集不含 Bing／Copilot 名称规则。App Store DIRECT、Apple News 美国、Apple Relay AI 例外继续保留。
重读确认组从 14 减至 12、规则从 140 减至 130，组成员剩 25；其余组、规则字段与相对顺序、节点和设置均保持原状，唯一启用 FINAL 仍在末尾。实际 HTTPS Surge、Clash、Shadowrocket conf 均已无这两个组和 Bing 规则引用；Surge self URL 正确，官方 CLI 与 50/50 远程规则集快照校验通过，静态域名遮蔽提示为 0；Clash 的 `mihomo -t` 通过。Shadowrocket 仅验证产物结构，未进行真机编译或业务连接验证。
本次写入前在线备份为 `/opt/proxy-station/data/backups/before-remove-apple-global-bing-20261004-103623.db`。只调整生产数据与相关文档，未部署代码或修改初始化模板。
同日后续按用户明确要求统一代理入口：原先指向 Automatic 的 20 条规则（包括 global／global_plus）全部改为 Proxy，Automatic 从 select 改为 url-test；AI／Speedtest／NoAuto 去掉 Automatic 成员。因此 x.com／bing.com 的已验证路径变为 global → Proxy；当时 AI 的可选成员为美国、新加坡、日本、All Nodes。该调整覆盖上文“保留 Automatic”的阶段性状态，详见 [Proxy 与 Automatic 选择链](PROXY-AUTOMATIC-2026-10-04.md)。
同日再按用户要求删除 Speedtest 组与其一条专用规则，并调整组显示顺序。当时 30 条启用 AI 规则集中排在广告与普通分流之前；用户明确选择保留 STUN 阻断及 Google 更新／翻译直连例外，因此两条协议防护及 Unbreak 在 AI 之前。实际 HTTPS Surge／Shadowrocket 的 126 个 AI 域名样例均首条匹配 AI，Google 例外仍为 DIRECT，49/49 规则集快照与 Surge CLI、Clash 原生校验通过。该阶段为 11 组、129 条规则、21 个成员，详见 [AI 与广告优先级](AI-PRIORITY-2026-10-04.md)。
随后新增 `DOMAIN-SUFFIX,ip.net.coffee → AI`，本机 DNS 探测从中国电信变为美国 Cloudflare；再将 AI 中的 All Nodes 替换为独立 `🧠 AI Nodes`，紧接 AI 显示，两个全节点组按完整名称排列且各自保存选择。最新为 12 组、130 条规则、31 条启用 AI 规则，见 [DNS 复测](NET-COFFEE-DNS-2026-10-04.md)与 [AI Nodes](AI-NODES-2026-10-04.md)。

105
docs/CURRENT-STATE.md Normal file
View File

@@ -0,0 +1,105 @@
# 当前生产状态与接续入口
核对日期：2026-10-04（UTC+8；管理 API 盘点时间 11:46）。来源为 LA 管理 API 与四类实际 HTTPS 订阅；本次仅更新文档，未执行部署或生产业务数据变更。完整响应、token、凭据与配置仅保存在权限受限的本机临时目录。
本文件集中维护最新生产盘点；日期化体检与变更报告保留各阶段证据。后续任务先重读 API，再更新这里，不能把模板、历史数量或本机模块当作生产现状。项目协作约定见 [AGENTS.md](../AGENTS.md)，技能入口见 [双工具协作](AI-COLLABORATION.md)。
## 节点与订阅范围
| 站点 | 登记节点 | 启用 | 停用 | 当前启用协议 |
|---|---:|---:|---:|---|
| JP（日本） | 8 | 4 | 4 | VMess／Trojan × Direct／Warp |
| SG（新加坡） | 8 | 4 | 4 | VMess／Trojan × Direct／Warp |
| LA（美国） | 6 | 4 | 2 | VMess／Trojan × Direct／Warp |
| RN（美国） | 8 | 0 | 8 | 无 |
| 合计 | 30 | 12 | 18 | VMess 6、Trojan 6，均为 WS |
全部 8 个 SS、6 个 HY2 以及 RN 的 4 个 VMess／Trojan 当前停用。停用是应用数据库状态，不代表 VPS 或远端线路已经移除／故障；不因整理文档、部署代码或重新生成交付页而启用。边缘舰队仍为 SG／LA／RN／JP，部署资料与 IPv4-only 约束见 [节点工作区](../edge-nodes/README.md)及 [IPv4 约定](EDGE-IPV4-ONLY.md)。舰队交付线路数与本应用登记／启用数不是同一指标。
现有 1 个启用订阅，nodeIds 为空数组，即下发全部启用且客户端支持的节点；没有公开默认 token。Surge、Clash、Shadowrocket 节点订阅当前均输出 12 个节点；这不是客户端只能支持这两种协议的断言。将来启用 SS／HY2 后仍须按 [客户端能力矩阵](../shared/src/protocols.ts)重新核对过滤与连接。
所有节点 sortOrder 现为默认 0。[IR](../server/src/services/ir.ts)按 sortOrder、name 升序读取，当前完整名称顺序为日本 → 新加坡 → 美国，同地区内 Trojan → VMess，同协议 Direct → Warp。新增节点保持默认权重即可按名称自然插入；非零权重会改变该全局来源的排序。Web 节点页另按站点、协议与出口展示。
## 策略组：显示顺序与有序成员
12 个组全部启用，共 21 个显式成员。下表顺序就是数据库 sortOrder，也是生成配置的组显示顺序。
| 顺序 | 名称 | 类型 | 成员／动态节点来源 |
|---:|---|---|---|
| 1 | 🚀 Proxy | select | Automatic、All Nodes、新加坡、美国、日本 |
| 2 | ⚡️ Automatic | url-test | 新加坡、美国、日本 |
| 3 | 📋 All Nodes | select | includeAllNodes，全部可用节点 |
| 4 | 🇺🇸 United States | url-test | includeAllNodes＋美国名称正则 |
| 5 | 🇸🇬 Singapore | url-test | includeAllNodes＋新加坡名称正则 |
| 6 | 🇯🇵 Japan | url-test | includeAllNodes＋日本名称正则 |
| 7 | 🤖 AI | select | 美国、新加坡、日本、🧠 AI Nodes |
| 8 | 🧠 AI Nodes | select | includeAllNodes，全部可用节点 |
| 9 | 🎬 Streaming | select | 新加坡、美国、日本 |
| 10 | 🪙 Bybit | select | DIRECT、新加坡、美国、日本 |
| 11 | 🇨🇳 Mainland | select | DIRECT |
| 12 | 🎯 NoAuto | select | Mainland |
- 普通代理规则指向 Proxy，只有 Proxy 包含 Automatic；没有直接指向 Automatic 的规则。
- AI 不引用 Automatic。All Nodes 与 AI Nodes 使用独立组身份保存节点选择；两组无正则、无显式成员，节点来源与名称升序列表相同。AI Nodes 紧接 AI，不能通过引用 All Nodes 来实现独立选择。
- Automatic 和三个地区组的数据库类型均为 url-test，interval=300、tolerance=50。组 testUrl 为 `http://cp.cloudflare.com/generate_204`，仅 Clash／Shadowrocket 使用；Surge 使用 General／节点测速地址。客户端自身模块可能覆盖组类型或参数。
- select 在没有有效保存选择时使用首个成员；名称排序和改名可能影响这个默认值。已保存的实际选择需在授权的客户端更新任务中保留。
- FINAL → NoAuto → Mainland → DIRECT。Bybit 的首个候选同为 DIRECT，实际使用仍由客户端保存的选择决定。
Apple、Global Services、Speedtest、Other，以及香港／台湾／韩国／英国地区组当前不存在。App Store DIRECT、Apple News 美国、Apple Relay AI 例外保留。原初始化模板还有历史组，修改模板或 reset 规则不能代替定向更新生产数据。
## 规则与服务归属
数据库有 130 条规则：128 启用、2 停用；登记 62 个规则集，实际配置引用 49 个不同远程 URL。唯一启用 FINAL 位于末尾，保留 dns-failed。
连接规则按首条匹配，当前顺序为：
1. STUN REJECT，以及 googlevideo.com 的 UDP REJECT-NO-DROP。
2. Unbreak DIRECT，保留已授权的 Google 更新／翻译直连例外。
3. 31 条启用的 AI 规则集中排列，包含原 AI 集、精确补充域名、Anthropic IP 兜底及 `ip.net.coffee` 后缀。
4. 业务例外、广告／隐私规则及其余服务、地区、国内、CDN、global 分流。
5. FINAL → NoAuto。
两条停用规则为全局 `PROTOCOL,DOH → AI` 和 `DOMAIN-KEYWORD,diabrowser.engineering → AI`；Dia 的 DOMAIN-SUFFIX 规则仍启用。普通代理入口统一到 Proxy；x.com／bing.com 的已验证路径是 global → Proxy，Bing 专用 AI RULE-SET 已删除。具体域名仍受更早规则及动态外部规则集影响，后续变更须重审遮蔽。
直接指向 Streaming 的启用 RULE-SET 共 13 条；相关服务的地区分流与 Emby 归属一并列在下表：
| 来源 | 策略 |
|---|---|
| Disney、Netflix、TikTok、YouTube、GoogleSearch | 🎬 Streaming，各 1 条 |
| stream_eu、stream_kr、stream_hk、stream_tw | 🎬 Streaming，各域名／IP 两条 |
| stream_us | 🇺🇸 United States，域名／IP 两条 |
| stream_jp | 🇯🇵 Japan，域名／IP 两条 |
| Emby | 🚀 Proxy，1 条 |
该表表示规则指定策略，不保证某服务的所有请求都走该组；例如先匹配 AI 的 Google API 请求或被协议防护拦截的请求仍执行先前规则。
## DNS、客户端差异与验收范围
Surge AI DNS 从启用 AI 域名规则派生 Host 到 `https://1.1.1.1/dns-query`，并生成 DoH 跟随出口开关与 1.1.1.1/32 → AI 规则。手写 Host、Unbreak 和默认国内 DNS 例外继续保持顺序。数据库 General 中原始开关为 false，生成配置派生为 true；原文设置与最终产物须分别核对。没有启用全局 DOH／全端口 53 AI 接管，边缘 IPv4-only 约束继续保留。
Net.Coffee 的 Claude 页通过随机 `*.d.ip.net.coffee` 记录递归解析器，使用 `DOMAIN-SUFFIX,ip.net.coffee → AI` 覆盖页面及子域。前面 Session 的本机 Chrome＋Surge 实测已从中国电信「可能泄露」变为美国 Cloudflare「未检测到泄露」；`dns trace` 确认 Cloudflare DoH。此结果限于该探测路径，不代表其他设备、域名或远端代理解析器已验收。
| 实际 HTTPS 产物 | 节点 | 组 | 规则 | 说明 |
|---|---:|---:|---:|---|
| Surge | 12 | 12 | 131 | 128 条启用数据库规则＋3 条派生 DNS 出口规则 |
| Clash | 12 | 12 | 126 | 49 个 provider；跳过 STUN 与 SMTP 文本 URL-REGEX |
| Shadowrocket 节点订阅 | 12 | — | — | 完整名称升序的 base64 URI 列表 |
| Shadowrocket conf | — | 12 | 122 | 保守跳过 6 条：STUN、googlevideo AND、reject／download／cdn DOMAIN-SET、SMTP 文本 URL-REGEX |
HTTP 订阅只有正文，没有 excluded／skippedRules 字段；总节点数与实际节点数不同，要区分停用、token 范围与客户端过滤。Shadowrocket 的全节点正则会收纳 App 内其他订阅，App 排序和其他节点不由本服务控制。
前面 Session 最近一次验证已通过 Surge 官方 CLI、49/49 规则集快照及 Clash `mihomo -t`，静态域名遮蔽提示为 0；本机 Surge 已验证新组名、两个列表的名称顺序和独立选择，改名后保留原节点及 AI 路径。本轮仅重读最新数据／产物并验证文档一致性，没有重复进行网络泄漏测试。iOS／Android 真机编译、节点连接、UDP、完整业务与隐私验收仍有未完成项。
## Session 变更记录与接续
| 主题 | 记录 | 后续维护要点 |
|---|---|---|
| Surge 体检与防护修复 | [体检](SURGE-AUDIT-2026-10-03.md)、[修复](SURGE-FIX-2026-10-03.md) | 保留 API 校验、FINAL、引用图、配置编码及 Host 顺序防护 |
| 移动端生成器体检与已授权后端部署 | [移动端体检](MOBILE-CLIENT-AUDIT-2026-10-04.md) | 能力矩阵与生成器范围独立检查，保留手机真机待验项 |
| AI 精确补充与删除 Apple／Global／Bing 专用分流 | [AI 规则审阅](AI-RULE-REVIEW-2026-10-04.md) | 精确补充主机；历史阶段保留 Automatic 的记录已被后续 Proxy 入口调整覆盖 |
| Proxy 统一普通代理入口、Automatic 测速 | [选择链](PROXY-AUTOMATIC-2026-10-04.md) | Proxy 为唯一 Automatic 父组，AI／NoAuto 独立 |
| 删除 Speedtest、AI 优先于广告 | [AI 优先级](AI-PRIORITY-2026-10-04.md) | 该阶段为 11 组／129 规则，后续新增项以本文件为准 |
| Net.Coffee 探测域名与 DNS 复测 | [DNS 复测](NET-COFFEE-DNS-2026-10-04.md) | 覆盖随机子域，区分网站探测与 Claude 实际域名 |
| 独立 AI Nodes、emoji 与名称排序 | [AI Nodes](AI-NODES-2026-10-04.md) | 独立 select、同节点来源、默认零权重、保留客户端选择 |
备份文件名与原阶段验收保留在各专题记录中，不清理远端备份。新增业务约束更新 AGENTS.md；当前盘点更新本文件；操作方法更新对应专题。代码部署、生产数据更新和设备配置更新分别核对授权，纯文档整理不触发这些动作。

26
docs/DEPLOY.md
View File

@@ -2,6 +2,10 @@
服务器资源有限（1 核／1.9G），采用 Node 直跑 + systemd 守护，前端在本机构建后由服务端静态托管，反向代理与证书由 aaPanel 管理。
本文描述 Proxy Station 应用发布。边缘 VPS 的部署、重建与协议维护已合入本仓库，见 [节点工作区](../edge-nodes/README.md) 与 `edge-node-multi-protocol` 技能；其私有资料不随应用部署上传。LA 同时承载节点与本应用，维护 nginx、证书或 WARP 时需核对共享服务影响。
当前配置与变更接续入口见 [生产状态](CURRENT-STATE.md)。应用部署只更新代码／产物，不重置生产数据库，不恢复已停用节点，也不自动修改客户端的活动配置与保存选择。
## 拓扑
```
@@ -22,7 +26,7 @@
## 更新代码
日常更新用项目级 Skill `deploy`（对 Claude 说「部署」即可触发），也可直接跑脚本：
日常更新用 Codex／Claude Code 共用的项目级技能 `deploy`（说「部署」即可匹配；也可分别用 `$deploy`／`/deploy` 显式调用），也可在仓库根目录直接跑脚本：
```bash
bash .claude/skills/deploy/scripts/deploy.sh all # 前后端一起（默认）
@@ -36,24 +40,30 @@ SSH 别名必须用小写 `la`，大写会被当作域名解析。
## 迁移数据库
用 sqlite3 在线备份导出一致副本，避免直接拷贝带 WAL 的库文件：
普通节点、组、规则与设置调整使用 update-db 管理 API，并先做生产 SQLite 在线备份。整库迁移／恢复只属于用户明确授权的相应任务；按技能恢复流程安排停服窗口、回滚备份和后续 HTTPS 验收，不用替库代替定向业务修改。
需要从本机导出时，使用在线备份取得一致副本，文件保存在私有临时目录：
```bash
sqlite3 server/data/proxy-station.db ".backup /tmp/ps.db"
scp /tmp/ps.db la:/tmp/ps.db
ssh la 'systemctl stop proxy-station && install -m 644 -o proxy-station -g proxy-station /tmp/ps.db /opt/proxy-station/data/proxy-station.db && rm -f /opt/proxy-station/data/proxy-station.db-wal /opt/proxy-station/data/proxy-station.db-shm /tmp/ps.db && systemctl start proxy-station'
umask 077
migration_dir="$(mktemp -d /private/tmp/proxy-station-migration.XXXXXX)"
sqlite3 server/data/proxy-station.db ".backup $migration_dir/proxy-station.db"
chmod 600 "$migration_dir/proxy-station.db"
```
远端备份确认 root 属主、600 权限；恢复后的活动数据库属运行用户，保留仅必要的访问权限。不要直接拷贝运行中的主库而漏掉 WAL，也不把含真实凭据的库放进 Git 或共享日志。
## 反向代理注意点
- aaPanel 的反代模板不带 `X-Forwarded-Proto`／`X-Forwarded-Host`，已手工补进反代配置。服务端 `routes/sub.ts` 的 `baseUrl()` 依赖这两个头还原外部地址，缺失时 Surge 的 `#!MANAGED-CONFIG` 与 Clash 的 provider URL 会变成 `http://`。
- 站点通过面板类 `AddSite`／`SetSSL`／`CreateProxy`／`HttpToHttps` 创建（脚本模式见 edge-nodes 的 `09-aapanel-sites.py`），不要手写 vhost，否则面板里看不到。
- 站点通过面板类 `AddSite`／`SetSSL`／`CreateProxy`／`HttpToHttps` 创建（脚本模式见本仓库 `.claude/skills/edge-node-multi-protocol/scripts/09-aapanel-sites.py`），不要手写 vhost，否则面板里看不到。
- 泛域名 `*.la.njcqtechaicoding.com` 的 DNS 已指向服务器，新子域无需单独加记录。
- acme.sh 的 `--reloadcmd` 要把新站点加进复制循环，且证书源路径必须写死（原先引用未定义的 `$SRC`，续期后不会重新部署证书）。
## 验证
```bash
curl -s https://ps.la.njcqtechaicoding.com/api/health
curl -s "https://ps.la.njcqtechaicoding.com/sub/<token>/clash" > /tmp/c.yaml && mihomo -t -f /tmp/c.yaml
curl -fsS --max-time 10 https://ps.la.njcqtechaicoding.com/api/health
```
部署脚本核对服务状态、源码／前端指纹、公网健康及管理接口鉴权。涉及生成器或 shared 后，还要读取最新节点范围与真实 HTTPS 订阅，按 [订阅验证](SURGE-CHANGES.md)检查 Surge／Clash 及受影响的 Shadowrocket 产物；先确保下载成功及文件非空，不能把 mihomo 为缺失文件创建的默认配置当成验收结果。与部署前候选比对时使用同一最新生产快照。

28
docs/EDGE-IPV4-ONLY.md Normal file
View File

@@ -0,0 +1,28 @@
# 边缘舰队 IPv4-only
2026-10-03 按用户授权对 SG、LA、RN、JP 四台现役节点统一禁用 IPv6。目标是经任何代理线路访问目标时，直连与 WARP 均只使用 IPv4；IPv6 地址及仅有 AAAA 的目标直接失败，不回退到 IPv6。
## 三层约束
1. 系统：`/etc/sysctl.d/99-z-proxy-station-ipv4-only.conf` 将 `net.ipv6.conf.all.disable_ipv6`、`default.disable_ipv6`、`lo.disable_ipv6` 设为 `1`。`proxy-station-ipv4-only.service` 已启用，在 `network-online.target` 之后、Xray／sing-box／WARP 之前重新应用。检查每个接口，不只检查 `all`；`ip -6 addr` 与 `ip -6 route` 应无地址／路由。
2. 代理：Xray 的每个 freedom 出站使用 `settings.domainStrategy=ForceIPv4` 与 `streamSettings.sockopt.domainStrategy=ForceIPv4`，内置 DNS 使用 `queryStrategy=UseIPv4`；`::/0` 拒绝规则在 WARP 分流之前。持久配置写在 3x-ui 数据库的 `xrayTemplateConfig`，不能只改生成的 `bin/config.json`。sing-box 在路由开始先 `resolve`（`ipv4_only`），再拒绝 `::/0`，之后才进入原有 direct／WARP 规则；DNS 经 IPv4 UDP 服务器，QUIC 入站监听 `0.0.0.0`。
3. DNS：节点根域、通配符及其他节点子域不保留 AAAA，A 记录为 DNS-only。私有 `config.env` 的 `SERVER_IPV6` 清空，防止重新创建 AAAA；清空变量不会删除已存在的记录。
WARP 在用户态代理隧道中仍有双栈能力，因此主机没有公网 IPv6 也不能替代代理层限制。Xray 的 `UseIPv4` 允许解析失败后回退；当前策略使用 `ForceIPv4`。依据：[Linux 内核 sysctl](https://www.kernel.org/doc/html/latest/networking/ip-sysctl.html)、[Xray sockopt](https://xtls.github.io/config/transports/sockopt.html)、[sing-box resolve](https://sing-box.sagernet.org/configuration/route/rule_action/#resolve)。
## 维护与回滚
通用 `08-xui-bootstrap.py` 与 `13-singbox-config.py` 已保留代理层防护；前者扩展已有模板时也应用 IPv4-only，后者需要 sing-box 1.12+。新建／重建服务器还须配置上述系统 sysctl 与开机服务，不要只依赖生成器。当前私有脚本工作副本已同步相关修改。
本次每台机器先通过 SQLite backup API 在线备份 3x-ui 数据库，并打包受影响配置、系统网络设置、systemd 单元、nginx、acme.sh 与 WARP 状态。备份在远端 `/root/ipv4-only-backup-<UTC时间>/`，具体路径、Cloudflare 删除前的记录及验收结果在 Git 忽略的 `edge-nodes/private/ipv4-only-20261003/`。不要将这些内容公开托管或入 Git。证书续期动作未修改。
回滚应读取本机的私有维护记录和该服务器快照，仅恢复受影响的 3x-ui 模板、sing-box 配置及 sysctl／开机单元；不要用整个目录快照覆盖后来新增的配置。恢复 IPv6 或 AAAA 须有用户授权。
## 本次验证与边界
- 四台服务器全部接口的 `disable_ipv6=1`，无 IPv6 地址；持久文件与开机服务均已配置。未进行整机重启验收。
- 服务器侧真实协议客户端验证 33 条线路（SG 8、LA 6、RN 11、JP 8）：IPv4 出口正常，direct 的 `warp=off`、WARP 的 `warp=on`；IPv6 字面地址与仅 IPv6 域名均失败。
- 从本机经公网验证线路：Trojan／Hysteria2／TUIC／SOCKS5 使用 sing-box，VMess／SS over WS 使用 mihomo。临时客户端只监听本机回环，不修改活动代理配置。具体结果见私有记录。
- Cloudflare 删除 SG、LA 的 4 条 AAAA；RN、JP 原本无 AAAA。实际 HTTPS Surge 订阅通过官方 CLI 校验。
代理入站使用的 QUIC UDP 已做真实连接验证；未逐条进行被代理 UDP 负载、手机真机或本地直连 IPv6 泄漏验收。这项策略限制服务器代理转发，不改变客户端绕过代理的本地网络行为。当前不需要通过 VPS 厂商面板才能达到代理仅 IPv4 的目标。

73
docs/MOBILE-CLIENT-AUDIT-2026-10-04.md Normal file
View File

@@ -0,0 +1,73 @@
# Shadowrocket／ClashMeta 体检：2026-10-04
本文保留体检开始时的快照、代码修复及随后已授权部署的证据。下文 18 个启用节点、14 个组等数量属于历史阶段；最新为 12 个启用节点、12 个组，完整盘点见 [当前生产状态](CURRENT-STATE.md)。
体检阶段只读盘点生产数据、拉取实际 HTTPS 订阅，对照官方资料审阅生成器，并在本地修复已确认的序列化问题。当时没有部署、修改生产业务数据、提交或推送；订阅访问会正常更新访问统计，自托管规则资源拉取可更新既有缓存。用户后续授权的部署及验收见末尾记录。
## 之前检查到哪里
[2026-10-03 验证记录](SURGE-FIX-2026-10-03.md) 已包含实际 Clash 订阅的 `mihomo -t`，以及 Shadowrocket conf 的 HTTPS 响应与候选一致性。已有测试覆盖两端的 PROTOCOL 处理、Surge AI DNS 不误传给其他端，以及 Shadowrocket 策略名不加引号；还没有两端节点、组、规则的系统体检或 iOS／Android 真机验收记录。
## 官方依据及边界
- Android 的目标是 **ClashMeta／mihomo**，不是早期 Clash 内核。依据 [mihomo 节点通用字段](https://wiki.metacubex.one/config/proxies/)、[VMess](https://wiki.metacubex.one/config/proxies/vmess/)、[SS](https://wiki.metacubex.one/en/config/proxies/ss/)、[TLS](https://wiki.metacubex.one/config/proxies/tls/)、[Hysteria2](https://wiki.metacubex.one/config/proxies/hysteria2/)、[策略组](https://wiki.metacubex.one/config/proxy-groups/)、[url-test](https://wiki.metacubex.one/config/proxy-groups/url-test/)、[fallback](https://wiki.metacubex.one/config/proxy-groups/fallback/)、[规则](https://wiki.metacubex.one/config/rules/)、[规则资源](https://wiki.metacubex.one/config/rule-providers/content/)，必要时核对 [官方规则解析源码](https://github.com/MetaCubeX/mihomo/blob/Meta/rules/parser.go)。本机验证内核为 mihomo 1.19.32；它不能代替用户 Android App 内核版本及 VPN 接管测试。
- Shadowrocket 官方来源从 [App Store 开发者页面](https://apps.apple.com/us/app/shadowrocket/id932747118) 指向 [shadowlaunch.com](https://shadowlaunch.com/)。开发者站只提供产品与联系入口，本次没有找到可核实的完整官方配置语法手册。`help.shadowrocket.net` 本次不可访问，也不能从开发者入口验证其归属；第三方手册不冒充官方依据。官方更新记录明确提到逻辑规则、QUIC 匹配和 Hysteria2，足以纠正“客户端不支持逻辑规则”的绝对断言，但不足以证明某一 Surge 写法可以直接透传。
- SS 插件传输的依据为 [Shadowsocks 官方 SIP003](https://shadowsocks.org/doc/sip003.html)：插件只转发 TCP。不能因客户端支持 UDP 就宣称 nginx WS 同端口也提供 SS UDP 服务。
## 体检开始时生产快照（历史）
| 项目 | 结果 |
|---|---|
| 节点 | 30 个，18 个启用，12 个停用 |
| 实际订阅节点范围 | 日本、新加坡、美国各 6 个；VMess／Trojan／SS 各 6 个，均为 WS；当时 HY2 与 RN 节点停用 |
| 组与规则 | 14 个启用组；116 条规则，其中 115 启用；62 个规则集记录 |
| Shadowrocket 节点订阅 | 18 个，排除 0 个；原顺序中 JP／SG 按协议交错 |
| Shadowrocket conf | 14 个组，108 条规则，跳过 7 条 |
| Clash | 18 个节点，14 个组，113 条规则，60 个 provider；跳过 2 条 |
四类实际 HTTPS 产物均成功拉取；修复前本地生成的 Surge／Clash／Shadowrocket 节点订阅／conf 与线上逐字节一致，确认审阅的是当前下发逻辑。真实密码、UUID、域名、Host IP、token、配置和快照只保存在权限受限的临时目录，不进入本报告或 Git。
## 已修复的问题
| 问题 | 修复及实际影响 |
|---|---|
| Shadowrocket JP／SG 混排 | 节点订阅对完整名称做确定性的字符串升序排序，不改变 IR、数据库排序或其他客户端顺序。当前顺序为 JP → SG → US；每国内 SS → Trojan → VMess，同协议 Direct → Warp。未来启用 HY2 时按名称自然排入 |
| Clash 未启用 UDP | 原产物 18 个节点均省略 `udp`，VMess／Trojan 默认不能承载 UDP。现在 12 个 VMess／Trojan 显式 `udp: true`；6 个 SS WS 显式 `false`。纯 TCP SS 和 HY2 的占位用例也覆盖；UDP 是否成功穿过远端仍需连接验证 |
| Clash 丢失 provider 的 no-resolve | 当前 IP reject RULE-SET 的 `no-resolve` 被丢弃，可能提前解析。现在保留这个参数，不改变规则顺序或业务策略 |
| Clash 逻辑规则只做文字替换 | 原来任意 PROTOCOL 都变成 NETWORK，遇到 STUN／DOH 子条件会产生无效规则，还可能改写匹配值中的文字。现在按结构递归映射 TCP／UDP，支持明确的等价子类型，任一子条件无法表达时跳过整个表达式；保留当前 googlevideo UDP AND 规则 |
| 动态组丢失显式成员 | Clash 正则分支、Shadowrocket 正则／全节点分支原来会丢节点、组或内置成员；现在保留完整有序显式成员，并继续动态收节点。当前生产动态组没有显式成员，所以这是潜在缺陷修复 |
| 测速容差 | 两端 url-test 显式零容差不再被省略；fallback 不输出 url-test 专用 tolerance。当前生产容差为 50，不受零值修复影响 |
| Clash TLS／VMess 字段 | 补上 VMess TLS 与 SS plugin 内层的 skip-cert-verify 映射；VMess IETF cipher 别名转回 mihomo 的名称，未知 cipher 明确排除并过滤组引用。当前节点均 auto、skipCertVerify=false，因此这些修复不额外排除生产节点 |
Shadowrocket conf 的动态筛选仍以 App 内全部节点为来源；显式成员保留的文本和结构经过测试，但没有 iOS 编译器的实际验证。Clash 正则仅作用于动态引入来源，不能把显式成员误当作需要筛掉的动态节点。
## 仍存在的客户端差异与待验项
1. **体检时 Shadowrocket 的 7 条规则缺口**：本生成器保守跳过 `PROTOCOL,STUN`、googlevideo 的 UDP AND、4 个 DOMAIN-SET（reject／apple_cdn／download／cdn）和 SMTP 文本 URL-REGEX。同日后续删除 apple_cdn 规则后，最新产物跳过 6 条，生成器范围没有因此扩大。对应广告拦截、CDN 策略和 UDP 防护不能声称与 Surge 等价。官方版本记录表明逻辑规则支持实际存在；后续应以 App 内帮助和 iOS 编译／匹配日志核实具体语法，再缩小跳过范围。本次已修正源码注释和 AGENTS.md 的错误能力断言。
2. **Shadowrocket RULE-SET,LAN 与 PROCESS-NAME**：当前产物保留一个 LAN 内置引用及一个 macOS 进程名规则，尚无官方语法证据或 iOS 匹配结果。56 个远程规则集 URL 可达并不证明这两个本地规则有效；iOS 也不能据 macOS 进程名期待相同匹配。
3. **Clash 的 2 条缺口**：STUN 应用协议识别没有 NETWORK 等价物；SMTP 文本 URL-REGEX 被跳过。当前 googlevideo UDP AND 已正确转换。不能用全局拒绝 UDP 代替 STUN 规则，否则会改变业务。
4. **SS WS 没有插件 UDP 转发**：选到这类节点时，UDP 无法由 WS 线路承载。mihomo 会继续向后匹配；可能走其他策略或 FINAL。未擅自新增全局 UDP 阻断、UDP-over-TCP 或改变默认选择。需在设备侧分别核对 VMess／Trojan 与 SS 候选的 UDP 行为。
5. **DNS 与原文段落不等价**：Clash 使用自己的 fake-ip／DoH 配置，不读取 Surge Host、重写、MITM、Script；Shadowrocket 仅复制 General 白名单及 Host／URL Rewrite／MITM，不下发 Header Rewrite／Script。Surge 自动 AI DNS 映射不会应用到两端。当前保留的 Host／MITM 语法、证书安装、DNS／WebRTC 行为仍需设备侧检查。
6. **节点 URI 的扩展字段**：VMess／Trojan 分享链接编码未完整保留 skipCertVerify；HY2 URI 未表达 up/down 限速；SS plugin 的独立 SNI／WS Host 不一定能同时表达。HY2 解析目前还把 pinSHA256 当成跳过证书验证，却没有保存指纹，应在后续协议字段修复中拒绝或完整保留这类输入。当前启用节点 skipCertVerify 全 false、HY2 停用，18 个节点的实际连接字段往返核对通过；这不构成这些潜在输入的支持证明。
7. **特殊字符与资源语义**：Shadowrocket 正则内逗号、规则扩展参数及复用 Surge 原文段落没有完整官方语法验证；Clash 的 Go 正则也不完全等同 JS 正则。当前地区正则只是普通或分支，可以正常解析。映射到不同维护者的规则列表存在内容差异；资源可达／语法通过不保证逐条业务语义与 Surge 相同。
## 体检阶段验证
- 全仓类型检查通过，51 项 Vitest 通过；新增测试覆盖四种节点协议、完整名称排序与 IR 不变、动态组显式成员、零容差、provider 命名冲突／no-resolve、逻辑子规则映射／整条跳过、TLS／cipher、排除后的组引用，并调用本机 mihomo 原生解析器。
- 线上旧 Clash 配置与本地修复候选都通过 `mihomo -t`。60/60 Clash provider 下载成功；把当前资源展开为 152,295 条辅助规则后也通过原生解析，覆盖资源内的 IP-ASN 等类型。展开检查用于核对子规则语法，不替代 Android provider 初始化、域名匹配语义或规则更新行为。
- Shadowrocket 18 个 URI 与原始节点的相关协议字段逐项核对，名称顺序正确；14 个组、108 条规则引用完整，FINAL 唯一且末尾，没有 `use=`。56 个远程规则集属于 Surge 检查已下载的资源。没有官方 iOS CLI，所以这是结构和序列化检查，不能称为 iOS 编译通过。
- 实际 HTTPS Surge 运行 `scripts/check-surge.py --fetch-rulesets`：官方 CLI OK，60/60 资源下载，本地快照 CLI OK，静态域名遮蔽提示 0。候选 Surge 与实际产物一致。
- `git diff --check` 通过。未切换活动配置、启动代理服务、导入 CA、测速或测试节点连接；iOS／Android 的订阅更新、编译、默认选择、规则命中、DNS／WebRTC、TCP／UDP 连接仍需真机验收。
后续本地变更至少执行 `pnpm -r typecheck`、`pnpm test`；Clash 使用独立临时目录 `mihomo -t -d <目录> -f <配置>`。涉及真实订阅仍按 [Surge 变更验证](SURGE-CHANGES.md) 检查实际 HTTPS 产物，生产部署和数据变更分别遵循 deploy／update-db 技能。
## 后续部署与验收：2026-10-04
用户明确授权后，通过 deploy 技能执行 `deploy.sh server --skip-checks`。跳过脚本内重复检查前，已重新完成全仓类型检查、51 项测试、最新生产快照的候选 Surge／Clash 解析与规则集快照校验。
- 部署完成：`server @ 349ab83`，包含工作区未提交的修复；后端源码指纹前缀 `b3aaeb92cba2` 与远端一致，旧源码保留为 `src.old`。systemd active、公网健康及未带 token 的管理接口返回 401 均正常。
- 部署前最新生产节点范围已变为 12 个：日本／新加坡／美国各 4 个 VMess／Trojan 节点。本次保留当前启用状态，没有恢复体检快照里的其他节点或修改业务数据。
- 部署后四类实际 HTTPS 订阅与最新已验证候选逐字节一致。Shadowrocket 的 12 个节点按完整名称升序排列，国家顺序 JP → SG → US，国内 Trojan → VMess，同协议 Direct → Warp。
- 实际 Surge：官方 CLI OK、60/60 规则资源下载成功、本地快照 CLI OK、静态域名遮蔽提示 0。实际 Clash：mihomo 解析通过。
设备需要重新更新节点订阅；此次确认的是线上响应顺序，尚未操作 iOS／Android 客户端。前述客户端能力缺口与真机验收边界仍然适用。没有创建 Git 提交或推送。

48
docs/NET-COFFEE-DNS-2026-10-04.md Normal file
View File

@@ -0,0 +1,48 @@
# Net.Coffee Claude 页面 DNS 检测与复测（2026-10-04）
本文保留当日页面脚本和本机实测证据；后续独立 AI Nodes 与当前订阅范围见 [当前生产状态](CURRENT-STATE.md)。页面实现及解析器出口可能变化，后续复测仍需重新核对。
用户要求检查 [Claude 检测页](https://ip.net.coffee/claude/) 的 DNS 检测机制，若使用该站域名，则将它加入 AI 分流并在本机复测。本次仅新增一条生产规则并刷新本机既有托管订阅，未部署应用代码。
## 实际检测机制
检查当日页面引用的 [claude-page.js](https://ip.net.coffee/claude/claude-page.js?v=20260916a)，`detectDNSLeak()` 的实现为：
1. 用 `Math.random()` 生成本次测试 token。
2. 依次加载 `https://<token>-1.d.ip.net.coffee/pixel.gif` 与 `https://<token>-2.d.ip.net.coffee/pixel.gif`，通过新主机名触发 DNS 查询。
3. 等待后查询同源 `/api/dns/result/<token>`，读取 `dns_servers` 数组，即该站权威 DNS 观察到的递归解析器 IP。
4. 查询这些解析器的地理信息；若其中有中国解析器，而页面认定的 Claude 出口不在中国，则显示「可能泄露」。此判断不要求 DNS 解析器 IP 等于 Claude 连接出口 IP，也不要求两者来自同一家运营商。
源码前面的注释仍提到 ipleak.net，但实际请求已使用该站自托管的 `d.ip.net.coffee`。检测没有查询 Claude 域名本身；在按域名分流的环境里，探测域名使用普通国内 DNS，不能单凭此结果认定 Claude 域名也使用国内 DNS。若接口未返回解析器，该页面会显示「DNS 加密或未暴露出口」；空结果也不能证明没有泄漏。
## 生产规则
经管理 API 新增启用的自定义规则：
```ini
DOMAIN-SUFFIX,ip.net.coffee,"🤖 AI"
```
后缀匹配同时覆盖页面根域和随机探测子域，精确 `DOMAIN,ip.net.coffee` 无法覆盖后者。新规则放在现有 AI 规则段末尾、广告和普通业务分流之前；既有协议防护、Unbreak、其他规则的相对顺序及唯一启用的末尾 FINAL 保持原状。
Surge 生成器由该规则自动派生：
```ini
ip.net.coffee = server:https://1.1.1.1/dns-query
*.ip.net.coffee = server:https://1.1.1.1/dns-query
```
已有 `encrypted-dns-follow-outbound-mode` 与 `1.1.1.1/32 → AI` 规则使该 DoH 查询随 AI 出口。没有修改全局 DNS、手写 Host、策略组成员或节点。
## 备份与验收
写入前在线备份：`/opt/proxy-station/data/backups/before-add-ai-net-coffee-dns-20261004-111830.db`，已收紧为 root 属主、600 权限。敏感 API 快照、实际订阅和活动配置备份仅保存在权限受限的本机临时目录。
- 重读确认规则从 129 条变为 130 条，仅新增上述规则；原规则字段和相对顺序保持一致，组、节点及设置重读与变更前相同。
- 从实际 HTTPS 入口拉取 Surge 与 Clash 订阅，核对托管 self URL、新规则和两条派生 Host 映射。
- `scripts/check-surge.py --fetch-rulesets` 通过官方 Surge CLI 和 49/49 规则集快照校验，静态域名遮蔽提示为 0；Clash 的 `mihomo -t` 通过。
- 本机原活动配置的托管 URL 与此次生产订阅一致。备份后用 `surge-cli managed-profile update` 更新同一托管配置，并在重载生效后确认有效配置包含新规则及 DNS 映射，原 AI 选择保持不变。
- 本机 `rule explain` 确认根域与探测子域命中 AI；`dns trace` 确认探测子域使用 `https://1.1.1.1/dns-query`。
- 同一个 Chrome 检测页修改前刷新显示中国电信 DNS「可能泄露」；修改后刷新显示美国 Cloudflare DNS「未检测到泄露」，Claude 连接出口保持原美国线路。WebRTC 显示「已禁用或无泄露」。
这是该网站、该浏览器和本机 Surge 的实际 DNS 复测；其他设备、其他客户端及远端代理解析器没有在此次测试中验收。网站测试实现与外部规则集后续可能变化，维护时应重新检查探测主机名。

41
docs/PROXY-AUTOMATIC-2026-10-04.md Normal file
View File

@@ -0,0 +1,41 @@
# Proxy 与 Automatic 选择链（2026-10-04）
最新节点范围、组成员及规则数量集中在 [当前生产状态](CURRENT-STATE.md)。下文业务约束已衔接后续修改；操作与备份记录保留统一代理入口时的阶段证据。
当前生产配置按用户要求由 Proxy 控制普通代理流量的出口。已有数据库通过管理 API 调整，原始初始化模板未修改，不用规则 reset 恢复旧引用。
## 业务约束
- 不允许规则直接指向 `⚡️ Automatic`；普通代理规则指向 `🚀 Proxy`。
- 只有 Proxy 的成员列表包含 Automatic。AI、NoAuto 和其他组不独立引用 Automatic。Speedtest 组与其专用规则在同日后续调整中已删除。
- Proxy 保持 `select`，成员顺序为 Automatic、All Nodes、新加坡、美国、日本。用户在客户端选择 Automatic 时，匹配 Proxy 的业务流量才沿 Automatic 选出口；选择其他成员则使用对应成员。
- Automatic 为 `url-test`，保留新加坡、美国、日本三个地区组；这三个地区组本身也为 url-test。沿用 `interval=300`、`tolerance=50`。Surge 用 General 的 `proxy-test-url` 或节点 `test-url`，不输出组级 `url=`；Clash／Shadowrocket 使用组的 `http://cp.cloudflare.com/generate_204`。
- AI 保持 select，成员为美国、新加坡、日本、🧠 AI Nodes。🧠 AI Nodes 是同日后续新增的独立 select 组，直接收纳全部节点，节点列表与 All Nodes 相同，按完整名称升序输出，两个组各自保存选择；见 [AI Nodes](AI-NODES-2026-10-04.md)。NoAuto 保持 select，只含 Mainland。
- AI、Streaming、Bybit、直连、拦截和 FINAL 等原有分流继续独立生效；此次没有把全部流量统一改到 Proxy。FINAL 仍指向 NoAuto。
以上约束针对业务请求的策略路径，不等于关闭客户端测速或手动测试。
当前组显示顺序为 Proxy、Automatic、All Nodes、美国、新加坡、日本、AI、🧠 AI Nodes、Streaming、Bybit、Mainland、NoAuto。同日后续删除 Speedtest、集中排列 AI 规则、加入 Net.Coffee 检测域名并新增 AI Nodes 后，现状为 12 组、130 条规则、21 个成员；详情见 [AI 与广告优先级](AI-PRIORITY-2026-10-04.md)、[DNS 复测](NET-COFFEE-DNS-2026-10-04.md)与 [AI Nodes](AI-NODES-2026-10-04.md)。下文备份与数量记录的是本次统一代理入口时的阶段性状态。
## 统一代理入口阶段的数据变更
将 20 条原先指向 Automatic 的规则改到 Proxy：
| 类型／规则集 | 范围 |
|---|---|
| RULE-SET／DOMAIN-SET | Emby、Facebook、Instagram、Threads、Discord、GitHub、substore、CDN 两条、global_plus、global |
| DOMAIN／DOMAIN-SUFFIX | api.amplitude.com、vercel.app、nssurge.com、surgee.me、www.torrentmac.net、cloudflare.com、jable.tv、m.cmx.im、api.themoviedb.org |
另将 Automatic 类型改为 url-test，从 AI／Speedtest／NoAuto 各移除一个 Automatic 成员。重读确认 12 个组、130 条规则、22 个组成员；没有直接指向 Automatic 的规则，唯一父组为 Proxy。其他规则字段与相对顺序、其他组配置、节点和设置均保持原状，唯一启用 FINAL 位于末尾。
x.com、twitter.com、bing.com、www.bing.com 原先由 global 接到 Automatic，当前 global 策略已改为 Proxy；后续出口由 Proxy 的客户端选择决定。Apple／Global Services 组及其专用规则、AI 的 Bing 专用规则仍维持已删除状态。
## 统一代理入口阶段的备份与验证
在线备份：`/opt/proxy-station/data/backups/before-proxy-gates-automatic-20261004-104820.db`，root 属主、600 权限。敏感 API 快照和实际订阅只存放在权限受控的私有临时目录。
实际 HTTPS Surge、Clash、Shadowrocket conf 均确认 Automatic 为 url-test、没有规则直接指向 Automatic、Proxy 为唯一父组、AI／Speedtest／NoAuto 已移除该选项，global 指向 Proxy。Surge self URL 正确；官方 Surge CLI 与 50/50 远程规则集快照校验通过，静态域名遮蔽提示为 0；Clash 结构与 `mihomo -t` 通过，FINAL/MATCH 末尾兜底保留。
Shadowrocket 仅做产物结构检查，没有真机编译或连接验收。未切换本机活动配置或修改设备已保存的策略选择；设备需要刷新订阅后获取新配置。此次只修改生产数据与文档，未部署代码。
测速参数含义以 [Surge url-test 官方说明](https://manual.nssurge.com/policy-groups/url-test.html) 为准：interval 是结果有效期，Surge 在组使用且结果过期等条件下重测，不表示固定每 300 秒执行；tolerance 用于减少相近延迟引起的反复切换。

40
docs/SEEDING.md
View File

@@ -1,33 +1,53 @@
# 节点导入指引
proxy-station 不直接读取 edge-nodes 工作区（那里全是真实凭据，保持解耦），节点通过 Web 界面批量粘贴分享链接导入。
节点部署管理已迁入本仓库的 `edge-nodes/`，真实配置与交付产物位于 Git 忽略的 `edge-nodes/private/`。Proxy Station 应用运行时不自动读取该目录，节点仍通过 Web 界面批量粘贴分享链接导入。工作区说明见 [edge-nodes/README.md](../edge-nodes/README.md)。
## 从 edge-nodes 交付文档导入
最新登记、启用与订阅范围见 [当前生产状态](CURRENT-STATE.md)。已有库导入新节点前先读当前节点并预览，避免把整份交付清单重复导入；部署脚本、分享链接存在或重新生成交付页都不表示该节点应被启用。
每个节点目录 `<id>-edge-node-docs/` 已生成好分享链接：
## 从本仓库私有交付文档导入
- `<proto>-<egress>.link`——VMess／Trojan 的分享链接文件（`vmess://`、`trojan://`）
- Shadowsocks 线路没有通用分享链接，用 sing-box JSON（`ss-*-singbox.json`）里的参数手动添加，或按 SIP002 + v2ray-plugin 格式自拼：
每个节点目录 `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/` 下有 `hysteria2://` 链接（含 `obfs=salamander&obfs-password=…`）
- Hysteria2 线路在 `scripts/node-links/` 下有 `hy2://` 或 `hysteria2://` 链接（含 `obfs=salamander&obfs-password=…`），两种 scheme 均可解析
操作：
1. 在 edge-nodes 侧汇总链接：`cat ~/Development/Fusion/Projects/edge-nodes/*-edge-node-docs/*.link`
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. SOCKS5 线路为内部使用，不要导入本系统
3. TUIC／SOCKS5 线路不属于本系统当前支持的类型，单独使用，不导入。线上数据任务按 `update-db` 技能先备份再走管理 API
## 命名建议（影响地区组归类）
模板的地区策略组按**节点名正则**筛选（如 `坡|🇸🇬|新加坡|狮城|SG|Singapore`、`美|🇺🇸|美国|US`）。命名时带上地区词与出口词，例如：
- `SG-vmess-direct`、`SG-trojan-warp`（命中 Singapore 组）
- `US-LA-trojan-direct`、`US-RN-vmess-warp`（命中 United States 组；只写 LA／RN 不会命中任何地区组，会落入 Other）
- `🇸🇬 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)执行；解析／导入成功不能代替设备连接验证。

1453
docs/SURGE-AUDIT-2026-10-03.evidence.json Normal file
View File

File diff suppressed because it is too large Load Diff

224
docs/SURGE-AUDIT-2026-10-03.md Normal file
View File

@@ -0,0 +1,224 @@
# Surge macOS 订阅体检：2026-10-03
本文保留修复前的体检结论；其中行号、缺陷与数量指体检时的源码与订阅快照。已实施的代码／生产修复和后续验证见 [修复记录](SURGE-FIX-2026-10-03.md)，最新盘点见 [当前生产状态](CURRENT-STATE.md)。不要把下文历史缺陷与快照当作当前状态。
实际订阅通过 Surge 6.9.1 的原生语法校验，生产数据与当前生成器一致。但存在规则被遮蔽、DNS 与连接策略不一致，以及管理 API 能接受最终导致无效配置或丢失规则的数据操作。
本次只查询生产管理 API、盘点数据库行数、读取 HTTPS 订阅和公开规则集；没有修改生产节点、规则、设置，没有部署、重启或切换本机活动配置。订阅 GET 按现有业务逻辑正常更新访问计数和访问时间（`server/src/routes/sub.ts:30`）。所有 API 写入复现都使用 `/private/tmp/` 下的隔离数据库与占位凭据。
## 范围与证据
| 项目 | 实际结果 |
|---|---|
| 生产节点 | 30 个，均启用；Surge 输出 22 个，排除 8 个 SS over WS |
| 生产策略组 | 14 个，均启用；无循环引用；地区组有效候选为美国 10、新加坡 6、日本 6 |
| 生产规则 | 116 条，其中 115 条启用；旧 `PROTOCOL,DOH,AI` 已停用 |
| 最终订阅规则 | 118 条：115 条数据库规则 + 3 条生成的 DNS 出口规则 |
| 生产规则集 | 数据库登记 62 个；当前配置引用 60 个不同远程 URL |
| 生产订阅 | 1 个启用订阅，节点范围为空数组，即全部启用节点 |
| 原生语法校验 | Surge Mac 6.9.1（12290），`surge-cli --check` 返回 `OK`、退出码 0 |
| 代码与生产一致性 | 用生产 API 快照重建 IR，由本地实际生成器输出；与 HTTPS 订阅逐字节相同 |
| 远程依赖 | 60/60 URL 本次返回 HTTP 200，合计 166,028 个非空、非注释条目，无 FINAL 条目 |
| 使用本次规则集快照的校验 | 将远程 URL 替换为临时本地文件，再用官方 CLI 校验：`OK` |
配置指纹、规则集指纹和复现结果见 [脱敏证据](SURGE-AUDIT-2026-10-03.evidence.json)。报告中的 `seq` 是数据库从 0 起算的顺序；“配置第 N 行”对应本次实际 HTTPS 响应。报告和证据不包含订阅 token、真实节点密码、UUID、节点地址或私有 Host IP。
校验能力以 [Surge 官方 CLI 文档](https://manual.nssurge.com/tools/cli.html) 为依据。CLI 返回 OK 证明配置可解析，不能证明每个规则都会被命中，也不能代替节点连接、解锁或泄漏测试。
P1 表示可导致配置不可用、规则丢失或重要控制失效；P2 表示行为偏差或需要修正的兼容性问题。静态推导的网络影响和依赖设备开关的风险明确另行说明。
## 已确认的业务代码缺陷
### C1 · P1：重置规则在存在自定义规则时失败，并先删除模板规则
`server/src/routes/rules.ts:60` 调用 `seedRulesFromTemplate(db, { keepCustom: true })`。`server/src/db/seed.ts:52` 读取自定义规则后只删除模板规则，随后在第 63 行把仍在表中的自定义规则再次 INSERT。自定义规则主键重复，且这些操作没有事务包裹。
隔离数据库复现结果：
```text
首次初始化：89 条模板规则
新增自定义规则：HTTP 201，合计 90 条
POST /api/rules/reset：HTTP 500
错误：UNIQUE constraint failed: rules.id
操作后：模板规则 0 条，自定义规则 1 条
```
生产快照中存在自定义规则，具备触发条件。**本次没有在生产调用 reset**，没有认定生产发生过此故障。
修复建议：把整个重置过程放入事务；保留自定义规则时更新其顺序，或在事务内明确删除后重插，避免重复主键；同时明确“重置”究竟是否保留自定义规则。现有 update-db 技能描述为清掉自定义规则，与当前代码的 `keepCustom: true` 意图不一致，需要一起纠正。
### C2 · P1：FINAL 并未得到完整保护，普通操作可使全部订阅无效
`server/src/services/ir.ts:102` 先过滤 `enabled=true`；后面的 FINAL 特判只处理策略引用失效，不能保住已被停用、删除或改成其他类型的 FINAL。`server/src/routes/rules.ts:83` 和第 92 行允许停用及删除唯一 FINAL，排序接口也没有校验末尾位置或完整 ids。
隔离 API 复现：创建 FINAL 返回 201，停用返回 200，生成器输出中 FINAL 数量变为 0；官方 CLI 返回：
```text
Rules must end with FINAL
```
当前生产恰有一条启用的 FINAL，位于末尾，因此当前配置通过校验。问题在后续编辑入口。官方要求规则以启用的 FINAL 结束；`dns-failed` 只是 DNS 失败时选用其策略，不会补回缺失的 FINAL。[FINAL 规范](https://manual.nssurge.com/rules/final.html)
修复建议：在写入时保护唯一末尾 FINAL，完整校验排序，拒绝产生无效状态的修改；生成侧再验证，不要仅靠注释声称“永远保留”。
### C3 · P1：输入与序列化允许合法 API 请求生成无效 Surge 配置
`shared/src/schemas.ts:6` 对节点名只校验长度；`server/src/services/generators/surge.ts:51` 直接拼接声明名。规则值在第 117 行直接拼接；`quoteName()` 只为策略引用加引号，没有完整处理引号／反斜线。
实际路由的隔离复现：
| 请求 | API 结果 | 官方 CLI 结果 |
|---|---|---|
| 新建名为 `Bad = Name` 的 VMess 节点 | 201 | `Unknown proxy type: Name = vmess` |
| 新建 URL-REGEX，值为 `^https://example.com/(a\|b),?c` | 201 | 把 `?c` 误当策略名，拒绝配置 |
表中正则的 `\|` 仅为 Markdown 表格转义；实际测试值使用普通 `|`。
Surge 对含逗号的正则值要求引用；新版本还有明确的引号、反斜线转义规则。这是已用官方解析器复现的错误，不是按自建解析器猜测。[HTTP 规则](https://manual.nssurge.com/rules/http.html)、[配置引用格式](https://manual.nssurge.com/profile/format.html)
修复建议：区分声明名、策略引用、普通规则值、逻辑规则表达式的编码规则；拒绝不能安全表达的名称和换行输入。逻辑规则内部的逗号不能简单按普通字符串一律引用。
### C4 · P1：策略组循环可通过 API 写入，导致整个配置被拒绝
`server/src/routes/groups.ts:21`、第 38 行和第 77 行没有图循环检查。隔离测试建立 `A → B → A`，两次新建均返回 201，IR 保留这些引用；官方 CLI 拒绝：
```text
Loop reference is found in the policy group: A.
```
当前生产 14 个组没有循环。修复建议：新建、修改成员与改名时，在事务内校验引用存在、类型正确及图无环；不能把存在性检查当成循环检查。
### C5 · P2：filterRegex 分支丢弃显式成员，只保留第一个来源组
`server/src/services/generators/surge.ts:85` 在存在正则时不输出 `memberNames`，非 includeAllNodes 情形也只取第一个 group 成员。
占位 IR 复现：输入组同时有显式 `DIRECT`、`includeAllNodes=true` 和正则，输出只有动态来源与正则，DIRECT 被丢弃。官方规定正则只作用于动态导入的成员，显式成员不受过滤；`include-other-group` 可包含多个来源组。[策略成员导入](https://manual.nssurge.com/policy-groups/policy-including.html)
当前生产的三个地区组没有显式成员，暂不触发。修复建议：完整保留显式成员和多个动态来源，分别应用 Surge 规定的语义。
### C6 · P2：VMess 参数映射不完整
`server/src/services/generators/surge.ts:13` 没有输出 VMess 的 `skipCertVerify`，忽略 `security`，并无条件输出 `vmess-aead=true`。占位测试确认 `skipCertVerify=true` 不出现在结果中；`alterId=64` 也仍输出 AEAD。
官方要求 AEAD 设置与服务端匹配，并支持 TLS 证书校验参数及指定的加密方式。当前生产 VMess 均为 `alterId=0`、`security=auto`、`skipCertVerify=false`，没有证据表明现有节点因此连接失败。[VMess 规范](https://manual.nssurge.com/policies/vmess.html)、[TLS 参数](https://manual.nssurge.com/policies/tls.html)
修复建议：在能力层拒绝无法表达的旧协议组合，或按官方参数转换；不能让用户输入被静默忽略。所有输入字段都应有明确的支持／转换／拒绝行为。
## 体检时生产配置中的行为问题
### D1 · P1：两条例外规则被更早的拦截集覆盖
本次下载的 `https://ruleset.skk.moe/List/non_ip/reject.conf` 含有对 `amplitude.com` 的 DOMAIN-SUFFIX，以及对 `appsflyer` 的 DOMAIN-KEYWORD。
| 域名 | 更早匹配 | 后面的例外规则 |
|---|---|---|
| `api.amplitude.com` | seq 11，REJECT | seq 94，Automatic |
| `inapps.appsflyer.com` | seq 11，REJECT | seq 66，Bybit |
现有例外不会覆盖早先的匹配。结论针对 Rule-Based 模式及本次规则集快照中的域名匹配；生产规则没有 pre-matching 标记，客户端资源可能存在缓存差异，未宣称已观察到设备上的请求失败。官方规则顺序是首条匹配决定策略。[规则顺序](https://manual.nssurge.com/rules/overview.html)
修复建议：先确定这两项是需要放行的业务例外，还是需要保持阻断的跟踪服务，再决定是否提前。不能自动为全部跟踪域名放行。
### D2 · P2：YouTube UDP 拦截被提前的 YouTube 规则集遮蔽
数据库 seq 37／配置第 135 行的 YouTube 规则集含 `DOMAIN-SUFFIX,googlevideo.com`，策略为 Streaming；seq 110／配置第 208 行才是：
```ini
AND,((PROTOCOL,UDP), (DOMAIN-SUFFIX,googlevideo.com)),REJECT-NO-DROP
```
对携带 googlevideo.com 主机名的普通 UDP 请求，先前的 DOMAIN-SUFFIX 已匹配，后面的 AND 不会生效。STUN 请求另有更前的拦截，所以不能由此认定 STUN 保护失效。逻辑表达式本身通过官方语法校验。[逻辑规则](https://manual.nssurge.com/rules/logical.html)、[规则顺序](https://manual.nssurge.com/rules/overview.html)
修复建议：若确实要让这类视频流量回落 TCP，把特定 UDP 规则放到相关服务域名规则之前；不要无依据地扩大为全局 UDP 拦截。
### D3 · P2：AI DNS 映射忽略更早的连接例外，且 googleapis 覆盖整个服务族
`server/src/services/generators/surge-ai-dns.ts:13` 收集所有指向 AI 的规则，并把结果整体放在数据库 Host 原文之前，不计算其他策略的更早例外。
本次可确认的例子：
```text
连接策略：seq 8 的 Unbreak 集匹配 update.googleapis.com → DIRECT
AI 域名规则：seq 30，DOMAIN-SUFFIX,googleapis.com → AI
Host 第 224 行：*.googleapis.com → Cloudflare DoH
Host 第 253 行：update.googleapis.com → 原来的国内 DNS
```
Host 首条匹配生效，所以后面的精确 DNS 设置被前面的通配覆盖；连接仍明确直连，而 Surge 自己解析该域名时按 AI Host 项处理。`youtube.googleapis.com` 也被 seq 30 送到 AI，而不会使用后面的 YouTube Streaming 策略。后一项是否符合业务意图需要确认。
官方允许 Host 绑定规则集，当前语法没有问题；问题是两个独立的有序匹配系统没有同样的例外优先级。[Host 映射](https://manual.nssurge.com/dns/local-dns-mapping.html)
修复建议：明确 Google AI 与其他 Google API 的范围，并在生成 Host 时保留需要优先的精确例外。对于连接规则中的 IP、进程或复杂表达式，不能承诺 Host 能完全复刻。
### D4 · P2：靠前的 IP 拦截在业务域名规则前触发 DNS
seq 12／配置第 110 行加载 `https://ruleset.skk.moe/List/ip/reject.conf`，位于 AI、YouTube、Bybit 等规则之前。本次文件含 778 条 IP／ASN 条目，其中 736 条没有 `no-resolve`。
按官方执行语义，没有在更前规则被决定、且目标还是域名的请求会在这些 IP 条目处触发解析；DNS 失败时转到 FINAL 的策略，不继续匹配后面的业务域名规则。这是规范推导的控制流影响，未测量延迟或宣称已抓到泄漏。[IP 与 DNS 规则](https://manual.nssurge.com/rules/ip.html)
修复建议：先确定 IP 黑名单是否应当主动解析所有域名；可考虑在该 RULE-SET 上加 `no-resolve`，或调整域名与 IP 规则顺序。前者会改变对未解析域名的 IP 拦截覆盖，不能当成无代价优化。
### D5 · P2：三个地区测速地址在 Surge 中实际未生效
数据库三个 url-test 组的 `testUrl` 为 Cloudflare 的 HTTP 204 地址，配置第 83–85 行输出为组参数 `url=`。全局 `proxy-test-url` 却为 Apple 的地址，节点没有 `test-url`。
当前官方规范明确组上的旧 `url=` 无效，测速以节点 `test-url` 或全局地址为准。因此 UI 中组级测速地址与 Surge 实际测试依据不一致。[自动测速组](https://manual.nssurge.com/policy-groups/url-test.html)
修复建议：把可用的设置模型改为官方支持的节点／全局测试参数；不要仅在组编辑界面保留一个看似可用但不会生效的字段。
### D6 · P1（取决于设备可达性）：控制接口使用全接口监听和模板默认口令
生产 General 同时配置 Remote Controller 和 HTTP API，均绑定 `0.0.0.0`，认证值与公开模板一致，并开启 Web Dashboard。模板本身也在仓库中，因此这些认证值不能视为私密、独立的设备凭据。订阅生成器原样透传 General。
这表示网络可达的控制接口存在风险；没有检查设备防火墙或公网端口，**不认定当前已暴露互联网**。官方说明这两个入口具有控制 Surge 的能力，HTTPS 不能弥补已知认证值的问题。[控制接口规范](https://manual.nssurge.com/profile/general.html)
修复建议：无远程控制需求时移除；本机需求绑定回环；有局域网控制需求时使用独立凭据与访问限制，避免所有订阅设备共享模板口令。
### D7 · P2（取决于设备开关）：MITM 关闭服务端证书验证
实际订阅有 `skip-server-cert-verify=true` 和 5 个 MITM hostname，但没有 CA 内容或 Keystore 引用。官方说明此项会在 MITM 时关闭真实目标服务器的证书验证；HTTPS 重写需要 MITM 开启和受信任证书。[MITM 规范](https://manual.nssurge.com/http/mitm.html)
未检查设备是否关联其他包含 CA 的本地配置、模块或证书设置，因此不能宣称现在的 HTTPS 重写有效，也不能宣称已经发生 MITM 安全事件。修复建议：若需要 MITM，保留上游验证并在设备侧核实证书与开关；若仅需要代理分流，评估是否应移除不需要的 MITM 与重写配置。
## 需要明确业务意图的配置
这些项目有官方支持，不直接判为错误：
| 项目 | 当前实际行为 | 需要明确的意图 |
|---|---|---|
| `⚡️ Automatic` | 实际类型是 select，默认第一项 Singapore，不跨地区自动选最快 | 名称是否应改，或者确实需要跨地区自动选择 |
| `🎯 NoAuto` | 首项 Mainland → DIRECT；FINAL 指向它并带 dns-failed | 新设备／无保存选择时，未知流量与 DNS 失败是否应默认直连 |
| `🪙 Bybit` | 首项 DIRECT | 是否希望交易业务默认直连，还是应固定所选出口 |
| `📋 All Nodes` 与地区组 | Direct 和 Warp 节点混在一起，地区 url-test 可切换出口 | AI／交易业务是否需要限制出口类型及切换范围 |
| FFSB 的进程直连 | App Bundle 写法有效，但规则在所有服务／通用集合之后 | 是只对未被前面规则匹配的请求直连，还是要整个 App 强制直连 |
| `DOMAIN-KEYWORD,byb` | 对任何包含该短字符串的域名匹配 | 是否可以缩小为已知域名，降低误收范围 |
| SMTP 相关直连 | `DOMAIN-SUFFIX,smtp` 匹配域名后缀；`URL-REGEX,(Subject\|HELO\|SMTP)` 检查 HTTP URL | 是否原本想匹配邮件协议；这两条不会识别邮件正文或 SMTP 命令 |
select 的首项是未选过或保存的选择已失效时的默认；不能据此断言用户当前选中的出口。[手动选择组](https://manual.nssurge.com/policy-groups/select.html)
`PROCESS-NAME,/Applications/FFSB.app/` 的首尾斜线属于官方 App Bundle 前缀匹配模式，不应误报为非法目录规则。[进程规则](https://manual.nssurge.com/rules/process.html)
URL-REGEX 的作用对象是经过 HTTP 引擎处理的 URL，HTTPS 还取决于 MITM；正则中出现 SMTP／HELO 不会使它变成邮件协议匹配规则。[HTTP 规则范围](https://manual.nssurge.com/rules/http.html)
## 已核实正常与验证边界
- HTTPS 订阅的 `#!MANAGED-CONFIG` self URL 与实际请求完全一致；没有回落到内网 URL。当前 `interval=86400, strict=true` 受官方支持，但更新间隔不是推送保证，strict 也意味着更新失败时的可用性取舍。[托管配置](https://manual.nssurge.com/profile/managed-profile.html)
- 生产三个地区正则能收纳当前 22 个可用节点，组引用无环，没有悬空规则策略，FINAL 位于末尾。
- 8 个 SS over WS 排除符合 Surge 的能力范围；不要为了使节点数相同强行输出。[Shadowsocks](https://manual.nssurge.com/policies/shadowsocks.html)
- Hysteria2 的 `salamander-password` 受支持，但官方注明需要 Mac 6.4.3+；实际检查使用 6.9.1。Host 规则集映射需要 Mac 5.10.0+。[Hysteria2](https://manual.nssurge.com/policies/hysteria2.html)
- 60 个外部资源本次均可下载。`global_plus.conf` 只有注释，没有有效条目；这是零覆盖，不是失效 HTTP 响应。资源可动态更新，设备缓存内容可能不同。
- 官方允许规则集中的非法行被跳过并记录警告。因此本次快照检查和 CLI 返回 OK，不能证明全部 166,028 个条目均已被客户端接受；逐条加载警告仍需设备侧检查。[规则集规范](https://manual.nssurge.com/rules/ruleset.html)
- 现有 STUN 拦截的类型、关键字、顺序可用。生产没有全局 PROTOCOL,UDP,REJECT；`udp-policy-not-supported-behaviour=REJECT` 仅是匹配到不支持 UDP 的策略后的回落，不是全局禁用 UDP。[协议规则](https://manual.nssurge.com/rules/protocol-and-network.html)
- Host 的 `server:` 映射只管 Surge 自己的 DNS 客户端，不会因 `use-local-host-item-for-proxy=true` 而改变远端代理的解析器；该开关只作用于 IP 映射。[Host 代理行为](https://manual.nssurge.com/dns/local-dns-mapping.html)
- 当前四个站点的节点域名都有显式 Host IP 映射。没有因此假设永远不会出现 DNS 引导回退；仍需核对所选节点与设备日志。[加密 DNS 引导与回退](https://manual.nssurge.com/dns/encrypted-dns.html)
- 没有切换本机配置、修改保存的策略选择、发起节点测速／带宽测试、导入 MITM CA 或抓取设备业务流量。
## 建议处理顺序
1. 修复 C1–C4：事务、FINAL、字段编码与循环校验，防止普通管理操作毁掉订阅。
2. 明确业务例外后修正规则顺序：D1、D2；同时处理 D3 的 DNS 例外、D4 的主动 DNS 与 FINAL 失败策略。
3. 收紧实际需要的控制入口与 MITM 参数：D6、D7。
4. 对齐测速与节点映射：D5、C5、C6，再明确跨地区／出口选择策略。
5. 对修复后的配置重复官方校验，然后在保留用户选择的前提下进行设备侧请求匹配、DNS、节点连接和业务回归。
本报告完成体检与复现，未实施以上修复。后续修改应分别列出业务代码变更和生产 API 数据变更；当前不要通过 reset 路径更新生产规则。

44
docs/SURGE-CHANGES.md Normal file
View File

@@ -0,0 +1,44 @@
# Surge 订阅变更与验证
2026-10-03 的缺陷与证据见 [体检报告](SURGE-AUDIT-2026-10-03.md)。后续节点、组、规则和设置变更使用本文件的检查；具体 API 与生产备份操作见 update-db 技能。
最新节点启用范围、组成员、名称排序与规则优先级见 [当前生产状态](CURRENT-STATE.md)。历史验收成功不能替代新一轮 API 重读；本机模块和已保存策略选择也不等同于数据库配置。
## 写入前
- 获取最新全量节点、组、规则和设置，明确改动对象及受影响订阅范围。保留策略选择和出口语义；名称正则、节点范围、客户端排除不能只按数据库行数检查。
- 分别核对节点登记总量、enabled、订阅 nodeIds 和客户端能力过滤。当前停用记录继续保留；All Nodes／AI Nodes 使用同一节点来源和独立选择，排序调整先核对 sortOrder，再看完整名称。
- 节点／组名称不能包含配置分隔符、控制字符或与内置策略及另一类实体冲突。导入预览先验证字段；组更新替换完整 members，校验存在性、成员类型及完整图无环。
- 保住唯一启用、末尾 FINAL；完整排序，不通过停用／删除 FINAL 处理兜底。不用 reset 调整生产；reset 的真实含义是事务内恢复模板并保留自定义规则。
- 用官方规则顺序检查业务例外与广告／服务规则集的遮蔽，协议规则不放在提前覆盖其目标的域名规则后。IP 黑名单的 `no-resolve` 会改变未解析目标的拦截覆盖，要记录取舍。
- DNS 对照连接规则、手写 Host、加密 DNS 出口和 FINAL 的 dns-failed 行为。Host 不能表达进程／协议／IP 路由，远端代理解析和浏览器自带 DoH 也不是同一条路径。
- Surge 测速用节点 `test-url` 或 General 的 `proxy-test-url`，不用组级 `url=`。共享订阅不传播默认控制口令，MITM 保留上游证书验证。
## 本地与生产验证
代码修改运行相关单测与类型检查；共享字段或 IR 修改运行全量类型检查及单测，页面修改再构建。数据库／管理 API 测试必须在导入 db 模块之前设置绝对临时 DATA_DIR。
将候选配置存到私有临时目录，文件权限 600，然后运行：
```bash
python3 scripts/check-surge.py /private/tmp/<profile>.conf
python3 scripts/check-surge.py /private/tmp/<profile>.conf --fetch-rulesets
```
脚本先调用本机官方 `surge-cli --check`，再检查 FINAL、无效组级 url、公开控制口令和 MITM 参数。第二条下载当前规则集，以临时本地快照再次调用官方 CLI，并提示更早不同策略对后面域名规则样例的覆盖。提示需要结合业务审阅，不能自动将所有广告域名放行。它不模拟 IP／协议／进程或客户端缓存，规则集非法行也可能被 Surge 跳过；有疑点时查看设备资源加载警告及请求匹配日志。
生产变更先在线备份，确认本次文件为 root 属主、600 权限；不要仅因脚本退出成功就假定权限正确。经管理 API 逐条核对状态，失败停止；在新代码防护部署后再写需要新防护的数据。组成员整体替换，排序使用完整且无重复的 ids；节点权重更新以私有文件保留全部原字段，重读排除排序／更新时间后比对，避免改变协议或凭据。写入后重读变更对象、核对数量与完整顺序，从实际 HTTPS 入口拉订阅并核对 MANAGED-CONFIG 的 self URL，然后重复以上校验。通过回环 API 拉的订阅可能带内网 self URL，不能拿它替代实际 HTTPS 验收。配置中的 token、密码、UUID、Host IP 不落仓库或共享日志。
下载使用 `curl -fsSL --max-time ...`，完成后检查文件存在、非空、预期段落或 YAML 结构，再运行原生校验。串行验证遇错停止；如果管道会隐藏前一步失败，启用 pipefail 或分别读取返回码。mihomo 在配置路径不存在时可能创建默认配置并报告成功，这种输出不能算真实订阅通过。
Clash 受影响时，用独立临时目录运行 `mihomo -t -d <临时目录> -f <配置>`；不要覆盖正在使用的配置或启动代理服务。没有客户端 CLI 的产物用对应单测和结构检查，明确尚缺的真机验收。HTTP 正文不包含 excluded／skippedRules，需将启用节点与实际产物逐项比对；配置规则条数也会受派生规则和客户端跳过类型影响。
Shadowrocket／Clash 的完整差异与待验项见 [2026-10-04 体检](MOBILE-CLIENT-AUDIT-2026-10-04.md)。除解析外还要检查节点完整名称顺序、UDP 能力、动态组显式成员、RULE-SET 的 no-resolve 和实际跳过规则。Shadowrocket 官方更新记录确认存在逻辑规则，不能把生成器的保守跳过范围当成客户端能力断言。
默认不切换活动 Surge 配置、修改保存的组选择或导入 CA。用户授权的本机复测需要更新既有托管配置时，先核对托管 URL 与当前配置，备份并读取最新组选择，再执行 `surge-cli managed-profile update`。该命令可能仅报告已安排重载；须随后读取 `dump profile effective` 和 `policy-group get` 确认真正生效，不把紧接更新的旧规则查询当作最终结果。
组改名时 API 会级联生产引用，但客户端保存选择按组身份存储。核对新组、父组路径和两个独立节点组的最新实际选择；仅迁移原选定节点到新组名，不借验证更换线路。用 `profile diff` 区分原订阅与模块覆盖；数据库 url-test 与设备有效 Smart 等类型可能不同，不直接用客户端覆盖修改数据库。
CLI 成功只证明解析；节点连接、测速结果、DNS／WebRTC 和业务连接仍需设备侧验证。Net.Coffee 的已完成复测限定于本机 Chrome＋Surge 的随机探测域名路径，详见 [DNS 复测](NET-COFFEE-DNS-2026-10-04.md)，不能代替其他设备或 Claude 全部业务请求的验收。
依据：[匹配与 DNS](https://manual.nssurge.com/rules/overview.html)、[FINAL](https://manual.nssurge.com/rules/final.html)、[成员导入](https://manual.nssurge.com/policy-groups/policy-including.html)、[测速](https://manual.nssurge.com/policy-groups/url-test.html)、[Host](https://manual.nssurge.com/dns/local-dns-mapping.html)、[引用格式](https://manual.nssurge.com/profile/format.html)、[CLI](https://manual.nssurge.com/tools/cli.html)。

54
docs/SURGE-FIX-2026-10-03.md Normal file
View File

@@ -0,0 +1,54 @@
# Surge 订阅修复与验证：2026-10-03
本次完成 [体检报告](SURGE-AUDIT-2026-10-03.md) 中已确认缺陷的代码修复和生产定向调整。原体检报告保留为修复前证据，本文数量与验收属于修复当日；最新盘点见 [当前生产状态](CURRENT-STATE.md)，后续变更流程见 [Surge 变更验证](SURGE-CHANGES.md)。
## 修复结果
| 原问题 | 已实施的处理 |
|---|---|
| C1 重置丢失规则 | 事务内恢复模板，更新保留自定义规则的顺序，不重新 INSERT 原主键；自定义 FINAL 不与模板重复；故障注入证明失败整体回滚 |
| C2 FINAL 缺乏保护 | API 拒绝停用、删除、改类型、重复创建、缺失／重复／不完整排序；IR 防御性保证唯一末尾 FINAL；页面关闭无效操作 |
| C3 配置字段编码 | 节点／组名称与控制字符校验，导入预览和写入一致；Surge 值、规则参数转义；逻辑表达式校验结构、无策略子规则和嵌套深度 |
| C4 组循环引用 | 写入前验证完整图、引用存在性与成员类型；组与成员替换、改名级联使用事务；节点／组／内置策略禁止名称冲突 |
| C5 丢成员及单来源 | 保留显式节点和内置成员；包含全部成员组来源；全节点展开去重且显式成员先于自动补充成员 |
| C6 VMess 映射 | 输出 TLS skip-cert-verify 与受支持 cipher；Surge 排除非零 alterId 和不支持 cipher 的 VMess，回报原因；当前生产节点不受额外排除 |
| D1 业务例外遮蔽 | 将 AppsFlyer／Amplitude 既有例外放到广告集合之前，保留原策略 |
| D2 视频 UDP 遮蔽 | googlevideo UDP 拦截移到 STUN 后、业务域名集合前，未扩大为全局 UDP 阻断 |
| D3 DNS 例外冲突 | 手写 Host 优先；按规则顺序保留 AI 之前的非 AI 域名／规则集 DNS 例外；update.googleapis.com 的原精确 DNS 映射不再被覆盖 |
| D4 提前主动解析 | 生产 IP reject RULE-SET 加 no-resolve；对尚未解析域名不再主动查 IP，已解析／IP 字面量仍可按黑名单处理 |
| D5 测速地址无效 | 删除 Surge 无效组级 url=；生产 General 的 proxy-test-url 改为 Cloudflare 204；UI 标明组级地址仅用于 Clash／ShadowRocket；fallback 不输出 tolerance |
| D6 默认控制口令 | 生产与初始化模板移除默认控制接口、Dashboard 及相关 TLS 参数；API／CLI 检查拒绝公开默认口令（包括带引号的写法）；恢复 LAN 访问限制 |
| D7 MITM 上游验证 | 生产与模板改为 skip-server-cert-verify=false；API／CLI 检查阻止重新关闭上游验证 |
`scripts/check-surge.py` 是新增的只读本地验证入口：官方 Surge CLI、FINAL、测速与安全参数、当前规则集快照，以及静态域名遮蔽提示。update-db helper 新增 `--body-file`，敏感 JSON 不进入命令参数，并校验／引用请求路径。它通过 mock SSH 验证 stdin 正文、URL 引用及危险路径拒绝。
## 生产变更
在线备份：`/opt/proxy-station/data/backups/before-surge-audit-fix-20261003-223218.db`，SQLite `PRAGMA quick_check` 返回 `ok`，备份含 116 条规则。
在最新快照上预演三项管理 API 操作，执行前再次确认节点、组、规则、规则集与设置未被其他修改。三个 PUT 均返回 200：IP 黑名单参数、完整规则排序、Surge 设置。没有调用生产 reset、直接写 SQLite 或改动节点凭据、组成员和订阅范围。
变更后盘点保持：30 个节点、14 个组、32 个成员、116 条规则（115 启用）、62 个规则集、1 个订阅、6 个设置。Surge 仍输出 22 个节点，8 个 SS over WS 按能力排除。
前后端已部署；前端／源码指纹、systemd active、公网健康和无 token 管理接口 401 均通过。工作区尚未提交，没有创建 git 提交或推送。
## 验证证据
- 全量类型检查通过，44 项 Vitest 通过；隔离 SQLite 验证真实 API、事务回滚、重置与 FINAL／循环／非法输入保护。
- 本机 Surge Mac 6.9.1（12290）实际校验六组占位配置，覆盖带逗号正则与密码、引号／反斜线、动态成员、TLS 与 cipher、逻辑规则及通知参数、缺失 FINAL 防御。
- 前端 production build 通过。
- 生产 API 快照中的 160 个节点／组／规则对象通过新 schema；候选操作在隔离数据库通过实际 API 路由执行。
- 真实 HTTPS 的 Surge、Clash 和 ShadowRocket conf 均返回 200，并与已验证候选逐字节一致。
- Surge 实际配置官方 CLI：OK；60/60 当前远程资源下载成功，替换为本地快照后官方 CLI：OK，静态域名遮蔽提示 0。
- Clash 实际配置在独立临时目录下 `mihomo -t` 通过；没有启动代理或覆盖活动配置。
- 技能 frontmatter、相对引用、符号链接、脚本语法及 git diff 空白检查通过。技能校验器缺少 PyYAML，使用项目现有 YAML 库适配其解析接口运行原校验规则，没有安装全局依赖。
Surge HTTPS 正文 SHA-256：`0c12a56f72bbc0e1b116570bbcccd2208cdd1ca06568391a7769728ae5499caf`。脱敏校验结果见 [验证数据](SURGE-FIX-2026-10-03.verification.json)。原始 API 快照和含凭据配置仅在权限受限的临时目录，不进入仓库或报告。
## 保留的业务选择与验收边界
Automatic 仍为手动 select，Bybit 与 FINAL 的原默认直连语义、googleapis 的 AI 路由范围、Direct／Warp 混合候选、FFSB 和 SMTP 相关规则未擅自改成其他业务策略。googleapis 范围若要缩小，应另以业务域名范围为依据调整；本次修复其 DNS 例外优先级。
no-resolve 会降低对未解析域名的 IP 黑名单覆盖，这是避免提前主动 DNS 的明确取舍。控制接口默认移除；需要远程控制的设备应在设备侧配置独立凭据与访问限制。设备需更新订阅后应用配置；托管订阅并非即时推送。
本次没有切换设备活动配置、改变保存的组选择、测速连接、导入 CA 或抓取业务流量。CLI 成功不证明实际节点连通、测速结果、业务解锁、MITM 开关／CA 或 DNS／WebRTC 无泄漏；这些仍属于设备侧验收。

68
docs/SURGE-FIX-2026-10-03.verification.json Normal file
View File

@@ -0,0 +1,68 @@
{
"surge": {
"httpStatus": 200,
"candidateExactByteMatch": true,
"bytes": 24963,
"sha256": "0c12a56f72bbc0e1b116570bbcccd2208cdd1ca06568391a7769728ae5499caf",
"nativeExitCode": 0,
"rulesetSnapshotCliExitCode": 0
},
"clash": {
"httpStatus": 200,
"candidateExactByteMatch": true,
"bytes": 25971,
"sha256": "98ff38b94544315bea8782344fa7a547c209be876653382fb3ebe78f45a002dd",
"nativeExitCode": 0
},
"shadowrocket-conf": {
"httpStatus": 200,
"candidateExactByteMatch": true,
"bytes": 12426,
"sha256": "90684cac8b1fb99df6b22b3629f5fab81a72f1bbf39e5fed4351494d819b783a"
},
"backup": {
"file": "before-surge-audit-fix-20261003-223218.db"
},
"schemaVersion": 1,
"date": "2026-10-03",
"client": {
"SurgeMac": "6.9.1",
"build": "12290"
},
"checks": {
"typecheck": "all packages passed",
"vitestPassed": 44,
"nativeSyntheticProfiles": 6,
"webBuild": "passed",
"schemaValidatedObjects": 160,
"rulesetDownloads": 60,
"domainShadowingWarnings": 0,
"skillValidation": "passed",
"apiHelperMockValidation": "passed"
},
"productionCounts": {
"nodes": 30,
"groups": 14,
"members": 32,
"rules": 116,
"enabledRules": 115,
"rulesets": 62,
"tokens": 1,
"settings": 6,
"surgeNodes": 22,
"excludedShadowsocksWebSocket": 8
},
"apiWrites": [
200,
200,
200
],
"backupQuickCheck": "ok",
"deployment": {
"workingTreeUncommitted": true,
"gitHeadBasis": "7358008",
"frontendFingerprintPrefix": "e11cf89c7ea8",
"backendFingerprintPrefix": "062622032ebd"
},
"deviceTrafficValidated": false
}

14
docs/SURGE-PRIVACY.md
View File

@@ -1,5 +1,13 @@
# Surge AI 域名 DNS 分流
当前数据库与实际 HTTPS 产物、节点／组选择链见 [生产状态](CURRENT-STATE.md)。AI DNS 由生成器派生，检查时区分数据库 Surge 原文、最终订阅及设备模块后的有效配置。
Claude／ChatGPT 的精确补充域名、广告拦截优先级例外、官方 inbound IP 兜底与不采用全局 NTP 分流的理由，见 [2026-10-04 AI 规则审阅](AI-RULE-REVIEW-2026-10-04.md)。该次补充保留已有 AI 规则集；新增域名同样由下述流水线派生 DNS 映射。
同日后续已将全部启用的 AI 规则集中排到广告及普通分流之前，按用户选择保留 STUN 阻断和 Google 更新／翻译直连例外。Unbreak 仍在 AI 之前，生成的 Host 映射也保持该顺序；手写 Host 未改动。具体排序、验证及限制见 [AI 与广告优先级](AI-PRIORITY-2026-10-04.md)。策略组显示顺序不决定连接规则或 DNS 匹配优先级。
Net.Coffee 的 Claude 页面通过随机 `*.d.ip.net.coffee` 子域名检测 DNS，而不是查询 Claude 域名。线上已按用户要求加入 `DOMAIN-SUFFIX,ip.net.coffee,🤖 AI`；精确 DOMAIN 根域规则无法覆盖这些探测子域。页面与探测子域名采用 AI 连接及派生 DNS 映射，本机更新同一托管订阅后，由中国电信 DNS「可能泄露」变为美国 Cloudflare「未检测到泄露」。页面检测权威 DNS 观察到的递归解析器，并按地区判断，不要求解析器 IP 等于代理出口 IP；无返回结果也不能证明无泄漏。检测机制、备份与验收边界见 [Net.Coffee DNS 复测](NET-COFFEE-DNS-2026-10-04.md)。
默认 DNS 基于 https://github.com/ClashConnectRules/Surge 的 Surge.conf：阿里、腾讯 DoH 与原来的国内 Host 映射保持直连；不再将全局 DNS 送到 AI，也不再新增全端口 53 接管。
Surge 生成器从启用的 AI 策略规则自动生成 Host 映射。组名支持 `AI` 和 `🤖 AI`。DOMAIN 精确匹配；DOMAIN-SUFFIX 同时生成根域与子域匹配；DOMAIN-KEYWORD 生成通配符；RULE-SET / DOMAIN-SET 直接绑定相同远程列表，由 Surge 更新，无需维护国内域名集合。IP、进程及复合规则无法直接转换为域名 DNS 映射，不生成。Host 与连接规则是独立匹配系统，复杂优先级或例外可能不同。
@@ -12,13 +20,15 @@ DOMAIN,doh.pub,DIRECT
DOMAIN,dns.alidns.com,DIRECT
```
AI Host 映射使用 `server:https://1.1.1.1/dns-query`，放在普通 Host 映射之前。选择其他 AI 线路后 Cloudflare 查询也跟随同一策略组。该 IP 规则也会将访问 1.1.1.1 的其他连接交给 AI 组。
AI Host 映射使用 `server:https://1.1.1.1/dns-query`。手写 Host 项在前，保留精确 DNS 例外；随后按连接规则顺序生成至最后一条 AI 域名规则的映射，先前非 AI 域名／规则集使用 General 的普通 DNS。这样 Unbreak 等先前例外不会被后面的宽泛 AI 映射覆盖。选择其他 AI 线路后 Cloudflare 查询也跟随同一策略组。该 IP 规则也会将访问 1.1.1.1 的其他连接交给 AI 组。
AI 可以选择地区组或独立的 `🧠 AI Nodes`；后者与 All Nodes 的节点来源相同、保存选择独立，详见 [AI Nodes](AI-NODES-2026-10-04.md)。2026-10-04 数据库 General 原文中的 encrypted-dns-follow-outbound-mode 仍为 false，生成器将最终配置派生为 true；不需要为这个差异重复修改全局 DNS 设置。
本功能控制 Surge 自己执行的 DNS 查询。代理目标域名可能由远端代理解析；官方说明 use-local-host-item-for-proxy 仅适用于 IP 映射，不适用于 server: 映射，因此不能声称远端代理的解析器被改为 Cloudflare。浏览器自带 DoH 也不自动按 AI 域名匹配这些 Host 项。
代理服务器域名的解析可能触发加密 DNS 循环依赖，需核对 Surge 日志。线上保留已验证的节点 Host IP 映射供引导使用；节点 IP 变化后更新映射，私有节点 IP 不提交仓库。
数据库 settings/rules 是已有订阅的来源，模板仅首次初始化导入。修改默认 DNS 时使用 update-db 技能备份并经管理 API 更新；不重置规则。移除上一版全局 PROTOCOL,DOH,AI；保留 STUN 阻断及 UDP REJECT，不影响已授权的 WebRTC 防护。
数据库 settings/rules 是已有订阅的来源，模板仅首次初始化导入。修改默认 DNS 时使用 update-db 技能备份并经管理 API 更新；不重置规则。全局 PROTOCOL,DOH,AI 已停用；保留 STUN 阻断，特定 googlevideo UDP 拦截放在服务域名规则之前。生产没有全局 UDP 拦截，不把 UDP 回落参数误认为全局阻断。
导入时关联 General、Proxy、Proxy Group、Rule、Host，并开启增强模式。无需 MITM 证书。更新后清除 DNS 缓存并复测 Surge DNS 请求日志；生成配置验证不是设备泄漏测试。