🐳 ECH-Workers for ARMv7 (Docker版)

专为 玩客云 (OneCloud) 及其他 ARMv7 (32位) 架构设备编译的 ECH-Workers Docker 镜像。
让闲置的电视盒子或老旧开发板变身网络神器。

---

✅ 适用设备 / Supported Devices

本镜像采用静态编译，理论上支持所有 Linux ARMv7l (32-bit) 系统：

• 🔌 玩客云 (OneCloud) - (推荐刷入 Armbian 系统)【实测可用】
• 🍓 树莓派 (Raspberry Pi) - 2B / 3B / 3B+ / 4B (运行 32位 系统时)
• 📺 电视盒子/机顶盒 - 如斐讯 N1 (32位系统), 移动 R3300L 等 Amlogic S905/S805 设备
• 🍌 其他开发板 - Orange Pi (香橙派), Banana Pi, ASUS Tinker Board 等

---

⬇️ 拉取镜像 / Installation

在你的 SSH 终端执行以下命令拉取最新镜像：

docker pull mcgtekwrt/ech-wk-armv7:latest

---

🚀 启动命令 / Advanced Usage

可自定义优选 IP、分流模式，请使用以下完整命令：

🖥️ 完整参数启动 (Full Options)

docker run -d \
  --name ech-wk \
  --restart always \
  --network host \
  mcgtekwrt/ech-wk-armv7:latest \
  -f "your-domain.workers.dev:443"   # 填写你的workers域名和端口
  -token "your-token"                 # 你设置的token
  -ech "cloudflare-ech.com"           # ech查询域名，一般保持默认
  -ip "visa.com"                      # 优选IP或域名
  -l "0.0.0.0:30000"                  # Socks5服务器的IP和端口，0.0.0.0为全局监听
  -routing "global"                # 分流模式，global=全局代理 bypass_cn=绕过大陆

⚙️ 详细参数说明

参数	说明	默认值	示例
-f	(必填) Workers 域名 (建议加:443)	-	abc.workers.dev:443
-token	(必填) 认证 Token/密码	空	password123
-l	(选填) 本地监听地址	0.0.0.0:30000	0.0.0.0:1080
-ip	(选填) 优选 IP 或域名 (CF CDN)	空	visa.com 或 104.16.x.x
-routing	(选填) 分流模式 (global / bypass_cn)	global	bypass_cn
-ech	(选填) ECH 查询域名	cloudflare-ech.com	-

🛸 Docker运行命令模板

按照上面的说明填写，一般只需填⌈workers域名⌋、⌈token⌋、⌈优选IP⌋这三项，然后复制到SSH终端运行：

docker run -d \
  --name ech-wk \
  --restart always \
  --network host \
  mcgtekwrt/ech-wk-armv7:latest \
  -f "你的workers域名:443" \
  -token "你的Token" \
  -ech "cloudflare-ech.com" \
  -ip "visa.com" \
  -l "0.0.0.0:30000" \
  -routing "global"

🍰 检测ECH运行状态

查看启动状态与配置详情、实时日志查询

docker logs ech-wk

Ping谷歌外网，出现 HTTP/2 200，说明网络已连接成功！

curl -I -x socks5h://127.0.0.1:30000 https://www.google.com

---

📱 客户端连接教程 / Client Setup

启动成功后，该程序本质上是一个 SOCKS5 代理。 假设你的玩客云/盒子 IP 地址是 192.168.1.100，默认端口是 30000。

💻 Windows / Mac 电脑使用

推荐使用 v2rayN (Win) 或 v2rayU (Mac)：

在 v2rayN 主界面点击 “服务器” -> “添加 [Socks] 服务器”，然后按以下填写：

• 别名 (remarks): 随便填，比如 玩客云-ECH

• 地址 (address): 192.168.1.100 (填你玩客云的IP)

• 端口 (port): 30000

• 用户名/密码: 留空 (除非你在启动 docker 时设置了 -token，如果设置了就填进去)

• 传输协议 (network): 选择 tcp (千万别选 ws)

• 点击确定。

最后一步： 选中这个新添加的节点，设为活动节点，测试一下真连接延迟，如果有数值（比如 200ms），就说明电脑能用了！

📱 Android / iOS 手机使用

手机和电脑必须连接在同一个 WiFi 下。

🍎 iOS (Shadowrocket / Stash)

1. 点击右上角 + 号添加节点。

2. 类型 (Type): 选择 Socks5。

3. 地址 (Host): 192.168.1.100 (填你玩客云的IP)

4. 端口 (Port): 30000

5. 用户/密码: 留空 (或填你的 token)。

6. 点击保存，选中开启即可。

🤖 Android (v2rayNG)

1. 点击右上角 + 号 -> 手动输入 [Socks]。

2. 别名: 玩客云-ECH

3. 地址 (IP): 192.168.1.100 (填你玩客云的IP)

4. 端口: 30000

5. 用户/密码: 留空。

6. 保存后，选中节点，点击右下角 V 图标连接。

---

📦 离线安装方法 / Offline Installation

如果你的玩客云/设备无法连接外网或无法拉取 Docker 镜像，可以使用离线包进行安装。

🔗 鸣谢 / Credits

• 核心代码来源: byJoey/ech-wk
• OpenWrt 插件支持: SunshineList/luci-app-ech-workers
• ech-wk项目Docker 64位版本: cirnosalt/ech-workers-docker

Star History

🐳 Docker Hub 实时数据

本镜像的拉取次数与镜像体积数据由 Docker Hub 实时同步更新。