Troubleshooting
连接问题
网络和代理故障排除
连接问题
本页帮助你诊断和解决网络连接相关的问题。
诊断步骤
1. 检查网络连接
# 测试网络连通性
ping api.anthropic.com
ping api.openai.com
2. 检查 DNS 解析
# 测试 DNS 解析
nslookup api.anthropic.com
3. 测试 HTTPS 连接
# 测试 HTTPS 连接
curl -I https://api.anthropic.com
常见问题
连接超时
症状: 请求长时间无响应后超时
可能原因:
- 网络不稳定
- 防火墙阻止
- Provider 服务不可用
解决方案:
- 检查网络连接
- 检查防火墙设置
- 尝试使用代理
- 增加超时时间
DNS 解析失败
症状: 无法解析域名
解决方案:
- 检查 DNS 设置
- 尝试使用公共 DNS(如 8.8.8.8)
- 清除 DNS 缓存
# macOS
sudo dscacheutil -flushcache
# Windows
ipconfig /flushdns
SSL/TLS 错误
症状: 证书验证失败
可能原因:
- 系统时间不正确
- 根证书过期
- 代理拦截 HTTPS
解决方案:
- 同步系统时间
- 更新系统证书
- 检查代理设置
代理配置
设置代理
在 ProxyCast 设置中配置代理:
- 进入 设置 > 高级
- 配置代理设置:
| 选项 | 说明 |
|---|---|
| HTTP 代理 | HTTP 代理地址 |
| HTTPS 代理 | HTTPS 代理地址 |
| 不代理地址 | 排除的地址列表 |
代理格式
http://proxy.example.com:8080
http://user:password@proxy.example.com:8080
socks5://proxy.example.com:1080
环境变量
也可以通过环境变量设置:
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1
Provider 特定问题
Anthropic API
端点: https://api.anthropic.com
常见问题:
- 某些地区可能需要代理
- 检查 API 状态页面
Google Gemini
端点: https://generativelanguage.googleapis.com
常见问题:
- 需要 Google Cloud 项目
- 检查 API 是否启用
阿里云 Qwen
端点: https://dashscope.aliyuncs.com
常见问题:
- 海外访问可能需要代理
- 检查区域设置
防火墙设置
允许的端口
确保防火墙允许以下端口:
| 端口 | 用途 |
|---|---|
| 443 | HTTPS 请求 |
| 8999 | ProxyCast API(默认) |
macOS 防火墙
- 系统偏好设置 > 安全性与隐私
- 防火墙 > 防火墙选项
- 允许 ProxyCast 接收传入连接
Windows 防火墙
- 控制面板 > Windows Defender 防火墙
- 允许应用通过防火墙
- 添加 ProxyCast
调试模式
启用详细日志:
- 进入 设置 > 高级
- 设置日志级别为 Debug
- 重现问题
- 查看网络请求日志