Proxy

Proxy is a tool to set os proxy settings, with support for Proxy Auto Config. It makes a pac file and set system proxy to pac/http/socks mode. It is not a proxy server.

Support Windows, MacOS and Ubuntu Desktop.

Config

# resources/config.json
{
    "host": "127.0.0.1",       # proxy server host
    "port": 1080,              # proxy server port
    "protocol": "http",        # proxy protocol, http or socks/socks5
    "pac_host": "127.0.0.1",   # pac server listen host, default 127.0.0.1
    "pac_port": 1081,          # pac server listen port, default 1081
    "proxy_commands": [""],    # commands to start proxy process. you can add multi commands, optional
}

Usage

proxy
    g[n]/global[n]: set os proxy to global mode. n: default 0, if 0 <= n < proxy_commands.length, start proxy_commands[n].
    pac[n]: set os proxy to pac mode.
    off/clear: clear os proxy setting.
    update: update pac file.

If you want to custom pac rule, write pac rule into resources/user-rule.txt.
You need to run update command to update pac file when:

1. host or port config changed.
2. resources/user-rule.txt chaned.
3. you want to update gfwlist.

Build

• Command line version:

Command line version is developed by go. Go 1.21 or higher is needed. Build:

go build -o proxy ./cmd

On windows, CGO is needed. Install MinGW64 and add mingw64/bin to enviroment path. Build:

$env:CGO_ENABLED=1  # powershell
go build -o proxy.exe ./cmd

• GUI version:

Gui version is developed by pyqt6. Python 3.11 or higher is needed. Pack a GUI App:

cd gui
pip install pyqt6
pip install pyinstaller
pyinstaller -w app.py
cp -r ../resource ./gui/dist/app/

Packed app is in gui/dist/app.