# Flutter

> 코드 변경 여부와 관계없이 Proxyman으로 Android 에뮬레이터, Android 기기, iOS 시뮬레이터, iPhone에서 실행되는 Flutter 앱의 HTTPS 트래픽을 캡처하세요.

## ✅ 1. 새로운 방법 {#-1-new-solution}

> **팁:** Proxyman 6.4.0 이상 또는 Windows/Linux 3.7.0 이상에서 지원됩니다

### Android 에뮬레이터 {#android-emulators}

Proxyman은 Android 에뮬레이터에서 실행 중인 Flutter 앱의 HTTPS 트래픽을 클릭 한 번으로 캡처할 수 있습니다. 기존 방법과 달리 Flutter 코드를 변경할 필요가 없습니다.

1. Proxyman을 실행한 다음 Certificate Menu -> Install Certificate on Android -> Emulators…를 선택합니다.
2. 먼저 Android 에뮬레이터를 설정했는지 확인하세요. 반드시 Google APIs 이미지여야 합니다.

Android 에뮬레이터를 설정하는 방법은 [automatic-script-for-android-emulator.md](https://proxyman.com/docs/ko/debug-devices/android-device/automatic-script-for-android-emulator)에서 확인하세요.

3. "Install Proxyman VPN on Android emulators" 옵션을 체크합니다.
4. "Override All Emulators" 버튼을 클릭합니다.

![Install Proxyman VPN 옵션이 체크되고 Override All Emulators 버튼이 있는 Proxyman Android Emulator 설정 가이드](https://proxyman.com/docs/assets/Screenshot%202026-01-10%20at%2019.29.46.jpg)

_Proxyman으로 Android 에뮬레이터에서 Flutter 앱의 HTTPS 캡처_

5. 새 Terminal 창이 열리고, 에뮬레이터 설정을 덮어쓰는 bash 스크립트가 실행됩니다.
6. 완료되면 에뮬레이터에 새 VPN 앱이 설치됩니다.
7. VPN 버튼을 눌러 시작합니다 -> 완료 ✅
8. Flutter 앱을 열고 HTTPS 요청을 보내세요. Proxyman이 이를 캡처합니다 ✅

![Android 에뮬레이터에서 연결되어 Flutter 및 React Native 트래픽을 Proxyman으로 라우팅하는 Proxyman VPN 앱](https://proxyman.com/docs/assets/Screenshot%202026-01-10%20at%2019.43.10.jpg)

## ⚠️ 2. 기존 방법 {#️-2-old-solution}

> **경고:** 기존 방법은 Proxyman macOS 6.3.0 이하, Windows/Linux 3.6.0 이하에서 동작합니다

### 2.1 문제 {#21-problem}

[Flutter는 시스템 수준 프록시를 사용하지 않습니다](https://github.com/flutter/flutter/issues/20376). 따라서 Proxyman을 사용해도 Flutter 프로젝트의 트래픽이 보이지 않을 수 있습니다.

다행히 Flutter의 HTTP 클라이언트가 Proxyman을 프록시로 사용하도록 설정하면 이 문제를 우회할 수 있습니다.

일반적으로 HTTP 클라이언트가 모든 트래픽을 Proxyman 프록시 서버(IP = localhost, 포트 = 9090)로 보내도록 설정해야 합니다.

#### 1. Flutter 설정 (모든 플랫폼 필수 - iOS 및 Android) {#1-set-up-flutter-required-for-all-platforms---ios--android}

단계는 HTTP 클라이언트마다 조금씩 다릅니다. 여기서는 널리 쓰이는 HTTP 클라이언트 몇 가지를 다룹니다:

* Dart의 [HttpClient](https://api.dartlang.org/stable/2.4.1/dart-io/HttpClient-class.html) 클래스
* [http](https://pub.dev/packages/http) 패키지
* [Dio](https://pub.dev/packages/dio)

Android 또는 iOS 시뮬레이터를 사용 중이라면 `String proxy = 'localhost:9090'`을 사용할 수 있습니다. Android 실제 기기에서는 `String proxy = '<YOUR_LOCAL_IP>:9090'`을 사용하세요.

\<YOUR\_LOCAL\_IP>는 Proxyman -> Certificate menu -> Install Certificate on iOS -> Physical Devices…에서 확인할 수 있습니다.

Flutter 앱에서 사용하는 네트워크 라이브러리에 맞는 아래 설정을 사용하세요:

#### Dart HTTPClient 클래스 {#dart-httpclient-class}

```dart
// Make sure to replace <YOUR_LOCAL_IP> with 
// the external IP of your computer if you're using Android. 
// You can get the IP in the Android Setup Guide window
String proxy = Platform.isAndroid ? '<YOUR_LOCAL_IP>:9090' : 'localhost:9090';

// Create a new HttpClient instance.
HttpClient httpClient = HttpClient();

// Hook into the findProxy callback to set
// the client's proxy.
httpClient.findProxy = (uri) {
  return "PROXY $proxy;";
};

// This is a workaround to allow Proxyman to receive
// SSL payloads when your app is running on Android
httpClient.badCertificateCallback = (cert, host, port) => true;
```

#### HTTP 패키지 {#http-package}

```dart
// Make sure to replace <YOUR_LOCAL_IP> with 
// the external IP of your computer if you're using Android. 
// You can get the IP in the Android Setup Guide window
String proxy = Platform.isAndroid ? '<YOUR_LOCAL_IP>:9090' : 'localhost:9090';

// Create a new HttpClient instance.
HttpClient httpClient = HttpClient();

// Hook into the findProxy callback to set
// the client's proxy.
httpClient.findProxy = (uri) {
  return "PROXY $proxy;";
};

// This is a workaround to allow Proxyman to receive
// SSL payloads when your app is running on Android.
httpClient.badCertificateCallback = (cert, host, port) => true;

// Pass your newly instantiated HttpClient to http.IOClient.
IOClient myClient = IOClient(httpClient);

// Make your request as normal.
final response = myClient.get('/my-url');
```

#### Dio ≥ v5.0.0 (권장) {#dio--v500-recommended}

```dart
// Make sure to replace <YOUR_LOCAL_IP> with 
// the external IP of your computer if you're using Android. 
// You can get the IP in the Android Setup Guide window
String proxy = Platform.isAndroid ? '<YOUR_LOCAL_IP>:9090' : 'localhost:9090';

// Create a new Dio instance.
Dio dio = Dio();

dio.httpClientAdapter = IOHttpClientAdapter(
  createHttpClient: () {
    final client = HttpClient();
    client.findProxy = (uri) {
      return 'PROXY $proxy';
    };
    client.badCertificateCallback = (cert, host, port) => true;
    return client;
  },
  validateCertificate: (cert, host, port) {
    return true;
  },
); 
```

#### Dio ＜ v5.0.0 (지원 중단된 API) {#dio--v500-deprecated-apis}

```dart
// Make sure to replace <YOUR_LOCAL_IP> with 
// the external IP of your computer if you're using Android. 
// You can get the IP in the Android Setup Guide window
String proxy = Platform.isAndroid ? '<YOUR_LOCAL_IP>:9090' : 'localhost:9090';

// Create a new Dio instance.
Dio dio = Dio();

// Tap into the onHttpClientCreate callback
// to configure the proxy just as we did earlier.
(dio.httpClientAdapter as DefaultHttpClientAdapter).onHttpClientCreate = (client) { 
  // Hook into the findProxy callback to set the client's proxy.
  client.findProxy = (url) {
    return 'PROXY $proxy';
  };
  
  // This is a workaround to allow Proxyman to receive
  // SSL payloads when your app is running on Android.
  client.badCertificateCallback = (X509Certificate cert, String host, int port) => true;
}
```

### 2.2 iOS 시뮬레이터에서 Flutter {#22-flutter-with-ios-simulators}

1. Flutter에서 iOS 시뮬레이터를 시작합니다.
2. Proxyman -> Certificate menu -> Install Certificate on iOS -> Simulators…를 선택합니다.
3. 아래 단계를 모두 따르세요.

![Installed &#x26; Trusted, Prepare Simulators, Reboot 세 단계가 있는 Proxyman iOS Simulators 설정](https://proxyman.com/docs/assets/proxyman-ios-simulators-setup.jpg)

_Proxyman 인증서를 iOS 시뮬레이터에 설치 &#x26; 신뢰_

4. ✅ 완료. Proxyman이 HTTPS 트래픽을 캡처할 수 있습니다.

### 2.3 iOS 기기에서 Flutter {#23-flutter-with-ios-devices}

* [iOS 기기 설정 가이드](https://proxyman.com/docs/ko/debug-devices/ios-device)를 따르세요.

### 2.4 Android 에뮬레이터에서 Flutter {#24-flutter-with-android-emulator}

* [Android 에뮬레이터용 자동 스크립트 가이드](https://proxyman.com/docs/ko/debug-devices/android-device/automatic-script-for-android-emulator)를 따르세요.

### 2.5 Android 기기에서 Flutter {#25-flutter-with-android-devices}

* [Android 기기 설정 가이드](https://proxyman.com/docs/ko/debug-devices/android-device)를 따르세요.

#### 크레딧 및 참고 자료 {#credit--reference}

크레딧: [https://flutterigniter.com/debugging-network-requests/](https://flutterigniter.com/debugging-network-requests/)의 James Dixon

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

* [Android 에뮬레이터에서 Flutter 앱의 HTTPS 트래픽을 캡처하는 방법](https://proxyman.com/posts/Capture-https-flutter-android-emulator)
* [Flutter iOS 앱의 HTTPS 트래픽을 캡처하는 방법](https://proxyman.com/posts/2024-11-11-capture-https-traffic-from-flutter-ios)
* [Proxyman으로 Flutter 앱의 HTTP/HTTPS 트래픽 캡처하기](https://proxyman.com/flutter) (Proxyman 웹사이트)