feat: 支持 Shadowrocket gost-plugin SS URI 解析，mihomo plugin mux 规范化

xream · xream · commit 5c90301b9056 · 2026-05-20T19:19:33.000+08:00
- 在 SS URI 解析中新增 `gost=` 参数解析，支持 address/port/route/host/path/route 的标准化映射
- `route=ws|wss|websocket` 时自动转换为 `plugin-opts.mode`，并在 wss 场景下启用 tls
- 增加 mihomo 风格输出对 `plugin-opts.mux` 的布尔化处理（兼容 0/1、true/false、字符串等输入）
- 补充 parser 和 producer 测试：覆盖 gost-plugin 解析、mihomo mux 归一化与保留
diff --git a/backend/package.json b/backend/package.json
@@ -1,6 +1,6 @@
 {
   "name": "sub-store",
-  "version": "2.23.16",
+  "version": "2.23.17",
   "description": "Advanced Subscription Manager for QX, Loon, Surge, Stash and Shadowrocket.",
   "main": "src/main.js",
   "packageManager": "pnpm@11.0.9",
@@ -60,4 +60,4 @@
     "peggy": "^2.0.1",
     "prettier": "2.6.2"
   }
-}
+}
diff --git a/backend/src/core/proxy-utils/parsers/index.js b/backend/src/core/proxy-utils/parsers/index.js
@@ -405,6 +405,7 @@ function URI_SS() {
         // handle obfs
         const pluginMatch = content.match(/[?&]plugin=([^&]+)/);
         const shadowTlsMatch = content.match(/[?&]shadow-tls=([^&]+)/);
+        const gostMatch = content.match(/[?&]gost=([^&]+)/);
 
         if (pluginMatch) {
             const pluginInfo = (
@@ -486,6 +487,33 @@ function URI_SS() {
                 proxy.port = parseInt(port, 10);
             }
         }
+        if (gostMatch) {
+            const params = JSON.parse(
+                Base64.decode(decodeURIComponent(gostMatch[1])),
+            );
+            const address = getIfNotBlank(params['address']);
+            const port = getIfNotBlank(params['port']);
+            const route = getIfNotBlank(params['route']);
+            const normalizedRoute = route?.trim().toLowerCase();
+            const isWebsocketRoute = ['ws', 'wss', 'websocket'].includes(
+                normalizedRoute,
+            );
+            proxy.plugin = 'gost-plugin';
+            proxy['plugin-opts'] = {
+                mode: isWebsocketRoute ? 'websocket' : route,
+                host: getIfNotBlank(params['host']),
+                path: getIfNotBlank(params['path']),
+            };
+            if (normalizedRoute === 'wss') {
+                proxy['plugin-opts'].tls = true;
+            }
+            if (address) {
+                proxy.server = address;
+            }
+            if (port) {
+                proxy.port = parseInt(port, 10);
+            }
+        }
         if (/(&|\?)uot=(1|true)/i.test(query)) {
             proxy['udp-over-tcp'] = true;
         }
diff --git a/backend/src/core/proxy-utils/producers/clashmeta.js b/backend/src/core/proxy-utils/producers/clashmeta.js
@@ -1,6 +1,7 @@
 import {
     getWireGuardAddressWithCIDR,
     isPresent,
+    normalizePluginMuxBooleanValue,
     produceProxyListOutput,
     supportsShadowsocksV2rayPluginMode,
 } from '@/core/proxy-utils/producers/utils';
@@ -261,6 +262,12 @@ export default function ClashMeta_Producer() {
                     }
                 }
 
+                if (isPresent(proxy, 'plugin-opts.mux')) {
+                    proxy['plugin-opts'].mux = normalizePluginMuxBooleanValue(
+                        proxy['plugin-opts'].mux,
+                    );
+                }
+
                 if (
                     ['vmess', 'vless'].includes(proxy.type) &&
                     proxy.network === 'http'
diff --git a/backend/src/core/proxy-utils/producers/utils.js b/backend/src/core/proxy-utils/producers/utils.js
@@ -55,6 +55,10 @@ export function normalizePluginMuxValue(mux) {
     return mux;
 }
 
+export function normalizePluginMuxBooleanValue(mux) {
+    return Boolean(normalizePluginMuxValue(mux));
+}
+
 export function supportsShadowsocksV2rayPluginMode(proxy, supportedModes) {
     if (proxy?.type !== 'ss' || proxy?.plugin !== 'v2ray-plugin') return true;
 
@@ -138,16 +142,15 @@ export function getWireGuardAddressWithCIDR(proxy = {}, family = 'ipv4') {
         proxy[config.cidrKey],
         config.defaultCIDR,
     );
-    return `${parsed.address}/${normalizedCIDR ?? parsed.cidr ?? config.defaultCIDR}`;
+    return `${parsed.address}/${
+        normalizedCIDR ?? parsed.cidr ?? config.defaultCIDR
+    }`;
 }
 
 export function produceProxyListOutput(list, type, opts = {}) {
     if (type === 'internal') return list;
 
-    if (
-        opts.prettyYaml ||
-        opts['pretty-yaml']
-    ) {
+    if (opts.prettyYaml || opts['pretty-yaml']) {
         return YAML.safeDump(
             {
                 proxies: list,
@@ -158,6 +161,8 @@ export function produceProxyListOutput(list, type, opts = {}) {
         );
     }
 
-    return 'proxies:\n' +
-        list.map((proxy) => '  - ' + JSON.stringify(proxy) + '\n').join('');
+    return (
+        'proxies:\n' +
+        list.map((proxy) => '  - ' + JSON.stringify(proxy) + '\n').join('')
+    );
 }
diff --git a/backend/src/test/proxy-parsers/uri.spec.js b/backend/src/test/proxy-parsers/uri.spec.js
@@ -287,9 +287,7 @@ describe('Proxy URI parser coverage', function () {
                     'early-data-header-name': 'Sec-WebSocket-Protocol',
                 },
             });
-            expect(proxy['ws-opts']).to.not.have.property(
-                'v2ray-http-upgrade',
-            );
+            expect(proxy['ws-opts']).to.not.have.property('v2ray-http-upgrade');
         });
 
         it('does not double-decode shadowsocks path query values before extracting early data', function () {
@@ -353,6 +351,27 @@ describe('Proxy URI parser coverage', function () {
             });
         });
 
+        it('parses Shadowrocket shadowsocks gost-plugin payloads', function () {
+            const proxy = parseOne(
+                'ss://MjAyMi1ibGFrZTMtYWVzLTEyOC1nY206WVRFMVpXVTRaVEV5WmpjM1ltRXpaQT09OlkySmhaVFUzT0RZdFpqZzNNQzAwTkE9PUBvcGVuYWkuY29tOjEx?gost=eyJwYXRoIjoiXC93cyIsInBvcnQiOiIxMSIsImhvc3QiOiJhIiwicm91dGUiOiJ3cyIsImFkZHJlc3MiOiJhIn0#%F0%9F%87%AF%F0%9F%87%B5%20%E6%97%A5%E6%9C%AC-A77ACD92',
+            );
+
+            expectSubset(proxy, {
+                type: 'ss',
+                name: '🇯🇵 日本-A77ACD92',
+                server: 'a',
+                port: 11,
+                cipher: '2022-blake3-aes-128-gcm',
+                password: 'YTE1ZWU4ZTEyZjc3YmEzZA==:Y2JhZTU3ODYtZjg3MC00NA==',
+                plugin: 'gost-plugin',
+                'plugin-opts': {
+                    mode: 'websocket',
+                    host: 'a',
+                    path: '/ws',
+                },
+            });
+        });
+
         it('parses SSR URIs with protocol and obfs parameters', function () {
             const encoded = Base64.encode(
                 [
diff --git a/backend/src/test/proxy-producers/structured.spec.js b/backend/src/test/proxy-producers/structured.spec.js
@@ -1557,7 +1557,7 @@ describe('Proxy structured producers', function () {
         });
     });
 
-    it('preserves numeric v2ray-plugin mux values across Clash-family YAML producers', function () {
+    it('preserves numeric v2ray-plugin mux values across non-Mihomo Clash-family YAML producers', function () {
         const buildProxy = (name, mux) => ({
             type: 'ss',
             name,
@@ -1577,12 +1577,7 @@ describe('Proxy structured producers', function () {
             },
         });
 
-        for (const platform of [
-            'Clash',
-            'ClashMeta',
-            'Shadowrocket',
-            'Stash',
-        ]) {
+        for (const platform of ['Clash', 'Shadowrocket', 'Stash']) {
             const internal = produceInternal(platform, [
                 buildProxy(`${platform} Mux On`, 1),
                 buildProxy(`${platform} Mux Off`, 0),
@@ -1608,6 +1603,109 @@ describe('Proxy structured producers', function () {
         }
     });
 
+    it('normalizes plugin mux values to booleans for Mihomo-compatible YAML producers', function () {
+        const buildProxy = (name, mux) => ({
+            type: 'ss',
+            name,
+            server: 'ss.example.com',
+            port: 8388,
+            cipher: 'aes-128-gcm',
+            password: 'secret',
+            plugin: 'v2ray-plugin',
+            'plugin-opts': {
+                mode: 'websocket',
+                host: 'cdn.example.com',
+                path: '/socket',
+                tls: true,
+                mux,
+            },
+        });
+        const cases = [
+            ['Number On', 1, true],
+            ['Number Off', 0, false],
+            ['Boolean On', true, true],
+            ['Boolean Off', false, false],
+            ['String True', ' TRUE ', true],
+            ['String False', ' false ', false],
+            ['String One', '1', true],
+            ['String Zero', '0', false],
+        ];
+        const proxies = cases.map(([name, mux]) =>
+            buildProxy(`Mihomo ${name}`, mux),
+        );
+
+        for (const platform of ['Mihomo', 'ClashMeta']) {
+            const internal = produceInternal(platform, proxies);
+            const external = loadProducedYaml(platform, proxies);
+
+            expect(internal, platform).to.have.length(cases.length);
+            expect(external.proxies, platform).to.have.length(cases.length);
+
+            cases.forEach(([name, , expected], index) => {
+                expect(
+                    internal[index]['plugin-opts'].mux,
+                    `${platform} internal ${name}`,
+                ).to.equal(expected);
+                expect(
+                    external.proxies[index]['plugin-opts'].mux,
+                    `${platform} external ${name}`,
+                ).to.equal(expected);
+            });
+        }
+    });
+
+    it('preserves Mihomo shadowsocks gost-plugin options with boolean mux', function () {
+        const proxy = {
+            type: 'ss',
+            name: 'Mihomo Gost Plugin',
+            server: 'ss.example.com',
+            port: 8388,
+            cipher: 'aes-128-gcm',
+            password: 'secret',
+            plugin: 'gost-plugin',
+            'plugin-opts': {
+                mode: 'websocket',
+                tls: true,
+                fingerprint: 'SHA256:TEST',
+                certificate: 'inline-test-client-cert',
+                'private-key': 'inline-test-client-key',
+                'skip-cert-verify': true,
+                host: 'cdn.example.com',
+                path: '/socket',
+                mux: 1,
+                headers: {
+                    custom: 'value',
+                },
+            },
+        };
+
+        const internal = produceInternal('Mihomo', proxy);
+        const external = loadProducedYaml('Mihomo', proxy);
+        const expected = {
+            type: 'ss',
+            name: 'Mihomo Gost Plugin',
+            plugin: 'gost-plugin',
+            'plugin-opts': {
+                mode: 'websocket',
+                tls: true,
+                fingerprint: 'SHA256:TEST',
+                certificate: 'inline-test-client-cert',
+                'private-key': 'inline-test-client-key',
+                'skip-cert-verify': true,
+                host: 'cdn.example.com',
+                path: '/socket',
+                mux: true,
+                headers: {
+                    custom: 'value',
+                },
+            },
+        };
+
+        expect(internal).to.have.length(1);
+        expectSubset(internal[0], expected);
+        expectSubset(external.proxies[0], expected);
+    });
+
     it('keeps legacy single-line proxy output by default for Clash-style YAML producers', function () {
         const proxy = {
             type: 'ss',

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "sub-store",`
`3`		`- "version": "2.23.16",`
	`3`	`+ "version": "2.23.17",`
`4`	`4`	`"description": "Advanced Subscription Manager for QX, Loon, Surge, Stash and Shadowrocket.",`
`5`	`5`	`"main": "src/main.js",`
`6`	`6`	`"packageManager": "pnpm@11.0.9",`
`@@ -60,4 +60,4 @@`
`60`	`60`	`"peggy": "^2.0.1",`
`61`	`61`	`"prettier": "2.6.2"`
`62`	`62`	`}`
`63`		`-}`
	`63`	`+}`