初始化

tg_bridge/proxy.py

@@ -0,0 +1,39 @@
+"""Telethon 代理配置（传给 TelegramClient 的 proxy 参数）。"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from tg_bridge.config import Settings
+
+
+def telethon_proxy_from_settings(s: Settings) -> dict[str, Any] | None:
+    """返回 Telethon ``TelegramClient(..., proxy=...)`` 所用的 dict。
+
+    键名与 Telethon ``Connection._parse_proxy`` 一致：
+    ``proxy_type, addr, port, rdns, username, password``（后两项可选）。
+    使用 dict 可避免 PySocks 整数类型与 ``(host, port, rdns)`` 元组长度的歧义。
+
+    参考：``telethon/network/connection/connection.py`` 中 ``_proxy_connect``。
+    """
+    if not s.proxy_type or not s.proxy_host or not s.proxy_port:
+        return None
+
+    t = s.proxy_type.lower().strip()
+    if t == "https":
+        t = "http"
+    if t not in ("http", "socks5", "socks4"):
+        raise ValueError(
+            f"不支持的 TELEGRAM_PROXY_TYPE={s.proxy_type!r}，可用: http, socks5, socks4"
+        )
+
+    d: dict[str, Any] = {
+        "proxy_type": t,
+        "addr": s.proxy_host,
+        "port": s.proxy_port,
+        "rdns": s.proxy_rdns,
+    }
+    if s.proxy_user is not None:
+        d["username"] = s.proxy_user
+        d["password"] = s.proxy_password if s.proxy_password is not None else ""
+    return d