feat(sub): add Happ client integration, routing presets, and app management (#6434)

* feat(sub): add Happ client integration, routing presets, and app management Implement comprehensive Happ proxy client integration according to official developer specifications. - Fix header emission on disabled routing and hidden settings to send explicit '0' headers rather than omitting, allowing Happ clients to reset cached settings. - Add support for 'happ://routing/off' deeplink in routing validation. - Preserve '?serverDescription=' query parameters in link fragments without escaping to support Happ server subtitles across VMess, VLESS, Trojan and SS. - Add Happ application management headers: ProviderID, New-Url, Fallback-Url, Sub-Info banners, Sub-Expire notifications, No-Limit mode, hardware ID enforcement, TUN modes/types, route exclusions, APNS exclusions, and per-app proxy settings. - Add curated routing presets (Iran Bypass, China Direct, AdBlock, Global) and interactive visual rule generator in frontend settings. - Synchronize all 13 translation locales with native Persian, Russian, and Chinese translations. * fix(sub): keep Happ header overrides behind the auto-detect opt-in The Routing-Enable/Hide-Settings off values were emitted on the User-Agent alone, so every panel that upgraded would push "Routing-Enable: 0" — documented by happ.su as disabling routing globally — to every Happ client without the operator enabling anything. They now ride subHappAutoDetect like every other Happ header. Two further mismatches against the vendor spec: - serverDescription was written as a key of the VMess base64 JSON object. happ.su documents it as a "#Title?serverDescription=<base64>" link parameter or a JSON "meta" entry, so the caption never reached Happ while every other VMess consumer received an unknown key. Dropped rather than moved: emitting the documented form is unsafe here because our own parser base64-decodes the whole VMess body (internal/util/link/outbound.go). - The TUN Mode dropdown stored the literal "default", forwarded as "Tun-Mode: default", where happ.su documents system|gvisor only. It now stores the unset value so no header is sent. TUN Type "default" is a documented value and is unchanged. Each fix carries a test that fails without it.
2026-09-17 15:47:14 +00:00 · 2026-09-10 17:16:12 +03:30
parent d5ab84e8d5
commit 1456658028
35 changed files with 3460 additions and 51 deletions
@@ -0,0 +1,118 @@
+// Encode UTF-8 string to standard Base64 safe for browser environments.
+export function toBase64Utf8(str: string): string {
+  return btoa(
+    encodeURIComponent(str).replace(/%([0-9A-F]{2})/g, (_, p1) =>
+      String.fromCharCode(Number(`0x${p1}`)),
+    ),
+  );
+}
+
+// Splits multiline or comma-separated string into clean unique token arrays.
+export function parseList(input: string): string[] {
+  return input
+    .split(/[\n,]+/)
+    .map((s) => s.trim())
+    .filter(Boolean);
+}
+
+// Build standard Happ routing deeplink or special state for curated presets.
+export function buildHappPresetDeeplink(preset: string): string {
+  switch (preset) {
+    case 'off':
+      return 'happ://routing/off';
+    case 'iran-bypass':
+      return (
+        'happ://routing/onadd/' +
+        toBase64Utf8(
+          JSON.stringify({
+            rules: [
+              {
+                type: 'field',
+                outboundTag: 'direct',
+                domain: ['domain:ir', 'regexp:.*\\.ir$'],
+                ip: ['geoip:ir', 'geoip:private'],
+              },
+              {
+                type: 'field',
+                outboundTag: 'block',
+                domain: ['geosite:category-ads-all'],
+              },
+              {
+                type: 'field',
+                outboundTag: 'proxy',
+                network: 'tcp,udp',
+              },
+            ],
+          }),
+        )
+      );
+    case 'china-direct':
+      return (
+        'happ://routing/onadd/' +
+        toBase64Utf8(
+          JSON.stringify({
+            rules: [
+              {
+                type: 'field',
+                outboundTag: 'direct',
+                domain: ['domain:cn', 'geosite:cn'],
+                ip: ['geoip:cn', 'geoip:private'],
+              },
+              {
+                type: 'field',
+                outboundTag: 'block',
+                domain: ['geosite:category-ads-all'],
+              },
+              {
+                type: 'field',
+                outboundTag: 'proxy',
+                network: 'tcp,udp',
+              },
+            ],
+          }),
+        )
+      );
+    case 'adblock':
+      return (
+        'happ://routing/onadd/' +
+        toBase64Utf8(
+          JSON.stringify({
+            rules: [
+              {
+                type: 'field',
+                outboundTag: 'block',
+                domain: ['geosite:category-ads-all'],
+              },
+              {
+                type: 'field',
+                outboundTag: 'direct',
+                ip: ['geoip:private'],
+              },
+              {
+                type: 'field',
+                outboundTag: 'proxy',
+                network: 'tcp,udp',
+              },
+            ],
+          }),
+        )
+      );
+    case 'global':
+      return (
+        'happ://routing/onadd/' +
+        toBase64Utf8(
+          JSON.stringify({
+            rules: [
+              {
+                type: 'field',
+                outboundTag: 'proxy',
+                network: 'tcp,udp',
+              },
+            ],
+          }),
+        )
+      );
+    default:
+      return '';
+  }
+}