OpenClash 安装与配置指南

适用于 OpenWrt / LuCI。软件中心的 OpenClash 入口通向上游安装说明；上游发行页提供 .ipk / .apk，但不保证包含下文的 oixCloud 账户集成。使用账户登录流程前，先确认已安装包含该入口的维护版本；通用发行版不能仅靠更换内核增加这个标签

固件与依赖要求

↔ 左右滑动，查看完整表格

项目	选择方式
固件	OpenWrt / LuCI，且软件源能提供所需内核模块与依赖；不能只凭路由器型号判断
包管理器	`opkg` 选 `.ipk`，`apk` 选 `.apk`；LuCI 插件包标记为 `all`，代理内核仍须匹配 CPU 架构
防火墙	按 Firewall4 / nftables 或 Firewall3 / iptables 选择依赖，见维护仓库的安装说明
空间与内存	为插件、代理内核、配置和运行缓存预留空间；缺少对应固件版本的内核模块时应先解决软件源匹配问题

1. 安装或更新插件

已安装用户先到「服务 → OpenClash → 插件设置 → 版本更新」备份现有配置；备份可能含账号、令牌和订阅地址，妥善保存
首次安装从对应的发行页或维护版本提供方获取安装包：opkg 固件用 .ipk，apk 固件用 .apk，在「系统 → 软件包」上传安装
依赖同时按包管理器和防火墙类型选择：Firewall4 / nftables 与 Firewall3 / iptables 的依赖组合不同，使用发布页对应命令，不要混装
在「版本更新」核对设备 CPU 的「编译版本」。更新插件时先等待地址检测，再点击可用地址的「插件」版本，等日志完成后刷新页面

LuCI 插件和代理内核可单独更新。找不到新菜单时，仅更新内核不会更新网页界面；安装失败先查看软件包错误、存储空间和固件依赖

2. 登录 oixCloud

进入「服务 → OpenClash → 插件设置 → oixCloud」，首次选择邮箱密码登录，生成 OpenClash 专属 Token；之后可选择 Token 登录，填写对应 Access Token 本身，不是订阅网址。Google 登录用户获取账户密码的方法与禁止客户端邮箱/密码登录的设置见首次登录说明

等待账户信息、配置和内核处理完成。插件会创建或更新 oixCloud - smart 订阅；能看到套餐与流量仅表示账户信息获取成功，还需检查正在使用的配置

3. 选择配置并启动

OpenClash · 确认正在运行专用配置 — 按维护版本绘制的界面示意 · 虚构数据 · 点击放大查看操作位置

到「运行状态」的配置文件区域找到 oixCloud - smart.yaml
如果当前不是它，选中并「切换」；等待由切换触发的重启完成，仍未运行时再打开启动开关
查看运行日志，确认配置加载和内核启动成功，内核版本应包含 oix
初次使用保留专用配置和「策略代理 / Rule」模式，再到控制面板选择可用节点或策略组

保留账户登录时，集成版本会优先选择专用内核，无需额外打开「Smart 内核」开关。不要把专用订阅交给第三方转换器再导入，转换可能丢失需要的配置

常用端口代理范围

当前维护版本默认启用常用端口代理，只把所列目标端口交给代理，其他端口直连；已有设置以路由器实际配置为准。游戏、语音或自建服务使用非常用端口时，在「插件设置 → 流量控制」中核对「仅允许常用端口流量」，调整后重新启动并验证

UDP 转发开启后仍受端口范围限制。端口过滤不等于识别所有 BT／P2P，不能作为允许 BT／P2P 下载或共享账户的依据

4. 用局域网设备验证

确认测试设备的网关、DNS 和 OpenClash 访问控制符合当前路由器或旁路由方案
分别访问直连站点和需要代理的站点
在控制面板的连接记录中核对目标、命中规则和出口

只有账户卡片、正常延迟或「运行中」状态，不能证明测试设备的流量已经接管。浏览器安全 DNS、其他 DNS 插件、IPv6 和旁路由网关都可能影响路径

5. 更新与节点筛选

更新配置：在运行状态页的配置区域更新，或在「配置订阅」设置自动更新时间，完成后确认当前配置与节点
筛选节点：oixCloud 标签的「节点筛选」打开网站编辑器；保存后重启 OpenClash 立即获取，或等待内核下次订阅更新。同账户的 OpenClash 设备共享筛选，见订阅与筛选
升级插件或内核：先备份，在版本更新中分别选择对应下载入口，不要把插件升级和订阅更新混为一件事

6. 更换与更新 oix 内核

OpenClash · 在版本更新中升级或更换 oix 内核 — 按维护版本绘制的界面示意 · 虚构数据 · 点击放大查看操作位置

oix 内核是支持 oixCloud 托管节点的 Mihomo 构建，不能用普通 Mihomo 包替代。维护版本登录账户后会优先使用它；插件更新、内核更新和订阅更新是三个不同操作

在线更新内核

打开「服务 → OpenClash → 插件设置 → 版本更新」，先导出包含内核的备份并保存到电脑
核对 CPU「编译版本」，例如 linux-arm64、linux-amd64-v1 或 linux-armv7
在内核列点击版本号链接，等待日志确认下载、校验和替换成功；使用与编译版本匹配的专用内核包
返回「运行状态」，如尚未运行则启动 OpenClash，确认版本包含 oix，再用局域网设备验证实际连接

安装路径通常是 /etc/openclash/core/clash_meta；启用小闪存模式时是 /tmp/etc/openclash/core/clash_meta。更新程序按实际模式选择路径并设置执行权限

手动上传与替换内核

在线更新失败时，可从 mihomo-oix 的 Pre-Alpha 发行页下载与「编译版本」匹配的 .gz 文件。不要使用普通 Mihomo、其他 CPU 架构或桌面安装包

替换前备份并确认空间

先导出包含旧内核的备份，记录当前编译版本与安装路径。内核大小随架构和版本变化，以下载文件解压后的实际大小为准；用 df -h 检查临时目录及目标分区的可用空间。下面以普通模式、路由器地址 192.168.1.1 为例；按实际地址操作，小闪存模式须把目标路径改为 /tmp/etc/openclash/core/clash_meta

在电脑上解压，先将占位文件名替换为实际下载的文件名：
sh
```
gzip -dc 'mihomo-<arch>-<version>.gz' > clash_meta
```
在 LuCI「运行状态」停止 OpenClash，再将新文件上传到临时位置：
sh
```
scp clash_meta root@192.168.1.1:/tmp/clash_meta.new
```
登录路由器 SSH，核对新文件可以运行且版本包含 oix：
sh
```
chmod 755 /tmp/clash_meta.new
/tmp/clash_meta.new -v
```
如果不能运行，先检查架构、文件完整性和具体报错，不要继续替换

核对目标路径后复制新文件，并按插件的方式设置权限：

cp /tmp/clash_meta.new /etc/openclash/core/clash_meta
chmod 4755 /etc/openclash/core/clash_meta
/etc/openclash/core/clash_meta -v

回到网页启动 OpenClash，检查运行日志，并用局域网设备测试。失败时停止服务，从备份取出旧内核，按同样的上传与校验步骤恢复；不要通过反复更新订阅来解决内核无法启动的问题

确认运行正常后，可以删除本次上传的 /tmp/clash_meta.new；保留电脑上的备份用于回退

常见问题

↔ 左右滑动，查看完整表格

现象	下一步
没有 oixCloud 标签	确认维护版本包含账户集成；上游通用安装包不保证有此入口，只有内核更新也无法增加标签
内核下载或启动失败	看当次日志，再查 CPU 架构、时间、空间和依赖；专用内核有独立下载来源，不能只凭 GitHub 是否可访问判断
登录成功却没有配置	检查配置订阅中的 `oixCloud - smart`，更新成功后明确切换到该配置
路由器已运行，设备仍异常	核对设备网关、DNS、访问控制和 IPv6，再看连接记录

反馈前在「运行日志 → 生成日志」导出调试信息，附插件与内核版本、运行模式和复现时间，并隐藏凭据。参考维护中的 OpenClash 集成与 OpenClash 上游安装说明

OpenClash 安装与配置指南 ​

固件与依赖要求 ​

1. 安装或更新插件 ​

2. 登录 oixCloud ​

3. 选择配置并启动 ​

常用端口代理范围 ​

4. 用局域网设备验证 ​

5. 更新与节点筛选 ​

6. 更换与更新 oix 内核 ​

在线更新内核 ​

手动上传与替换内核 ​

常见问题 ​