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 开启单域名绕过(获授权时)
- 打开 SWG bar → 域名,选择确切的受检主机名(例如
api.anthropic.com或pypi.org),在绕过 SWG一行点击开启——或运行swgbar bypass enable <domain>。 - 等待状态显示为绕过中,随后重启浏览器标签页、终端工具或 IDE,使既有 TLS/HTTP/3 连接池经由物理
硬件网卡IPv4 接口重新建立连接。 - 运行
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 信任配置。