网络与连接
网络问题应从 DNS、TLS、代理、超时和客户端进程五个层面排查。不要一开始就假设必须使用某种代理工具。
1. 直接测试域名
bash
curl -I https://aikey365.com若站点可访问,再测试 API:
bash
curl https://aikey365.com/v1/models \
-H "Authorization: Bearer $AIKEY365_API_KEY"2. 查看详细连接信息
bash
curl -v https://aikey365.com/v1/models \
-H "Authorization: Bearer $AIKEY365_API_KEY"重点观察 DNS、TLS 握手、HTTP 状态码和是否连接到预期主机。
3. 检查代理环境
终端程序可能读取:
text
HTTP_PROXY
HTTPS_PROXY
ALL_PROXY
NO_PROXY浏览器能访问不代表 CLI 一定走同一网络路径;反过来也一样。
4. 企业网络与安全软件
公司网络、透明代理、HTTPS 检查、防火墙或安全软件可能修改证书、请求头或连接时长。必要时换一个独立网络做对照测试。
5. 超时
长推理和多媒体任务需要比普通文本请求更长的处理时间。区分:
- DNS / 连接超时
- TLS 握手失败
- 首字节等待过久
- 流式连接中断
- 客户端自身总体超时
6. 只在客户端失败
如果 curl 正常而某个客户端失败,优先检查该客户端是否读取了不同代理、Base URL、环境变量或证书设置。