Proxyman
HomepageDownload
  • Overview
  • Changelog
  • License
  • License Manager
  • Raycast
  • Command-line
  • Security Compliance
  • Proxyman iOS
    • Proxyman for iOS
    • Map Local for iOS
    • Breakpoint for iOS
    • Tutorial for iOS
      • Map Local for iOS Tutorial
      • Breakpoint for iOS Tutorial
  • Debug on Devices
    • macOS
    • iOS Device
    • iOS Simulator
    • tvOS & watchOS
    • Android Device & Emulator
      • Automatic Script for Android Emulator
      • Sample Android Project
    • Firefox
    • Java VMs
    • Python
    • Ruby
    • NodeJS
    • Rust
    • Golang
    • React Native
    • Flutter
    • HTTP Clients
    • Docker
    • ElectronJS
    • NextJS (fetch)
  • Automatic Setup
    • Automatic Setup
    • Manual Setup
    • Troubleshooting
  • Atlantis
    • Atlantis for iOS
  • BASIC FEATURES
    • Proxyman Proxy Helper Tool
    • Request / Response Previewer
    • SSL Proxying
    • Bypass Proxy List
    • Import / Export
    • Content Filter
    • Multiple Tabs
    • Horizontal/Vertical/Window Layout
    • Copy as
    • Custom Previewer Tab
    • Custom Header Column
    • Regex (Regular Expression)
    • Filter JSON Response
    • Highlight by Color and Add Comment
    • Import / Export Settings
    • Multipart Form-Data Previewer
    • JSONPath
    • Customize Toolbar
    • Localization
    • Quick Preview
  • ADVANCED FEATURES
    • Repeat
    • Edit & Repeat
    • Compose new Request
    • No Caching
    • Breakpoint
    • Breakpoint Templates
    • Map Local (File)
    • Map Local (Directory)
    • Map Remote
    • External Proxy
    • Save Session
    • Protobuf
    • WebSocket
    • Clear Session
    • Block List
    • Allow List
    • Charles Proxy Converter
    • Custom Certificates
    • GraphQL
    • Network Conditions
    • Multiple Filters
    • Custom Filters
    • Publish to Gist
    • Reverse Proxy
    • Code Generator
    • Diff
    • Access Control
    • DNS Spoofing
    • SOCKS Proxy
    • Swagger OpenAPI
    • TLS Key Logging
  • Proxyman Windows
    • Install Certificate
    • WSL
  • Scripting
    • Scripting
    • async/await Request
    • Addons
    • Built-in JS Libraries
    • Write your own Addons
    • Snippet Code
    • Environment Variables
  • Troubleshooting
    • Proxyman does not work with VPN apps
    • My Remote Devices (iOS/Android) could not connect to Proxyman?
    • iOS 16 and iOS 17 issues
    • SSL Error from HTTPS Request/Response
    • I could not see any requests from my localhost server
    • I could not see any HTTP traffic from my NodeJS, Python, or Ruby scripts
    • *.local requests do not appear on Proxyman
    • I couldn't see any traffics on Proxyman
    • I couldn't see any requests from 3rd-party network libraries
    • [Breakpoint] Modify Request/Response by Raw Message
    • Could not change Proxyman App Icons
    • Lost data after updating Proxyman app?
    • Proxyman consumes too much RAM & unresponsive
Powered by GitBook
On this page
  • 1. Problems
  • 2. Solution: iOS devices
  • 0. Issue with iOS 16 Physical Devices / Simulator
  • 1. Make sure your Mac device and iOS/Android devices are on the same network
  • 2. Make sure the server IP and Port number must match with Proxyman
  • 3. Turn OFF all VPN apps from macOS and iOS/Android devices
  • 4. Firewall settings (macOS)
  • 4. Firewall Setting (Windows 10/11)
  • 5. If you're using the Company Network, ask the Security team to open Proxyman's port 9090
  • 6. Use Private Browser on Safari to open http://cert.proxyman.io or http://proxy.man/ssl
  • 7. I'm still unable to connect.
  • 8. Still does not work? (iOS app only)
  • Android Devices and Android Emulators
  • 1. After setting HTTP Proxy in Wifi Setting, I could not open http://proxy.man/ssl
  • 2. Install and trust Proxyman CA for Android with API 30+
  • 3. My Android Physical Devices or Emulator connection is not stable.
  • 4. The adb command not FOUND! when using Android Emulator Automatic Script
  • 5. If you debug with Android Emulator and could not know how to install and trust Proxyman Certificate, please consider using Automatic Script for Android Emulator
  1. Troubleshooting

My Remote Devices (iOS/Android) could not connect to Proxyman?

A troubleshooting page to show how to make iOS/Android device to connect to Proxyman

PreviousProxyman does not work with VPN appsNextiOS 16 and iOS 17 issues

Last updated 3 months ago

