# iOS 기기

> Mac의 Proxyman으로 iPhone과 iPad의 HTTP/HTTPS 트래픽을 캡처하세요. Wi-Fi 프록시를 설정한 뒤, 기기에 Proxyman 인증서를 설치하고 신뢰하도록 설정합니다.

iPhone이나 iPad의 트래픽을 캡처하려면, 기기의 Wi-Fi 트래픽을 컴퓨터의 Proxyman을 거치도록 설정해야 합니다. HTTPS 검사를 하려면 Proxyman 인증서를 설치하고, 기기에서 이 인증서를 명시적으로 신뢰하도록 설정해야 합니다. 이 두 과정은 별도의 단계입니다.

Proxyman을 실행한 상태로 두고, 기기를 컴퓨터에 접근할 수 있는 네트워크에 연결하세요. 기기의 IP 주소가 아니라, 설정 가이드에 표시된 컴퓨터의 IP 주소와 Proxyman 포트를 사용하세요.

Proxyman에서 실제 기기 설정 가이드를 여세요:

* **Certificate** **Menu** -> **Install Certificate on iOS -> Physical Devices...**

> **팁:** 이 설정 가이드는 iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro를 포함한 모든 실제 기기에서 작동합니다.

## iOS 설정 가이드 {#ios-setup-guide}

