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

# Mac의 SWG 환경에서 Homebrew, Docker, Python, Node.js CA 신뢰 구성

macOS에서 Homebrew, Docker Desktop, Node.js, Python, git, curl이 SWG 서명 TLS 인증서를 거부하는 이유와 CA 번들 구성 vs. 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 키체인 아님) | Docker VM / 이미지 신뢰 저장소에 기업 CA 추가 |

## 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`). 자세한 내용은 [멀티 도메인 웹 앱, SSO, CDN, API용 SWG 우회하기](<https://swgbar.com/ko/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/ko/guides/swg-tls-certificate-errors-macos/>)을 읽어보세요. 로컬 라우팅 규칙과 게이트웨이 정책 제외를 비교하려면 [SWG 우회와 TLS 검사 예외 비교](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)를 확인하세요.

## 관련 가이드

*   [Mac에서 SWG 우회하는 방법 (원클릭 도메인 우회 및 CLI)](<https://swgbar.com/ko/guides/how-to-bypass-swg/>)
*   [Mac에서 SSL 검사 우회하는 방법(기업 SWG 도메인별 해결책)](<https://swgbar.com/ko/guides/bypass-ssl-inspection-mac/>)
*   [macOS에서 HTTPS 및 TLS 검사 우회하는 방법(Break-and-Inspect 가이드)](<https://swgbar.com/ko/guides/bypass-https-tls-inspection-mac/>)
*   [Mac에서 기업 프록시 및 SWG SSL 검사 우회하는 방법](<https://swgbar.com/ko/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [내 Mac이 SWG에 의해 가로채기되고 있는지 확인하는 방법(HTTPS 및 SSL 검사)](<https://swgbar.com/ko/guides/detect-https-inspection/>)
*   [회사나 업무용 Mac이 HTTPS를 가로채고 있는지 확인하는 방법(SSL 검사)](<https://swgbar.com/ko/guides/check-if-work-mac-intercepting-https/>)
*   [Mac용 SSL 검사 체커: HTTPS 가로채기를 감지하는 메뉴 막대 도구](<https://swgbar.com/ko/guides/ssl-inspection-checker-mac/>)
*   [Mac의 Zscaler SSL 검사: 도메인별 확인 및 우회 방법](<https://swgbar.com/ko/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Mac의 Netskope SSL 검사: 복호화 확인 및 도메인별 우회](<https://swgbar.com/ko/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac의 Cloudflare WARP 및 Zero Trust TLS 검사: 감지 및 우회](<https://swgbar.com/ko/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar에서 HTTPS 검사의 ‘확인됨’과 ‘의심됨’ 분류 이해하기](<https://swgbar.com/ko/guides/confirmed-vs-suspected-https-inspection/>)
*   [SWG bar에서 중간자(MITM) 루트 인증서 및 발급자 확인하기](<https://swgbar.com/ko/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac의 기업용 SWG 및 MDM HTTPS 검사 원리](<https://swgbar.com/ko/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 우회와 TLS 검사 예외(Break-and-Inspect) 비교](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)
*   [Mac에서 멀티 도메인 웹 앱, SSO, CDN, API용 SWG 우회하기](<https://swgbar.com/ko/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Mac에서 SWG 우회 ‘복구 중’, ‘일시 중지’ 및 연결 오류 해결하기](<https://swgbar.com/ko/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS VPN 가상 인터페이스와 SWG HTTPS 검사 비교](<https://swgbar.com/ko/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [인증서 피닝 및 mTLS 앱이 SWG 검사 환경에서 실패하는 이유](<https://swgbar.com/ko/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Mac의 CLI 및 AI 도구에서 발생하는 SWG TLS/SSL 인증서 오류 해결](<https://swgbar.com/ko/guides/swg-tls-certificate-errors-macos/>)
*   [Mac에서 Claude Code 및 Cursor의 'unable to get local issuer certificate' 오류 해결(SWG 및 MCP)](<https://swgbar.com/ko/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Mac에서 openssl과 security verify-cert로 TLS 인증서 검증하기](<https://swgbar.com/ko/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar 권한, 로컬 개인정보 보호 및 TLS 프로브 제한](<https://swgbar.com/ko/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar의 HTTPS 검사 원리](<https://swgbar.com/ko/how-it-works/>)
*   [Mac용 SWG bar 다운로드 및 설치(macOS 14+)](<https://swgbar.com/ko/install/>)
*   [SSL 및 HTTPS 검사를 감지하는 Chrome 확장 프로그램(SWG bar 연동)](<https://swgbar.com/ko/chrome-extension/>)
*   [SWG bar CLI 가이드](<https://swgbar.com/ko/cli/>)
*   [SWG bar MCP 가이드](<https://swgbar.com/ko/mcp/>)
*   [SWG bar 릴리스 정보](<https://swgbar.com/ko/releases/>)
*   [SWG bar 소개](<https://swgbar.com/ko/about/>)
