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

检查 Netskope Client 是否在 Mac 上解密 HTTPS(*.goskope.com 证书),对比 SWG bar 单域名绕过与 Do Not Decrypt 策略,并配置 nscacert_combined.pem。

SWG bar · 更新日期

要确认 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(macOS 14+,Apple 芯片,提供 14 个使用日免费试用),访问网站或执行报错命令。打开 SWG bar → 域名,或运行 swgbar domains list --status confirmed,即可列出所有被 Netskope 租户 CA(常见格式如 ca.<tenant>.goskope.com 或公司自定义 CA)重签 TLS 证书的主机名。配合免费的 SWG bar Chrome 扩展,还能直接在浏览器工具栏查看状态徽章。
  • 在终端检查 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)
Netskope 租户 Do Not Decrypt / 证书固定应用例外 是,全受管 Mac 统一生效 需要(Policies → SSL Decryption → Do Not Decrypt 或 Steering Configuration → Exceptions) 全团队共用的证书固定桌面应用或研发端点大面积中断(详见SWG 绕过与 TLS 解密例外对比)
为 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 证书错误和Mac 在 SWG 下的 Homebrew、Docker、Python 与 Node.js CA 信任配置。