Source: https://swgbar.com/ja/guides/homebrew-docker-python-node-ca-trust-swg-macos/
Language: ja

# Mac の SWG 配下における Homebrew、Docker、Python、Node.js の CA 信頼設定

macOS で Homebrew、Docker Desktop、Node.js、Python、git、curl が SWG 署名の TLS 証明書を拒否する理由と、CA バンドル設定と SWG 回避の使い分けを解説します。

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

HTTPS Break-and-Inspect を行う企業環境下の Mac では、開発者ランタイムごとに TLS 証明書の検証方法が異なります。Safari や Chrome が **macOS キーチェーン**を参照するのに対し、CLI ツールやコンテナーは独自の CA バンドルを使うことが多く、パッケージマネージャーや SDK 全体で突然ビルドエラーが発生する原因になります。

## Mac の開発ツールが選択的に失敗する理由

| ツール / ランタイム | macOS 上のデフォルト信頼ストア | 主な環境変数または設定 |
| --- | --- | --- |
| **Node.js / npm / yarn / pnpm** | バイナリ組み込みの Mozilla CA バンドル | `NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem` |
| **Python / pip / uv / requests** | `certifi` バンドルまたは OpenSSL の CA パス | `SSL_CERT_FILE` / `REQUESTS_CA_BUNDLE` |
| **git** | ビルドに応じた OpenSSL または Secure Transport | `git config --global http.sslCAInfo /path/to/corp-ca.pem` |
| **curl / Homebrew（`brew`）** | macOS Secure Transport または OpenSSL CA バンドル | `HOMEBREW_CURLRC` / `CURL_CA_BUNDLE`（`curl --version` で確認） |
| **Docker Desktop / コンテナー** | Linux VM およびイメージ内の `/etc/ssl/certs`（macOS キーチェーンではない） | 企業 CA を Docker VM / イメージの信頼ストアへ追加 |

## 1\. どのレジストリや API ホスト名が傍受されているか特定する

シェルプロファイルやコンテナービルドを編集する前に、DNS やファイアウォールのブロックではなく、具体的にどの外部ホスト名が SSL 検査を受けているのかを確認します。

```
swgbar domains list --status confirmed
swgbar probe registry.npmjs.org
swgbar probe pypi.org
swgbar probe ghcr.io
```

