Skip to content
This repository was archived by the owner on Nov 6, 2026. It is now read-only.

feat: 内置代理订阅节点池(mihomo)+ 双构建 + 健康检查(v4.4.0) - #21

Merged
zhuweiyou merged 21 commits into
mainfrom
feat/mihomo-node-pool
Oct 28, 2026
Merged

zhuweiyou merged 21 commits into
mainfrom
feat/mihomo-node-pool

Conversation

@zhuweiyou

Copy link
Copy Markdown
Owner

概要

免费额度按出口 IP 计量,单机直连很容易被用光。本 PR 增加了「代理订阅节点池」:
配置一个订阅地址,程序在启动阶段拉取订阅、解析成内存节点池并做健康探测,之后按策略
轮换节点;429/403/传输失败自动换下一个出口。

同时引入双构建:

  • Vercel(无内核):-tags nomihomo,二进制约 8.4 MB,只支持 http/socks5 代理列表;
  • 本地 / Docker(带内核):默认构建,约 46.4 MB,Clash YAML 的
    ss/vmess/vless/trojan/hysteria2 等全协议可用。

主要改动

  • 新增 internal/proxypool
    • Clash/Mihomo YAML 由 github.com/metacubex/mihomo/adapter.ParseProxy 解析;
      同时支持纯文本 IP:PORT[:USER:PASS]、URI 行、base64 包裹;
    • sticky(默认,填充:一个节点用到不可用才换) / round_robin(轮询)两种策略;
    • 启动时加载订阅并后台并发健康探测(真实 TLS 握手:1.1.1.1:443 + opencode.ai:443,不消耗额度);
    • 定时健康检查:重试所有死节点 + 每 30 分钟复检健康节点;
    • 429/403 短期冷却、传输失败长期冷却,错误信息脱敏订阅地址。
  • internal/zen:新增 WithDial(),支持「先经代理隧道、再做 Bun uTLS 握手」;默认直连行为不变。
  • internal/chat:带节点池时按策略取节点;429/403/5xx 或节点不通自动换;无节点池时走原路径。
  • internal/config:新增 4 个 PROXY_* 环境变量(见下表)。
  • internal/httpapi
    • /health 返回统计 + 健康节点列表(?state=healthy|unhealthy|cooling|all);
    • /ip 同时返回 {direct, proxy}:直连出口和节点池出口各一份;
    • internal/ipinfo 改为 ipquery / ip-api / 1.1.1.1/cdn-cgi/trace 三来源并发竞速,先回先得。
  • 双构建:mihomo.go(!nomihomo)/ mihomo_stub.go(nomihomo);
    scripts/build-go.sh 固定 -tags nomihomo;Dockerfile 增加 ARG GO_TAGS。
  • 版本号升到 4.4.0。

新增环境变量

变量 默认 说明
PROXY_SUBSCRIPTION_URL 空(直连) 订阅地址(http/https),启动时拉取
PROXY_MAX_ATTEMPTS 5 429/403/5xx 或节点不通时最多尝试几个节点,1–10
PROXY_STRATEGY sticky sticky(填充,用到不可用才换) / round_robin(轮询)
PROXY_HEALTH_INTERVAL_SECONDS 600 定时健康检查间隔,0 关闭,60–86400

Docker 示例:

docker run -d --name oc2api --restart unless-stopped \
  -p 8080:8080 \
  -e API_KEY=your-key \
  -e PROXY_SUBSCRIPTION_URL='https://你的订阅地址' \
  ghcr.io/zhuweiyou/oc2api:latest

构建体积

构建 命令 二进制约
无内核(Vercel) go build -tags nomihomo ./cmd/oc2api 8.4 MB
带内核(本地 / Docker) go build ./cmd/oc2api 46.4 MB

Docker 瘦身镜像:docker build --build-arg GO_TAGS=nomihomo ...

验证

  • go test ./... 与 go test -tags nomihomo ./... 均通过;
  • go vet ./... 通过;
  • 真实订阅(161 个节点)实测:
    • 启动探测:healthy=54 / dead=107,unknown=0;
    • 非流式对话连续 30 次全部 200;
    • 流式(带自定义工具)3/3 成功,有 [DONE]、工具名正常还原;
    • round_robin 下 3 次请求命中 3 个不同节点;
    • /ip 能看到 direct 与 proxy 两份出口,trace 命中时带 warp/loc/colo。

⚠️ 兼容性 / 破坏性变更

  • /ip 返回结构变了:从 {ip, source} 变为 {direct: {...}, proxy: {...}},
    按旧格式解析 /ip 的调用方需要调整。
  • 未配置 PROXY_SUBSCRIPTION_URL 时,对话/SSE/鉴权/整形主链路行为与之前一致;
    仅 /health 在带内核构建下多了 proxy 字段(纯增量)。
  • Vercel 无内核构建:Clash 多协议订阅不可用,/health 也不返回节点列表;
    需要全协议请使用 Docker / 本地版本。
  • 订阅内容目前只在启动时拉取一次,不自动刷新订阅源(健康检查只重探节点,不重新下载订阅)。

已知限制

  • 带 dialer-proxy 的链式节点会跳过;
  • 节点健康状态只在内存,重启会重新探测;
  • internal/httpapi、internal/rpc、api/index.js 仍没有测试覆盖。

Checklist

  • 默认构建 + -tags nomihomo 构建均通过
  • 两种构建的单元测试均通过
  • 真实订阅端到端验证(流式 / 非流式 / 轮换 / 健康探测)
  • README、AGENTS.md 已同步
  • 版本号已升到 4.4.0

节点刷新流程

1. 拉取新订阅(旧池照常服务)
2. 解析出新节点列表
3. 新增/变化的节点先在旧池之外真实探测(TLS 握手)
4. 探测完成后再锁内一次性替换
   ├─ 未变节点:保留原 health / cooling / latency
   ├─ 新节点:带上探测结果,健康的进池,死的直接冷却
   └─ 移除节点:从池里删掉;若是 sticky 的 current 才清空
5. 如果拉取失败 / 解析为空 / 新池探测后 0 个健康节点
   └─ 完整保留旧节点池,不清空、不切换

agent added 21 commits October 28, 2026 09:28
@zhuweiyou
zhuweiyou merged commit fdd0543 into main Oct 28, 2026
2 checks passed
@zhuweiyou
zhuweiyou deleted the feat/mihomo-node-pool branch October 28, 2026 04:10
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant