客户端下载
- 下载蜂窝 OpenClash 统一安装包
约 49 MB · x86_64 / ARM64 自动识别 · 首次安装只下载这一个
安装前，准备好这三样
新版程序安装在 OpenWrt 路由器上，手机和电脑通过浏览器使用。统一安装包已经包含所需的原版 OpenClash 组件和内核，无需先自行安装 OpenClash。
首次安装完成后，日常操作和后续版本更新都在蜂窝网页中进行。
- ① 安装一次下载统一包，部署到路由器
- ② 网页登录获取订阅，测速并选择节点
- ③ 点击连接设备流量经过软路由即可使用
这是部署压缩包，不是路由器固件，也不是 IPK/APK 软件包。不要上传到刷机或软件包安装页面。
- 一台 64 位 OpenWrt 路由器：支持 x86_64 或 ARM64，不支持 32 位 ARM、MIPS。
- 一台与路由器连接在同一局域网的电脑，以及路由器管理 IP、root 密码和 SSH 访问权限。
- 路由器能够上网，系统软件源可用。建议存储空间和 /tmp 临时空间各预留至少 200 MB。
把安装包放进路由器并安装
点击文章顶部的下载按钮，保存 fengwo-openclash.tar.gz。无需在电脑上解压，也不用分别下载 x86 和 ARM 版本。
用 WinSCP 等文件传输工具连接路由器，协议选择 SCP，用户名填写 root，将安装包上传到 /tmp 文件夹。然后打开路由器 SSH 终端。也可使用下面的电脑终端命令上传，任选一种方式即可。
示例地址 192.168.1.253 请替换成你自己的路由器 IP。电脑端执行第一段；登录路由器后再执行第二段。安装期间保持供电和网络，等待结束，不要重复运行。
① 在电脑终端执行：先进入下载文件所在文件夹，再上传并登录
scp -O fengwo-openclash.tar.gz root@192.168.1.253:/tmp/
ssh root@192.168.1.253② 在路由器 SSH 中执行：整段复制，解压并安装
mkdir -p /tmp/fengwo-install &&
tar -xzf /tmp/fengwo-openclash.tar.gz -C /tmp/fengwo-install &&
sh /tmp/fengwo-install/install.sh- 安装程序会自动识别架构和软件包管理器，处理所需组件与依赖。
- 看到 Installation complete 才代表安装完成，终端会显示网页访问地址。
- 如果出现错误，保存终端提示，不要反复安装；安装详情保存在 /etc/fengwo-openclash/logs/install.log。
打开网页，登录蜂窝账号
安装完成后，用手机或电脑浏览器打开终端给出的地址。默认是 http://路由器IP:8089/，例如 http://192.168.1.253:8089/。设备需要与路由器处于同一局域网，不用另装手机或电脑客户端。
输入蜂窝账号和密码登录。没有账号可点击注册，忘记密码可从登录页找回。首次成功登录的账号会绑定为这台路由器的管理账号，请使用设备所有者的账号。
登录页会显示业务 API 检测结果。登录后等待订阅加载完成，再进行下一步。
- 电脑端使用左侧导航；手机端可从底部“我的”进入节点状态、高级设置等页面。
- 只在自己使用的设备上记住账号，共享设备用完后请退出登录。
- 网页用于管理路由器；手机和电脑是否走代理，还要看第 5 步的网关与 DNS 设置。
测速、选节点，再点击连接
进入“节点状态”，等待节点列表加载。首次登录会自动获取订阅，需要重新获取时点击“更新订阅”。不需要先去原版 OpenClash 页面启动服务。
点击“全部测速”，等待检测完成，也可以只测试一个节点。点击“延迟排序”找到延迟较低的节点，选中后再点击“连接”启动代理。
- 获取订阅等待加载，必要时更新订阅
- 测速并选择全部测速 → 延迟排序 → 选节点
- 连接使用等待连接结果，再实际访问网站
查看节点、测速和选择节点不会自动接管局域网流量；点击连接后才启动正式代理。
- “未检测”不等于离线；“检测失败”表示本次测试未通过，可以重试或换节点。
- 日常可先使用规则模式；需要让更多流量经过所选代理时再切换全局模式，内网等流量仍由 OpenClash 配置处理。
- 连接后用实际设备访问目标网站，也可在“实用工具”中进行网站连通性检测。
- “已连接”表示代理服务已启动，仍需确认自己的设备流量确实经过这台软路由。
让手机和电脑真正走软路由
如果 OpenWrt 就是主路由，确认设备取得的默认网关和 DNS 指向它。如果 OpenWrt 是旁路由，需要将使用代理的设备的网关和 DNS 指向 OpenWrt。建议先在一台电脑上验证，再调整其他设备。
下面是同一局域网内的旁路由示例。请按自己的网络修改，不要把示例地址直接填到不同网段。
- 手机 / 电脑网关和 DNS：192.168.1.253
- OpenWrt 旁路由管理 IP：192.168.1.253
- 主路由 → 互联网主路由 IP：192.168.1.251
设备可以连接同一个交换机或 Wi-Fi 网络，关键是实际取得的网关和 DNS。
| 在哪里设置 | 填写什么 |
|---|---|
| OpenWrt 的 LAN 地址 | 192.168.1.253，子网掩码 255.255.255.0 |
| OpenWrt 的上游网关 | 192.168.1.251（主路由） |
| OpenWrt 的上游 DNS | 可访问的上游 DNS，例如 223.5.5.5；不要填成本机自己 |
| 需要代理的手机 / 电脑 | 保持本机 IP 唯一，网关与 DNS 都指向 192.168.1.253 |
- 不要为连接代理而随意关闭路由器防火墙，也不要同时运行多个透明代理服务。
- 全家统一使用时，可在分配地址的 DHCP 服务中设置网关和 DNS；同一网络不要重复开启多个 DHCP 服务。
- 修改后重新连接 Wi-Fi 或重新获取网络地址，确认实际获得的网关和 DNS。
- 如果 IPv6 走另一台网关，可能绕过当前代理，需要一并检查 IPv6 设置。
平时常用的功能在哪里
| 想做什么 | 去哪里操作 |
|---|---|
| 购买或续费套餐 | 进入“套餐”，按页面完成支付；确认订单生效后更新订阅 |
| 更换节点 / 重新测速 | 进入“节点状态”，选择节点或点击“全部测速” |
| 查看当前连接 | 进入“实时连接”，查看目标、使用节点和传输情况 |
| 查看用量 | 进入“流量明细”；刷新流量与更新订阅是不同操作 |
| 修改密码 | 进入“高级设置”中的“修改密码” |
| 检查版本 / 导出日志 | 进入“高级设置”中的“客户端维护” |
| 退出账号 | 使用“退出登录”；需要停止代理时，先单独执行断开操作 |
后续更新，在网页里完成
首次安装只需下载顶部这一个包。此后客户端会定期检查新版本，发现更新时显示红点提醒，无需每次重新手动下载安装包。
打开“高级设置 → 版本检查”，查看最新版本号和更新内容，然后点击“立即升级”。系统会下载、校验、备份并替换蜂窝程序，页面显示各阶段进度。自动检查不会在未点击确认时直接安装。
升级期间保持路由器供电。网页暂时断开可能是服务正在重启，请等待升级结果，完成后重新登录。可通过“查看升级状态”确认进度。
- 常规网页升级保留账号绑定、配置、订阅和操作日志，不替换原版 OpenClash 和代理内核。
- 发布了适用的一键升级版本后才会出现“立即升级”。没有红点时可手动检查；当前已是最新版时无需操作。
- 如果只有下载入口，没有“立即升级”，请联系支持确认该版本升级方式，不要重复安装旧包。
- 升级失败先查看页面结果并导出日志；涉及系统依赖或 OpenClash 组件变更时，以该版本发布说明为准。
有问题，先看这里
记下问题发生的时间、页面提示和操作编号。在“高级设置 → 客户端维护”点击“导出操作日志”，将日志连同现象交给支持人员，便于定位登录、订阅、测速、连接或升级的具体阶段。
| 遇到的问题 | 先做什么 |
|---|---|
| 打不开网页 | 确认安装完成、设备在同一局域网，访问 http://路由器IP:8089/，不要使用旧版 8088 端口 |
| API 不可用 / 登录失败 | 检查路由器自身上网、系统时间和 DNS，重新检测 API，保存错误提示 |
| 节点列表为空 | 等待订阅加载，确认套餐有效后点击“更新订阅”；仍为空时导出日志 |
| 测速失败 | 先测试一个节点，再换节点或重试；检查路由器网络和系统时间 |
| 已连接，但手机不能上网 | 检查手机实际网关、DNS 和 IPv6；重新连接 Wi-Fi、重开浏览器，排除旧 DNS 缓存 |
| 安装中断或报错 | 保存终端输出和 install.log；不要删除锁文件或强制覆盖未知错误 |
网页打不开时：在路由器 SSH 中读取服务状态，交给支持人员
/usr/bin/fengwo-openclash -version
/etc/init.d/fengwo-openclash running && echo SERVICE_RUNNING
ubus call service list '{"name":"fengwo-openclash"}'附：本版本的测试环境
以下为 2026 年 9 月 27 日的开发测试记录。使用 QEMU 隔离虚拟机，从未安装 OpenClash 的系统开始验证。普通用户不需要搭建这些环境。
这些结果不代表所有固件、fw3 环境或局域网拓扑都已验证。部署后仍需用自己的设备完成登录、订阅和实际网站访问检查。
| 环境 | 已验证内容 |
|---|---|
| x86_64 / OpenWrt 24.10.7 / opkg / fw4 | 统一包安装、依赖处理、网页访问、重启后自启动与重复安装 |
| ARM64 / OpenWrt 25.12.5 / apk / fw4 | 统一包安装、网页访问、自启动与重复安装；隔离环境验证覆盖升级及失败回退 |
| 重复安装检查 | 原版 OpenClash 配置、启动脚本、内核及蜂窝 UCI 配置校验值保持一致 |
常见问题
需要分别下载 x86 和 ARM 安装包吗？
不需要。顶部的 fengwo-openclash.tar.gz 同时支持 x86_64 和 ARM64，安装时自动选择。只下载这一个文件即可。
可以直接上传到 LuCI 的软件包安装页面吗？
不可以。新版是完整部署压缩包，请上传到路由器 /tmp 后按第 2 步执行安装脚本。不要改后缀为 .ipk 或 .apk，也不要拿它刷固件。
还要先安装原版 OpenClash 吗？
不需要。安装程序会处理所需组件。已安装可识别且版本不低于 0.47.156 的 OpenClash 时会复用；版本过旧或来源无法识别时，请按安装提示处理。
以后会自动更新吗？
程序会自动检查并提示新版本，你在网页内查看更新说明并点击“立即升级”即可。不会未经确认就自动替换程序，常规更新无需再手动下载完整安装包。
从旧版蜂窝 IPK 怎么迁移？
先导出旧版日志、记录设置并停止旧代理，再按本教程部署新版并重新登录。旧版 fengwo-client 使用 8088，新版 fengwo-openclash 默认使用 8089。不要把旧安装包或旧网页升级入口当作新版。
网页检测成功，就代表全家的设备都能用了？
不一定。网页检测与设备实际流量路径不同。请用需要代理的手机或电脑访问目标网站，并确认该设备的网关、DNS 和 IPv6 设置。