パッケージマネージャーはダウンロードを複数のホストへリダイレクトすることがよくあります（例：`formulae.brew.sh` → `ghcr.io`、`github.com` → `objects.githubusercontent.com`）。詳しくは [マルチドメインの Web アプリ、SSO、CDN、API 向けに SWG を回避する](<https://swgbar.com/ja/guides/multi-domain-sso-api-cdn-swg-bypass/>)をご覧ください。

## 2\. CA バンドル設定、TLS 検査除外、SWG 回避のどれを使うか判断する

*   **企業ルート CA の PEM を追加する**：社内ポリシーによりすべての通信で SWG 復号が必須の場合は、**SWG bar → 証明書**で特定した正確なルート CA をエクスポートし、IT セキュリティ部門の案内に従って `NODE_EXTRA_CA_CERTS`、`SSL_CERT_FILE`、`REQUESTS_CA_BUNDLE`、または `http.sslCAInfo` を設定します。TLS 検証自体を無効化（`NODE_TLS_REJECT_UNAUTHORIZED=0` や `sslVerify=false`）することは絶対に避けてください。
*   **IT 部門に TLS 検査除外を申請する**：共有レジストリ、Docker ベースイメージ、厳格な証明書ピンニングを行うツールなど、CI とローカル端末の両方でカスタム CA バンドルを維持するのが壊れやすいケースで推奨されます。
*   **許可されたネットワークでドメイン単位の SWG 回避を使う**：Mac 上で特定のホストを回避する権限がある場合や自身がネットワークを管理している場合は、SWG bar で **SWG を回避**を有効にするか（または `swgbar bypass enable <domain>` を実行し）、CLI プロセスを再起動します。

## システム既定値を変える前にワークフローを比較する

`CERTIFICATE_VERIFY_FAILED` エラーの段階的な対処方法は [Mac の CLI・AI ツールにおける SWG TLS/SSL 証明書エラーを解決する方法](<https://swgbar.com/ja/guides/swg-tls-certificate-errors-macos/>)をお読みください。ローカルのルーティングルールとゲートウェイのポリシー除外を比較する場合は、[SWG 回避と TLS 検査の除外設定の違い](<https://swgbar.com/ja/guides/swg-bypass-vs-tls-exception/>)をご参照ください。

## 関連ガイド

*   [Mac で SWG を回避する方法（ドメイン単位のワンクリック回避と CLI）](<https://swgbar.com/ja/guides/how-to-bypass-swg/>)
*   [Mac で SSL 検査を回避する方法（企業 SWG とドメイン単位の解決策）](<https://swgbar.com/ja/guides/bypass-ssl-inspection-mac/>)
*   [macOS で HTTPS・TLS 検査を回避する方法（Break-and-Inspect ガイド）](<https://swgbar.com/ja/guides/bypass-https-tls-inspection-mac/>)
*   [Mac で企業プロキシと SWG の SSL 検査を回避する方法](<https://swgbar.com/ja/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Mac が SWG に傍受されているか確認する方法（HTTPS・SSL 検査の検出）](<https://swgbar.com/ja/guides/detect-https-inspection/>)
*   [会社・勤務先の Mac が HTTPS 通信を傍受（SSL 検査）しているか確認する方法](<https://swgbar.com/ja/guides/check-if-work-mac-intercepting-https/>)
*   [Mac 用 SSL 検査チェッカー：HTTPS 傍受を検出するメニューバーツール](<https://swgbar.com/ja/guides/ssl-inspection-checker-mac/>)
*   [Mac の Zscaler SSL 検査：ドメイン単位での確認と回避方法](<https://swgbar.com/ja/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Mac の Netskope SSL 検査：復号の確認とドメイン単位の回避方法](<https://swgbar.com/ja/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac の Cloudflare WARP と Zero Trust TLS 検査：検出と回避方法](<https://swgbar.com/ja/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar における HTTPS 検査の「確認済み」と「疑いあり」の違い](<https://swgbar.com/ja/guides/confirmed-vs-suspected-https-inspection/>)
*   [SWG bar で中間者（MITM）ルート証明書と発行者を検査する](<https://swgbar.com/ja/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac における企業向け SWG と MDM の HTTPS 検査（インスペクション）](<https://swgbar.com/ja/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 回避と TLS 検査の除外設定（Break-and-Inspect）の違い](<https://swgbar.com/ja/guides/swg-bypass-vs-tls-exception/>)
*   [Mac でマルチドメインの Web アプリ、SSO、CDN、API 向けに SWG を回避する](<https://swgbar.com/ja/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Mac で SWG 回避の「復旧中」「一時停止」や接続エラーを解決する](<https://swgbar.com/ja/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS の VPN 仮想インターフェースと SWG の HTTPS 検査の違い](<https://swgbar.com/ja/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [証明書ピンニングや mTLS を使うアプリが SWG 検査下で失敗する理由](<https://swgbar.com/ja/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Mac の CLI・AI ツールにおける SWG TLS/SSL 証明書エラーを解決する方法](<https://swgbar.com/ja/guides/swg-tls-certificate-errors-macos/>)
*   [Mac で Claude Code・Cursor の「unable to get local issuer certificate」を解決する方法（SWG・MCP）](<https://swgbar.com/ja/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Mac で openssl と security verify-cert を使い TLS 証明書を検証する](<https://swgbar.com/ja/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar の権限、ローカルプライバシーと TLS プローブ上限](<https://swgbar.com/ja/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar による HTTPS 検査の仕組み](<https://swgbar.com/ja/how-it-works/>)
*   [Mac 用 SWG bar のダウンロードとインストール（macOS 14 以降）](<https://swgbar.com/ja/install/>)
*   [SSL・HTTPS 検査を検出する Chrome 拡張機能（SWG Bar コンパニオン）](<https://swgbar.com/ja/chrome-extension/>)
*   [SWG bar CLI ガイド](<https://swgbar.com/ja/cli/>)
*   [SWG bar MCP ガイド](<https://swgbar.com/ja/mcp/>)
*   [SWG bar のリリース情報](<https://swgbar.com/ja/releases/>)
*   [SWG bar について](<https://swgbar.com/ja/about/>)
