跳到主要内容

OpenWrt / Merlin 路由器使用说明

本教程帮助 OpenWrt、Merlin（梅林）、官改和梅改固件用户选择正确的插件安装包、完成安装，并在插件中导入 Paxora 订阅。

路由器配置会影响连接到该路由器的所有设备。普通用户建议先在电脑或手机上使用 Paxora 官方客户端，确认账号和节点可以正常连接后，再配置路由器。

先看完整流程​

确认固件和软件包格式 → 备份路由器配置 → 安装正确的插件包 → 导入 Paxora 订阅 → 选择节点 → 启动插件。

这不是普通 App 安装。安装包必须与路由器固件和平台匹配；如果无法确认型号、固件或 CPU 平台，请先不要安装。

操作前必须确认

安装错误的软件包或修改错误的网络设置，可能导致路由器后台打不开或全家设备断网。开始前请备份路由器配置，并确认自己知道如何停止插件、恢复 DNS 和重启路由器。

一、先看快速选择表​

打开 路由器插件下载目录，根据固件选择文件：

路由器固件应选择的文件不知道 CPU 架构时
OpenWrt 24.10 或更早版本.ipk选择 full.ipk
OpenWrt 25.12 或更新版本.apk选择 full.apk
Merlin / 官改 / 梅改.tar.gz必须先查询机型对应平台

简单来说：

  • OpenWrt 使用 opkg → 下载 .ipk
  • OpenWrt 使用 apk → 下载 .apk
  • Merlin / 官改 / 梅改 → 下载与路由器平台匹配的 .tar.gz
注意

.ipk、.apk 和 .tar.gz 都是插件安装包，不是路由器系统固件。不要上传到“固件升级”页面。

二、OpenWrt：判断应该使用 IPK 还是 APK​

OpenWrt 新旧版本使用不同的软件包管理器：

  • OpenWrt 24.10 及更早版本通常使用 opkg，对应 .ipk。
  • OpenWrt 25.12 及更新版本使用 apk，对应 .apk。

如果不确定当前系统使用哪一种，可以 SSH 登录路由器后分别执行：

command -v opkg
command -v apk

根据返回结果选择：

  • 显示了 opkg 的路径 → 下载 .ipk
  • 显示了 apk 的路径 → 下载 .apk
  • 两条命令都没有结果 → 暂停安装，先确认固件类型和版本
信息

OpenWrt 的 .apk 是路由器软件包格式，与 Android 手机安装包不是同一回事。

三、OpenWrt：什么是 Full 通用版​

文件名中带有 full，表示该安装包会尝试自动识别 OpenWrt 路由器的 CPU 架构，例如：

x86_64
aarch64
arm
mips
mipsel

常见文件如下：

插件名-full.ipk
插件名-full.apk

不知道路由器 CPU 架构时，可以优先选择 Full 版本。

Full 不能判断软件包格式

Full 只能帮助识别 CPU 架构，不能判断系统应该使用 IPK 还是 APK。仍然必须先确认：

  • 使用 opkg → full.ipk
  • 使用 apk → full.apk

四、OpenWrt：通过管理后台安装​

1. 备份设置​

进入 OpenWrt 后台，在“系统 → 备份/升级”或相近页面下载当前配置备份。不同固件和主题的菜单名称可能不同。

2. 打开软件包页面​

通常位于：

系统 → 软件包

在部分主题中也可能叫：

  • 上传软件包
  • 安装本地软件包
  • 手动安装
  • 上传并安装

3. 上传正确的安装包​

  1. 使用 opkg 的系统上传 .ipk。
  2. 使用 apk 的系统上传 .apk。
  3. 确认文件不是 .tar.gz，也不是路由器固件。
  4. 点击“上传”或“安装”，等待安装日志结束。

安装期间不要刷新页面、关闭路由器电源或连续点击安装按钮。

4. 安装后检查​

安装完成后刷新后台页面。插件入口通常出现在“服务”或“VPN”等菜单中。

如果菜单没有出现，按顺序尝试：

  1. 刷新浏览器页面。
  2. 退出路由器后台后重新登录。
  3. 清除当前页面缓存。
  4. 检查安装日志是否出现依赖或架构错误。
  5. 确认安装包与软件包管理器匹配。
  6. 最后再考虑重启路由器。

