OpenClash 安装与配置指南
适用于 OpenWrt / LuCI。账户入口以 软件中心 提供的版本为准。通用发行版或旧版未必包含相同入口，先核对来源
1. 安装或更新插件
- 已安装用户先到「服务 → OpenClash → 插件设置 → 版本更新」备份现有配置；备份可能含账号、令牌和订阅地址，妥善保存
- 首次安装从软件中心对应的发布页获取安装包：
opkg固件用.ipk，apk固件用.apk，在「系统 → 软件包」上传安装 - 依赖同时按包管理器和防火墙类型选择：Firewall4 / nftables 与 Firewall3 / iptables 的依赖组合不同，使用发布页对应命令，不要混装
- 在「版本更新」核对设备 CPU 的「编译版本」。更新插件时先等待地址检测，再点击可用地址的「插件」版本，等日志完成后刷新页面
LuCI 插件和代理内核可单独更新。找不到新菜单时，仅更新内核不会更新网页界面；安装失败先查看软件包错误、存储空间和固件依赖
2. 登录 oixCloud
进入「服务 → OpenClash → 插件设置 → oixCloud」，选择邮箱密码登录或 Token 登录。Token 输入框填写有效 Access Token 本身，不是订阅网址
等待账户信息、配置和内核处理完成。插件会创建或更新 oixCloud - smart 订阅；能看到套餐与流量仅表示账户信息获取成功，还需检查正在使用的配置
3. 选择配置并启动
- 到「运行状态」的配置文件区域找到
oixCloud - smart.yaml - 如果当前不是它，选中并「切换」；等待由切换触发的重启完成，仍未运行时再打开启动开关
- 查看运行日志，确认配置加载和内核启动成功，内核版本应包含
oix - 初次使用保留专用配置和「策略代理 / Rule」模式，再到控制面板选择可用节点或策略组
保留账户登录时，集成版本会优先选择专用内核，无需额外打开「Smart 内核」开关。不要把专用订阅交给第三方转换器再导入，转换可能丢失需要的配置
4. 用局域网设备验证
- 确认测试设备的网关、DNS 和 OpenClash 访问控制符合当前路由器或旁路由方案
- 分别访问直连站点和需要代理的站点
- 在控制面板的连接记录中核对目标、命中规则和出口
只有账户卡片、正常延迟或「运行中」状态，不能证明测试设备的流量已经接管。浏览器安全 DNS、其他 DNS 插件、IPv6 和旁路由网关都可能影响路径
5. 更新与节点筛选
- 更新配置：在运行状态页的配置区域更新，或在「配置订阅」设置自动更新时间，完成后确认当前配置与节点
- 筛选节点：oixCloud 标签的「节点筛选」打开网站编辑器；保存后重启 OpenClash 立即获取，或等待内核下次订阅更新。同账户的 OpenClash 设备共享筛选，见 订阅与筛选
- 升级插件或内核：先备份，在版本更新中分别选择对应下载入口，不要把插件升级和订阅更新混为一件事
常见问题
| 现象 | 下一步 |
|---|---|
| 没有 oixCloud 标签 | 核对软件中心提供的版本，更新插件并刷新浏览器缓存 |
| 内核下载或启动失败 | 看当次日志，再查 CPU 架构、时间、空间和依赖；专用内核有独立下载来源，不能只凭 GitHub 是否可访问判断 |
| 登录成功却没有配置 | 检查配置订阅中的 oixCloud - smart，更新成功后明确切换到该配置 |
| 路由器已运行，设备仍异常 | 核对设备网关、DNS、访问控制和 IPv6，再看连接记录 |
反馈前在「运行日志 → 生成日志」导出调试信息，附插件与内核版本、运行模式和复现时间，并隐藏凭据。参考 维护中的 OpenClash 集成 与 OpenClash 使用手册