---
title: "Mac 프록시 설정으로 앱에 문제가 발생하는 경우: 찾기 및 해결 · Kilobat 가이드"
url: "https://kilobat.app/ko/guides/proxy-settings-breaking-apps"
description: "Mac 앱 또는 터미널 도구의 연결을 막는 시스템 프록시, PAC 파일 또는 HTTPS_PROXY 변수를 찾아 수정하거나 제거하세요."
---

VPN, 프록시 및 필터

# 프록시 설정으로 인해 Mac에서 앱이 연결되지 않습니다

프록시 설정은 다른 서버를 통해 트래픽을 보냅니다. 해당 서버가 잘못되었거나 사용할 수 없으면 일부 앱이 연결되지 않을 수 있지만 다른 앱은 정상 작동할 수 있습니다.

적용 대상: 시스템 설정 경로는 macOS 13 Ventura 이상. 명령은 현재 모든 macOS 버전에서 작동합니다. · 확인일: 2026년 10월 29일

## 증상

- Safari는 작동하지만 한 앱 또는 터미널 도구에 시간 초과 또는 “프록시” 오류가 표시됩니다.
- 앱이 집에서는 연결되지만 다른 네트워크에서는 실패하거나 그 반대입니다.
- 명령줄 도구에서 “프록시를 확인할 수 없음” 오류가 발생하거나 로컬 포트 연결이 거부됩니다.
- VPN 또는 프록시 앱이 종료된 후 연결이 중단됩니다.

## 가능한 원인

- **오래된 시스템 프록시.** 시스템 설정에서 지정한 프록시는 해당 프록시가 필요한 네트워크를 떠난 후에도 유지됩니다.
- **PAC 파일 또는 자동 프록시 검색.** Mac이 URL에서 프록시 규칙을 가져옵니다. URL을 불러올 수 없으면 일부 앱이 연결되지 않습니다.
- **프록시 환경 변수.** 터미널 도구는 `http_proxy`, `https_proxy` 및 `all_proxy`을(를) 읽습니다. 이 변수는 시스템 설정의 프록시를 변경하지 않으며 Dock에서 실행한 앱에는 적용되지 않습니다.
- **중지된 프록시 앱.** 일부 앱은 127.0.0.1과 같은 로컬 포트에 프록시를 설정합니다. 앱이 중지되면 해당 포트에서 수신하는 대상이 없습니다.
- **자체 프록시 설정이 있는 앱.** 일부 앱은 자체 설정에 프록시 필드가 있습니다. 이 필드는 시스템 프록시와 별개입니다.

## 확인 방법

1. 터미널을 여세요. macOS가 현재 사용하는 프록시 구성을 표시합니다.

   ```
   scutil --proxy
   ```

   출력 `HTTPEnable`, `HTTPSEnable`, `ProxyAutoConfigEnable` 및 `ProxyAutoDiscoveryEnable` 같은 키. 값 1은 켜짐을 뜻합니다.
2. 한 네트워크 서비스의 HTTP 및 HTTPS 프록시를 표시합니다. 필요한 경우 Wi-Fi를 해당 서비스 이름으로 바꾸세요.

   ```
   networksetup -getwebproxy Wi-Fi
   networksetup -getsecurewebproxy Wi-Fi
   ```
3. PAC 파일과 자동 프록시 검색 설정을 표시합니다.

   ```
   networksetup -getautoproxyurl Wi-Fi
   networksetup -getproxyautodiscovery Wi-Fi
   ```
4. 셸의 프록시 변수를 표시합니다.

   ```
   env | grep -i proxy
   ```
5. 프록시가 127.0.0.1을 가리키면 해당 포트에서 수신하는 대상을 찾으세요. 7890을 포트 번호로 바꾸세요.

   ```
   lsof -nP -iTCP:7890 -sTCP:LISTEN
   ```

## 해결 방법

