快速检查
- 确认托盘中已经选择正确上游，或选择
NoProxy测试直连。 - 确认应用连接的是
127.0.0.1:8888（或你配置的本地端口），而不是上游端口。 - 切换上游后建立一个新连接；已有连接不会在中途改道。
- 确认本地端口未被其他程序占用，防火墙未阻止 Python/PyProxySwitch。
- 用
pyproxyswitch --log-level DEBUG启动并查看PyProxySwitch.log。
常见问题
浏览器显示代理连接失败
检查 PyProxySwitch 是否仍在托盘运行、监听端口是否与浏览器一致。若刚修改端口，确保设置保存成功且新端口可用。
HTTP 可用但某个协议不可用
确认应用选择了正确的客户端协议。PyProxySwitch 本地入口虽可自动识别协议，但应用发出的握手仍必须符合 HTTP、SOCKS4/SOCKS4a 或 SOCKS5。
SOCKS5 认证失败
SOCKS5 必须同时填写用户名与密码，每项 UTF-8 编码不超过 255 字节。还应确认上游确实启用了用户名/密码认证方法。
局域网设备无法连接
默认只监听回环地址，这是安全设计。确需共享时需修改 LOCAL_ADDRESS 并配置防火墙；本地入口没有客户端认证，不建议暴露到不受信网络。
报告问题
请前往 GitHub Issues。建议提供版本、操作系统、Python 版本、客户端协议、上游协议、最小复现步骤以及已脱敏的日志。不要提交真实代理密码、访问令牌或私有地址。