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
  • iOS Setup Guide
  • Tutorial
  • Tired of manual config?
  • Flutter app?
  1. Debug on Devices

iOS Device

How to set up iOS/iPad Devices with Proxyman, to capture and decrypt HTTPS request/response

PreviousmacOSNextiOS Simulator

Last updated 3 months ago

In order to capture HTTP/HTTPS messages in iOS devices (iPhone, iPad), please navigate to:

  • Certificate Menu -> Install Certificate on iOS -> Physical Device

iOS Setup Guide

⚠️ If you're iOS 16, there is an Apple bug that you could not set the HTTP Proxy. Please check out the .

Let's follow the guidelines:

  1. Get your iOS Device -> Open Setting app -> Wifi -> Select the current Wifi -> Config the HTTP Proxy by following the next tables.

Name

Value

Server IP

Your current IP Network

Port

The current port of Proxyman: 9090 is the default

Authentication

No

If you're using any VPN apps on macOS or iOS devices, please make sure to close all VPN apps, because they conflict with the HTTPS Proxy config.

http://proxy.man/ssl or http://cert.proxyman.io is a local website, which serves from the local Proxyman's HTTP server. If you can't open it, please forget the wifi, re-connect, and make sure the Proxyman app is opening.

4. From iOS 10.3, we have to explicitly install & trust the Proxyman CA in the Settings app

Install Proxyman CA

  • iOS ≥ 10.3: Setting app > General > Profiles > Select Proxyman CA > Install

  • iOS ≥ 12.2: Setting app > Profiles Downloaded > Select Proxyman CA > Install

Trust Proxyman CA

  • Setting app > General > About > Certificate Trust Settings > Switch ON on Proxyman CA.

Make sure that you delete the certificate on your iPhone when you're not debugging by Proxyman. If not, your HTTP/HTTPS requests can be intercepted and leak your sensitive data.

Tutorial

Tired of manual config?

We understand that manually overriding the HTTP Proxy and installing and trusting Proxyman Certificates is painful. Let's check out Atlantis, which is a native iOS framework that helps you do it automatically.

Flutter app?

You might not be able to see the Network Traffic on Proxyman if your app is a Flutter app.

Flutter does not use a system-level proxy, so requests to Proxyman will not be displayed. To do this, you must manually configure your HTTP client used in the code to work with a proxy.

To find out your local IP, please go to Certificate Menu -> Install Certificate on iOS -> Physical device and get the Server IP and Port

Install Root Proxyman Certificate on your machine: You can follow the .

3. Open or http://cert.proxyman.io by Safari browser from your iOS Devices in order to install the Proxyman Certificate.

If you can't access it. Please open the support ticket at .

Please make sure we install and trust the Proxyman CA on your iOS Device. If you have any problem, shoot us an email at support@proxyman.io or bump it to

If you cannot see any traffic from your iOS Devices, please check out this

See detailed steps on how to with Proxyman.

Please follow the solution "Getting Charles to work with Flutter" in

macOS Guide
http://proxy.man/ssl
Github's repo
Github
troubleshooting
debug an application on iOS device
Atlantis for iOS
https://flutterigniter.com/debugging-network-requests/
troubleshooting
Install Proxyman Certificate on iOS devices
Install and Trust Proxyman Certificate