Proxyman Documentation
HomepagePricingBlogDownload
Search…
Overview
Changelog
License
License Manager
Command-line
Proxyman iOS
Proxyman for iOS
Debug on Devices
macOS
iOS Device
iOS Simulator
tvOS & watchOS
Android Device & Emulator
Firefox
Java VMs
Python
Ruby
React Native
Flutter
HTTP Clients
Docker
Atlantis
Atlantis for iOS
BASIC FEATURES
Proxyman Proxy Helper Tool
Request / Response Previewer
SSL Proxying
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
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
Publish to Gist
Reverse Proxy
Code Generator
Diff
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?
SSL Error from HTTPS Request/Response
I could not see any requests from my localhost server
*.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
Map Local (Directory)

1. What's it?

It's a handy tool to map a matched requests to local files on a selected Directory. If the local files doesn't exist, it will serve from the real server.
If you would like to map a Local File, let check out the Map Local (File) page

2. How to use

2.1 Map a path and its subdirectories

api.proxyman.io/build/v1/* => All sub-paths after /v1/ will map to a selected directory.
For instance, we select ~/desktop/my_folder as the local directory
Real URL
Resolved Local Path
http://api.proxyman.io/build/v1/index.html
~/desktop/my_folder/index.html
http://api.proxyman.io/build/v1/js/main.js
~/desktop/my_folder/js/main.js

How to config

Rule
How to use
Examples
Wildcard
  • Check ON "Include subpaths" checkbox
  • Or use /* at the end of the URL
  • api.proxyman.io/build/v1/ (Check ON)
  • api.proxyman.io/build/v1/*
Regex
  • Use (.*) at the end
  • https:\/\/api.proxyman.io\/build\/v1\/(.*)
  • https:\/\/api.proxyman.io\/build\/v1\/(.*.css)
Make sure you use () group Regex operator to tell Proxyman where to map

2.2 Map Entire Host

api.proxyman.io/* => All sub-paths will map to a selected directory.
For instance, we select ~/desktop/my_folder as the local directory
Real URL
Resolved Local Path
http://api.proxyman.io/build/v1/index.html
~/desktop/my_folder/build/v1/index.html
http://api.proxyman.io/build/v1/js/main.js
~/desktop/my_folder/build/v1/js/main.js

How to config

Rule
How to use
Examples
Wildcard
  • Leave the path blank
  • api.proxyman.io
Regex
  • Use single path that contains (.*) at the end
  • https:\/\/api.proxyman.io\/(.*)
  • https:\/\/api.proxyman.io\/(*.html)

3. Map Local Directoy with Scripting Tool ✅

If you would like to do Map Local Directory with complicated rules, you might check out Scripting since it's easier to achieve the same result.
Please check out our Snippet Code to understand how to map a local file with Javascript Code.
ADVANCED FEATURES - Previous
Map Local (File)
Next - ADVANCED FEATURES
Map Remote
Last modified 11mo ago
Copy link
Outline
1. What's it?
2. How to use
2.1 Map a path and its subdirectories
2.2 Map Entire Host
3. Map Local Directoy with Scripting Tool ✅