在 Mac 上为多域名 Web 应用、SSO、CDN 与 API 配置 SWG 绕过
为什么只绕过单个主域名对现代应用往往不够:在 SWG bar 中找出登录、CDN 和 API 主机名,并彻底重置 Keep-Alive 长连接。
SWG bar · 更新日期
在 macOS 上启用绕过 SWG时,一个常见困惑是:主网页确实刷新加载了,但登录跳转、页面图片、包下载或 API 请求仍然触发 HTTPS 检查甚至失败。这是因为 SWG bar 的绕过规则严格按精确主机名生效,而现代多域名 Web 应用与开发工具往往同时依赖多个独立主机。
为什么单主机名绕过不会涵盖子域名
对 app.example.com 开启绕过时,路由规则仅作用于 app.example.com,不会自动涵盖:
- 单点登录(SSO)与 OAuth 身份提供商:例如
login.example.com、auth.example.com、sso.company.com,或第三方身份主机(accounts.google.com、login.microsoftonline.com)。 - API 与 AI 服务端点:例如
api.example.com、graphql.example.com,以及独立的遥测或流式传输子域名。 - 静态资源与制品仓库:例如
cdn.example.net、assets.example.com,或对象存储桶(*.s3.amazonaws.com、objects.githubusercontent.com)。
另请注意,无法识别或采用加密 SNI/ECH 的主机名无法匹配单域名绕过规则。
找出应用依赖的全部受检主机名
- 在 SWG bar 保持监测的情况下,打开目标网站或重现一次失败的开发工具操作。
- 在 SWG bar → 域名中按已确认 / 疑似筛选并输入关键词搜索(如
example或auth),或通过 CLI 查询:
swgbar domains list --status confirmed --search example
swgbar domains list --bypass active
- 针对该业务流程必需的每一个受检主机名,分别打开其详情并开启绕过 SWG(或执行
swgbar bypass enable <hostname>)。 - 请留意:在获授权的网络中绕过某个必需的身份认证或 API 域名,并不代表需要放开其他无关域名——请将规则严格控制在确有必要的主机范围内。
关闭 Keep-Alive 长连接并检查 Chrome 状态
即便状态已经显示为绕过中,浏览器和后台守护进程仍可能继续复用先前通过旧检查路径建立的 HTTP/2、HTTP/3 或 TLS Keep-Alive 套接字:
- Web 浏览器:使用强制刷新(
Cmd + Shift + R)重载标签页;若站点使用了长驻 WebSocket 或 HTTP/3 连接,请关闭并重新打开浏览器窗口。你可以借助 Chrome 配套扩展查看当前标签页对应的主机名状态——但请记住扩展仅展示 SWG bar 已记录的观测结果,不会直接读取 Chrome 的实时套接字。 - 终端与 IDE:重启持久运行的后台进程(如
npm、Claude Code守护进程、IDE 语言服务器或git凭据助手),促使其通过物理网卡重新建立全新的 TCP/TLS 连接。
逐一核验每个主机名
更新规则后,请回到域名视图(或运行 swgbar domains detail <hostname>),确认新发起的探测显示流程中的每一个相关主机名都已恢复公共路径信任,而不只是浏览器地址栏显示的顶级网址。如果某个团队共用的 SaaS 或 SSO 域名影响全体成员,请对照SWG 绕过与 TLS 解密例外对比,评估是否更适合由管理员配置网关例外规则。