1. Problems

  • ❌ My iOS or Android Devices could not access the Internet after changing the Proxy Config in the Wifi Setting.

  • ❌ I can't download the certificate from http://cert.proxyman.io or http://proxy.man/ssl

For Android, please follow the

2. Solution: iOS devices

Please make sure to double-check the following steps:

0. Issue with iOS 16 Physical Devices / Simulator

Some reports from Proxyman's users, that Proxyman and Charles Proxy could not capture any traffic from iOS 16 devices/simulator, even though they config the HTTP Proxy.

It's a bug from iOS, we have to wait for the Apple team to fix it.

To workaround:

iOS 16 physical devices:

  • Forget the network and try to connect again.

  • Use to capture the traffic

  • Use iOS 15 devices

iOS 16 Simulator:

  • Use iOS 15 Simulators

1. Make sure your Mac device and iOS/Android devices are on the same network

If they're on a different network, they are unable to connect to each other.

2. Make sure the server IP and Port number must match with Proxyman

3. Turn OFF all VPN apps from macOS and iOS/Android devices

By default, the VPN app will force all traffic through the VPN server instead of the Proxyman Proxy server (at 9090). Therefore, there are no requests that appear on the Proxyman app.

Turn OFF all VPN apps will fix it:

  • For iOS Devices: Navigate to Settings -> General -> VPN and make sure the VPN status is OFF

  • For Android Devices: Find the VPN setting on the Settings app and turn it OFF

  • For macOS: Quit all VPN apps

4. Firewall settings (macOS)

By default, a Firewall might block all incoming traffic to your mac. Thus, your remote devices might not be able to connect to Proxyman.

On macOS: Navigate to System Preference -> Security & Privacy -> Firewall tab -> Option

Verify that:

  • Block All incoming connections is OFF

  • Proxyman app allows incoming connection

  • If there is no Proxyman app, please add the Proxyman app by clicking on + button

  • Automatically allow built-in software to receive incoming connection is ON

  • Automatically allowing downloaded signed software to receive incoming connections is ON

4. Firewall Setting (Windows 10/11)

Windows 10/11 might block Proxyman, and iPhone/Android devices could not connect to the app. To fix it:

  1. Search and open the "Windows Defender Firewall" app -> Click the "Advanced Setting" on the left panel

  2. Select "Inbound Rules"

  3. Find Proxyman.exe -> Double-click to open the setting

  4. Select "Allow the Connection" in the General Tab

  5. Click OK

5. If you're using the Company Network, ask the Security team to open Proxyman's port 9090

Some companies block certain ports by default. Therefore, your iOS devices couldn't access to Proxyman's port at 9090.

6. Use Private Browser on Safari to open http://cert.proxyman.io or http://proxy.man/ssl

7. I'm still unable to connect.

If you follow all the above steps and all configuration is correct but it hasn't resolved your cases yet.

Please try to ON/OFF your Wifi, Forget the Wifi Network (iOS), and Restart the Computer.

8. Still does not work? (iOS app only)

Manual Override the HTTP Proxy, install and trust Proxyman on iOS devices is hard. We understand that. Let's try Atlantis, which is an iOS framework that helps you do it automatically.

Android Devices and Android Emulators

1. After setting HTTP Proxy in Wifi Setting, I could not open http://proxy.man/ssl

  • Double-check the Wifi Connection in the Emulator. It must be Connected Status (not Limited Connection or No Internet)

If it happens, please try to forget the network and re-connect the Wifi.

2. Install and trust Proxyman CA for Android with API 30+

From Android Emulator API 30+, it requires extra steps to trust the Proxyman Certificate

  • Open http://proxy.man/ssl from Google Chrome to download the certificate

  • Setting app -> Security -> Encryption & Credentials -> Install a Certificate -> CA Certificate -> Install Anyway and Select CA Proxyman Certificate in your storage

You can verify that by opening Trusted Credentials -> User Tab

3. My Android Physical Devices or Emulator connection is not stable.

It probably dues to the Android devices/emulators, the only way might fix it is to change the DNS from your Mac or Android Device to 8.8.8.8

  • On macOS: Open System Preference -> Network -> Select Wifi -> Advanced -> Select DNS Tab -> Enter 8.8.8.8 on DNS Server Table

  • On Android Device: Open Wifi Setting -> Set DNS as 8.8.8.8

4. The adb command not FOUND! when using Android Emulator Automatic Script

If you attempt to override Android Emulator and get the following error:

adb command line could not be found!!!

Please install the adb command line then try again!

Use to capture the traffic.

☝️

Read more at

5. If you debug with Android Emulator and could not know how to install and trust Proxyman Certificate, please consider using

Atlantis Framework
iOS 16 and iOS 17 issues
Atlantis for iOS
https://github.com/ProxymanApp/Proxyman/issues/636
Automatic Script for Android Emulator
Atlantis Framework
second section
Please follow the above troubleshooting
How to install ADB
Firewall setting on macOS
Allow Proxyman on Windows Firewall
Trust the Certificate