Docker 部署

Docker 是部署 EchPlus 客户端最简单的方式，无需安装 Go 环境。

前置要求

Docker 20.10+
Docker Compose (可选)

快速开始

1. 构建镜像

cd apps/client docker build -t echplus-client .

2. 运行容器

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

3. 验证运行

# 检查容器状态 docker ps | grep echplus-client  # 测试代理连接 curl -x socks5://127.0.0.1:30000 https://httpbin.org/ip

Docker Compose 部署

创建 docker-compose.yml:

version: "3.8" services:  echplus-client:  build: ./apps/client  container_name: echplus-client  ports:  - "30000:30000"  environment:  - ECHPLUS_LISTEN=0.0.0.0:30000  - ECHPLUS_SERVER=your-worker.workers.dev:443  - ECHPLUS_TOKEN=your-secret-token  - ECHPLUS_ROUTING=bypass_cn  restart: unless-stopped

运行：

docker-compose up -d

环境变量

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

分流模式

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

# 使用 bypass_cn 模式 docker run -d \  --name echplus-client \  -p 30000:30000 \  -e ECHPLUS_SERVER=your-worker.workers.dev:443 \  -e ECHPLUS_TOKEN=your-secret-token \  -e ECHPLUS_ROUTING=bypass_cn \  echplus-client

常用命令

# 查看日志 docker logs -f echplus-client  # 停止容器 docker stop echplus-client  # 重启容器 docker restart echplus-client  # 删除容器 docker rm -f echplus-client  # 更新镜像 docker build -t echplus-client . && docker restart echplus-client

生产环境建议

资源限制

services:  echplus-client:  # ...  deploy:  resources:  limits:  cpus: "0.5"  memory: 128M  reservations:  cpus: "0.1"  memory: 32M

日志配置

services:  echplus-client:  # ...  logging:  driver: "json-file"  options:  max-size: "10m"  max-file: "3"

网络模式

如果需要让局域网其他设备使用代理：

services:  echplus-client:  # ...  environment:  - ECHPLUS_LISTEN=0.0.0.0:30000  ports:  - "30000:30000"

然后其他设备可以使用 <宿主机IP>:30000 作为代理地址。

完整示例

version: "3.8" services:  echplus-client:  build: ./apps/client  container_name: echplus-client  ports:  - "30000:30000"  environment:  - ECHPLUS_LISTEN=0.0.0.0:30000  - ECHPLUS_SERVER=your-worker.workers.dev:443  - ECHPLUS_TOKEN=your-secret-token  - ECHPLUS_ROUTING=bypass_cn  restart: unless-stopped  deploy:  resources:  limits:  cpus: "0.5"  memory: 128M  logging:  driver: "json-file"  options:  max-size: "10m"  max-file: "3"

Docker 部署

On this page