---
title: "Mac에서 There was a problem communicating with the secure web proxy server (HTTPS)(CFNetwork 오류 310) · Kilobat 가이드"
url: "https://kilobat.app/ko/guides/cfnetwork-error-310-problem-communicating-with-the-secure-web-proxy-server"
description: "앱이 There was a problem communicating with the secure web proxy server (HTTPS), CFNetwork 오류 310으로 실패합니다. 프록시 설정을 고치세요."
---

# 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에 연결되지 않는 이유 찾기](https://kilobat.app/ko/guides/recipes/why-cant-it-connect)를 참고하세요.

## 질문

**306은 무엇인가요?**

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

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

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

## 출처

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

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

## 관련 가이드

- [Mac에서 “Safari가 웹 프록시 서버에 연결할 수 없습니다”](https://kilobat.app/ko/guides/safari-cant-connect-proxy-server): 네트워크 설정에 웹 프록시가 설정되어 있지만 Safari가 연결할 수 없습니다.
- [프록시 설정으로 인해 Mac에서 앱이 연결되지 않습니다](https://kilobat.app/ko/guides/proxy-settings-breaking-apps): 프록시 설정은 다른 서버를 통해 트래픽을 전송합니다.
- [회사 프록시 인증서로 인해 Mac의 터미널 도구가 작동하지 않음](https://kilobat.app/ko/guides/corporate-proxy-certificates): 일부 회사 네트워크는 HTTPS 트래픽을 검사합니다.
- [Mac에서 콘텐츠 필터가 웹사이트를 차단하는 경우](https://kilobat.app/ko/guides/content-filter-blocking): 콘텐츠 필터가 웹 트래픽을 검사하고 일부 사이트를 차단합니다.