五、OpenWrt：通过 SSH 安装​

只有熟悉 SSH 和路由器文件路径时才使用本节。先把安装包上传到路由器的 /tmp 目录。

IPK 安装命令​

opkg install /tmp/插件文件名.ipk

例如：

opkg install /tmp/paxora-full.ipk

APK 安装命令​

对于从外部下载的本地 APK 软件包，可以执行：

apk add --allow-untrusted /tmp/插件文件名.apk

例如：

apk add --allow-untrusted /tmp/paxora-full.apk

文件名必须换成你实际上传的名称。不要直接复制示例文件名执行。

如果安装日志显示缺少依赖、签名错误或架构不兼容，请停止操作，不要使用强制覆盖参数反复安装。

六、Merlin：选择正确的平台安装包​

Merlin、官改和梅改固件使用 .tar.gz 安装包。与 OpenWrt 的 Full 通用版不同，Merlin 通常需要按完整路由器型号和固件平台选择。

常见平台包括：

arm
hnd
hnd_v8
qca
mtk
ipq32
ipq64

常见对应关系：

平台包名称下载目录中的平台标记
fancyss_armarm
fancyss_hndhnd
fancyss_hnd_v8hnd_v8
fancyss_qcaqca
fancyss_mtkmtk
fancyss_ipq32ipq32
fancyss_ipq64ipq64

查询路由器平台​

  1. 记录路由器的完整型号，不要只写系列名称。
  2. 记录当前固件名称和版本。
  3. 打开 fancyss 支持机型列表。
  4. 搜索完整型号，查看它对应的 fancyss 平台。
  5. 回到 Paxora 路由器插件下载目录，选择同平台的 .tar.gz。

例如，支持列表显示：

fancyss_hnd_v8

就应选择文件名中带有：

hnd_v8.tar.gz

的安装包。

危险

不要只根据 ARM、ARM64 或 CPU 型号猜安装包。不同机型即使 CPU 指令集相似，软件中心平台也可能不同。fancyss 页面用于查询平台，不是 Paxora 插件下载地址。

七、Merlin：离线安装插件​

  1. 先在路由器后台备份配置。
  2. 打开：软件中心 → 离线安装。
  3. 部分固件中该入口叫：软件中心 → 手动安装。
  4. 选择刚刚下载的 .tar.gz 文件。
  5. 直接上传完整文件，不要自行解压。
  6. 等待软件中心显示安装完成。

安装期间不要：

  • 刷新或关闭管理页面
  • 关闭路由器电源
  • 主动重启路由器
  • 连续点击安装按钮

完成后刷新软件中心，确认插件入口已经出现。

八、安装完成后导入 Paxora 订阅​

不同插件的按钮名称会有区别，常见名称包括“订阅管理”“节点订阅”“机场订阅”或“配置管理”。基本流程如下：

1. 复制个人订阅​

  1. 打开 Paxora 用户中心并登录。
  2. 找到适用于 Clash 或路由器插件的个人订阅地址。
  3. 点击复制。
危险

个人订阅地址包含账号权限。不要把完整地址放进截图、日志、论坛帖子或公开代码仓库。

2. 在插件中添加订阅​

  1. 登录路由器后台并打开刚安装的插件。
  2. 进入“订阅管理”或相近页面。
  3. 新建一个订阅，名称填写 Paxora。
  4. 将个人订阅地址粘贴到 URL 输入框。
  5. 保存后点击“更新订阅”或“下载配置”。
  6. 等待节点列表出现。

如果更新失败，先确认路由器在不开启插件时能够正常访问互联网，再重新复制订阅地址。

3. 选择节点​

  1. 打开“节点选择”“服务器”或“代理节点”页面。
  2. 选择一个普通节点进行首次测试。
  3. 不要照搬教程示例节点，应根据自己的用途和延迟选择。

4. 首次运行设置​

第一次启动时建议：

  • 使用插件默认或规则模式。
  • DNS 设置先保持插件推荐默认值。
  • 不要同时启用多个路由器代理插件。
  • 访问控制先只选择一台测试设备。
  • 暂时不要开启复杂的定时切换、负载均衡或全局模式。

保存设置后点击“应用”“启动”或“运行”，等待插件完成重载。

5. 测试连接​

