Quick Start

macOS

brew install cliproxyapi
brew services start cliproxyapi

When installed via Homebrew and run with brew services, the default config path is $(brew --prefix)/etc/cliproxyapi.conf (typically /opt/homebrew/etc/cliproxyapi.conf on Apple Silicon and /usr/local/etc/cliproxyapi.conf on Intel Macs). If you want to keep using ~/.cli-proxy-api/config.yaml as your main config, symlink the default path to it:

brew services stop cliproxyapi
mv "$(brew --prefix)/etc/cliproxyapi.conf" "$(brew --prefix)/etc/cliproxyapi.conf.bak"
ln -s ~/.cli-proxy-api/config.yaml "$(brew --prefix)/etc/cliproxyapi.conf"
brew services start cliproxyapi

Linux

One-Click Installer Script

curl -fsSL https://raw.githubusercontent.com/router-for-me/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer | bash

Thanks to brokechubb for building the Linux installer!

Arch Linux (AUR)

If you are an Arch Linux user, you can install directly from the AUR:

# Using yay
yay -S cli-proxy-api-bin

# Using paru
paru -S cli-proxy-api-bin

After installation, you can manage the service via systemd:

# Start the service
systemctl --user start cli-proxy-api

# Enable auto-start on boot
systemctl --user enable cli-proxy-api

⚠️ Note: A configuration file is required before starting the service. You can create it by copying the example configuration:

mkdir -p ~/.cli-proxy-api
cp /usr/share/doc/cli-proxy-api-bin/config.example.yaml ~/.cli-proxy-api/config.yaml

Windows

You can download the latest release from here and run it directly.

Or

You can download our desktop GUI app from here and run it directly.

Docker

Mount your plugins directory to /CLIProxyAPI/plugins so plugin installations persist across container restarts.

docker run --rm -p 8317:8317 -v /path/to/your/config.yaml:/CLIProxyAPI/config.yaml -v /path/to/your/auth-dir:/root/.cli-proxy-api -v /path/to/your/plugins-dir:/CLIProxyAPI/plugins eceasy/cli-proxy-api:latest

Building from Source

1. Clone the repository:

   git clone https://github.com/router-for-me/CLIProxyAPI.git
   cd CLIProxyAPI

2. Build the application:

   Linux, macOS:

   go build -o cli-proxy-api ./cmd/server

   Windows:

   go build -o cli-proxy-api.exe ./cmd/server