If you are willing to help hiproxy to write documentation, please contact email@example.com, thank you!
All you have to do is to global install
hiproxy, Local install is NOT necessary
Two rules of ‘hiproxy’:
- All projects in one Workspace;
- Put configuration files (hosts / rewrite) into specific project directory, submit them to the repository for version control and teamwork.
Therefore, all configuration files should be located in specific project directory. In terms of different projects, diverse configuration files can be added. While the ‘hiproxy’ on starting, those files will be found from workspace.
Recommended directory structure is as follows:
Of course, to put all configuration files outside of the project directory, just specify the file’s path via the start options:
-c, --hosts-file <files> hosts files, format: <file1>[,<file2>[,...]]
-r, --rewrite-filesupport Simplified pattern matching; e.g.
- Supported syntax：
- Unsupported syntax：
hosts is similar to hosts, except it’s located in the project directory, hiproxy will automatically find and resolve the hosts file named ‘hosts’ from the root directory of the project.
If the file name isn’t
hosts, just specify it via option
You can see hosts for more details.
rewrite is similar to
hosts, it’s also located in the project directory, hiproxy will automatically find and resolve the file named ‘rewrite’ from the root directory of the project.
If the file name isn’t
rewrite, just specify it via option
You can see rewrite for more details.
Git commitment is highly recommended, submit configuration files (hosts/rewrite) to the repository for version control and teamwork.
The concept of hiproxy is based on Workspace. The proxy service of hiproxy should be started in the workspace. Assuming that all projects are located in
~/workspace/, then this directory is the
Enter this directory, start the proxy service, then hiproxy will find all the configuration files of all projects.
If service is needed before entering the workspace, just start proxy using the option
-w, --workspace <workspace> in any directories.
# Enter any directories
TIPS: While on starting the proxy, use the option
-o, --open [browser-name] to open a new browser window and configure the proxy automatically. Therefore, no manual configuring is needed.
When the proxy is started, if the proxy rules are configured, all requests from the browser window will be handled by hiproxy.
No need to configure system hosts.