![Wi-Fi 프록시 서버와 포트, proxy.man/ssl 링크, 설치 및 신뢰 단계가 표시된 Proxyman iOS 설정 가이드](https://proxyman.com/docs/assets/proxyman-ios-setup-guide.jpg)

_실제 기기용 iOS 설정 가이드_

다음 단계를 따르세요:

1. Mac에 **Root Proxyman Certificate**를 설치합니다. [macOS 가이드](https://proxyman.com/docs/ko/debug-devices/macos)를 참고할 수 있습니다.
2. iOS 기기에서 Settings 앱 -> Wi-Fi -> 현재 Wi-Fi 선택 -> HTTP Proxy를 아래 표의 값으로 설정합니다.

| 이름           | 값                                                  |
| -------------- | --------------------------------------------------- |
| Server IP      | Mac의 현재 IP 주소                                  |
| Port           | Proxyman의 현재 포트 (기본값: 9090)                 |
| Authentication | No                                                  |

> **노트:** macOS 또는 iOS 기기에서 **VPN 앱**을 사용 중이라면 모두 종료하세요. VPN 앱은 HTTP Proxy 설정과 충돌합니다.

  3\. iOS 기기의 **Safari 비공개 탭**에서 [http://proxy.man/ssl](http://proxy.man/ssl) 또는 [http://cert.proxyman.io](http://cert.proxyman.io/)를 열어 Proxyman 인증서를 다운로드하세요.

> **노트:** **http://proxy.man/ssl**과 **http://cert.proxyman.io**는 Proxyman 내부의 HTTP 서버가 제공하는 로컬 웹사이트입니다. 열리지 않는다면 Wi-Fi 네트워크를 삭제한 뒤 다시 연결하고, Proxyman 앱이 열려 있는지 확인하세요.
>
> 그래도 접속할 수 없다면 [Proxyman GitHub 저장소](https://github.com/ProxymanApp/Proxyman)에 지원 요청을 등록해 주세요.

    4\. iOS 10.3부터는 Settings 앱에서 Proxyman CA를 명시적으로 설치하고 신뢰해야 합니다.

#### **Proxyman CA 설치** {#install-proxyman-ca}

* **iOS ≥ 12.2**: iPhone에서 -> Settings 앱 열기 > Profile Downloaded > Proxyman CA 선택 > Install

#### Proxyman CA 신뢰 {#trust-proxyman-ca}

프로필을 설치하는 것만으로는 완전한 신뢰가 설정되지 않습니다. HTTPS 트래픽을 테스트하기 전에 이 단계를 완료하세요:

* Settings 앱 > General > About > Certificate Trust Settings > Proxyman CA 스위치를 ON으로 설정합니다.

![Proxyman CA의 iOS 프로필 설치 화면과 Certificate Trust Settings 스위치가 켜진 모습](https://proxyman.com/docs/assets/install_and_trust_proxyman_certificate.png)

> **노트:** iOS 기기에 Proxyman CA를 **설치**하고 **신뢰**했는지 반드시 확인하세요. 문제가 있다면 **support@proxyman.com**으로 이메일을 보내거나 [**GitHub**](https://github.com/ProxymanApp/Proxyman)에 이슈를 등록해 주세요.

> **노트:** 설정을 마친 후, 도메인에 대해 [SSL Proxying](https://proxyman.com/docs/ko/basic-features/ssl-proxying)을 활성화하고 새 요청을 보내세요. 트래픽이 나타나지 않으면 [기기 연결 문제 해결 가이드](https://proxyman.com/docs/ko/troubleshooting/my-ios-devices-couldnt-connect-to-proxyman-via-proxy)를 참고해 Wi-Fi 프록시 IP와 포트, 네트워크 연결, VPN 설정을 확인하세요. 요청은 보이지만 HTTPS가 실패한다면 인증서 설치와 신뢰 설정을 다시 확인하세요.

> **노트:** Proxyman으로 디버깅하지 않을 때는 반드시 **iPhone에서 인증서를 삭제**하세요. 그렇지 않으면 HTTP/HTTPS 요청이 가로채여 민감한 데이터가 유출될 수 있습니다.

## 튜토리얼 {#tutorial}

Proxyman으로 [iOS 기기에서 앱 디버깅하기](https://proxyman.com/posts/2019-06-16-How-I-use-Proxyman-to-see-HTTP-requests-responses-on-my-iPhone)의 자세한 단계를 확인하세요.

### 수동 설정이 번거로우신가요? {#tired-of-manual-config}

HTTP Proxy를 수동으로 변경하고 Proxyman 인증서를 설치하고 신뢰하는 작업은 번거롭습니다. 이 과정을 자동으로 처리해 주는 네이티브 iOS 프레임워크 Atlantis를 확인해 보세요.

- [Atlantis for iOS](https://proxyman.com/docs/ko/atlantis/atlantis-for-ios)

## Flutter 앱인가요? {#flutter-app}

앱이 Flutter 앱이라면 Proxyman에서 네트워크 트래픽이 보이지 않을 수 있습니다.

Flutter는 시스템 수준의 프록시를 사용하지 않으므로, 요청이 Proxyman으로 전달되지 않습니다. 이를 해결하려면 코드에서 HTTP 클라이언트가 프록시를 사용하도록 설정해야 합니다. 코드 예제는 [Flutter 가이드](https://proxyman.com/docs/ko/debug-devices/flutter)를 참고하세요.

[https://flutterigniter.com/debugging-network-requests/](https://flutterigniter.com/debugging-network-requests/)에 나오는 "Getting Charles to work with Flutter" 해결 방법도 따를 수 있습니다.

로컬 IP를 확인하려면 Certificate 메뉴 -> Install Certificate on iOS -> Physical Devices…로 이동하여 Server IP와 Port를 확인하세요.

## 더 알아보기 {#learn-more}

* [iOS 26 또는 iPadOS 26에서 iPhone의 HTTP/HTTPS 트래픽을 캡처하는 방법](https://proxyman.com/posts/how-to-capture-https-iOS-26-update-2025)
* [회사 VPN을 사용하는 iOS 앱에서 HTTPS 트래픽을 캡처하는 방법](https://proxyman.com/posts/capture-https-ios-app-with-company-vpn)
* [Proxyman으로 iPhone 및 iPad의 HTTPS 트래픽 캡처하기](https://proxyman.com/iphone-device) (Proxyman 웹사이트)