Android Sniffing on Ubuntu with mitmproxy¶
This guide walks you through setting up an Android emulator on Ubuntu, installing a custom CA certificate, and using mitmproxy to intercept traffic. It also includes an optional Python addon for enhanced output filtering.
📋 Prerequisites¶
- Ubuntu 22.04+
- Docker (for running mitmproxy)
- Android Studio (for emulator and ADB)
- CA certificate (
ca.crtandca.pem) in the./certs/folder- Created by
bash scripts/certs/create-cert.shor by Bumper at startup; see Certificates
- Created by
🚀 Install Android Studio & SDK¶
Install Android Studio via Snap:
Launch Android Studio and follow the initial setup to install the SDK and platform-tools.
Tip
Install the SDK under ~/.android/Sdk for consistency.
🖥️ Create an Emulator¶
- Open AVD Manager (Virtual Device Manager).
- Click Create Virtual Device.
- Choose a device (e.g., Pixel 6 Pro) without Google Play Store.
- Select a system image with API 28 (Android 9 Pie) or lower to allow system CA installation.
🔧 Prepare the Emulator¶
(Optional) Disable Quickboot file-backed feature (can help with BTRFS-related emulator issues):
List available AVDs:
Start the emulator with root access and writable system.
Replace <AVD_NAME> with an AVD from the list above:
~/.android/Sdk/emulator/emulator \
-avd <AVD_NAME> \
-writable-system \
-no-boot-anim \
-gpu host \
-cores 4 \
-memory 4096
Restart ADB as root and remount:
🔒 Install the CA Certificate¶
Push your custom CA into the emulator's system trust store. The emulator must
be started with -writable-system and ADB remounted as root (see
Prepare the Emulator):
HASH=$(openssl x509 -inform PEM -subject_hash_old -in certs/ca.crt | head -1)
~/.android/Sdk/platform-tools/adb push certs/ca.crt "/system/etc/security/cacerts/${HASH}.0"
~/.android/Sdk/platform-tools/adb reboot
~/.android/Sdk/platform-tools/adb wait-for-device
Note
On Android 10 and newer the system partition is read-only. Install the CA as a user certificate instead, and use an app that trusts user CAs (for example the patched app from Defeating Certificate Pinning).
📱 Install the Target App and Proxy App¶
1️⃣ Install Ecovacs Home App¶
Download and install version 2.4.1 of the Ecovacs Home APK:
Note
To reverse newer app versions, you need to unpin the certificate first. See Defeating Certificate Pinning for instructions.
- Ecovacs Home on APKPure (older versions may be easier to inspect; newer versions may require certificate pinning bypass)
Install the app on the emulator:
Tip
Drag-and-drop the APK onto the emulator window.
2️⃣ Install SOCKS5 Proxy App¶
Install a SOCKS5 proxy client (e.g., Super Proxy):
- Use a SOCKS5 proxy app on the emulator/device (for example, Proxy Server on APKPure or another SOCKS5 client; verify the app/package before installing).
🌐 Configure Proxy on Android¶
In the emulator's network or proxy app settings:
- Protocol: SOCKS5
- Host:
<YOUR_SERVER_IP> - Port:
1080
This routes all emulator traffic through mitmproxy.
⚙️ Run mitmproxy with Docker Compose / Swarm¶
The repository includes docker-compose-mitm.yaml with pre-defined mitmproxy settings and helper scripts.
It uses certs/ca.pem, so make sure your Bumper certificates exist.
Docker Compose
Docker Swarm
Alias
This uses the docker-swarm-compose alias.
Pass the compose file with -f; setting COMPOSE_FILE is not enough. The
final argument is the stack name.
Access http://localhost:8081 to inspect traffic.
🐍 Optional: Python Script Addons¶
docker-compose-mitm.yaml mounts helper scripts from configs/ (mitm-cmd.py, mitm-mqtt.py, mitm-dns.py).
Script loading is controlled by environment variables, so you can enable only what you need:
| Variable | Default | Script | Purpose |
|---|---|---|---|
MITM_SCRIPT_CMD |
1 |
/tmp/mitm-cmd.py |
Capture/filter HTTP command traffic |
MITM_SCRIPT_MQTT |
0 |
/tmp/mitm-mqtt.py |
MQTT sniffing |
MITM_SCRIPT_DNS |
1 |
/tmp/mitm-dns.py |
DNS helper/filtering |
Examples:
# Enable MQTT sniffing in addition to defaults
MITM_SCRIPT_MQTT=1 docker compose -f docker-compose-mitm.yaml up -d
# Only the MQTT script
MITM_SCRIPT_CMD=0 MITM_SCRIPT_MQTT=1 MITM_SCRIPT_DNS=0 docker compose -f docker-compose-mitm.yaml up -d
You can also set MITM_WEB_PW to change the mitmweb password (default: mitm) and MITM_PATH for capture output.
🛠️ Troubleshooting¶
- SSL errors: Verify the CA hash and placement.
- Emulator won't root: Use API 28 or lower with
-writable-system. - App 2003 errors: Launch the app once without proxy to fetch initial data.