1. Apple 메뉴 > 시스템 설정 > 네트워크를 선택하세요. 네트워크 서비스를 클릭한 다음 세부사항을 클릭하세요.
2. 프록시를 클릭하세요. 네트워크에 필요하지 않은 각 프록시 유형을 끄세요.
3. 일부 호스트는 프록시를 사용하면 안 됩니다. “다음 호스트 및 도메인에 대한 프록시 설정 무시”에 추가하세요.
4. 변경 사항을 저장하려면 확인을 클릭하세요.
5. 터미널에서 웹 프록시를 끄려면 networksetup을 사용하세요. macOS가 관리자 암호를 요청할 수 있습니다.

   ```
   networksetup -setwebproxystate Wi-Fi off
   networksetup -setsecurewebproxystate Wi-Fi off
   ```

   관리자 암호가 필요합니다.
6. `~/.zshrc` 같은 셸 시작 파일에서 오래된 프록시 변수를 제거하세요. 그런 다음 새 터미널 윈도우를 여세요.
7. 문제가 있는 앱의 설정에서 자체 프록시 필드를 찾으세요. 네트워크에 맞게 설정하세요.

## Kilobat 사용

1. Kilobat의 연결 검사는 시스템 프록시와 PAC 파일을 보고합니다. 직접 경로와 프록시 경로도 테스트합니다.

   ```
   kilobat why api.example.com
   ```
2. 해당 앱 환경의 프록시 변수를 읽으려면 `--app`을 추가하세요. 암호는 표시되지 않습니다.

   ```
   kilobat why https://api.example.com/v1/models --app com.example.App
   ```
3. 앱에 자체 프록시 설정이 있다면 `--proxy`로 해당 주소를 지정합니다.

   ```
   kilobat why huggingface.co --proxy http://127.0.0.1:7890
   ```
4. 검사는 무료입니다. 앱 및 MCP 단계는 [특정 사이트 또는 API에 연결되지 않는 이유 찾기](https://kilobat.app/ko/guides/recipes/why-cant-it-connect)를 참조하세요.

## 질문

**터미널에서는 실패하지만 Safari에서는 작동하는 이유는 무엇인가요?**

Safari는 시스템 프록시를 사용합니다. 터미널 도구는 셸의 프록시 변수를 사용합니다. 두 설정은 다를 수 있습니다.

**자동 프록시 검색이란 무엇인가요?**

Mac이 네트워크에서 프록시 규칙을 찾습니다. 프록시가 없는 네트워크에서는 이 기능을 끌 수 있습니다.

## 출처

- [Apple 지원: Mac에서 프록시 설정 변경](https://support.apple.com/guide/mac-help/change-proxy-settings-on-mac-mchlp2591/mac)
- scutil(8), macOS 27.2와 함께 설치된 매뉴얼 페이지
- networksetup(8), macOS 27.2와 함께 설치된 매뉴얼 페이지
- lsof(8), macOS 27.2와 함께 설치된 매뉴얼 페이지

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

## 관련 가이드

- [한 사이트 또는 API에 연결되지 않는 이유 찾기](https://kilobat.app/ko/guides/recipes/why-cant-it-connect): 인터넷은 작동하지만 한 주소에 연결할 수 없을 때 Kilobat이 각 계층을 차례로 확인합니다.
- [회사 프록시 인증서로 인해 Mac의 터미널 도구가 작동하지 않음](https://kilobat.app/ko/guides/corporate-proxy-certificates): 일부 회사 네트워크는 HTTPS 트래픽을 검사합니다.
- [Mac에서 Homebrew 또는 npm 다운로드 실패](https://kilobat.app/ko/guides/homebrew-npm-download-fails): Homebrew는 curl과 Git으로 다운로드합니다.
- [Mac에서 VPN이 연결되었지만 인터넷이 안 되는 경우](https://kilobat.app/ko/guides/vpn-connected-no-internet): VPN은 터널을 통해 트래픽을 전송합니다.