Repository navigation
Releases
v1.1.1 - 剔除 403 / error code 1034 的 IP
本版修复:不让 403 / 1034 的 IP 被写进 hosts
Cloudflare 对不属于某个 zone 的 anycast IP 会回 403 + error code: 1034:
HTTP/1.1 403 Forbidden
...
error code: 1034
关键是它 TLS 握手正常、证书对该域名合法、响应还比健康 IP 更快。旧版只校验证书,于是这种 IP 会在测量轮里拿到漂亮的 p50、排到推荐位,写进 hosts 之后打开就是一张 Cloudflare 错误页——「优化完更糟」。
这一版把三道口子一起堵上:
1. 测量轮:4xx/5xx 不再算「快」
命中 4xx/5xx 时不再把它记成一个很快的健康样本,而是:
- 记 1 个惩罚样本(999ms)并立刻收工,不再空转满 20 秒窗口
- 给这个 IP 打上
blocked状态码 - 单列一档,排在所有候选最后,不进推荐池
scan 结果里会明确打印:
已剔除 3 个「不服务目标域名」的 IP(HTTP 403,多为 CF 1034):162.159.12.1, 162.159.44.1…
表里这类 IP 的延迟列显示为 —,并标注 HTTP 403(不服务该域名,已排除),而不是一个误导性的「快」数字。
2. scan_verified:不给降级补位的机会
apply 自动选 IP 时,blocked 的候选直接跳过——连「候选不够时降级使用」都不行。写进去是错误页,比慢更糟。
3. apply --ip:增加第二道闸门 http_probe
手动指定 IP 时,除了原来的证书校验,还会真实请求一次 /cdn-cgi/trace:
| 结果 | 处理 |
|---|---|
| 200 / 3xx | 通过 |
| 403 / 4xx / 5xx | 拒写 |
响应里带 error code: 1034 |
拒写(即使状态码不是 403) |
| 无响应 / 超时 | 拒写(「无法确认」而不是默认放行) |
bat 版同步
- 候选读数里保留
edgeRefused:之前ConvertFrom-CfProbeLine已经识别了 4xx/5xx,但合并候选时把标记丢了,导致「不服务」被当成普通丢包候选 - 4xx/5xx 的候选单列
blocked档,表格里显示「不服务」,排序压到最后 Get-CfDecision与Invoke-CfApply都排除edgeRefused,不再拿它做「全部偏慢时降级写」的兜底- 选项 1 的「若写入会写哪两个」也会跳过这类 IP,并在全被排除时明确提示「写 hosts 会拒绝执行」
实测证据(真实网络)
== 闸门探测 ==
162.159.12.1 cert_ok=True http=403 cf_error=1034 证书校验通过 · HTTP 403
162.159.44.1 cert_ok=True http=403 cf_error=1034
104.26.0.1 cert_ok=True http=200 cf_error=0 证书校验通过 · HTTP 200
== 测量轮(4s 窗口)==
162.159.12.1 n=2 blocked=403 p50=999 ← 立即判死,不再采样
104.26.0.1 n=5 blocked=0 p50=840.9 ← 健康
== 端到端 apply --ip ==
apply --ip 162.159.12.1 rc=1 written=False ← 拒写
apply --ip 104.26.0.1 rc=0 written=True ← 正常写入
升级须知
| 项 | 旧 | 新 |
|---|---|---|
| 测量轮的 4xx/5xx | 当成很快的健康样本,可能排第一 | 记失败、标 blocked、立即收工 |
| 自动选 IP | blocked 候选可能被「降级补位」 | 永远跳过 |
apply --ip |
只看证书 | 证书 + 真实请求 /cdn-cgi/trace,403/1034/5xx/无响应都拒写 |
| bat 候选表 | 4xx/5xx 显示成「丢包」 | 显示「不服务」,单独一档且排在最后 |
验证
- Python 39 项断言全绿:含
http_status/cf_edge_error解析、blocked 淘汰与排序、scan_verified跳过、apply --ip对 403/1034/500/空响应的拒写、以及 200 正常写入;H1/H2/H4/H6 回归全部保持通过 - PowerShell 24 项断言全绿:含
edgeRefused传递、blocked档、Get-CfDecision/Invoke-CfApply排除、以及 H1/H2/H4/H6 回归 - 两个
.ps1在 Windows PowerShell 5.1 与 pwsh 7 下语法零错误 - bat 全链路用
CFPIN_FAST=1真实跑过一轮扫描(56 候选 → 12 实测 → 表格),edgeRefused字段正常进入排序
附件
open-design-ip-optimizer-bat-v1.1.1.zip—— bat 版解压即用fixes-403-1034-v1.1.1.patch—— 相对 v1.1.0 的补丁(只含本次 403/1034 修复)fixes-all-v1.1.1.patch—— 相对 v1.0.0 的累计补丁(v1.1.0 + v1.1.1)
仍然存在、本版未覆盖
- H7/H8:提权执行用户可写目录里的脚本、
CFPIN_HOSTS_FILE可指向任意路径 - H9:原地重写降级路径非原子
- 测速正确性系列:
--domains未透传给测速轮、--full漏扫104.24/14、排序键不含 colo、p95 惩罚值语义在慢链路上会失真
v1.1.0 - hosts 安全修复(编码保真 / 标记段 fail-closed / 备份只做一次 / 修提权参数)
本版修复
这一版只做一件事:别把用户的 hosts 改坏。四条都来自对 db618a4 的审计(每条都有可复现的实测证据)。
H1 非 UTF-8 的 hosts 不再被损坏
中文 Windows 上 hosts 常被存成 ANSI/GBK,少数工具会写成 UTF-16。旧版按 UTF-8 errors="replace" 读、按 UTF-8 写回,中文注释会被永久替换成 U+FFFD,revert 也救不回。
现在按 BOM(UTF-8 / UTF-16 LE / UTF-16 BE)→ 严格 UTF-8 → 系统 ANSI(cp936)→ latin-1 兜底 的顺序探测编码,写回时沿用同一编码 + 同一 BOM。而且写入前会以「即将被替换的那个文件」重新探测,不依赖进程里残留的全局状态。
| hosts 编码 | 旧版 | 新版 |
|---|---|---|
| GBK / ANSI 中文注释 | 变成 U+FFFD,不可逆 | 逐字节还原 |
| UTF-8 带 BOM | Python 勉强过 / bat 丢 BOM | 两者都保留 BOM |
| UTF-16 LE | 整文件乱码 | 逐字节还原 |
H2 标记段不完整时拒绝写入(fail-closed)
只有 BEGIN 没有 END(或 END 在前、BEGIN 嵌套)时,旧版删除标记段的逻辑会把 BEGIN 之后直到文件末尾的内容全部删掉——包括用户自己的内网映射条目,revert 也无法恢复。
现在新增标记段状态判断(none / ok / broken):
apply、revert遇到broken直接失败(Python 退出码 3),打印原因并提示先手工修 hosts,不改动文件status会输出[警告] ... 标记段不完整- Python 提供
--force逃生口(明确提示"会删除到文件末尾")
H4 备份只在首次运行时做一次
旧版:
- Python 备份名只精确到秒,同一秒内两次写入(典型是
apply后立刻revert)会互相覆盖,把唯一的原始备份顶掉 - bat 每次都用
-Force覆盖固定名hosts.bak,第二次写入后备份里已经是 pin 过的版本
现在两边统一为固定的 hosts.bak,只在备份不存在时创建一次,之后任何写入都不再覆盖;revert 不再生成备份。apply 的输出会区分"本次已创建原始备份"与"备份已存在,未覆盖"。
H6 菜单提权时的参数拼接 bug
cfpin.ps1 用 -join ' ' 拼参数,$Action 为空(双击 cfpin.bat 无参数 → 菜单)时拼出:
-NoProfile -ExecutionPolicy Bypass -File "..." -Action -KeepOpen
提权进程报 Missing an argument for parameter 'Action',窗口一闪而过、ERRORLEVEL 还是 0 —— 主推的双击用法下,非管理员用户选「2 测速并写入」/「3 常驻」实际什么都没发生。
改成数组形式的 Get-CfElevatedArguments:$Action 为空时不传 -Action。
升级须知
| 项 | 旧 | 新 |
|---|---|---|
| 备份文件名 | hosts.bak.<时间戳>(Python)/ hosts.bak(bat) |
统一 hosts.bak,只创建一次、不覆盖 |
| 标记段不配对 | 静默删到文件末尾 | 拒绝执行,Python 退出码 3;--force 可强行执行 |
revert |
会再生成一份备份 | 不再生成备份 |
status |
不感知坏标记段 | 输出 [警告] 标记段不完整 |
| hosts 编码 | 一律 UTF-8 读写 | 保持原编码与 BOM |
验证
- 补丁可
git apply --check干净打到db618a4 - Python 21 项 / PowerShell 16 项断言全绿(GBK、UTF-8 BOM、UTF-16 hosts 的
apply → revert逐字节往返;broken时文件零改动;单份备份;连续 apply 幂等;提权参数能正常启动子进程) - 两个
.ps1在 Windows PowerShell 5.1 与 pwsh 7 下语法零错误,保持 CRLF + UTF-8 BOM - 测试全部跑在
%TEMP%副本上,不碰真实 hosts、不联网、不提权
附件
open-design-ip-optimizer-bat-v1.1.0.zip—— bat 版解压即用(与上一版附件结构相同)fixes-h1-h2-h4-h6.patch—— 相对db618a4的完整补丁
已知剩余问题(本版未修)
- H3(建议优先修):Python 的写前"证书闸门"只看 TLS 握手,不判 HTTP 状态码,
403 / error code 1034的 IP 仍可能被写进 hosts(打开是错误页)。bat 版的CertCheck已经是对的,可直接移植;上游 PR #1 也有现成改法。 - H7/H8:提权执行用户可写目录里的脚本、
CFPIN_HOSTS_FILE可指向任意路径 - H9:原地重写降级路径非原子
- 测速正确性系列(
--domains未透传、--full漏段、排序不含 colo、p95 惩罚语义)
细节见仓库内 README.md 与 bat/README.md 的「安全」段落。
v1.0.0 - 新增 PowerShell 内核版(无需 Python)
新内容
新增 bat/ 目录:同一套测量口径的 PowerShell 实现,Windows 自带 PowerShell 5.1 直接跑,
不需要 Python、不需要 Node。
双击 cfpin.bat,三个选项:
- 执行一次测速并展示结果 —— 粗筛 56 个候选 → 读落地机房 → 实测 12 个(每个 20 秒窗口),只显示,不改 hosts
- 测速并自动写入 hosts —— 写前对每个候选做真实证书链 + 主机名校验,通过后写 1~2 个到
CLOUDFLARE-PIN标记段 - 常驻检测和切换 —— 当前线路 3 秒采样、候选 5 分钟一轮,快 150ms 就自动换
口径与 cf_pin.py 一致
- 20 秒采样窗口、超时按 999ms 计入、7.5% 丢包线
- clean / ok / degraded 三档,degraded 一票否决;clean 与 ok 之间按 p50
- 连接层失败重试一次(SJC 的 SYN 挂死实测重试 7/7 成功),重试过最高只给 ok
- 写前真实证书链 + 主机名校验,并确认边缘真的在为该 zone 服务(避免
error code: 1034那种「证书正常但拒绝服务」的 IP 被写进去) - hosts 标记段格式逐字节一致,两套实现可以互相接管(但不要同时跑)
候选池精简到 56 个
不再扫 162.159/16 + 104.26/16 的 256 个地址,改用实测确认机房的 56 个:
| 段 | 数量 | 机房 |
|---|---|---|
104.17.128–159(主机位 .1,全段) |
32 | SJC |
104.26.0/2/4/6/8/10/12/14 |
8 | HKG |
162.159.128–158 偶数 |
16 | HKG |
实测 56/56 全部存活,无一落远端机房,粗筛从 6 秒降到 1 秒。
为什么留 SJC:amr-link 的回源在美西(Server-Timing: cfEdge;dur=9,cfOrigin;dur=232),
边缘挂 HKG 等于让请求多绕一次跨太平洋往返。
地址分两组
addresses—— 参与探测:候选读数、证书闸门、当前线路基准writeAddresses—— 只参与写入,不测速
实际写入取并集,所以 open-design.ai 会和 amr-link 用同一个 IP写进标记段,
但不让每轮测速多跑一倍采样。
附件
open-design-ip-optimizer-bat-v1.0.0.zip —— 解压即用,里面的 README.md 说明全部选项与口径。