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
  • Proxyman Proxy Helper Tool
  • Require user Permission for macOS 13 Ventura or later
  • Guest or non-admin users
  • Uninstall the Proxy Helper Tool
  • Install the Proxy Helper Tool by command line
  • Changelog
  • Version 1.6.0 (Proxyman 5.11.0 or later)
  • Version 1.5.0
  • Version 1.4.0
  • Version 1.3.0
  • Version 1.2.0:
  • Troubleshooting
  1. BASIC FEATURES

Proxyman Proxy Helper Tool

Explain what Proxyman Proxy Helper Tool is. Useful to override / revert System HTTP Proxy at launch time. Faster than using networkutils

PreviousAtlantis for iOSNextRequest / Response Previewer

Last updated 6 months ago

Proxyman Proxy Helper Tool

By default, Proxyman will try overriding your HTTP/HTTPS Proxy Config by using the Command-Line. However, the networksetup is a bottleneck during starting or quitting the app.

Proxyman offers a better solution: Proxyman Proxy Helper Tool, which is a in order to override Network Proxy in high performance.

You can notice the performance difference by starting the app with or without the Proxy Setting Tool.

At the first launch, Proxyman will present the Popup to install the Proxyman Proxy Helper Tool. You can skip it and install it later in Preference -> Advanced Tab.

After the installation, you can find the Helper tool at /Library/PrivilegedHelperTools/com.proxyman.NSProxy.HelperTool

If Proxyman releases a new update for Proxy Setting Helper Tool, it requires installation again.

Require user Permission for macOS 13 Ventura or later

MacOS Ventura or later requires permission to work properly.

To grant the permission, please follow the steps:

  1. Open System Setting -> General -> Login Items

  2. Find Proxyman and Switch ON ✅

Guest or non-admin users

If you're a guest or non-admin user, the networksetup CLI would fail and could not change the HTTP/HTTPS Proxy config until you install the Proxyman Proxy Helper Tool.

Proxyman Proxy Helper Tool has privileged permission to override the proxy config for all kinds of users.

We highly recommend installing the Proxyman Helper Tool if you're a guest or non-admin user to make the UX smoother.

Uninstall the Proxy Helper Tool

You can uninstall the Proxy Helper Tool in Preference -> Advanced Tab -> Uninstall Proxy Setting Tool or delete it directly at /Library/PrivilegedHelperTools/com.proxyman.NSProxy.HelperTool

Install the Proxy Helper Tool by command line

From macOS 4.12.0 or later, you can install the Helper Tool without GUI.

sudo /Applications/Proxyman.app/Contents/MacOS/proxyman --install-privileged-components

Changelog

Version 1.6.0 (Proxyman 5.11.0 or later)

  • Fixed: Proxyman can't restore the PAC URL when the app is closed

Version 1.5.0

  • Fix the Security Vulnerability that Proxyman v1.5.0 or older (2019) can connect to the Helper Tool (v1.4.0) and override the system proxy without user consent. This fix will add some constraints to verify the incoming Connection. (The caller must be notarized by Apple, signed by Proxyman LLC Certificate, enabled Library Validation, and enabled Force Hard flag). (CVE-2023-45732)

📣 Credit to Scott Leitch from NCC Group.

Version 1.4.0

  • Comply with new macOS 13 Ventura Requirements for Helper Tool

  • Show App Icon & App Name on the Login-Items

On macOS Ventura, Helper Tools, Launch Daemon, and Launch Agent will be added to the Allow in the Background, even though Proxyman only runs on the Foreground.

After installing the 1.4.0, the Login Item might not be updated due to the cache layer of the Preference.

To fix it:

  1. Open Terminal app -> Run: sfltool resetbtm

  2. Restart the macOS

  3. Done

Version 1.3.0

  • Remember and restore to your previous Proxy Setting.

Version 1.2.0:

  • Gracefully revert the HTTP Proxy Config if Proxyman is crashed.

Troubleshooting

If you've encountered this error when installing the helper Tool:

The operation couldn’t be completed. (CFErrorDomainLaunchd error 9.)

There is an ongoing discussion on that macOS should fix it.

Please follow this solution:

Ref:

Twitter
https://cloud.tencent.com/developer/article/1816504
https://github.com/ProxymanApp/Proxyman/issues/1113
networksetup
Privileged Helper Tool macOS
Grant permission to Proxyman Helper Tool
Display correct Proxyman icon and App Name
Invalid Cache