Function normalize_browser_proxy_url

src/services/browser_captcha.py:260–293

将浏览器代理标准化为 Playwright/Chromium 可接受的格式。 Chromium 不支持带账号密码的 socks5/socks5h 代理认证。 对于 `socks5(h)://user:pass@host:port`，自动降级为 `http://user:pass@host:port`， 方便兼容同时提供 HTTP/SOCKS5 双入口的代理服务商。 Returns: (normalized_proxy_url, warning_message)

(proxy_url: str)

    return None

def normalize_browser_proxy_url(proxy_url: str) -> tuple[Optional[str], Optional[str]]:
    """将浏览器代理标准化为 Playwright/Chromium 可接受的格式。

    Chromium 不支持带账号密码的 socks5/socks5h 代理认证。
    对于 `socks5(h)://user:pass@host:port`，自动降级为 `http://user:pass@host:port`，
    方便兼容同时提供 HTTP/SOCKS5 双入口的代理服务商。

    Returns:
        (normalized_proxy_url, warning_message)
    """
    if not proxy_url:
        return None, None

    proxy_url = proxy_url.strip()
    match = re.match(r'^(socks5h?|socks5|http|https)://(?:([^:]+):([^@]+)@)?([^:]+):(\d+)$', proxy_url)
    if not match:
        if not re.match(r'^(http|https|socks5h?|socks5)://', proxy_url):
            proxy_url = f"http://{proxy_url}"
        return proxy_url, None

    protocol, username, password, host, port = match.groups()
    if protocol.startswith("socks5") and username and password:
        normalized = f"http://{username}:{password}@{host}:{port}"
        warning = (
            f"检测到带认证的 {protocol.upper()} 代理。"
            "Chromium 不支持 socks5 用户名密码认证，"
            f"已自动改用 HTTP 代理启动浏览器: http://{host}:{port}"
        )
        return normalized, warning

    if protocol == "socks5h":
        proxy_url = f"socks5://{host}:{port}"

    return proxy_url, None

def validate_browser_proxy_url(proxy_url: str) -> tuple[bool, str]:
    if not proxy_url: return True, None