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. 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 ✅
  1. ADVANCED FEATURES

Map Local (Directory)

PreviousMap Local (File)NextMap Remote

Last updated 3 years ago

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 since it's easier to achieve the same result.

Please check out our to understand how to map a local file with Javascript Code.

Map Local (File)
Scripting
Snippet Code