Skip to content

更新日志 ​

记录 Sublink Worker 的重要版本与功能演进,方便自托管场景快速了解近期变化。

自 v2.0.0 起,更新日志遵循语义化版本规范,版本号与 Git Tag/Release 保持一致;v1.x 记录仅供回溯。

语义化版本(自 v2.0.0 起) ​

[2.5.0] - sing-box 1.14 适配与转换可靠性修复 - 2026-11 ​

本次更新适配 sing-box 1.14,新增 AnyTLS 分享链接支持,并集中修复了一批"单个节点导致整份配置无法加载"和"节点或参数被静默丢弃"的问题。

Added ​

  • AnyTLS 分享链接:支持 anytls:// 链接,包括直接粘贴的链接、远程订阅和 Base64 订阅,可输出到 Clash 和 Sing-Box(#416)。
  • sing-box 1.14 配置档位:按客户端 User-Agent 识别 1.14 及以上版本,规则集下载改用 1.14 的 http_clients;无法识别版本的客户端仍使用兼容性最好的 1.12 档位(#411)。
  • Clash 代理提供者模式支持按国家分组:订阅以 proxy-provider 方式引用时,国家分组通过 use + filter 生成,不再为空(#403、#412)。

Changed ​

  • TUIC 默认校验证书:TUIC 链接以前默认跳过证书校验,现在与其他协议一致,只有显式指定 insecure=1 / allowInsecure=1 才跳过(#447)。
  • 不支持的节点只跳过该节点:目标客户端无法表达的节点(如 sing-box 下的 xhttp/kcp 传输、VLESS encryption、shadow-tls 插件,以及 sing-box 1.11 下的 AnyTLS)现在只跳过这一个节点,不再让整份配置加载失败(#448、#451、#454)。
  • 格式错误的链接会被跳过:一条无法解析的链接不再导致整个请求返回 500,也不再丢掉订阅中排在它之后的所有节点(#452)。

Fixed ​

  • 安全:对 customRules 中的 site/ip 标识做清洗,防止 SSRF(#414);依赖升级修复 undici 的 CVE-2026-6734 与 CVE-2026-9697。
  • 修复 insecure=0 被当作跳过证书校验:分享链接中的 insecure=0 / allowInsecure=0 以前会被当成开启跳过校验,现在会正确校验证书(#447)。
  • 修复 sing-box SS 插件配置无法加载:plugin_opts 改为 sing-box 要求的 SIP003 字符串,插件名也改为 sing-box 认识的名称(#409、#451);sing-box JSON 订阅中的 SS 插件转换到 Clash 时也不再被 mihomo 拒绝(#455)。
  • 修复 Mihomo 下 obfs 失效:分享链接中的 obfs-local 插件名现在会转换为 Mihomo 认识的 obfs,以前会被 Mihomo 静默忽略,导致连接时不做混淆(#451)。
  • 修复 Mihomo 输出丢失 VLESS 参数:保留 VLESS encryption、xhttp-opts 以及 uTLS 指纹(fp)(#449);保留 Reality ML-KEM 选项(#441)。
  • 修复长订阅无法生成短链接:短链接接口支持 POST,不再因 URL 过长返回 414/431(#450)。
  • 修复 sing-box 1.13 起 UDP 失效:移除节点上误加的 network: tcp,调整 hijack-dns 与 clash_mode 的规则顺序(#402)。
  • 修复 sing-box 规则集下载失败:规则集改为直连下载,不再在代理尚未就绪时因走代理而启动失败(#401、#408、#411、#431)。
  • 修复 sing-box DNS 递归:解析节点域名时不再经由代理 DNS,避免以域名作为地址的节点无法启动(#433)。
  • 官方 sing-box 内联订阅:移除仅 fork 版本支持的 outbound provider,远程订阅统一展开为具体节点(#435、#436)。
  • 修复 Hysteria2 端口跳跃丢失:支持 mport 等写法,sing-box 输出改用正确的字段名(#428)。
  • 修复 Trojan 缺省 security 时未默认启用 TLS 的问题(#389)。
  • 修复 Xray 输出丢失订阅流量信息的问题(#362、#382)。
  • 移除 sing-box 已弃用的 block / dns 特殊 outbound,拒绝改用规则动作(#380)。
  • 修复同名节点去重、按输出格式隔离已保存的配置、配置 TTL 为 0 时被忽略的问题(#421、#422、#423)。
  • 修复 Node/Vercel 内存 KV 在 TTL 超过约 24.8 天时立即过期的问题,默认 30 天 TTL 的配置以前会在写入后立刻消失。

Maintenance ​

  • CI 新增真实客户端兼容性检查:每个 PR 都会用 sing-box 1.11 / 1.12 / 1.14 与 mihomo 加载生成的配置,并每周检查 sing-box 最新预发布版本(#453)。
  • 运行环境升级到 Node 22,测试框架升级到 Vitest 4;移除 pnpm-lock.yaml,统一使用 npm。

[2.4.2] - 自定义规则与订阅解码修复 - 2026-04 ​

Fixed ​

  • 修复自定义规则丢失代理选项:Clash、Sing-Box、Surge 配置中的自定义规则出站现已正确包含「节点选择」「自动选择」、手动切换分组及节点列表,之前自定义规则因缺少这些成员而无法被切换(#371)。
  • 修复远程订阅误解码:重写订阅内容解码流程,先识别明文 Clash/Sing-Box/Surge 配置和协议链接,仅当内容确实是 Base64 候选时才解码,避免明文订阅被强行 Base64 解码导致乱码或空配置(#370)。
  • 空 Clash 代理组改为显式报错:当 url-test/fallback 分组没有任何成员时不再静默生成无效配置,改为抛出 InvalidConfigError,便于快速定位上游订阅或合并问题(#378)。
  • 修复 Auto Provider 命名不稳定:使用代理提供者(Proxy Provider)模式时,自动生成的 provider 名称现已在多次构建中保持稳定,避免每次重建配置都出现新的 provider 引用(#379)。

[2.4.1] - 规则源切换与空节点选择修复 - 2026-04 ​

Fixed ​

  • 切换 sing-box 规则源:原规则源 lyc8503/sing-box-rules 账号被封禁,已切换至 MetaCubeX/meta-rules-dat sing 分支,所有规则集 URL 现已恢复正常访问(#367)。
  • 修复空节点选择导致的配置错误:当使用非 Balance 规则且节点列表为空时,不再创建没有成员的 Auto Select 分组,避免 Sing-Box 报错 "missing tags"(#366)。

[2.4.0] - 订阅信息透传与多项修复 - 2026-04 ​

本次更新新增订阅流量信息透传功能,并修复多个影响协议解析、配置构建和跨平台兼容性的问题。

Added ​

  • 订阅流量信息透传:所有订阅端点(/singbox、/clash、/surge)现已转发上游订阅的 subscription-userinfo 响应头,客户端可直接显示剩余流量和到期时间(#354、#363)。
  • src_ip_cidr 自定义规则支持:自定义规则新增 src_ip_cidr 类型,支持基于源 IP 段的分流(#331)。

Fixed ​

  • 修复 Shadowsocks URL 中 Base64 编码的加密方式被 decodeURIComponent 破坏的问题,解决密码含 +、/、= 时的解析乱码(#337、#365)。
  • 修复启用「按国家分组」时自定义规则意外变为全局规则的问题,自定义规则不再包含国家分组作为出站(#256、#364)。
  • 修复 Clash 配置中所有代理类型默认未启用 UDP 的问题(#360)。
  • 修复 Sing-Box 入站配置中残留已废弃 sniff 字段的问题(#357)。
  • 修复 Hysteria2 协议在 security 参数缺失时未默认使用 TLS 的问题(#345)。
  • 修复 esbuild 注入 __name() 导致浏览器运行时崩溃的问题。
  • 修复 Surge 配置解析函数在浏览器运行时不可用的问题(#341)。
  • 修复 VLESS 协议 TLS 默认值缺失及 proxy-providers 模式下 use 字段缺失的问题(#339)。
  • 移除 UTF-8 BOM 字符并强化 toStringArray 输入过滤。

[2.3.2] - 规则路由修复 - 2026-02 ​

Fixed ​

  • 修复 Clash 配置中 rule-providers 同名 key 冲突导致分流规则失效的问题:当规则同时包含域名和 IP 规则集(如 Google、Location:CN)时,IP 规则集会覆盖域名规则集,导致域名流量无法被正确匹配,回落到"非中国"等兜底规则(#334)。

[2.3.0] - Subconverter 外部配置与稳定性修复 - 2026-02 ​

本次更新新增 Subconverter 外部配置导出功能,并修复多个影响订阅转换稳定性的问题。

Added ​

  • Subconverter 外部配置导出:新增 /subconverter API 端点,将项目规则系统导出为 Subconverter 外部配置(INI 格式),可直接用于 Subconverter 的 config 参数(#320 by @Yueby)。
  • 禁用自动选择分组:新增选项允许用户在生成的配置中移除自动选择(Auto Select)代理组。

Fixed ​

  • 修复所有路由(/singbox、/clash、/surge、/xray)未从请求头读取 User-Agent 的问题,旧客户端 UA 检测现已正常工作(#321)。
  • 修复 Clash 旧客户端(如 Merlin)应输出 YAML 格式而非 mrs 格式的问题(#306)。
  • 修复 Surge 类型订阅注释格式问题(#299)。
  • 修复 Sing-Box 订阅无法导入的问题(#297)。
  • 修复 Vercel 部署时请求路径错误。
  • 修复 parseServerInfo 空值导致的 startsWith 报错。
  • 修复自定义规则模式下空选择静默回退到 balanced 预设的问题。

Changed ​

  • 更新依赖以修复安全漏洞。

[2.2.0] - 代理提供者与智能配置 - 2025-12 ​

本次更新引入代理提供者(Proxy Provider)支持、智能配置合并,以及多项协议解析增强。

Added ​

  • 代理提供者支持:Clash 和 Sing-Box 配置现已支持 Proxy Provider,可远程加载代理列表。
  • 智能配置合并:用户自定义的代理组和 Sing-Box outbounds 可与系统配置智能合并并校验。
  • Sing-Box 版本识别:根据查询参数或 User-Agent 自动选择适配的 Sing-Box 配置版本。
  • Shadowsocks 插件解析:支持解析 SS URL 中的 plugin 查询参数,自动映射 SIP003 选项到 Clash plugin-opts。

Fixed ​

  • 修复转换后节点超时问题(#290)。
  • 统一代理请求头中 host 字段为小写,避免大小写不一致导致的解析问题(#286 by @afsfge)。

Changed ​

  • Sing-Box 1.11 DNS 优化:使用 TLS 代理,新增直连 detour,优化阻断规则。
  • 代理提供者引用重命名为自动生成格式,提升 Clash 和 Sing-Box 构建器的 provider 处理能力。

[2.1.1] - 问题修复 - 2025-12 ​

Fixed ​

  • 实现 Surge、Clash 和 Sing-Box 配置的跨格式代理组解析与构建。

Documentation ​

  • 在 README 中添加简洁的项目描述。
  • 更新发布说明中的部署指南 URL。
  • 简化 README.md,更新 .gitignore。

[2.1.0] - 多源支持 - 2025-12 ​

本次更新大幅扩展了输入源支持,现在可以直接粘贴 Clash、Sing-Box、Surge 配置进行转换。

Added ​

  • Clash 配置输入:支持直接解析 Clash YAML 格式配置文件。
  • Sing-Box 配置输入:支持直接解析 Sing-Box JSON 格式配置文件。
  • Surge 配置输入:支持直接解析 Surge INI 格式配置文件。
  • 版本更新检查器:应用内提示新版本,支持一键跳转更新指南。

Fixed ​

  • 修复 VLESS 协议在 Clash 输出中缺少 udp=true 的问题(#272)。
  • 修复 SingboxConfigBuilder 导入路径大小写问题。
  • 修复 GitHub 同步后可能出错的问题(#266)。

Changed ​

  • 「分享链接」输入框更名为「输入源」,更准确地反映其多格式支持能力。

[2.0.1] - 查缺补漏 - 2025-12 ​

  • fix: 自动原链接自动解析回归
  • chore: README 中的 Typo,排版问题

[2.0.0] - 2025-12 ​

Sublink Worker v2.0 继续以“统一订阅管线”为核心,重点解决部署弹性、配置持久化与分享效率。

Added ​

  • 模块化多运行时:解耦配置构建、代理解析与存储适配,Cloudflare Workers、Node.js、Vercel 与 Docker 均可一键部署。
  • 全链路持久化:统一的 KV/Redis/Upstash/Vercel KV 接口,Config Storage 自动托管基础配置与短链,默认 30 天 TTL 可续期。

Changed ​

  • 重构前端组件:全面拥抱 Hono 和 Alpine.js,提供更流畅的使用和二次开发体验。

v1.x 历史记录(未采用语义化版本) ​

以下内容按时间倒序列出,仅概览功能演进,可能缺少版本号与兼容性说明。

2025-11-08 ​

  • feat(config): 按国家分组的代理配置,更新相关翻译。

2025-09-28 ​

  • 修复 Singbox 1.12.0 中部分配置 warning。
  • 其他体验问题修复。

2025-05-02 ​

  • 相同名称代理自动重命名(#175)。
  • 修复 Singbox DNS 配置(#174)。

2025-04-30 ​

  • 完整适配 Sing-Box 1.11。
  • Balanced 规则集添加 Github 以应对近期限制。

2025-04-27 ​

  • 提升 Hysteria2 协议兼容性。

2025-04-23 ​

  • 新增俄语支持(#162)。

2025-04-04 ​

2025-03-31 ​

  • 因 Deploy to Workers 重定向问题更新部署流程。
  • 调整部分过时配置。

2025-03-08 ​

  • 支持自定义 UA。
  • 全面使用 Clash Meta Rule Provider。

2025-02-22 ​

  • 全面支持 i18n。

2025-02-19 ​

  • 更新 💬 AI服务 路由规则。

2025-02-18 ​

  • 添加前端 i18n 支持,后续持续完善订阅逻辑。

2025-01-11 ​

  • 使用代理获取规则集。

2024-12-27 ​

  • 将 sing-box tun 中废弃的 inet4_address 替换为 address。

2024-12-07 ​

  • 手动选择规则时,预定义规则选择框会同步更新为 "custom"。

2024-11-30 ​

  • 添加对旧式 Shadowsocks URL 的支持。

2024-11-23 ​

  • 修复重复点击生成导致短链不可访问的问题。

2024-11-20 ​

  • 修复 sing-box 配置首次下载缓慢的问题。

2024-11-19 ​

  • 改进 UI 交互体验。

2024-11-05 ​

  • 新增保存自定义基础配置功能,优化 UI。

2024-10-15 ​

2024-10-03 ​

  • 支持保存并管理自定义短链接。

2024-09-28 ​

  • (#41 by @Wikeolf)
    • 添加自定义域名关键词支持。
    • 支持重排自定义规则顺序。

2024-09-23 ​

  • 修复 VMess & Shadowsocks URL 中文乱码(#37)。

2024-09-20 ​

2024-09-18 ​

  • 确保 Vmess 转换时 security 选项存在。
  • 修复默认配置缺少出站的问题。

2024-09-15 ​

  • 现在可以自定义短链接路径(#31、#25)。
  • 优化前端显示,简化操作流程。

2024-09-13 ​

  • 优化出站选择的排布(#27)。

2024-09-10 ​

  • 修复 Base64 无法转换多个 HTTP 的问题(#25)。
  • 为生成的链接提供二维码。

2024-09-09 ​

  • 修复 Github 规则无效的问题(#23)。

2024-09-07 ​

  • 修复导入 Base64 订阅出现乱码(#16)。

2024-09-03 ​

  • 📚 教育资源 规则集中新增 geosite-category-scholar-!cn。

2024-09-02 ​

  • 使用 KV 存储短链接,不再依赖 R2。

2024-09-01 ​

  • 自定义规则新增 domain_suffix、ip_cidr、geoip、geosite。

2024-08-25 ​

  • 修复 ClashMeta for Android ≥ v2.10.1 不显示规则集的问题。

2024-08-20 ​

  • 新增自定义规则和对应 API(详见 API 文档)。

最后更新于:

遵循 MIT 许可证