burp-proxy

Manage Burp Suite proxy on Android devices/emulators via ADB.

Sets up an adb reverse tunnel and configures the Android global HTTP proxy so all device traffic flows through Burp. Also handles installing the Burp CA as a system-level certificate (root required) for HTTPS interception on Android 7+.

Usage

./burp_proxy.sh <command>

Command	Description
on	Enable proxy — creates ADB reverse tunnel and sets global HTTP proxy
off	Disable proxy — tears down tunnel and restores direct connection
status	Show proxy config, tunnel state, Burp listener, CA cert, and connectivity
cert	Download and install Burp CA as an Android system certificate

Environment

Variable	Default	Description
BURP_PORT	8080	Burp listener port on the host machine

Requirements

• adb in PATH with a connected device/emulator
• Burp Suite running on the host
• Root access on the Android device (for system CA installation)
• openssl and curl (for the cert command)

Examples

# Start intercepting
./burp_proxy.sh on

# Check everything is wired up
./burp_proxy.sh status

# First-time setup: install Burp CA as system cert
./burp_proxy.sh cert

# Done testing, restore direct connection
./burp_proxy.sh off

# Use a non-default port
BURP_PORT=9090 ./burp_proxy.sh on