Skip to content
| Marketplace
Sign in
Visual Studio>Tools>Android Proxy Tunnel
Android Proxy Tunnel

Android Proxy Tunnel

hayman.dev LTD

| (0) | Free
Tunnel Android Emulator network requests to services running on your development machine. Host names the emulator asks for are mapped to addresses on your workstation and forwarded through a CONNECT t
Download

Android Proxy Tunnel

Let your Android Emulator reach the services running on your development machine, using the real host names your app already calls. No 10.0.2.2, no editing the emulator's hosts file, no leaving Visual Studio.


The problem it solves

Inside the Android Emulator, localhost is the emulator, not your PC. If your app calls a production-shaped name such as https://api.myapp.local.example, the emulator cannot resolve it, and swapping in 10.0.2.2 in your code breaks host-name routing, cookies and certificate checks.

Android Proxy Tunnel runs a small proxy inside Visual Studio. Point the emulator at it, map the names you care about, and your app keeps calling the names it was built to call.


Features

  • 🗺️ Host mapping — Map a host name and port the emulator asks for to a service on your workstation, such as api.myapp.local.example:443 to localhost:5001
  • 🔒 TLS is never touched — Secure connections are carried through as a plain tunnel. The extension does not decrypt, change or re-sign them, so a mapped service must present a certificate the emulator already trusts
  • 📋 Live activity list — See each request as it happens: the destination, how it ended, how much data moved each way and how long it took. Select a row and click + Add mapping for selected to turn a name that passed through into a mapping
  • ↪️ Optional pass-through — Turn on Forward unmapped to send names you have not mapped on to the internet as normal. It is off by default, so nothing leaves your machine unless you choose
  • ⚙️ Settings in the window — Port, bind address, timeouts and limits are all in the Proxy Settings section, each with a description, its default and its valid range. No hand-editing of files
  • 🔄 Safe editing — If the settings file changes outside Visual Studio, the window offers Reload or Overwrite, so an edit is never lost silently
  • 🎨 Follows your theme — Dark, Light and High Contrast, with keyboard focus outlines on every control

Getting started

  1. Install the extension from the Visual Studio Marketplace
  2. Open the window — View → Android Proxy Tunnel
  3. Add a mapping — enter the host name and Match port the emulator will ask for, and the Target port of your local service
  4. Click Start — the proxy listens on port 8888 by default
  5. Point the emulator at the proxy — in the emulator's Extended controls, open Settings → Proxy and set a manual proxy of 127.0.0.1 port 8888
  6. Run your app — mapped names now reach your local service

Safe by default

  • Listens on loopback only (127.0.0.1). Exposing the proxy to other computers asks you to confirm and shows a warning
  • Only the names you map are redirected. Anything else is refused unless you turn on Forward unmapped
  • Ports below 1024 are blocked unless you tick Allow ports below 1024
  • Stop closes open connections after about five seconds, so the proxy never hangs in the background
  • The activity list records where a connection went and how much data moved, never the content of a request or response

Requirements

  • Visual Studio 2022 or 2026 (Community, Professional or Enterprise)
  • The Android Emulator, with the ability to set a manual proxy in its settings
  • A service on your workstation to map to

FAQ / Troubleshooting

Issue Solution
The emulator cannot reach a mapped name Check the proxy is started, the emulator's proxy is set to 127.0.0.1:8888, and both the host name and the Match port match the mapping exactly. A mapping matches a name and a port
Request shows Failed / 502 The name is not mapped and Forward unmapped is off. Add a mapping from the activity list, or turn on Forward unmapped
"Port in use" when starting Another program holds the port. Choose a different port, or close the program the message names
Certificate error in the app The proxy does not intercept TLS. The mapped service must present a certificate the emulator already trusts for that host name
Cannot map to port 443 or another low port Tick Allow ports below 1024 in Proxy Settings
Changed the port or bind address while running These need a restart. The window tells you and offers to restart for you

Privacy

Android Proxy Tunnel sends no data to any external server and collects no telemetry. Settings are stored locally in %AppData%\AndroidProxyTunnel\config.json. Traffic is only sent onward when you map a name to a local service or turn on Forward unmapped.


Support

Questions, bugs and ideas: github.com/hayman-dev/Android-Proxy-Tunnel

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft