Changelog
Records important versions and feature evolution of Sublink Worker, making it easy for self-hosted scenarios to quickly understand recent changes.
Since v2.0.0, the changelog follows semantic versioning, with version numbers aligned with Git Tags/Releases; v1.x records are for reference only.
Semantic Versioning (Since v2.0.0)
[2.5.0] - sing-box 1.14 Support & Conversion Reliability Fixes - 2026-11
This release adds sing-box 1.14 support and AnyTLS share links, and fixes a batch of issues where a single node made the whole config fail to load, or where nodes and options were silently dropped.
Added
- AnyTLS share links:
anytls://links are now supported in pasted links, remote subscriptions and Base64 subscriptions, for both Clash and Sing-Box output (#416). - sing-box 1.14 config tier: Clients on 1.14+ are detected from the User-Agent and download rule sets via 1.14's
http_clients; clients whose version cannot be detected keep the most compatible 1.12 tier (#411). - Country groups over Clash proxy providers: When a subscription is referenced as a proxy provider, country groups are now built with
use+filterinstead of coming out empty (#403, #412).
Changed
- TUIC verifies certificates by default: TUIC links used to skip certificate verification by default. They now behave like every other protocol and skip it only with an explicit
insecure=1/allowInsecure=1(#447). - Unsupported nodes are skipped individually: A node the target client cannot express (xhttp/kcp transports, VLESS encryption or the shadow-tls plugin on sing-box, AnyTLS on sing-box 1.11) is now skipped on its own instead of making the whole config fail to load (#448, #451, #454).
- Malformed links are skipped: A link that cannot be parsed no longer turns the request into a 500, nor drops every node after it in a subscription (#452).
Fixed
- Security: Sanitize site/ip identifiers in customRules to prevent SSRF (#414); dependency upgrades pick up the undici fixes for CVE-2026-6734 and CVE-2026-9697.
insecure=0no longer disables certificate verification:insecure=0/allowInsecure=0in share links used to be treated as "skip verification"; certificates are now verified as requested (#447).- sing-box configs with SS plugins load again:
plugin_optsis now the SIP003 string sing-box requires, with plugin names sing-box recognizes (#409, #451); SS plugins from sing-box JSON subscriptions are no longer rejected by Mihomo after conversion to Clash (#455). - obfs works on Mihomo again: The
obfs-localplugin name from share links is now mapped to Mihomo'sobfs. Mihomo used to ignore it silently and connect without obfuscation (#451). - Mihomo output keeps VLESS options: VLESS
encryption,xhttp-optsand uTLS fingerprints (fp) are preserved (#449), as is the Reality ML-KEM option (#441). - Long subscriptions can be shortened: The short-link endpoint accepts POST, so long URLs no longer fail with 414/431 (#450).
- UDP restored on sing-box 1.13+: Removed the stray
network: tcpon nodes and movedhijack-dnsahead ofclash_moderules (#402). - sing-box rule-set downloads no longer fail at startup: Rule sets are downloaded directly instead of through a proxy that is not up yet (#401, #408, #411, #431).
- No more sing-box DNS recursion: Node hostnames are no longer resolved through proxy DNS, which kept domain-addressed nodes from starting (#433).
- Inline subscriptions for official sing-box: Removed fork-only outbound providers; remote subscriptions are expanded into concrete nodes (#435, #436).
- Hysteria2 port hopping preserved:
mportand similar spellings are parsed, and sing-box output uses the correct field names (#428). - Trojan now defaults to TLS when
securityis omitted (#389). - Xray output keeps subscription traffic info (#362, #382).
- Removed the deprecated sing-box
block/dnsspecial outbounds in favor of reject rule actions (#380). - Fixed deduplication of identically named nodes, stored configs leaking across output formats, and a zero config TTL being ignored (#421, #422, #423).
- The Node/Vercel in-memory KV no longer expires entries immediately when the TTL exceeds ~24.8 days; configs stored with the default 30-day TTL used to disappear right after being written.
Maintenance
- CI now checks real-client compatibility: every PR loads the generated configs in sing-box 1.11 / 1.12 / 1.14 and Mihomo, and the newest sing-box pre-release is checked weekly (#453).
- Runtime moved to Node 22 and the test framework to Vitest 4;
pnpm-lock.yamlwas removed in favor of npm.
[2.4.2] - Custom Rule & Subscription Decoding Fixes - 2026-04
Fixed
- Restored custom rule proxy choices: Custom rule outbounds in Clash, Sing-Box, and Surge configs now correctly include
Node Select,Auto Select, the manual switch group, and the proxy list. Previously these members were missing, leaving custom rules unswitchable in clients (#371). - Fixed remote subscription mis-decoding: Rewrote the subscription decoding pipeline to first detect plain-text Clash/Sing-Box/Surge configs and protocol URIs, and only fall back to Base64 when the content is a genuine Base64 candidate. Plain subscriptions are no longer corrupted by aggressive Base64 decoding, which previously produced garbled output or empty configs (#370).
- Reject empty Clash proxy groups:
url-test/fallbackgroups with no members no longer silently produce an invalid config — the builder now throwsInvalidConfigError, surfacing upstream subscription or merge issues immediately (#378). - Stable auto provider names: When using proxy providers, auto-generated provider names are now stable across rebuilds, preventing new provider references from appearing on every config rebuild (#379).
[2.4.1] - Rule Source Migration & Empty Node Selection Fix - 2026-04
Fixed
- Migrated sing-box rule source: Switched from
lyc8503/sing-box-rules(account banned) toMetaCubeX/meta-rules-datsing branch. All rule set URLs are now accessible again (#367). - Fixed empty node selection causing config errors: When using non-Balance rules with an empty proxy list, Auto Select groups are no longer created without members, preventing Sing-Box "missing tags" errors (#366).
[2.4.0] - Subscription Info Passthrough & Multiple Fixes - 2026-04
This update adds subscription traffic info passthrough and fixes multiple issues affecting protocol parsing, config building, and cross-platform compatibility.
Added
- Subscription Info Passthrough: All subscription endpoints (
/singbox,/clash,/surge) now forward thesubscription-userinfoheader from upstream subscriptions, enabling clients to display remaining traffic and expiry info (#354, #363). src_ip_cidrCustom Rule Support: Custom rules now supportsrc_ip_cidrtype for source IP-based routing (#331).
Fixed
- Fixed
decodeURIComponentcorrupting Base64-encoded cipher in Shadowsocks URLs, resolving garbled output when passwords contain+,/,=(#337, #365). - Fixed custom rules acting as global rules when country grouping is enabled — custom rules no longer include country groups as outbounds (#256, #364).
- Fixed Clash config not enabling UDP by default for all proxy types (#360).
- Fixed legacy
snifffield remaining in Sing-Box inbound config (#357). - Fixed Hysteria2 protocol not defaulting to TLS when
securityparameter is missing (#345). - Fixed esbuild
__name()injection breaking browser runtime. - Fixed Surge config parser unavailable in browser runtime (#341).
- Fixed VLESS TLS default and missing
usefield in proxy-providers mode (#339). - Removed UTF-8 BOM characters and hardened
toStringArrayinput filtering.
[2.3.2] - Rule Routing Fix - 2026-02
Fixed
- Fixed
rule-providerskey collision in Clash config causing incorrect traffic routing — when rules contain both domain and IP rule sets (e.g. Google, Location:CN), IP rule sets would overwrite domain rule sets (#334).
[2.3.0] - Subconverter External Config & Stability Fixes - 2026-02
This update adds Subconverter external config export and fixes multiple issues affecting subscription conversion stability.
Added
- Subconverter External Config Export: New
/subconverterAPI endpoint exports the project's rule system as Subconverter external config (INI format), usable directly as Subconverter'sconfigparameter (#320 by @Yueby). - Disable Auto Select Group: New option to remove the Auto Select proxy group from generated configs.
Fixed
- Fixed all routes (
/singbox,/clash,/surge,/xray) not reading User-Agent from request headers, legacy client UA detection now works correctly (#321). - Fixed Clash legacy clients (e.g. Merlin) receiving mrs format instead of YAML (#306).
- Fixed Surge subscription comment format issue (#299).
- Fixed Sing-Box subscription import failure (#297).
- Fixed incorrect request path on Vercel deployments.
- Fixed
parseServerInfonull value causingstartsWitherror. - Fixed custom rule mode silently falling back to balanced preset when no rules selected.
Changed
- Updated dependencies to fix security vulnerabilities.
[2.1.1] - Bug Fixes - 2025-12
Fixed
- Implement cross-format parsing and building of proxy groups for Surge, Clash, and Sing-Box configurations.
Documentation
- Add a concise project description to the README.
- Update deployment guide URL in release notes.
- Simplified README.md, update .gitignore.
[2.1.0] - Multi-Format Input Support - 2025-12
This update significantly expands input source support. You can now directly paste Clash, Sing-Box, and Surge configurations for conversion.
Added
- Clash Config Input: Parse Clash YAML format configuration files directly.
- Sing-Box Config Input: Parse Sing-Box JSON format configuration files directly.
- Surge Config Input: Parse Surge INI format configuration files directly.
- Version Update Checker: In-app notification for new versions with one-click access to update guide.
Fixed
- Fixed missing
udp=truefor VLESS protocol in Clash output (#272). - Fixed SingboxConfigBuilder import path casing issue.
- Fixed potential errors after GitHub sync (#266).
Changed
- Renamed "Share URLs" input field to "Input Source" to better reflect its multi-format support capability.
[2.0.1] - Bug Fixes - 2025-12
- fix: Auto-parse original link regression.
- chore: Typos and formatting issues in README.
[2.0.0] - 2025-12
Sublink Worker v2.0 continues to focus on "unified subscription pipeline", addressing deployment flexibility, configuration persistence, and sharing efficiency.
Added
- Modular Multi-Runtime: Decoupled configuration building, proxy parsing, and storage adapters - one-click deployment on Cloudflare Workers, Node.js, Vercel, and Docker.
- Full-Chain Persistence: Unified KV/Redis/Upstash/Vercel KV interface, Config Storage automatically manages base configurations and short links with default 30-day TTL (renewable).
Changed
- Refactored Frontend Components: Fully embracing Hono and Alpine.js for a smooth user and development experience.
v1.x Historical Records (No Semantic Versioning)
The following content is listed in reverse chronological order, providing only a feature evolution overview and may lack version numbers and compatibility notes.
2025-11-08
- feat(config): Proxy configuration grouped by country, updated related translations.
2025-09-28
- Fixed some configuration warnings in Singbox 1.12.0.
- Other experience issue fixes.
2025-05-02
2025-04-30
- Full adaptation to Sing-Box 1.11.
- Added
Githubto Balanced rule set to address recent restrictions.
2025-04-27
- Improved Hysteria2 protocol compatibility.
2025-04-23
- Added Russian language support (#162).
2025-04-04
2025-03-31
- Updated deployment process due to Deploy to Workers redirect issue.
- Adjusted some outdated configurations.
2025-03-08
- Support for custom UA.
- Full use of Clash Meta Rule Provider.
2025-02-22
- Full i18n support.
2025-02-19
- Updated
💬 AI Servicesrouting rules.
2025-02-18
- Added frontend i18n support, continuing to improve subscription logic.
2025-01-11
- Use proxy to fetch rule sets.
2024-12-27
- Replaced deprecated
inet4_addresswithaddressin sing-box tun.
2024-12-07
- When manually selecting rules, predefined rule selector syncs to "custom".
2024-11-30
- Added support for legacy Shadowsocks URLs.
2024-11-23
- Fixed issue where repeated clicks on generate caused short links to become inaccessible.
2024-11-20
- Fixed slow first download issue for sing-box configs.
2024-11-19
- Improved UI interaction experience.
2024-11-05
- Added save custom base configuration feature, optimized UI.
2024-10-15
- Added FAQ documentation.
2024-10-03
- Support for saving and managing custom short links.
2024-09-28
2024-09-23
- Fixed VMess & Shadowsocks URL Chinese character garbling (#37).
2024-09-20
- Enabled new public domain: https://sublink-worker.sageer.me.
2024-09-18
- Ensured
securityoption exists during Vmess conversion. - Fixed missing outbound in default config.
2024-09-15
- Now supports custom short link paths (#31, #25).
- Optimized frontend display, simplified operation flow.
2024-09-13
- Optimized outbound selection layout (#27).
2024-09-10
- Fixed Base64 unable to convert multiple HTTP issue (#25).
- Provided QR codes for generated links.
2024-09-09
- Fixed Github rule invalid issue (#23).
2024-09-07
- Fixed garbled text when importing Base64 subscriptions (#16).
2024-09-03
- Added
geosite-category-scholar-!cnto📚 Education Resourcesrule set.
2024-09-02
- Use KV to store short links, no longer dependent on R2.
2024-09-01
- Custom rules added
domain_suffix,ip_cidr,geoip,geosite.
2024-08-25
- Fixed ClashMeta for Android ≥ v2.10.1 not displaying rule sets issue.
2024-08-20
- Added custom rules and corresponding API (see API Documentation).