Source: https://swgbar.com/zh-CN/guides/netskope-ssl-inspection-bypass-mac/
Language: zh-CN

# Mac 上的 Netskope SSL 检查：检测解密与单域名绕过指南

检查 Netskope Client 是否在 Mac 上解密 HTTPS（\*.goskope.com 证书），对比 SWG bar 单域名绕过与 Do Not Decrypt 策略，并配置 nscacert\_combined.pem。

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

要确认 **Netskope Client** 是否正在你的 Mac 上执行 SSL/TLS 解密，请打开 **SWG bar → 概览**（或运行 `swgbar overview`），查看**域名劫持占比**是否大于 `0%`，以及**中间人证书**中是否包含 **Netskope** 或 `*.goskope.com` 租户证书。要在获授权的 Mac 上为特定主机名绕过 Netskope SSL 检查，请打开 **SWG bar → 域名**，选择该主机名并在**绕过 SWG**一行点击**开启**（或运行 `swgbar bypass enable <domain>`）。

Netskope 安全 Web 网关在企业 macOS 设备群中部署广泛，通常结合 `NetworkExtension` 流量牵引客户端与租户专属中级 CA 运行。由于 Netskope 根证书已通过 MDM 推送到 macOS 钥匙串，浏览器会照常显示绿色有效连接状态，但命令行运行时（`pip`、`npm`、`AWS CLI`、`git`、`Docker`、`Claude Code`）以及采用证书固定的桌面应用却会报 `CERTIFICATE_VERIFY_FAILED` 或 `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`。

## 1\. 验证 Netskope 是否正在 Mac 上解密特定域名

同时排查系统级拦截状态与具体主机名：

*   **通过 SWG bar 菜单栏与 Chrome 扩展查看**：[安装 SWG bar](<https://swgbar.com/zh-CN/install/>)（macOS 14+，Apple 芯片，提供 14 个使用日免费试用），访问网站或执行报错命令。打开 **SWG bar → 域名**，或运行 `swgbar domains list --status confirmed`，即可列出所有被 Netskope 租户 CA（常见格式如 `ca.<tenant>.goskope.com` 或公司自定义 CA）重签 TLS 证书的主机名。配合免费的 [SWG bar Chrome 扩展](<https://swgbar.com/zh-CN/chrome-extension/>)，还能直接在浏览器工具栏查看状态徽章。
*   **在终端检查 Netskope 证书与实时签发者**：

```
# 检查 macOS 系统钥匙串中是否安装了 Netskope CA
security find-certificate -c "Netskope" /Library/Keychains/System.keychain

# 查看特定主机名返回的实时证书签发者
openssl s_client -connect registry.npmjs.org:443 -servername registry.npmjs.org </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject
```

请留意，Netskope 策略通常会解密部分 SaaS 或代码托管域名，同时对其余域名仅做牵引而不解密；排查时务必测试确切报错的主机名。

## 2\. 为什么退出 Netskope Client 通常无效

在启用了 Netskope _Protect Client configuration and resources_（防篡改保护）策略的受管环境中，Netskope 菜单栏图标中的 **Disable** 选项通常处于置灰或密码锁定状态，强行卸载守护进程也会直接破坏系统网络路由。同样地，清空 macOS Wi-Fi 代理设置也不起作用，因为 Netskope 是在 macOS `NetworkExtension` 层牵引流量。

## 3\. 在 macOS 上选择合适的 Netskope 处理方案

| 方案 | 是否停止 Netskope 解密？ | 是否需要 Netskope 租户管理员？ | 最适用场景 |
| --- | --- | --- | --- |
| **按域名绕过 SWG（`SWG bar`）** | 是，仅针对选定主机名走物理`硬件网卡` IPv4 | 不需要（获授权 Mac 上的本地控制） | 证书固定应用、WebSocket 或开发端点在 Netskope 解密下故障，且具备直连 IPv4 路径（详见[如何在 Mac 上绕过 SWG](<https://swgbar.com/zh-CN/guides/how-to-bypass-swg/>)） |
| **Netskope 租户 `Do Not Decrypt` / 证书固定应用例外** | 是，全受管 Mac 统一生效 | 需要（**Policies → SSL Decryption → Do Not Decrypt** 或 **Steering Configuration → Exceptions**） | 全团队共用的证书固定桌面应用或研发端点大面积中断（详见[SWG 绕过与 TLS 解密例外对比](<https://swgbar.com/zh-CN/guides/swg-bypass-vs-tls-exception/>)） |
| **为 CLI 工具配置合并 CA 包（`nscacert_combined.pem`）** | 否（流量继续受检） | 不需要 | 策略要求流量保持 Netskope 解密路由，CLI/AI 工具仅需信任 Netskope CA 证书链 |

## 4\. 开启单域名绕过或配置 Netskope CLI CA 信任

### 方案 A：使用 SWG bar 开启单域名绕过（获授权时）

1.  打开 **SWG bar → 域名**，选择确切的受检主机名（例如 `api.anthropic.com` 或 `pypi.org`），在**绕过 SWG**一行点击**开启**——或运行 `swgbar bypass enable <domain>`。
2.  等待状态显示为**绕过中**，随后重启浏览器标签页、终端工具或 IDE，使既有 TLS/HTTP/3 连接池经由物理`硬件网卡` IPv4 接口重新建立连接。
3.  运行 `swgbar probe <domain>` 确认已返回源站的公共证书链。如需立即恢复默认路由，再次点击该控件或运行 `swgbar bypass disable <domain>` 即可。

### 方案 B：在 Netskope 下为 CLI 工具构建合并 PEM 证书包

如果流量必须继续经过 Netskope 检查，可从 macOS 信任库导出合并后的 PEM 证书包（或直接使用 IT 提供的 `nscacert_combined.pem`），并在 `~/.zshrc` 中将其配置给开发工具：

```
security find-certificate -a -p \
  /System/Library/Keychains/SystemRootCertificates.keychain \
  /Library/Keychains/System.keychain > "$HOME/.certs/nscacert_combined.pem"

export NODE_EXTRA_CA_CERTS="$HOME/.certs/nscacert_combined.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
export SSL_CERT_FILE="$HOME/.certs/nscacert_combined.pem"
export AWS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
```

更多针对不同工具的配置细节，请参阅[修复 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 上绕过 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 上的 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 上为多域名 Web 应用、SSO、CDN 与 API 配置 SWG 绕过](<https://swgbar.com/zh-CN/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [排查 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/>)
