一、为何需要限制监听域名？
在常规调试场景中，Charles默认会捕获所有经过代理的HTTP/HTTPS请求。当开发者仅需分析特定域名（如api.example.com）的请求时，全量监听模式会带来三大问题：
- 数据过载：浏览器/APP产生的无关请求（如广告追踪、CDN资源）会淹没目标请求，增加筛选成本。
- 隐私风险：全量监听可能捕获用户敏感信息（如登录凭证、支付数据），违反最小化数据收集原则。
- 性能损耗：Charles处理大量无关请求会消耗额外内存，导致界面卡顿甚至崩溃。
以移动端开发为例，当调试微信小程序的后端API时，若不限制监听域名，Charles会同时捕获微信自身的统计请求、用户头像加载请求等，导致关键API请求被淹没。通过仅监听api.weixin.qq.com，可确保调试界面仅显示目标请求，大幅提升分析效率。
二、配置步骤详解
1. 基础配置：通过Include功能过滤
步骤1：打开Charles，点击顶部菜单栏的Proxy > Recording Settings。
步骤2：在弹出的窗口中，切换至Include标签页。
步骤3：点击Add按钮，在输入框中输入需要监听的域名（如*.example.com），支持通配符匹配。
步骤4：确认后，Charles将仅捕获匹配该模式的请求，其余请求会被自动忽略。
进阶技巧：
- 使用正则表达式：在
Include配置中，可通过正则表达式实现更复杂的匹配（如^https?://(api|cdn)\.example\.com/.*）。 - 多域名配置：可添加多个
Include规则，实现同时监听多个域名（如api.example.com和cdn.example.com）。
2. 高级配置：结合SSL代理与端口过滤
若需监听HTTPS请求，还需额外配置SSL代理：
步骤1：在Recording Settings中，切换至SSL Proxying标签页。
步骤2：添加需要解密的域名（如api.example.com:443），确保端口号正确。
步骤3：在移动端安装Charles根证书，并启用SSL代理。
端口过滤技巧：
- 若目标域名使用非标准端口（如8080），需在
Include规则中明确指定端口（如api.example.com:8080）。 - 通过
Proxy>Port可修改Charles默认监听端口（默认8888），避免与其他服务冲突。
三、常见问题与解决方案
1. 配置后仍捕获无关请求
原因：Include规则未正确配置，或存在更宽泛的Exclude规则覆盖。
解决方案：
- 检查
Include规则是否包含通配符或正则表达式错误（如遗漏*）。 - 在
Exclude标签页中确认无冲突规则（如*会覆盖所有Include规则）。
2. HTTPS请求显示为”Unknown”
原因：未正确配置SSL代理，或移动端未安装Charles证书。
解决方案：
- 在
SSL Proxying设置中添加目标域名的443端口。 - 移动端需安装Charles证书并信任（iOS需在设置中手动信任，Android需安装用户证书）。
3. 动态域名无法匹配
场景：目标域名包含随机子域名（如user-123.example.com）。
解决方案：
- 使用通配符
*.example.com匹配所有子域名。 - 若需更精确控制，可通过正则表达式匹配（如
^https?://user-\d+\.example\.com/.*）。
四、最佳实践与安全建议
- 最小化权限原则：仅配置必要的域名，避免监听无关服务（如第三方统计SDK）。
- 定期清理规则：项目结束后删除临时配置的
Include规则，防止误捕获生产环境数据。 - 结合环境变量：通过脚本动态生成
Include规则（如根据ENV变量切换测试/生产域名）。 - 隐私保护：在团队共享Charles配置时，删除包含敏感信息的规则（如内部API域名）。
五、扩展应用场景
- 多环境调试：通过配置不同的
Include规则集（如test.example.com和prod.example.com），快速切换测试与生产环境。 - 性能分析：仅监听关键API域名，结合
Sequence视图分析请求耗时，定位性能瓶颈。 - 安全审计：限制监听范围后，可更高效地检查目标域名是否存在未加密传输（HTTP）或敏感头泄露（如
Authorization）。
六、总结
通过Charles的Include功能实现域名级监听，不仅能显著提升调试效率，还能有效降低隐私泄露风险。开发者应掌握通配符、正则表达式等高级匹配技巧，并结合SSL代理配置，构建精准、安全的调试环境。在实际项目中，建议将常用域名配置保存为模板，通过脚本自动化切换，进一步提升工作效率。