# Android 에뮬레이터용 자동 스크립트

> Proxyman 자동 스크립트로 Android 에뮬레이터의 HTTP 프록시를 설정하고 Proxyman 인증서를 설치하세요. 클릭 한 번으로 HTTPS 트래픽을 캡처할 수 있습니다.

## 1. 무엇인가요? {#1-whats-it}

HTTP 프록시를 직접 변경한 뒤 Android 에뮬레이터에 Proxyman 인증서를 설치하고 신뢰하도록 설정하는 것은 복잡하고 실수하기 쉽습니다.

Proxyman에는 이 작업을 몇 초 만에 대신 해 주는 스크립트가 내장되어 있습니다. **Certificate Menu -> Install Certificate on Android -> Emulators…**에서 열 수 있습니다.

> **팁:** Proxyman 5.16.0 이상에서는 Proxyman 인증서를 시스템 수준 저장소에 설치할 수 있습니다. 이를 통해 Android 에뮬레이터의 모든 HTTPS 트래픽을 복호화할 수 있습니다.

> **노트:** Proxyman은 이제 Google Play 및 Google Play가 아닌 에뮬레이터를 모두 지원합니다. 클릭 한 번으로 프록시를 설정할 수 있습니다. [google-play-android-emulator-with-magisk.md](https://proxyman.com/docs/ko/debug-devices/android-device/google-play-android-emulator-with-magisk)를 참고하세요.

![Override All Emulators와 Install Proxyman VPN 옵션이 체크된 Proxyman Android 에뮬레이터 설정 가이드](https://proxyman.com/docs/assets/Screenshot%202026-01-10%20at%2019.29.46.jpg)

## 동영상 {#video}

[API 36 Android 에뮬레이터에서 네이티브 Android 앱(OkHttp)의 HTTPS 캡처](https://www.youtube.com/watch?v=CWInB7gZj6g)

## 2. 장점 {#2-benefit}

**클릭 한 번으로:**

* **✅ 자동으로** HTTP 프록시 설정 / 되돌리기
* **✅ 자동으로** Proxyman 인증서를 다운로드하고, 설치하고, 시스템 수준 저장소에서 신뢰하도록 설정합니다. 에뮬레이터의 모든 HTTPS를 복호화합니다. (Proxyman 5.16.0 이상에서 사용 가능)
* **network\_security\_config.xml**이 필요하지 않습니다
* **✅** 실수할 가능성이 적고 몇 번의 클릭으로 끝납니다

> **팁:** `adb`를 통해 Android 에뮬레이터와 Android 실제 기기 모두에서 작동합니다 (Proxyman v5.19.0 이상에서만 지원)

![Android 에뮬레이터에서 실행 중인 OkHttp 앱의 복호화된 HTTPS 요청을 보여 주는 Proxyman 메인 창](https://proxyman.com/docs/assets/Capture_HTTPS_Android_Emulator_proxyman.jpg)

_Proxyman으로 Android 에뮬레이터의 HTTPS를 캡처하고 복호화_

* Proxyman 인증서를 시스템 수준 저장소에 설치합니다.

### ✅ Flutter / React Native 앱 {#-flutter--react-native-app}

Proxyman macOS 6.4.0 이상에서는 코드 변경 없이 Flutter 앱의 HTTPS 트래픽을 캡처할 수 있습니다.

자세한 내용은 [flutter.md](https://proxyman.com/docs/ko/debug-devices/flutter) 문서를 참고하세요.

## 3. 사용 방법 {#3-how-to-use-it}

1. `adb` 명령이 설치되어 있는지 확인하세요. 설치되어 있지 않다면 설치하세요.

```bash
brew install android-platform-tools
```

2. Android Studio로 Android 앱을 여세요
3. Android Virtual Device Manager에서 새 에뮬레이터를 만드세요. **Google Play 이미지가 아닌지 확인하세요. 반드시 Google APIs 이미지여야 합니다.**

* ✅ NEW: Proxyman으로 이제 Google Play Store 에뮬레이터도 루팅할 수 있습니다. [google-play-android-emulator-with-magisk.md](https://proxyman.com/docs/ko/debug-devices/android-device/google-play-android-emulator-with-magisk)를 참고하세요.

4. Proxyman -> Certificate Menu -> Install Certificate on Android -> Emulators… -> Override All Emulators 버튼을 클릭하세요

5. Terminal 스크립트가 완료될 때까지 기다리세요

6. Android Studio에서 Android 앱을 다시 실행하세요
7. Proxyman이 모든 HTTPS 데이터를 캡처합니다 ✅

> **노트:** Proxyman을 종료한다면 Revert All Changes 버튼을 반드시 클릭하세요. 그렇지 않으면 Android 에뮬레이터가 인터넷에 접속할 수 없습니다.

## 4. ⚠️ Proxyman 5.15.0 이하 {#4-️-proxyman-5150-or-earlier}

* Proxyman 5.15.0 이하에서는 Proxyman 인증서를 사용자 수준에만 설치할 수 있습니다.
* 따라서 다음 단계를 직접 수행해야 합니다:
* 소스 코드에서:
  * res/xml/network\_security\_config.xml 추가

```xml
<network-security-config>
    <debug-overrides>
        <trust-anchors>
            <!-- Trust user added CAs while debuggable only -->
            <certificates src="user" />
            <certificates src="system" />
        </trust-anchors>
    </debug-overrides>

    <base-config cleartextTrafficPermitted="true">
        <trust-anchors>
            <certificates src="system" />
            <certificates src="user" />
        </trust-anchors>
    </base-config>
</network-security-config>
```

* AndroidManifest.xml에 추가

<pre class="language-xml"><code class="lang-xml">&#x3C;?xml version="1.0" encoding="utf-8"?>
&#x3C;manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    &#x3C;uses-permission android:name="android.permission.INTERNET" />

    &#x3C;application
        android:networkSecurityConfig="@xml/network_security_config">
        &#x3C;activity
            ...
        &#x3C;/activity>
    &#x3C;/application>

&#x3C;/manifest>
</code></pre>

## 5. 고급: 스크립트 수동 실행 {#5-advanced-run-the-script-manually}

Privacy & Security에서 Automation 권한을 허용하지 않고도 Terminal 앱에서 스크립트를 수동으로 실행할 수 있습니다.

### **스크립트 경로**: {#script-path}

```bash
/Applications/Proxyman.app/Contents/Frameworks/ProxymanCore.framework/Resources/install_certificate_android_emulator.sh
```

* Proxyman 5.19.0 이상

```bash
Usage: /Applications/Proxyman.app/Contents/Frameworks/ProxymanCore.framework/Resources/install_certificate_android_emulator.sh -m <mode> [options]

Modes:
  all             Set proxy and install certificate
  proxy           Set proxy only
  revertProxy     Revert proxy settings only
  certificate     Install certificate only

Required Options based on Mode:
  -m, --mode <mode>              : Operation mode (all, proxy, revertProxy, certificate)
  -i, --ip <ip_address>          : IP address (required for all, proxy, certificate)
  -p, --port <port_number>       : Port number (required for all, proxy, certificate)
  -c, --cert <path_to_cert.pem>  : Path to Proxyman certificate (required for all, certificate)

Optional Options:
  --include-physical            : Include physical devices (default: only emulators)
  -h, --help                    : Show this help message
```

### 인증서 준비 {#prepare-the-certificate}

1. Proxyman 앱을 여세요
2. 메인 툴바에서 현재 IP를 확인하세요
3. Certificate 메뉴 -> Export -> Root Certificate as PEM -> 바탕화면 폴더에 저장

### 5.1 HTTP 프록시 설정 및 시스템 수준 저장소에 인증서 설치 {#51-override-http-proxy-and-install-the-certificate-to-system-level-store}

* Proxyman v5.19.0 이상 (NEW)

```bash
bash /Applications/Proxyman.app/Contents/Frameworks/ProxymanCore.framework/Resources/install_certificate_android_emulator.sh --mode all --ip <current_ip> --port <port> --cert <certificate_path>
```

* Proxyman v5.18.0 이하

```bash
bash /Applications/Proxyman.app/Contents/Frameworks/ProxymanCore.framework/Resources/install_certificate_android_emulator.sh all <current_ip> <port> <certificate_path>
```

### 5.2 HTTP 프록시만 설정 {#52-only-override-http-proxy}

* Proxyman v5.19.0 이상 (NEW)

```bash
bash /Applications/Proxyman.app/Contents/Frameworks/ProxymanCore.framework/Resources/install_certificate_android_emulator.sh --mode proxy --ip <current_ip> --port <port>
```

* Proxyman v5.18.0 이하

```bash
bash /Applications/Proxyman.app/Contents/Frameworks/ProxymanCore.framework/Resources/install_certificate_android_emulator.sh proxy <current_ip> <port> 
```

### 5.3 HTTP 프록시 되돌리기 {#53-revert-http-proxy}

* Proxyman v5.19.0 이상 (NEW)

```bash
bash /Applications/Proxyman.app/Contents/Frameworks/ProxymanCore.framework/Resources/install_certificate_android_emulator.sh --mode revertProxy
```

* Proxyman v5.18.0 이하

```bash
bash /Applications/Proxyman.app/Contents/Frameworks/ProxymanCore.framework/Resources/install_certificate_android_emulator.sh revertProxy
```

## 6. 리프 인증서 만료 기간 {#6-left-certificate-expiry-date}

6.1 문제: Android WebView에서 HTTPS를 가로챌 때 이 오류가 발생합니다

❗️ Android WebView가 ERR\_CERT\_VALIDITY\_TOO\_LONG 오류와 함께 연결을 거부합니다

Proxyman Settings -> General -> 인증서 옆의 **More** -> **Leaf Certificate Expiry**에서 리프 인증서 만료 기간을 변경한 다음, 10일처럼 더 짧은 기간을 선택하세요.

![Proxyman Settings의 General 탭에서 인증서 More 메뉴가 열려 있고 Leaf Certificate Expiry가 10 days로 설정된 화면](https://proxyman.com/docs/assets/Screenshot%202026-08-28%20at%2014.28.54.jpg)

* 참고: [https://github.com/ProxymanApp/Proxyman/issues/2751](https://github.com/ProxymanApp/Proxyman/issues/2751)

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

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