Connect. Automate.
Rotate.

Installation

Install the Android app first, then connect with the browser extension or configure the proxy endpoint manually.

1. Android APK

1. Allow app installation from your selected source in Android Settings.
2. Open the downloaded APK and confirm installation.
3. Launch 8PROXY and allow notifications. The foreground notification keeps the service active.

2. First start

1. Connect the phone and client to the same local network.
2. Keep cellular data active on the phone.
3. Use protocol AUTO and port 8888 unless your client requires a specific mode.
4. Enable Basic Auth when the local network is shared.
5. Tap Start and copy the endpoint shown in the app.

3. Enable IP rotation: set 8PROXY as the assistant

1. Open 8PROXY and tap Rotate IP Address.
2. Open Settings → Apps → Default apps → Digital assistant app. On Samsung, use Settings → Apps → Choose default apps → Digital assistant app.
3. Select 8PROXY and confirm.
4. Return to 8PROXY and tap Rotate IP Address again.

Visual interface guide

The numbered markers identify the controls and values shown by the current Android app.

Dashboard

01 02 03 04 05 06 07 08

1. 01
   Start / Stop

   Starts or stops the proxy. The center shows the connection time.

2. 02
   Proxy address + copy

   Copy this address into the extension, browser, script, or proxy client.

3. 03
   Rotate IP Address

   Requests an immediate mobile IP change.

4. 04
   Mobile public IP

   The public address used by proxy traffic.

5. 05
   Local Wi‑Fi / USB address

   The phone address used by clients on the local network.

6. 06
   Settings

   Opens rotation, authentication, port, protocol, and interface settings.

7. 07
   Proxy status

   ACTIVE means the local proxy is running.

8. 08
   Cellular warning

   Mobile internet is unavailable. Proxy traffic cannot exit through the SIM.

Traffic & status

09 10 11 12 13 14

9. 09
   Upload

   Total data sent through the proxy during the current session.

10. 10
    Download

    Total data received through the proxy during the current session.

11. 11
    Rotation count

    Number of completed IP rotations in the current run.

12. 12
    Rotation interval

    Configured time between automatic IP rotations.

13. 13
    Ping

    Current mobile-network latency.

14. 14
    Protocol

    Active mode: AUTO, HTTP/S, or SOCKS5.

Settings

01 02 03 04 05 06 07

1. 01
   IP Rotation

   Enables the rotation subsystem. Turn it off when the proxy must keep the same carrier session.

2. 02
   Interval (minutes)

   0 means link/button-only rotation. Values from 1 to 1440 schedule automatic rotation while the service is running.

3. 03
   Rotation URL

   Copyable local endpoint for scripts and AI agents: http://8proxy.local:PORT/newip.

4. 04
   Protect /newip

   Requires a key on rotation requests. Enable this on shared Wi‑Fi so other devices cannot rotate the phone anonymously.

5. 05
   Authentication

   Requires a username and password for proxy traffic. This is separate from the /newip key.

6. 06
   Port

   Local listening port. Default: 8888. Clients, the extension, and control URLs must all use the same port.

7. 07
   Protocol

   AUTO detects HTTP or SOCKS5 on the same port. HTTP supports plain HTTP and HTTPS CONNECT. SOCKS5 is for SOCKS-compatible clients and remote DNS.

8. 08
   Connection interface — conditional

   The WI‑FI / USB selector appears only when both interfaces are available. It chooses the local address advertised to clients; outgoing traffic still uses cellular data.

Protect the /newip URL

01 02 03

1. 01
   Enable the key gate

   When enabled, /newip rejects requests that do not contain the correct key.

2. 02
   Protected URL preview

   The copyable URL automatically includes ?key=…. Treat it as a local control secret.

3. 03
   NEWIP KEY

   An eight-character key is generated when the gate is enabled for the first time. Edit it if needed; the screenshot uses the non-secret example DEMO_KEY.

Proxy authentication

01 02 03

1. 01
   Proxy Authentication

   Protects HTTP and SOCKS5 proxy access with credentials. Recommended on any network you do not fully trust.

2. 02
   Login

   Proxy username. Leave it empty to let 8PROXY generate one when the proxy starts.

3. 03
   Password

   Proxy password. Leave it empty for automatic generation. Copy the complete authenticated endpoint from the Dashboard.

Android: Digital Assistant

Digital Assistant

01

Choose 8PROXY

02

1. 01
   Check the assistant

   The Digital assistant app row must show 8PROXY.

2. 02
   Choose 8PROXY

   Open the row and select 8PROXY.

3. 03
   Test IP rotation

   Return to 8PROXY and tap Rotate IP Address.

