Source: https://swgbar.com/zh-CN/guides/multi-domain-sso-api-cdn-swg-bypass/
Language: zh-CN

# 在 Mac 上为多域名 Web 应用、SSO、CDN 与 API 配置 SWG 绕过

为什么只绕过单个主域名对现代应用往往不够：在 SWG bar 中找出登录、CDN 和 API 主机名，并彻底重置 Keep-Alive 长连接。

SWG bar · 更新日期 2026年11月18日

在 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 的主机名**无法匹配单域名绕过规则。

## 找出应用依赖的全部受检主机名

1.  在 SWG bar 保持监测的情况下，打开目标网站或重现一次失败的开发工具操作。
2.  在 **SWG bar → 域名**中按**已确认** / **疑似**筛选并输入关键词搜索（如 `example` 或 `auth`），或通过 [CLI](<https://swgbar.com/zh-CN/cli/>) 查询：

```
swgbar domains list --status confirmed --search example
swgbar domains list --bypass active
```

3.  针对该业务流程必需的每一个受检主机名，分别打开其详情并开启**绕过 SWG**（或执行 `swgbar bypass enable <hostname>`）。
4.  请留意：在获授权的网络中绕过某个必需的身份认证或 API 域名，并不代表需要放开其他无关域名——请将规则严格控制在确有必要的主机范围内。

## 关闭 Keep-Alive 长连接并检查 Chrome 状态

即便状态已经显示为**绕过中**，浏览器和后台守护进程仍可能继续复用先前通过旧检查路径建立的 HTTP/2、HTTP/3 或 TLS Keep-Alive 套接字：

*   **Web 浏览器**：使用强制刷新（`Cmd + Shift + R`）重载标签页；若站点使用了长驻 WebSocket 或 HTTP/3 连接，请关闭并重新打开浏览器窗口。你可以借助 [Chrome 配套扩展](<https://swgbar.com/zh-CN/chrome-extension/>)查看当前标签页对应的主机名状态——但请记住扩展仅展示 SWG bar 已记录的观测结果，不会直接读取 Chrome 的实时套接字。
*   **终端与 IDE**：重启持久运行的后台进程（如 `npm`、`Claude Code` 守护进程、IDE 语言服务器或 `git` 凭据助手），促使其通过物理网卡重新建立全新的 TCP/TLS 连接。

## 逐一核验每个主机名

更新规则后，请回到**域名**视图（或运行 `swgbar domains detail <hostname>`），确认新发起的探测显示流程中的**每一个**相关主机名都已恢复公共路径信任，而不只是浏览器地址栏显示的顶级网址。如果某个团队共用的 SaaS 或 SSO 域名影响全体成员，请对照[SWG 绕过与 TLS 解密例外对比](<https://swgbar.com/zh-CN/guides/swg-bypass-vs-tls-exception/>)，评估是否更适合由管理员配置网关例外规则。

## 继续阅读

*   [如何在 Mac 上绕过 SWG（单域名一键绕过与 CLI 命令）](<https://swgbar.com/zh-CN/guides/how-to-bypass-swg/>)
*   [如何在 Mac 上绕过 SSL 检查（企业 SWG 单域名绕过指南）](<https://swgbar.com/zh-CN/guides/bypass-ssl-inspection-mac/>)
*   [如何在 macOS 上绕过 HTTPS 与 TLS 检查（Break-and-Inspect 指南）](<https://swgbar.com/zh-CN/guides/bypass-https-tls-inspection-mac/>)
*   [如何在 Mac 上绕过企业代理与 SWG SSL 检查](<https://swgbar.com/zh-CN/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [如何判断我的电脑是否被 SWG 劫持（Mac 上检测 HTTPS/SSL 检查）](<https://swgbar.com/zh-CN/guides/detect-https-inspection/>)
*   [如何检查公司或办公 Mac 是否正在拦截 HTTPS（SSL 检查排查）](<https://swgbar.com/zh-CN/guides/check-if-work-mac-intercepting-https/>)
*   [Mac SSL 检查检测工具：菜单栏实时侦测 HTTPS 拦截](<https://swgbar.com/zh-CN/guides/ssl-inspection-checker-mac/>)
*   [Mac 上的 Zscaler SSL 检查：如何检测并按域名绕过](<https://swgbar.com/zh-CN/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Netskope SSL 检查：检测解密与单域名绕过指南](<https://swgbar.com/zh-CN/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Cloudflare WARP 与 Zero Trust TLS 检查：检测与绕过](<https://swgbar.com/zh-CN/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar 中的“已确认”与“疑似”HTTPS 检查状态解析](<https://swgbar.com/zh-CN/guides/confirmed-vs-suspected-https-inspection/>)
*   [在 SWG bar 中检查中间人根证书与签发机构](<https://swgbar.com/zh-CN/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac 上的企业 SWG 与 MDM HTTPS 解密检查解析](<https://swgbar.com/zh-CN/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 绕过与 TLS 解密例外（Break-and-Inspect）对比](<https://swgbar.com/zh-CN/guides/swg-bypass-vs-tls-exception/>)
*   [排查 Mac 上 SWG 绕过的“恢复中”“已暂停”与连接错误](<https://swgbar.com/zh-CN/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS VPN 虚拟网卡与 SWG HTTPS 检查对比](<https://swgbar.com/zh-CN/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [为什么证书固定（Pinning）应用与 mTLS 在 SWG 检查下会失效](<https://swgbar.com/zh-CN/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [修复 Mac 终端 CLI 与 AI 工具中的 SWG TLS/SSL 证书错误](<https://swgbar.com/zh-CN/guides/swg-tls-certificate-errors-macos/>)
*   [Mac 在 SWG 下的 Homebrew、Docker、Python 与 Node.js CA 信任配置](<https://swgbar.com/zh-CN/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [修复 Mac 上 Claude Code 与 Cursor 的 'unable to get local issuer certificate' 报错（SWG 与 MCP）](<https://swgbar.com/zh-CN/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [在 Mac 上使用 openssl 与 security verify-cert 验证 TLS 证书](<https://swgbar.com/zh-CN/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar 权限、本地隐私与 TLS 探测限额说明](<https://swgbar.com/zh-CN/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar 如何检查 HTTPS 解密](<https://swgbar.com/zh-CN/how-it-works/>)
*   [下载并安装 Mac 版 SWG bar（macOS 14+）](<https://swgbar.com/zh-CN/install/>)
*   [检测 SSL 与 HTTPS 检查的 Chrome 扩展（SWG bar 配套插件）](<https://swgbar.com/zh-CN/chrome-extension/>)
*   [SWG bar CLI 使用指南](<https://swgbar.com/zh-CN/cli/>)
*   [SWG bar MCP 使用指南](<https://swgbar.com/zh-CN/mcp/>)
*   [SWG bar 版本信息](<https://swgbar.com/zh-CN/releases/>)
*   [关于 SWG bar](<https://swgbar.com/zh-CN/about/>)
