oixClash 安装与配置指南

适用于安装了 KoolCenter 软件中心的 Merlin 固件（梅林改版、官改）。安装包以 软件中心 提供的版本为准。oixClash 按 oixCloud 下发的配置接管局域网设备，设备本身无需任何设置，不支持导入其他订阅

1. 选择安装包

在路由器管理页进入「软件中心」，确认识别的平台后，点击下表中的安装包直接下载，无需打开 GitHub：

平台	安装包	常见机型
hnd	下载	RT-AX86U、RT-AX88U、GT-AX6000、GT-AX11000 等大多数机型
mtk	下载	TUF-AX4200Q、TX-AX6000、RT-AX57 Go 等
qca	下载	RT-AX89X
ipq32	下载	ZenWiFi BD4
ipq64	下载	型号代码 TUF_6500

下载地址会跟随最新正式版本更新，也可下载 SHA256 校验文件 核对文件完整性

安装包约 18MB，需要 JFFS 有足够空间。512MB 及以上内存的机型可按默认设置运行；256MB 等小内存机型可使用 0.0.3 起提供的低内存模式。普通模式下，内核解压到内存约占 48MB，代理运行、GeoIP 数据和控制面板还会占用额外内存

2. 离线安装

1. 打开「软件中心 → 离线安装」，选择下载的安装包上传
2. 不要修改文件名；浏览器重复下载时加上的「(1)」要删掉，否则软件中心会拒绝安装
3. 看到安装完成后返回软件中心，打开 oixClash

平台不符时软件中心会直接提示并停止安装，换成对应平台的安装包即可

3. 登录 oixCloud

中文模拟界面 · 虚构数据 · 点击查看大图

首次在「oixCloud 账号」选择邮箱和密码登录，生成 oixClash 专属 Token；之后可使用对应的 Access Token。Google 登录用户获取账户密码的方法与禁止客户端邮箱/密码登录的设置见 首次登录说明

登录方式：

• 登录令牌：粘贴在 oixCloud 网站或 App 中复制的 Access Token，不是订阅地址
• 邮箱和密码：填写 oixCloud 账户的邮箱与密码，密码只用于本次登录，不保存在路由器上

登录后显示账号、套餐、到期时间与流量。粘贴其他 oixCloud 客户端的令牌时，插件会换成 oixClash 自己的令牌，节点筛选按 oixClash 单独保存；网站上创建的令牌无法转换，按原样使用

4. 开启代理

中文模拟界面 · 虚构数据 · 点击查看大图

1. 在「运行」打开开关，点「保存并应用」
2. 等日志显示「启动成功」。首次运行会下载 GeoIP 等数据，需要一些时间
3. 「运行状态」显示运行中和内核版本即为正常

oixClash 接管主局域网设备的 TCP 与 DNS。需要代理游戏、语音通话等 UDP 流量时，勾选「UDP 转发」后保存，运行状态出现「UDP 已转发」才表示生效；未开启 UDP 转发时，建议保持「屏蔽 QUIC」，浏览器会改用可被代理的 TCP

小内存设备

oixClash 0.0.3 起提供「低内存模式」。首次安装时，检测到总内存不足 384MB 会自动开启；升级时保留已有选择，也可在「运行 → 低内存模式」手动调整

1. 勾选「低内存模式」，点「保存并应用」；应用期间会先停止代理再检查配置，局域网暂时直连，配置检查不通过时也会保持直连
2. 启动后检查该选项下方的提示：「内核在 JFFS 上运行」表示内核文件已移到闪存；若提示「JFFS 空间不足，内核仍解压到内存」，先释放不需要的插件占用，再保存并验证
3. 点「自检」，检查 JFFS 剩余空间和可用内存，再按下一节验证局域网连接

调整	需要了解
空间允许时，内核和控制面板存放在 JFFS	减少内存文件占用，但需要更多闪存空间；代理进程本身仍使用内存
使用精简 GeoIP 库	仅覆盖 CN 等少数地区，使用其他地区 GEOIP 自定义规则时需留意匹配结果
更积极地回收内存	降低内存峰值，但可能增加 CPU 开销，不能保证所有配置都能在 256MB 机型运行

关闭低内存模式后，已放到 JFFS 的内核仍继续使用；下次更新插件时才恢复为压缩包并在运行时解压到内存

5. 用局域网设备验证

