#!/usr/bin/env python3 """ Sub2SOCKS bootstrap - fetch subscription -> pick VLESS node -> sing-box SOCKS proxy. Only required env var: SUB_URL (subscription group URL with VLESS nodes) Optional env vars: SOCKS_PORT (default 1080) SOCKS5 listen port SOCKS_USER / SOCKS_PASS auth credentials (empty -> no auth) DNS_SERVER (default tls://8.8.8.8) upstream resolver e.g. tls:// PICK_STRATEGY first | random (default "first") LOG_LEVEL info | debug | warn | error (default "info") """ import base64 import json import os import random import sys import textwrap import urllib.error import urllib.parse as up import urllib.request SUB_URL = os.environ["SUB_URL"] SOCKS_PORT = int(os.environ.get("SOCKS_PORT", "1080")) SOCKS_USER = os.environ.get("SOCKS_USER", "") SOCKS_PASS = os.environ.get("SOCKS_PASS", "") DNS_SERVER = os.environ.get("DNS_SERVER", "tls://8.8.8.8") PICK_STRATEGY = os.environ.get("PICK_STRATEGY", "first") LOG_LEVEL = os.environ.get("LOG_LEVEL", "info") CONFIG_FILE = "/tmp/sub2socks.json" def _fetch(url): """Download sub content, auto decode base64 if needed.""" req = urllib.request.Request(url, headers={"User-Agent": "clash.meta"}) with urllib.request.urlopen(req, timeout=30) as r: raw = r.read() try: return raw.decode("utf-8") except UnicodeDecodeError: return base64.b64decode(raw).decode("utf-8") def _vless_lines(text): """Return VLESS URI lines (handles base64-encoded lines too).""" out = [] for line in text.splitlines(): line = line.strip() if not line or line.startswith("#"): continue if line.lower().startswith("vless://"): out.append(line) continue try: d = base64.b64decode(line).decode("utf-8") if d.lower().startswith("vless://"): out.append(d) except Exception: pass return out def _parse(url_str): """Parse a VLESS URL into component dict.""" p = up.urlparse(url_str.strip()) q = up.parse_qs(p.query) def g(key, default=None): if key in q: return q[key][0] return default return { "uuid": p.username, "server": p.hostname, "port": p.port or (443 if p.scheme == "vless+tls" else 80), "security": g("security", "tls"), "type": g("type", "tcp"), "sni": g("sni") or "", "alpn": g("alpn") or "", "pbk": g("public_key") or g("pbk") or "", "sid": g("sid") or "", "spX": g("spX") or "", "path": g("path") or "/", "serviceName": g("serviceName") or g("service-name") or "", "host": g("host") or "", "flow": g("flow") or "", } def _config(proxy): """Build sing-box JSON config.""" ob = { "type": "vless", "tag": "proxy", "server": proxy["server"], "server_port": proxy["port"], "uuid": proxy["uuid"], "packet_encoding": "xudp", } sec = proxy.get("security") or "tls" if sec == "reality": ob["tls"] = { "enabled": True, "server_name": proxy.get("sni"), "utls": {"enabled": True, "fingerprint": "chrome"}, "reality": { "enabled": True, "public_key": proxy["pbk"], "short_id": proxy.get("sid") or proxy.get("spX"), }, } elif sec == "tls": ob["tls"] = { "enabled": True, "server_name": proxy.get("sni"), "utls": {"enabled": True, "fingerprint": "chrome"}, } alpn_raw = proxy.get("alpn") if alpn_raw: ob["tls"]["alpn"] = [x.strip() for x in alpn_raw.split(",") if x.strip()] ttype = proxy.get("type") or "tcp" tp = {"type": ttype} if ttype == "ws": tp["path"] = proxy.get("path") or "/" hv = proxy.get("host") if hv: tp["headers"] = {"Host": hv} elif ttype == "http": hv = proxy.get("host") if hv: tp["host"] = [x.strip() for x in hv.split(",") if x.strip()] tp["path"] = proxy.get("path") or "/" elif ttype == "grpc": svc = proxy.get("serviceName") or proxy.get("path") if svc: tp["service_name"] = svc ob["transport"] = tp cfg = { "log": {"level": LOG_LEVEL}, "dns": { "servers": [ {"tag": "remote", "address": DNS_SERVER, "detour": "direct"}, ], "rules": [ {"outbound": "any", "server": "remote"}, ], }, "inbounds": [{ "type": "socks", "listen": "::", "listen_port": SOCKS_PORT, }], "outbounds": [ ob, # index 0 -> tag: proxy {"type": "direct", "tag": "direct"}, # DNS detour / bypass ], "route": { "rules": [{ "clash_mode": "direct", "outbound": "direct", }], "final": "proxy", # default -> outbound[0] }, } if SOCKS_USER: cfg["inbounds"][0]["users"] = [ {"username": SOCKS_USER, "password": SOCKS_PASS}, ] return cfg def main(): print(textwrap.dedent(f""" +-------------------------------------------------------+ | Sub2SOCKS -- bootstrapping | +-------------------------------------------------------+ | SUB_URL : {SUB_URL} | SOCKS port : {SOCKS_PORT:>6d} | DNS upstream : {DNS_SERVER} | PICK_STRATEGY : {PICK_STRATEGY} | LOG_LEVEL : {LOG_LEVEL} +-------------------------------------------------------+ """).strip()) # 1. fetch and filter try: data = _fetch(SUB_URL) except urllib.error.URLError as e: print(f"ERROR: Cannot reach {SUB_URL}: {e}", flush=True) sys.exit(1) except Exception as e: print(f"ERROR: Subscription error: {e}", flush=True) sys.exit(1) lines = _vless_lines(data) if not lines: print("ERROR: No VLESS nodes found in subscription!") print(data[:500]) sys.exit(1) print(f" Found {len(lines)} VLESS node(s) - picking one.", flush=True) chosen = random.choice(lines) if PICK_STRATEGY == "random" else lines[0] proxy = _parse(chosen) print(f" Node: {proxy['server']}:{proxy['port']}", flush=True) conf = _config(proxy) with open(CONFIG_FILE, "w") as fp: json.dump(conf, fp, indent=2) print(f" Config written -> {CONFIG_FILE}", flush=True) # exec sing-box in-place env_copy = dict(os.environ) env_copy["ENABLE_DEPRECATED_LEGACY_DNS_SERVERS"] = "true" env_copy["ENABLE_DEPRECATED_OUTBOUND_DNS_RULE_ITEM"] = "true" os.execve( "/usr/local/bin/sing-box", ["sing-box", "run", "-c", CONFIG_FILE], env_copy, ) if __name__ == "__main__": main()