在 Insomnia 中配置代理

在 Insomnia 中配置代理

简介

Insomnia 是开发者常用的 HTTP 客户端，是 Postman 的替代品。Insomnia 的代理支持对于在企业网络中工作、从不同地理位置测试 API 以及通过拦截代理调试流量都至关重要。

基本配置

在 Insomnia 中配置

1. 打开 Insomnia
2. 进入 Preferences（Ctrl+,）
3. "General" 标签页 →"HTTP Network Proxy" 部分
4. 启用 "Enable Proxy"
5. 按以下格式填写代理地址：http://proxy_ip:port
6. HTTPS 使用：https://proxy_ip:port
7. No Proxy：localhost, *.local

身份验证

Insomnia 支持带身份验证的代理：
- URL 格式：http://user:pass@proxy_ip:port
- 或通过环境变量：HTTP_PROXY、HTTPS_PROXY

环境变量

Insomnia 会读取系统环境变量：
- HTTP_PROXY / http_proxy
- HTTPS_PROXY / https_proxy
- NO_PROXY / no_proxy

高级配置

环境变量

多数工具都支持标准的代理环境变量：
- HTTP_PROXY / http_proxy — 用于 HTTP 请求的代理
- HTTPS_PROXY / https_proxy — 用于 HTTPS 请求的代理
- NO_PROXY / no_proxy — 排除列表（绕过代理的地址）
- ALL_PROXY / all_proxy — 用于所有协议的代理

SSL 与自签名证书

企业代理经常使用自己的 SSL 证书。要通过它们工作，您需要：
1. 向管理员索取该代理的 CA 证书
2. 将其添加到系统证书库
3. 或者关闭 SSL 校验（仅限测试）

身份验证

支持两种主要的身份验证方式：

用户名和密码 — 标准的 HTTP Basic 身份验证。每次请求都会发送凭据。URL 格式：http://user:pass@proxy_ip:port

按 IP 地址（白名单） — 将您的 IP 加入白名单，无需发送任何凭据。

验证

配置完成后请检查：
1. 通过代理执行一次测试请求
2. 确认 IP 地址已经改变
3. 检查连接速度
4. 确认没有 DNS 泄漏

故障排查

代理连接问题

• 检查地址和端口是否正确
• 确认防火墙没有拦截连接
• 检查从您的网络能否访问该代理

SSL 错误

• 企业代理请添加 CA 证书
• 测试时可临时关闭 SSL 校验
• 将 SSL 库升级到最新版本

身份验证错误

• 检查用户名和密码
• 确认凭据格式正确
• 尝试对密码中的特殊字符做 URL 编码

最佳实践

1. 使用环境变量 — 兼顾灵活性与安全性
2. 不要把凭据硬编码 — 使用环境变量或配置文件
3. 配置排除项 — 不要把 localhost 和内网地址走代理
4. 记录配置 — 写进项目 README 或团队 wiki
5. 改动后做测试 — 任何配置变更都需要验证

结论

正确的代理配置能保证工具稳定运行和连接安全。请遵循本指南的建议，并在配置完成后务必验证功能是否正常。