Mac의 “There was a problem communicating with the secure web proxy server (HTTPS)”(CFNetwork 오류 310)

Mac이 HTTPS 프록시를 사용하도록 설정되어 있는데 프록시가 작동하지 않습니다. 시스템 프록시를 따르는 모든 앱이 실패합니다.

에이전트로 해결하기Claude Code, Codex 또는 터미널을 쓸 수 있는 에이전트용 프롬프트를 복사합니다.

제 Mac에 이런 문제가 있습니다: Mac의 “There was a problem communicating with the secure web proxy server (HTTPS)”(CFNetwork 오류 310). https://kilobat.app/ko/guides/cfnetwork-error-310-problem-communicating-with-the-secure-web-proxy-server.md을(를) 읽고 저와 함께 해결해 주세요. Kilobat CLI가 없으면 설치해 주세요: brew install seifip/kilobat/kilobat. 가이드의 터미널 및 kilobat 점검은 직접 실행하고, 알아낸 내용을 알려 주세요. 저만 할 수 있는 단계는 목록으로 정리해 주세요. 설정을 바꾸기 전에는 먼저 물어봐 주세요.

적용 대상: macOS 13 Ventura 이상. 문구는 macOS 27.2의 CFNetwork에서 확인했습니다.확인일: 2026년 10월 29일

증상

  • 앱에 “There was a problem communicating with the secure web proxy server (HTTPS).”가 표시됩니다.
  • 콘솔에 kCFErrorDomainCFNetwork Code=310이 표시됩니다.
  • Safari에 “can’t connect to the web proxy server”가 표시됩니다.

가능한 원인

  • 꺼져 있거나 잘못된 프록시. 프록시 주소나 포트가 잘못되었거나 프록시가 꺼져 있습니다.
  • 이전 네트워크의 프록시 설정. Mac에 회사 프록시가 남아 있습니다.
  • 프록시를 설정하는 프로파일 또는 앱. VPN이나 보안 앱이 설정할 수 있습니다.

확인 방법

  1. macOS가 사용하는 프록시 설정을 표시합니다.

    scutil --proxy
  2. Wi-Fi의 보안 웹 프록시 설정을 표시합니다.

    networksetup -getsecurewebproxy Wi-Fi

해결 방법

  1. 시스템 설정 › 네트워크 › Wi-Fi › 세부사항 › 프록시를 여세요. 필요하지 않다면 보안 웹 프록시(HTTPS)를 끄세요.

  2. 필요하다면 관리자와 함께 주소와 포트를 바로잡으세요.

  3. 프록시를 설정하는 VPN이나 필터 앱을 끄세요.

  4. 앱을 종료했다가 다시 여세요.

Kilobat 사용

  1. Wi-Fi, 라우터, 인터넷, DNS 및 로그인 페이지를 한 번에 확인합니다.

    kilobat diagnose
  2. 특정 사이트나 서비스가 실패하면 이를 막는 계층을 찾으세요.

    kilobat why example.com
  3. CLI는 무료입니다. 앱에서 이 검사에 따른 조언은 Kilobat Pro에 포함됩니다. 특정 사이트나 API에 연결되지 않는 이유 찾기를 참고하세요.

질문

306은 무엇인가요?

306은 웹 프록시(HTTP)에 대한 같은 메시지입니다. 프록시 목록의 HTTP 프록시 항목을 확인하세요.

왜 많은 앱이 한꺼번에 실패하나요?

같은 시스템 프록시를 사용하기 때문입니다.

출처

  • macOS 27.2의 CFNetwork.framework 오류 메시지(Localizable.loctable)
  • curl(1) 및 nc(1), macOS 27.2와 함께 설치된 man 페이지

2026년 10월 29일 확인했습니다.