尧图网页设计 
TG WS Proxy托盘应用完整指南MTProto代理配置文件字段逐项讲解、日志查看与自动更新设置【免费下载链接】tg-ws-proxyLocal MTProto proxy server for partial bypassing of Telegram loading项目地址: https://gitcode.com/gh_mirrors/tg/tg-ws-proxyTG WS Proxy是一款本地 MTProto 代理工具通过 WebSocket 连接部分绕过 Telegram 加载问题实现 Telegram 加速。它以托盘应用形式运行配置、日志和更新检查都围绕应用数据目录展开。本文将从配置文件字段逐项讲起带你看懂日志位置与轮转机制并掌握自动更新设置帮你快速完成 Telegram MTProto 代理的日常维护。一、托盘应用数据目录配置文件在哪里TG WS Proxy 托盘应用把配置和日志统一存放在系统应用数据目录下见 utils/tray_common.py系统数据目录Windows%APPDATA%\TgWsProxymacOS~/Library/Application Support/TgWsProxyLinux~/.config/TgWsProxy或$XDG_CONFIG_HOME/TgWsProxy目录中有两个关键文件config.json—— 全部配置项由 utils/default_config.py 提供默认值proxy.log—— 运行日志每次启动会清空重建 如果你把可执行文件旁建了TgWsProxy_data目录应用会自动切换为便携模式配置也存放在该目录中。二、配置文件字段逐项讲解默认配置由托盘界面生成并保存核心字段示例如下完整说明见 docs/EN/TrayConfig.md{ host: 127.0.0.1, port: 1443, secret: ..., dc_ip: [2:149.154.167.220, 4:149.154.167.220], verbose: false, buf_kb: 256, pool_size: 4, log_max_mb: 5.0, check_updates: true, cfproxy: true, cfproxy_user_domain: , cfproxy_worker_domain: , force_test_dc: false, appearance: auto }连接参数host、port、secrethost代理监听地址默认127.0.0.1仅本机可访问port监听端口默认1443secret32 位十六进制密钥首次启动时随机生成。Telegram 端 MTProto 代理设置里必须填写这个值丢失后可在托盘设置中重新生成这三项共同构成tg://proxy连接链接托盘菜单中的「打开在 Telegram」即自动使用该链接完成配置。数据中心参数dc_ipdc_ip是一个列表每项格式为DC号:IP例如2:149.154.167.220表示把 2 号数据中心DC2的流量引导到指定 IP。默认包含 DC2 和 DC4若 DC 未配置、或该数据中心 WebSocket 被拉黑/超时代理会自动回退到 CF 代理或直连 TCP逻辑见 proxy/tg_ws_proxy.py⚠️ 若图片/视频不加载可参考官方提示在 DC → IP 中只保留4:149.154.167.220或完全清空该字段dc_ip解析与校验逻辑在 proxy/config.py 的parse_dc_ip_list中实现。性能参数buf_kb 与 pool_sizebuf_kb套接字收发缓冲区大小KB默认256最小 4pool_size每个 DC 预热的 WebSocket 连接池大小默认4。连接池命中时可跳过握手显著降低首次连接延迟实现见 proxy/pool.py回退通道cfproxy 系列字段cfproxy是否启用 Cloudflare 代理回退默认true。未配置自己的域名时应用每小时自动从上游拉取公共域名池cfproxy_user_domain/cfproxy_worker_domain填入自己的 Cloudflare 域名或 Worker 域名支持多个逗号/分号分隔分别用于 CF 域名回退和免费 Worker 回退对应开关字段cfproxy_user_domain_enabled、cfproxy_worker_enabled决定列表是否生效其他实用字段verbose调试日志开关。true时日志级别提升到 DEBUG输出每次握手的 DC、协议等细节排查连接问题非常有用log_max_mb日志文件轮转上限MB默认5check_updates自动更新检查开关下一节详述force_test_dc强制全部流量走 Telegram 测试数据中心普通用户无需开启appearance界面主题auto/dark/lightautostart仅 Windows开机自启动开关见 utils/default_config.py三、日志查看proxy.log 位置与轮转机制最快查看方法右键托盘图标 →「打开日志」系统会直接打开日志文件无需手动翻目录。日志文件长什么样位置数据目录下的proxy.log与config.json同级格式时间 级别 模块名 内容例如启动时的Starting proxy on 127.0.0.1:1443 ...和每分钟一次的stats: ...连接统计启动信息块会打印Secret、监听地址、目标 DC IP 和tg://proxy连接链接忘记密钥时翻日志即可找回轮转机制日志不会无限增长日志由 utils/logging_setup.py 统一构建为滚动文件处理器RotatingFileHandler当前文件达到log_max_mb上限后自动轮转至少保留 1 份备份代码强制backupCount 1避免「静默不轮转、文件无限膨胀」的经典坑 小建议把verbose设为true后复现问题再检查proxy.log中该客户端 IP 的记录就能看清是 WebSocket 握手失败、302 重定向还是回退直连。四、自动更新设置check_updates 如何工作托盘设置窗口中的「检查更新」复选框对应配置项check_updates默认开启。工作流程应用启动约 1.5 秒后后台线程调用 GitHub Releases API 查询最新标签实现见 utils/update_check.py将当前版本与最新版本比较若存在新版本弹出提示并可一键打开下载页请求结果缓存在数据目录的.update_check_cache.json每台机器最多一小时请求一次 API并支持 ETag304节省流量相关细节关闭check_updates后完全不会发起网络请求若当前版本比最新发行版还新例如使用开发版不会误报「有更新」检查失败网络受限、API 限流 403 等只记录日志不影响代理运行五、快速上手清单找到数据目录用文本编辑器打开config.json按需调整port、dc_ip保持DC:IP格式需要排查问题时勾选verbose重启托盘应用通过托盘「打开日志」跟踪proxy.log保持check_updates开启及时获取新版 MTProto 代理更多安装与连接说明可参考 docs/EN/README.md 与 docs/EN/TrayConfig.md。掌握以上配置字段、日志与更新设置后TG WS Proxy 的日常运维基本只需几秒钟的开销。【免费下载链接】tg-ws-proxyLocal MTProto proxy server for partial bypassing of Telegram loading项目地址: https://gitcode.com/gh_mirrors/tg/tg-ws-proxy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TG WS Proxy托盘应用完整指南：MTProto代理配置文件字段逐项讲解、日志查看与自动更新设置
TG WS Proxy托盘应用完整指南MTProto代理配置文件字段逐项讲解、日志查看与自动更新设置【免费下载链接】tg-ws-proxyLocal MTProto proxy server for partial bypassing of Telegram loading项目地址: https://gitcode.com/gh_mirrors/tg/tg-ws-proxyTG WS Proxy是一款本地 MTProto 代理工具通过 WebSocket 连接部分绕过 Telegram 加载问题实现 Telegram 加速。它以托盘应用形式运行配置、日志和更新检查都围绕应用数据目录展开。本文将从配置文件字段逐项讲起带你看懂日志位置与轮转机制并掌握自动更新设置帮你快速完成 Telegram MTProto 代理的日常维护。一、托盘应用数据目录配置文件在哪里TG WS Proxy 托盘应用把配置和日志统一存放在系统应用数据目录下见 utils/tray_common.py系统数据目录Windows%APPDATA%\TgWsProxymacOS~/Library/Application Support/TgWsProxyLinux~/.config/TgWsProxy或$XDG_CONFIG_HOME/TgWsProxy目录中有两个关键文件config.json—— 全部配置项由 utils/default_config.py 提供默认值proxy.log—— 运行日志每次启动会清空重建 如果你把可执行文件旁建了TgWsProxy_data目录应用会自动切换为便携模式配置也存放在该目录中。二、配置文件字段逐项讲解默认配置由托盘界面生成并保存核心字段示例如下完整说明见 docs/EN/TrayConfig.md{ host: 127.0.0.1, port: 1443, secret: ..., dc_ip: [2:149.154.167.220, 4:149.154.167.220], verbose: false, buf_kb: 256, pool_size: 4, log_max_mb: 5.0, check_updates: true, cfproxy: true, cfproxy_user_domain: , cfproxy_worker_domain: , force_test_dc: false, appearance: auto }连接参数host、port、secrethost代理监听地址默认127.0.0.1仅本机可访问port监听端口默认1443secret32 位十六进制密钥首次启动时随机生成。Telegram 端 MTProto 代理设置里必须填写这个值丢失后可在托盘设置中重新生成这三项共同构成tg://proxy连接链接托盘菜单中的「打开在 Telegram」即自动使用该链接完成配置。数据中心参数dc_ipdc_ip是一个列表每项格式为DC号:IP例如2:149.154.167.220表示把 2 号数据中心DC2的流量引导到指定 IP。默认包含 DC2 和 DC4若 DC 未配置、或该数据中心 WebSocket 被拉黑/超时代理会自动回退到 CF 代理或直连 TCP逻辑见 proxy/tg_ws_proxy.py⚠️ 若图片/视频不加载可参考官方提示在 DC → IP 中只保留4:149.154.167.220或完全清空该字段dc_ip解析与校验逻辑在 proxy/config.py 的parse_dc_ip_list中实现。性能参数buf_kb 与 pool_sizebuf_kb套接字收发缓冲区大小KB默认256最小 4pool_size每个 DC 预热的 WebSocket 连接池大小默认4。连接池命中时可跳过握手显著降低首次连接延迟实现见 proxy/pool.py回退通道cfproxy 系列字段cfproxy是否启用 Cloudflare 代理回退默认true。未配置自己的域名时应用每小时自动从上游拉取公共域名池cfproxy_user_domain/cfproxy_worker_domain填入自己的 Cloudflare 域名或 Worker 域名支持多个逗号/分号分隔分别用于 CF 域名回退和免费 Worker 回退对应开关字段cfproxy_user_domain_enabled、cfproxy_worker_enabled决定列表是否生效其他实用字段verbose调试日志开关。true时日志级别提升到 DEBUG输出每次握手的 DC、协议等细节排查连接问题非常有用log_max_mb日志文件轮转上限MB默认5check_updates自动更新检查开关下一节详述force_test_dc强制全部流量走 Telegram 测试数据中心普通用户无需开启appearance界面主题auto/dark/lightautostart仅 Windows开机自启动开关见 utils/default_config.py三、日志查看proxy.log 位置与轮转机制最快查看方法右键托盘图标 →「打开日志」系统会直接打开日志文件无需手动翻目录。日志文件长什么样位置数据目录下的proxy.log与config.json同级格式时间 级别 模块名 内容例如启动时的Starting proxy on 127.0.0.1:1443 ...和每分钟一次的stats: ...连接统计启动信息块会打印Secret、监听地址、目标 DC IP 和tg://proxy连接链接忘记密钥时翻日志即可找回轮转机制日志不会无限增长日志由 utils/logging_setup.py 统一构建为滚动文件处理器RotatingFileHandler当前文件达到log_max_mb上限后自动轮转至少保留 1 份备份代码强制backupCount 1避免「静默不轮转、文件无限膨胀」的经典坑 小建议把verbose设为true后复现问题再检查proxy.log中该客户端 IP 的记录就能看清是 WebSocket 握手失败、302 重定向还是回退直连。四、自动更新设置check_updates 如何工作托盘设置窗口中的「检查更新」复选框对应配置项check_updates默认开启。工作流程应用启动约 1.5 秒后后台线程调用 GitHub Releases API 查询最新标签实现见 utils/update_check.py将当前版本与最新版本比较若存在新版本弹出提示并可一键打开下载页请求结果缓存在数据目录的.update_check_cache.json每台机器最多一小时请求一次 API并支持 ETag304节省流量相关细节关闭check_updates后完全不会发起网络请求若当前版本比最新发行版还新例如使用开发版不会误报「有更新」检查失败网络受限、API 限流 403 等只记录日志不影响代理运行五、快速上手清单找到数据目录用文本编辑器打开config.json按需调整port、dc_ip保持DC:IP格式需要排查问题时勾选verbose重启托盘应用通过托盘「打开日志」跟踪proxy.log保持check_updates开启及时获取新版 MTProto 代理更多安装与连接说明可参考 docs/EN/README.md 与 docs/EN/TrayConfig.md。掌握以上配置字段、日志与更新设置后TG WS Proxy 的日常运维基本只需几秒钟的开销。【免费下载链接】tg-ws-proxyLocal MTProto proxy server for partial bypassing of Telegram loading项目地址: https://gitcode.com/gh_mirrors/tg/tg-ws-proxy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考