Repository navigation
Releases
ping-rust v0.3.2
What's Changed
- deps: 升级 quinn-udp 至 0.5.16 修复 RUSTSEC-2026-0538 by @Jyanbai in #117
- chore: 从 Linguist 语言统计中排除辅助 Python 脚本 by @Jyanbai in #109
- ci: 强化 Agent 规则与独立审查清单(Agent Pipeline 2.0 第一步) by @Jyanbai in #115
- ci: 新增手动触发的只读 Codex 规划工作流(Agent Pipeline 2.0 第二步) by @Jyanbai in #116
- ci: 门禁策略支持步骤别名,过渡接受菜单回归步骤更名 by @Jyanbai in #118
- fix: 自动检测并升级不支持 Sudoku 的 shoes 内核 by @Jyanbai in #112
- fix: 统一终端 UI 与菜单返回行为 by @Jyanbai in #114
- chore: 准备 v0.3.2 发版 by @Jyanbai in #120
Full Changelog: v0.3.1...v0.3.2
ping-rust v0.3.1
What's Changed
- fix: 移除 VLESS-ENC 配置详情中的 TLS 提示行 by @Jyanbai in #43
- docs: sync v0.3.0 VLESS-ENC release guidance by @Jyanbai in #44
- fix: clarify unknown shoes source and verify legacy upgrades by @Jyanbai in #45
- Add Claude Code GitHub Workflow by @Jyanbai in #46
- ci: dispatch tasks to Codex cloud via /codex comments by @Jyanbai in #49
- fix(codex-dispatch): run codex cloud inside a repo-hint checkout by @Jyanbai in #50
- ci(codex-dispatch): print redacted diagnostics when env lookup fails by @Jyanbai in #51
- ci(codex-dispatch): run codex exec on the runner instead of Codex cloud by @Jyanbai in #52
- fix(codex-dispatch): allow unprivileged user namespaces for the Codex sandbox by @Jyanbai in #54
- fix(codex-dispatch): codex 失败时继续执行以报告原因 by @Jyanbai in #57
- 修复菜单取消、错误恢复、端口修改及首次部署交互 by @Jyanbai in #58
- docs: 添加 AGENTS.md 和 CLAUDE.md(agent 工作规则与审查清单) by @Jyanbai in #59
- ci(release): 发布前要求人工批准并校验 tag 位于 main by @Jyanbai in #60
- ci(codex-dispatch): 支持 CODEX_REASONING_EFFORT 并记录请求的模型设置 by @Jyanbai in #61
- ci: Reality SNI 固定名单与 CI 实测(#62) by @Jyanbai in #65
- ci: 迁移测试容器传入 GITHUB_TOKEN,避免 GitHub API 限流导致随机失败 by @Jyanbai in #66
- docs: 添加 Codex Dispatch 真实 runner 实测记录 by @Jyanbai in #55
- fix: 统一菜单纯文本输入并支持输入 0 返回 by @Jyanbai in #68
- ci: 运行菜单输入终端回归(tests/menu_input.exp) by @Jyanbai in #69
- feat: 自动检测并选择 Reality 与 ShadowTLS 目标 by @Jyanbai in #70
- ci(codex-dispatch): PR 说明写在最终回复里,不要写进仓库文件 by @Jyanbai in #71
- fix(codex-dispatch): 允许在 PR 下发状态评论(pull-requests: write) by @Jyanbai in #73
- feat: 实现可选的 SNI 检测与推荐 by @Jyanbai in #72
- fix: SNI 预检失败时附上脱敏的 shoes 错误摘要 by @Jyanbai in #75
- feat: 重排主菜单 8–10 并显示节点摘要 by @Jyanbai in #77
- ci: Ubuntu 验收的菜单添加流程回应 SNI 方式选择 by @Jyanbai in #78
- ci: Ubuntu 验收和链式代理 systemd 验收在 PR 上运行 by @Jyanbai in #79
- ci: codex 分支的检查失败后自动把日志派回 Codex 修复 by @Jyanbai in #80
- fix: 首次默认部署失败时仍进入主菜单 by @Jyanbai in #81
- ci: Codex Dispatch 不把外部用户的 issue 内容交给 Codex by @Jyanbai in #82
- fix: 菜单首次默认部署前先确认,可跳过 by @Jyanbai in #83
- ci(codex-dispatch): Codex 沙箱读不到凭据和 RUNNER_TEMP,运行前先实测 by @Jyanbai in #84
- fix: 配置与管理状态不一致时菜单仍进入主菜单 by @Jyanbai in #85
- chore(shoes): 固定版本升级到 shoes v0.3.7 by @Jyanbai in #86
- ci: 新增 main-watch,main 上的检查失败时开 issue,纯基础设施失败自动重跑一次 by @Jyanbai in #90
- ci(codex-dispatch): 实测 Codex 沙箱不能绑定回环端口;增加断网检查,prompt 如实说明 by @Jyanbai in #91
- test: 缺少 shoes 时的跳过统一可见,CI 中禁止跳过 by @Jyanbai in #92
- fix(codex-ci-fix): 复用 main-watch 读取日志,摘录不再因 ANSI 颜色被 gh 拒绝而为空 by @Jyanbai in #94
- fix(ci): source matrix 随机密码以 - 开头时不再偶发失败 by @Jyanbai in #98
- ci: 用 Codex 接管独立审查与自动回修 by @Jyanbai in #100
- fix: 补齐 Codex 审查运行依赖并拒绝未完成结果 by @Jyanbai in #102
- feat: 新增 VLESS-XHTTP-REALITY 受管协议 by @Jyanbai in #97
- feat: 为 VLESS-ENC 增加可选 Sudoku 外观 by @Jyanbai in #89
- feat: 新增无加密的 VLESS-Sudoku 受管协议 by @Jyanbai in #103
- ci: 为当前 PR head 增加统一合并门禁 by @Jyanbai in #107
- feat: 统一添加协议菜单并支持快速 AnyTLS REALITY by @Jyanbai in #105
- ci: 增加严格的 Release 发版门禁与公开完整性验收 by @Jyanbai in #108
- chore: 准备 v0.3.1 正式发版 by @Jyanbai in #110
Full Changelog: v0.3.0...v0.3.1
ping-rust v0.3.0
ping-rust v0.3.0
客户端兼容要求
- Reality 客户端:CI 实测 Xray v25.5.16 和 v26.6.27 可以连接,建议使用 Xray 25.5.16 及以上。更早的版本未验证,可能连不上(例如旧版 v2rayN 内置的 Xray),请先升级客户端及其 Xray 内核。
- Snell v3:Mihomo 只支持
aes-128-gcm。新节点默认改为aes-128-gcm,已有节点不自动修改;已有的 chacha20 或 aes-256 节点若使用 Mihomo,需要手动修改 cipher 并重新导出配置。
升级与配置迁移
- 默认 shoes 版本为 v0.3.6。通配符路由规则在升级时自动迁移为 shoes v0.3.6 支持的格式;候选配置先验证,应用失败会回滚。
- 新版 ping-rust 搭配旧 shoes 时,修改配置会提示先升级 shoes。
- 升级顺序:先执行
self-update更新 ping-rust,再执行update把 shoes 升级到 v0.3.6:
sudo ping-rust self-update --version v0.3.0
sudo ping-rust update --method release自更新成功后旧进程会退出,请重新运行 ping-rust,再执行第二条命令。安装了更新但未经验证的 shoes 版本时,请按工具提示决定是否显式允许降级。
新增 VLESS-ENC 预设
- 菜单第 14 项,或执行
sudo prs add vless-enc。默认使用 x25519、native、0rtt、600s,Vision 默认关闭。 - 原生 TCP,不套 TLS 或 Reality,安全性完全依赖 VLESS Encryption。支持 native/xorpub/random 外观、x25519/mlkem768 认证和可选 Vision;random 外观会关闭 TCP splice。
- 支持 Mihomo 导出;不支持 sing-box 或 NekoBox,不支持链式出口或 H2MUX。
- 客户端版本以 CI 实测为准:Xray v26.6.27、Mihomo v1.19.33。Xray 已验证 x25519 的三种外观与 Vision 开关六种组合,以及 native/mlkem768/Vision 关闭;Mihomo 已验证 native/x25519 的 Vision 关闭和开启。其他版本或组合未验证。
- 更改外观、认证或重新生成密钥后,需要重新导入客户端配置。mlkem768 链接较长,可能无法通过二维码导入。
降级限制
添加 VLESS-ENC 节点后不能降级到 v0.2.x,旧版无法读取包含该节点的管理状态。若必须降级,请先在 v0.3.0 中删除全部 VLESS-ENC 节点并备份配置,再执行降级。删除 VLESS-ENC 节点后再降级的其他行为未验证。
ping-rust v0.2.2
ping-rust v0.2.2
默认安装改用固定的 shoes v0.2.7
- 默认一键安装、bootstrap、添加节点时的自动安装和
update --method release现在只安装经过 ping-rust 验证的 shoes v0.2.7,不再请求releases/latest(#29)。 - v0.2.1 及更早版本在上游 10 月 6 日发布 v0.3.x 后会装到未经验证的 shoes。10 月 5 日之后用 v0.2.1 及以前版本新装的用户,可能装的是 v0.3.x。
- 检查:升级到 v0.2.2 后执行
sudo ping-rust status,或在 Update Center 查看状态。如果已装的版本高于 v0.2.7,会提示:当前 shoes vX 未经 ping-rust 验证;可执行 sudo ping-rust update --method release --allow-downgrade 回到 v0.2.7。也可以执行sudo ping-rust info,看第一行的 shoes 版本。 - 回退:
sudo ping-rust update --method release --allow-downgrade。只提示,不会自动降级。
- 检查:升级到 v0.2.2 后执行
安全:修复 RUSTSEC-2024-0449
- YAML 库从已弃用的 serde_yaml(依赖 unsafe-libyaml)换成纯安全 Rust 的 serde-saphyr(#28)。新旧库读写结果经过 golden 夹具比对,已有配置无需任何操作。
- 同时把 quinn-proto 升到 0.11.19(RUSTSEC-2026-0338 至 0342)。
其他
ping-rust --version会在 stderr 额外输出构建 commit(commit <sha>,从 crates.io 源码构建时为unknown)。stdout 仍为ping-rust 0.2.2,旧版 self-update 的校验因此不受影响。- CI 新增反向兼容验收:v0.2.1 Release 二进制能正确读取新版写出的 Reality、SOCKS5 和 Chain 2.0 文件。
- 删除 SOURCE_SNAPSHOT.md,可从 v0.1.9 tag 获取。
ping-rust v0.2.1
ping-rust v0.2.1
新增与修复
- Chain Pool 增加“测试 Pool 内全部节点”,逐项显示可用/失败及耗时。Pool 和多 Chain 轮询仍不是健康感知故障切换。
- Verified Hot Reload 不可用时,显示具体原因及受控重启提示。默认一键安装使用 shoes GitHub Release,监听变更使用受控重启;固定 pin 构建可启用热重载。
- NaiveProxy 自签测试证书按 CA/B Forum Ballot SC-081v3 时间表生成:按证书 notBefore 使用199/99/46天,更早阶段397天,均比该阶段上限少1天。期限逐步缩短,2029年起约每6周需要重新生成。生产环境应使用受信任证书。
- NaiveProxy 添加/查看显示有效期与到期日,status 在剩余不足有效期1/3或过期时警告;菜单和
regenerate-test-certificate提供经过 dry-run、原子提交、受控重启及失败回滚的重新生成操作。 - GitHub API 请求支持可选 GITHUB_TOKEN / GH_TOKEN及有限退避重试;bootstrap失败诊断保留stderr并只上传脱敏摘要。
- README及Wiki同步安装来源、热重载、H2MUX支持范围和证书迁移说明;shoes验证pin保持不变。
NaiveProxy 升级迁移
v0.2.0生成的NaiveProxy自签测试证书有效期过长,与Chromium系客户端不兼容。升级后,缺少有效期元数据的旧证书及超过其发行阶段上限的测试证书需要重新生成:
sudo prs regenerate-test-certificate <配置名称>也可使用“更改配置 → 重新生成测试证书”。完成后重新导出客户端配置并信任新证书。不会自动替换现有证书。
验收证据与边界
2026-10-01,Debian13.4 VPS对HK agent:R1–R3、固定pin切换及P1证据按授权沿用;新FIX_SHA上Naive397→199天迁移、新建、SS2022+ShadowTLS、认证SOCKS5、Hysteria2 UDP、H2MUX、Chain/Pool/BLOCK/DIRECT/断链失败、Update Center降级拒绝、备份恢复哈希和真实reboot后Reality均通过。详见COMPLETION_AUDIT.md,历史失败保留。
Naive实测客户端为sing-box1.14.2 / NaiveProxy150.0.7871.63;不外推其它构建或未来阶段接受边界。同VPS两上游的出口IP无法区分跳数。H2MUX已在Release v0.2.7和固定pin的受验证范围内可用,未新增来源拒绝行为。
v0.2.1 tag 与多平台 GitHub Release 资产已发布,SHA256SUMS 已校验。公开默认安装、零输入 Reality、认证节点受控重启提示,以及 v0.2.0 → v0.2.1 self-update 的实机冒烟全部通过;crates.io v0.2.1 已发布。HK 测试凭据已清理;prs-test 已按备份恢复原始环境。7个持久文件的SHA-256、权限和属主与备份一致,服务enabled/active,原监听恢复,HK使用原Reality节点请求成功且出口IP与VPS一致。watch PID由旧版管理工具正常部署流程自动生成;构建依赖按用户要求保留。历史失败及证据边界详见COMPLETION_AUDIT.md。
ping-rust v0.2.0
ping-rust v0.2.0
Highlights
Unified Update Center
- Main menu option 6 manages ping-rust self-updates, the verified shoes pin, and advanced shoes GitHub Release updates.
- Downgrade protection, shoes provenance, and upstream compatibility monitoring are included.
Verified Hot Reload
- Active profile add, port edit, and non-last delete use verified reload with MainPID continuity when the listener change is observable.
- Atomic config replacement and rollback protect failed reloads; changes without reliable reload verification use the existing restart path.
Chain Proxy 2.0 and Rule-based Routing
- Named nodes and pools, ordered multi-hop chains, hop-level round-robin, and whole-chain round-robin.
- Ordered IPv4/CIDR, IPv6/CIDR, and hostname rules with DIRECT, BLOCK, Chain, round-robin Chain, and default-route targets. IPv6 CIDR and wildcard hostname coverage includes schema validation; traffic E2E coverage is narrower.
H2MUX
- Managed VMess WebSocket TLS, non-Vision VLESS WebSocket TLS, and Trojan TLS client preferences, including eligible Chain nodes.
- sing-box export and Trojan H2MUX data path verified; concurrent streams, half-close, large payload, and padding tested against the pinned shoes revision.
Compatibility notes
- VLESS Vision with H2MUX is rejected. Mihomo H2MUX is not enabled; ordinary URI/QR links do not encode the H2MUX preference. H2MUX UDP is not implemented.
- Pool and whole-chain round-robin are not health-aware failover.
- The production shoes revision remains pinned and is monitored against upstream separately.
ping-rust v0.1.20
Added
-
Managed NaiveProxy support
- TLS + HTTP/2 with ALPN
h2 - trusted certificate production path
- explicit self-signed testing mode
- random username/password
- padding enabled by default
- sing-box export
- TLS + HTTP/2 with ALPN
-
Shadowsocks 2022 + ShadowTLS v3
- shoes-native single-process deployment
- sing-box export
- Mihomo export
- editable SNI/handshake
Compatibility
-
NaiveProxy Mihomo: unsupported
-
NaiveProxy NekoBox: unsupported
-
NaiveProxy URI/QR: unsupported
-
NaiveProxy UDP/UoT: not implemented
-
SS2022 + ShadowTLS v3 URI/QR: unsupported
-
SS2022 + ShadowTLS v3 UDP: not implemented
ACME, NaiveProxy chain outbound, ShadowTLS chain outbound, H2MUX, and other transports are not included in this release.
ping-rust v0.1.19
Full Changelog: v0.1.18...v0.1.19
ping-rust v0.1.18
Full Changelog: v0.1.17...v0.1.18
ping-rust v0.1.17
Full Changelog: v0.1.16...v0.1.17