更新日志
记录 Sublink Worker 的重要版本与功能演进,方便自托管场景快速了解近期变化。
自 v2.0.0 起,更新日志遵循语义化版本规范,版本号与 Git Tag/Release 保持一致;v1.x 记录仅供回溯。
语义化版本(自 v2.0.0 起)
[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-datsing 分支,所有规则集 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 外部配置导出:新增
/subconverterAPI 端点,将项目规则系统导出为 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 选项到 Clashplugin-opts。
Fixed
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
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
- 添加 FAQ 文档。
2024-10-03
- 支持保存并管理自定义短链接。
2024-09-28
2024-09-23
- 修复 VMess & Shadowsocks URL 中文乱码(#37)。
2024-09-20
- 启用新公共域名:https://sublink-worker.sageer.me。
2024-09-18
- 确保 Vmess 转换时
security选项存在。 - 修复默认配置缺少出站的问题。
2024-09-15
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 文档)。