使用刚才选中的测试设备检查：

  1. 路由器后台仍然可以打开。
  2. 普通网页可以正常访问。
  3. 局域网设备和打印机等本地服务仍然可用。
  4. 目标网站可以正常打开。

确认一台设备正常后，再逐步扩大访问控制范围。

九、更新订阅和更换节点​

节点失效、套餐更新或节点列表变化时：

  1. 在插件首页停止运行或关闭代理开关。
  2. 打开“订阅管理”。
  3. 找到 Paxora 订阅并点击“更新”。
  4. 等待节点列表刷新。
  5. 重新选择节点。
  6. 启动插件并使用一台设备测试。

更新失败时不要连续快速点击。先检查普通网络、套餐状态和订阅地址，再重试。

十、停止使用和恢复网络​

如果配置后出现断网：

  1. 在插件首页点击“停止”或关闭主开关。
  2. 关闭插件的开机启动、自动运行和定时任务。
  3. 将访问控制恢复为“不代理”或关闭。
  4. 将 DNS 设置恢复到修改前的状态。
  5. 应用配置并等待路由器网络恢复。
  6. 仍无法恢复时，重启路由器。
  7. 最后才考虑导入安装前保存的配置备份。

如果路由器后台打不开，可以先让电脑通过网线连接路由器，并确认电脑使用自动获取 IP 和 DNS。不要在不清楚恢复方法时执行恢复出厂设置。

十一、文件名示例​

假设插件名称为 paxora，下载目录中可能出现：

文件名示例用途
paxora-full.ipk使用 opkg 的 OpenWrt 通用架构版
paxora-full.apk使用 apk 的 OpenWrt 通用架构版
paxora-x86_64.ipkOpenWrt x86_64 IPK 版
paxora-aarch64.apkOpenWrt aarch64 APK 版
paxora-arm.tar.gzMerlin ARM 平台
paxora-hnd.tar.gzMerlin HND 平台
paxora-hnd_v8.tar.gzMerlin HND V8 平台
paxora-qca.tar.gzMerlin QCA 平台
paxora-mtk.tar.gzMerlin MTK 平台
paxora-ipq32.tar.gzMerlin IPQ32 平台
paxora-ipq64.tar.gzMerlin IPQ64 平台

文件名只是格式示例，实际名称以下载目录为准。

十二、常见问题​

安装时提示软件包格式错误​

通常是 IPK 和 APK 选错。SSH 执行：

command -v opkg
command -v apk

根据实际软件包管理器重新下载对应格式。

提示架构不兼容​

  • OpenWrt：不知道架构时改用对应格式的 Full 版。
  • Merlin：重新按完整机型查询 arm/hnd/hnd_v8/qca/mtk/ipq32/ipq64 平台。

Full 可以同时给新旧 OpenWrt 使用吗？​

不可以。Full 只表示通用 CPU 架构，软件包格式仍然不同：

opkg → full.ipk
apk  → full.apk

Merlin 可以安装 IPK 或 APK 吗？​

不可以。Merlin、官改和梅改请选择匹配平台的 .tar.gz。

TAR.GZ 需要解压吗？​

一般不需要。直接在 Merlin 软件中心“离线安装”页面上传完整的 .tar.gz。

fancyss 找不到路由器型号怎么办？​

不要选择看起来相似的型号。记录完整型号、固件名称、固件版本和 CPU/SoC，再向固件或插件维护者确认兼容性。

安装成功但看不到插件菜单​

依次尝试刷新页面、重新登录后台、清除浏览器缓存并检查安装日志。确认没有报错后再重启路由器。

订阅更新成功但没有节点​

确认套餐有效、个人订阅没有重置，并检查插件是否支持订阅提供的协议。重新复制地址后删除旧订阅再导入。

启动插件后所有设备断网​

立即停止插件，恢复访问控制和 DNS。只用一台设备重新测试，不要直接让全家设备经过尚未验证的配置。

十三、安全和责任说明​

  • 安装、升级或修改设置前始终保留配置备份。
  • 不要安装来源不明或与架构不符的软件包。
  • 不要公开个人订阅地址、路由器后台地址、密码或完整日志。
  • 不同路由器型号、固件版本和第三方插件之间存在差异，具体操作以当前设备界面和插件说明为准。

Paxora 不提供路由器刷机服务。固件、软件中心和第三方插件本身的问题，请向对应项目维护者查询。