Chrome extension

8PROXY Proxy Manager connects Chrome to 8PROXY Mobile and keeps additional proxy profiles in one place.

Install in Chrome

1. 01
   Open the store page

   Go to 8PROXY in the Chrome Web Store.

2. 02
   Add to Chrome

   Click “Add to Chrome”, then confirm with “Add extension”.

3. 03
   Pin it

   Pin Proxy Manager from Chrome’s Extensions menu.

Main screen

• Current connectionPublic IP, country, session time, rotation count, ping, and protocol.
• Rotate IPThe circular arrows request a new mobile public IP.
• 8PROXY MobileYour phone’s local proxy endpoint. Use the power button to connect or disconnect it.
• Refresh / SettingsReload connection data or open proxy settings.

Proxy list

• 8PROXY MobileThe local address detected from your phone.
• Other ProxySaved HTTP and SOCKS5 profiles with location and ping.
• Power buttonConnect to the selected proxy or disconnect it.
• Refresh / SettingsRefresh the list or open proxy management.

Settings

• Add ProxyEnter the proxy IP and port. Name, username, password, and note are optional.
• Rotation URLAdd the provider’s URL when the proxy supports IP rotation.
• Import listAdd multiple proxy profiles from a prepared list.

Bypass

• Bypass listAdd one host rule per line. Matching addresses connect directly without the proxy.
• DefaultsRestore the default local-address rules.
• Save RulesApply the current bypass list.

Backup

• Export BackupDownload all proxy profiles and settings as a JSON file.
• Import BackupReplace the current profiles and settings with a backup.
• Keep it privateThe backup can contain proxy passwords in plain text.

Network path

Every client reaches the phone over the local network. 8PROXY then creates a separate upstream connection bound to the phone’s cellular network.

flowchart LR
  CLIENTS["Browser · AI agent · curl · app"]
  LAN["Wi-Fi or USB LAN"]
  PROXY["8PROXY on Android
8proxy.local:8888"]
  CELL["SIM · Cellular network"]
  WEB["Internet destination"]
  CLIENTS --> LAN --> PROXY --> CELL --> WEB
  classDef core fill:#180b08,stroke:#ff5424,color:#ffffff,stroke-width:2px
  classDef edge fill:#0b0b0e,stroke:#34343b,color:#f4f4f1
  class PROXY core
  class CLIENTS,LAN,CELL,WEB edge
            

Address & protocols

The proxy listens on port 8888 by default. Use mDNS when supported or the phone’s LAN address shown in the app.

API for AI & automation

The control API is intentionally small and runs on the same host and port as the proxy. It is designed for local scripts, orchestration tools, and AI agents that can make HTTP requests or run shell commands.

Base URL

GET /status

running=true confirms that the listener is active. It does not guarantee that the carrier currently has working internet, so critical automation should also perform a request through the proxy.

GET /newip

Response contract

Agent-ready shell runbook

IP rotation

A rotation briefly resets the cellular radio, waits for mobile service to return, closes stale upstream sockets, and reports the newly observed public IP.

ADB control & phone reboot

The code contains several control paths that look similar from the outside but do different work. ADB is the system-control channel; the HTTP API and the app’s internal rotation pipeline are separate.

What “restart” means

Internal commands vs external ADB

AirplaneModeService contains internal Runtime.exec attempts for cmd connectivity and svc data. They run as the normal app UID and usually fail on a non-rooted consumer phone because those commands require shell privileges. The app then falls back to the configured Digital Assistant path. This is not an embedded ADB client.

The ADB broadcast path is different: an external adb shell process sends an intent to the exported ProxyCommandReceiver, which then calls the same process-level ProxyCore rotation queue used by the UI and /newip.

Start, stop, rotate, and inspect

Direct external ADB rotation

These commands bypass ProxyCommandReceiver and change Android connectivity directly. The running proxy observes the network loss and rebinds when cellular service returns.

Restart only the 8PROXY app

Reboot the entire phone

Limits & operational notes

• An active SIM and working cellular data are required.
• The client and phone must be reachable on the same local network unless you provide your own secure private tunnel.
• mDNS 8proxy.local is convenient but not universal; use the numeric LAN IP as the fallback.
• Your carrier assigns the next public IP. A different address is not guaranteed after every radio reset.
• Active upstream connections may drop during rotation or when changing the proxy port or protocol.
• Basic Auth protects proxy use. The separate /newip key protects rotation. /status remains available on the local listener.
• The HTTP API cannot reboot Android, restart the app, or change system settings. Use ADB for those operations.
• Speed and latency depend on the phone, signal, plan, and carrier.