Skip to content

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 + filter instead 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=0 no longer disables certificate verification: insecure=0 / allowInsecure=0 in 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_opts is 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-local plugin name from share links is now mapped to Mihomo's obfs. Mihomo used to ignore it silently and connect without obfuscation (#451).
  • Mihomo output keeps VLESS options: VLESS encryption, xhttp-opts and 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: tcp on nodes and moved hijack-dns ahead of clash_mode rules (#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: mport and similar spellings are parsed, and sing-box output uses the correct field names (#428).
  • Trojan now defaults to TLS when security is omitted (#389).
  • Xray output keeps subscription traffic info (#362, #382).
  • Removed the deprecated sing-box block / dns special 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.yaml was 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/fallback groups with no members no longer silently produce an invalid config — the builder now throws InvalidConfigError, 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) to MetaCubeX/meta-rules-dat sing 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 the subscription-userinfo header from upstream subscriptions, enabling clients to display remaining traffic and expiry info (#354, #363).
  • src_ip_cidr Custom Rule Support: Custom rules now support src_ip_cidr type for source IP-based routing (#331).

Fixed ​

  • Fixed decodeURIComponent corrupting 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 sniff field remaining in Sing-Box inbound config (#357).
  • Fixed Hysteria2 protocol not defaulting to TLS when security parameter 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 use field in proxy-providers mode (#339).
  • Removed UTF-8 BOM characters and hardened toStringArray input filtering.

[2.3.2] - Rule Routing Fix - 2026-02 ​

Fixed ​

  • Fixed rule-providers key 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 /subconverter API endpoint exports the project's rule system as Subconverter external config (INI format), usable directly as Subconverter's config parameter (#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 parseServerInfo null value causing startsWith error.
  • 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=true for 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 ​

  • Auto-rename proxies with duplicate names (#175).
  • Fixed Singbox DNS configuration (#174).

2025-04-30 ​

  • Full adaptation to Sing-Box 1.11.
  • Added Github to 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 Services routing 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_address with address in 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 ​

2024-10-03 ​

  • Support for saving and managing custom short links.

2024-09-28 ​

  • (#41 by @Wikeolf)
    • Added custom domain keyword support.
    • Support for reordering custom rules.

2024-09-23 ​

  • Fixed VMess & Shadowsocks URL Chinese character garbling (#37).

2024-09-20 ​

2024-09-18 ​

  • Ensured security option 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-!cn to 📚 Education Resources rule 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 ​

Last updated:

Released under the MIT License