命令行客户端

概述

命令行客户端适合在服务器、路由器或需要自动化的场景中使用。

安装

下载预编译版本

从 Releases 下载对应平台的二进制文件：

echplus-client-linux-amd64 - Linux x64
echplus-client-linux-arm64 - Linux ARM64
echplus-client-darwin-amd64 - macOS Intel
echplus-client-darwin-arm64 - macOS Apple Silicon
echplus-client-windows-amd64.exe - Windows x64

从源码编译

cd apps/client
go build -o echplus-client .

Docker 运行

docker run -d \
  --name echplus-client \
  -p 30000:30000 \
  -e ECHPLUS_SERVER=your-worker.workers.dev:443 \
  -e ECHPLUS_TOKEN=your-token \
  echplus-client

快速开始

./echplus-client \
  -l 127.0.0.1:30000 \
  -f your-server.com:443 \
  -token your-secret-token

启动后，将应用程序的代理设置为 127.0.0.1:30000（支持 SOCKS5 和 HTTP）。

配置参数

参数	环境变量	默认值	说明
`-l`	`ECHPLUS_LISTEN`	`127.0.0.1:30000`	本地代理监听地址
`-f`	`ECHPLUS_SERVER`	-	服务端地址 (必填)
`-ip`	`ECHPLUS_SERVER_IP`	-	指定服务端 IP (可选)
`-token`	`ECHPLUS_TOKEN`	`147258369`	身份验证令牌
`-dns`	`ECHPLUS_DNS`	`dns.alidns.com/dns-query`	DoH 服务器
`-ech`	`ECHPLUS_ECH_DOMAIN`	`cloudflare-ech.com`	ECH 配置域名
`-routing`	`ECHPLUS_ROUTING`	`global`	分流模式

分流模式

模式	说明
`global`	全局代理，所有流量通过代理
`bypass_cn`	跳过中国大陆 IP，国内网站直连
`none`	直连模式，不使用代理

示例

# 全局代理
./echplus-client -f server.com:443 -routing global

# 跳过中国大陆
./echplus-client -f server.com:443 -routing bypass_cn

# 直连模式
./echplus-client -f server.com:443 -routing none

交互命令

运行后可以使用以下命令：

命令	说明
`status`	查看服务器状态
`restart`	重启代理服务器
`routing <mode>`	切换分流模式
`help`	显示帮助信息
`quit` / `exit` / `q`	退出程序

示例

> status
[状态] 运行中
  监听地址: 127.0.0.1:30000
  服务端: your-server.com:443
  分流模式: global

> routing bypass_cn
[命令] 正在切换分流模式为 bypass_cn 并重启...
[命令] 分流模式已切换为 bypass_cn

使用环境变量

可以通过环境变量配置，方便在容器或脚本中使用：

export ECHPLUS_LISTEN=0.0.0.0:30000
export ECHPLUS_SERVER=your-server.com:443
export ECHPLUS_TOKEN=your-secret-token
export ECHPLUS_ROUTING=bypass_cn

./echplus-client

Systemd 服务

创建 /etc/systemd/system/echplus.service:

[Unit]
Description=EchPlus Proxy Client
After=network.target

[Service]
Type=simple
User=nobody
Environment=ECHPLUS_LISTEN=127.0.0.1:30000
Environment=ECHPLUS_SERVER=your-server.com:443
Environment=ECHPLUS_TOKEN=your-secret-token
ExecStart=/usr/local/bin/echplus-client
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

启用服务：

sudo systemctl daemon-reload
sudo systemctl enable echplus
sudo systemctl start echplus

常见问题

连接失败

检查服务端地址是否正确
确认 Token 与服务端一致
检查网络连接

ECH 配置获取失败

尝试更换 DoH 服务器：-dns 1.1.1.1/dns-query
检查 ECH 域名是否可访问

分流不生效

确认使用 bypass_cn 模式
首次运行会自动下载中国 IP 列表
检查 IP 列表文件是否存在

命令行客户端

On this page