1. 测试设备使用路由器下发的网关和 DNS；先关闭浏览器的安全 DNS 再测试
2. 分别访问直连站点和需要代理的站点
3. 点「打开控制面板」，在连接记录中核对目标、命中规则和出口

路由器自身和访客网络的流量不经过 oixClash。设备通过 IPv6 上网时会绕过代理，运行状态会提示，建议在「IPv6」页面把连接类型设为停用

6. 节点、筛选与更新

• 切换节点：点「打开控制面板」，在策略组中选择节点；选择会在重启后保留
• 节点筛选：点账号栏的「订阅管理」打开网站编辑器，保存后在插件点「更新节点」立即获取，或等待每天自动更新。节点筛选对使用同一账户的所有 oixClash 生效，见 订阅与筛选
• 更新插件：开启插件后每天检查一次新版本，也可以点版本号旁的「检查更新」。出现「更新到 x.y.z」后点击，插件会下载并校验安装包再安装，期间代理会短暂中断

若插件内更新提示无法校验安装包，或旧版自检提示缺少 sha256sum，请从本页下载对应平台的安装包，通过「软件中心 → 离线安装」更新。安装包校验不通过时不要继续安装，重新下载并核对 SHA256

7. 编辑账号自定义规则

oixClash 0.0.2 起可在插件的「自定义规则」中编辑网站上的同一份 账号规则，账号规则排在默认规则之前。保存会影响使用这份规则的其他客户端；清空后保存会删除整份账号规则，操作前先保留需要的内容

中文模拟界面 · 虚构数据 · 点击查看大图

1. 登录后点击「读取面板规则」，确认显示「已读取面板规则，可编辑后保存」
2. 每行写一条标准 Surge 格式的规则，无需 rules: 或行首短横线；# 或 // 开头的行是注释。策略填写 DIRECT、REJECT 或配置中已有的策略组名称
3. 点击「保存到面板并更新」，查看日志：插件运行中会更新并检查配置；插件未运行时，在下次开启时获取并检查
4. 用局域网设备建立新连接，在控制面板核对命中规则和出口

DOMAIN-SUFFIX,example.com,DIRECT
DOMAIN,ads.example.com,REJECT

路由器编辑器最多处理 8192 个 UTF-8 字节，中文等字符会占多个字节。更长的规则请在网站编辑，再点插件「更新节点」，不要截短原规则来适配编辑器

提示或情况	处理方式
规则已被其他页面修改	先另存当前草稿，重新读取最新规则，再合并需要的修改；不要直接覆盖别处的新内容
面板保存成功，但路由器尚未应用	网站上的规则已经改变，先修正规则或网络问题，再点「更新节点」并验证连接
无法读取，或当前版本没有规则入口	在网站编辑账号规则，保存后点「更新节点」获取；插件内读取和保存还需要站点支持

重新读取会替换未保存的草稿，先确认提示。账号规则与节点筛选的共享范围不同，见 订阅与筛选

常见问题

现象	下一步
离线安装提示平台不符或文件名有误	按软件中心识别的平台下载安装包，删掉文件名里的「(1)」
运行状态提示「登录已失效」	点「退出登录」后重新登录
提示「账号没有可用的套餐」	续费后点「保存并应用」
提示「路由器时间尚未同步」或时间不准确	在「系统管理 → 系统设置」检查时区和 NTP 服务器；时间同步后插件会自动启动
提示内存不足、内核无法启动	开启低内存模式，关闭不需要的其他插件后点「保存并应用」；发生内存不足后，看门狗改为每 30 分钟自动重试
低内存模式已开启，内核仍解压到内存	检查 JFFS 空间和插件日志，释放闪存空间后重新保存；勾选低内存模式本身不代表内核已迁移成功
插件内更新提示无法校验安装包	按本页的对应平台下载并离线安装，不要跳过完整性校验
UDP 转发没有生效	点「自检」，查看 TPROXY 与策略路由两项；部分固件不支持时只影响 UDP，TCP 照常代理
提示与科学上网或 MerlinClash 冲突	先关闭另一个代理插件，同时只能开启一个
路由器已运行，设备仍异常	核对设备的网关、DNS 和 IPv6，再看控制面板的连接记录

反馈前点「自检」，把自检结果和「查看日志」中的插件日志一并发送，并隐藏账号信息