在路由器上装插件和在电脑上装软件是两件事：路由器的存储和内存都很有限，出问题时又往往没有第二块屏幕可以查资料——一旦把自己的网络搞断，连搜索答案都成了问题。所以在 OpenWrt 上动手之前，最值得花时间的是把版本、软件源和回退路径核对清楚。
这篇梳理动手前必须确认的几件事，并补上路由器场景特有的准备工作：资源余量、回退方案，以及为什么强烈建议不要在只有一台路由器时做实验。
顺序上有一个原则贯穿始终：先确认环境，再动手安装。路由器上的每一次失败，代价都比在电脑上大得多——不只是你自己上不了网，家里其他人也会一起受影响。多花十分钟核对，通常能省下几小时的补救。
一、先认准当前仓库
请以当前的官方组织仓库 Openwrt-Passwall/openwrt-passwall 为准，不要沿用网上流传的旧地址（部分旧地址已 404）。安装方式主要有两类：从源码 feeds 编译，或使用发布的安装包。
| 方式 | 关键动作 | 前置条件 |
|---|---|---|
| 源码 feeds | 将两行源加入 feeds.conf.default |
必须在 ./scripts/feeds update -a 之前插入 |
| 安装包（ipk） | 使用 opkg 安装 |
下载与系统匹配的 release |
| 安装包（apk） | 使用 apk add 安装 |
对应使用 apk 的系统 |
二、源码方式：两行 feeds 的顺序很关键
按 README，从源码编译时需要把两行源加入 feeds.conf.default，并且这一步必须在执行 ./scripts/feeds update -a 之前完成。顺序反了，feeds 更新就不会包含 PassWall 对应的内容。这是动手前最容易忽略、却最影响结果的一点。
三、安装包方式：分清 opkg 与 apk
据 release 页，发布物中 ipk 使用 opkg 安装，apk 则使用 apk add。安装前先确认你的 OpenWrt 使用哪种包管理方式，再选择对应的安装物与命令，避免拿错包。
四、README 里的证书公告（按原文转述）
据 README 公告：2026 年 6 月 1 日之后，Xray Core 使用自签名证书，需要配合 pcs / pinnedPeerCertSha256，或改用 sing-box Core。此处仅按官方 README 的公告原文转述，具体以 README 最新内容为准，本文不对其做额外解释或延伸。
之所以把“核对版本与软件源”放在动手之前，是因为 OpenWrt 上的插件安装对环境相当敏感：仓库地址、包管理方式、feeds 顺序、内核与证书要求，任何一处对不上，都可能在编译或安装时报错。与其装到一半再回头排查，不如先把这些边界一次性核对清楚。上面这几点——当前仓库地址、feeds 两行的插入时机、opkg 与 apk 的区分、以及 README 里的证书公告——正是最容易出问题、也最值得提前确认的地方。
需要说明的是，本文只做“动手前的核对”，并不替代官方文档的完整安装步骤；不同 OpenWrt 版本与设备的差异，仍应以官方仓库和 README 的最新说明为准。遇到本文未覆盖的细节，请回到官方仓库查阅，而不是套用网上流传的旧教程。
五、动手前核对清单
- 使用当前官方组织仓库地址，不用已 404 的旧地址。
- 源码编译时，两行源已加入
feeds.conf.default，且在./scripts/feeds update -a之前。 - 确认系统使用 opkg 还是 apk，选对安装物与命令。
- 已阅读 README 关于 2026-06-01 后 Xray Core 自签名证书的公告。
- 清楚本文不含性能或可访问性结论。
六、路由器场景特有的三项准备
存储与内存余量。先看设备剩余的可用空间与内存，空间不足时安装会失败，甚至可能影响现有配置。这一步比选版本更优先。
回退路径。动手前先备份当前配置，并确认你知道怎么恢复出厂设置、怎么进入故障恢复模式。没有这两样，任何一次失败都可能变成长时间断网。
一条不依赖这台路由器的网络。手机流量就够。搞不定的时候，你至少还能上网查资料，而不是对着一台不通的路由器干等。
七、建议的操作顺序
- 备份当前配置，确认恢复方式（含恢复出厂与故障恢复模式）你都清楚。
- 核对固件版本、包管理方式与剩余空间，三项都满足再继续。
- 准备一条独立的备用网络（手机流量即可）。
- 按官方仓库与 README 的当前说明安装，不要照搬网上的旧教程。
- 安装后先只做最小配置，验证基础上网正常，再逐项调整。
- 每次改动后都验证一次，不要一次改完再统一测试。
八、路由器方案与逐台配置怎么选
路由器方案的吸引力在于「配一次，全屋生效」：电视、游戏机、智能设备这些不方便单独装客户端的设备，也能一并覆盖。代价同样明显——排查变难（问题可能出在路由器、固件、插件或线路的任意一层），而且一旦配错，影响的是全家人的网络。
逐台配置则相反：单台出问题不影响其他设备，调整灵活，但设备一多就变成重复劳动，而且那些不能装客户端的设备始终覆盖不到。
一个折中的做法是分层：不方便单独配置的设备交给路由器，主力电脑和手机仍然各自装客户端。这样既覆盖了盲区，又保留了在关键设备上快速切换与排查的能力。选哪种，取决于你家里那些「装不了客户端的设备」到底重不重要。
如果暂时拿不定主意，先从逐台配置开始通常更稳妥——它随时可以退回，而路由器方案一旦配好，反而不容易再拆。
九、常见问题
安装失败但没有明确报错怎么办？
优先看剩余空间与包管理方式是否用错。这两项占了此类失败的绝大多数。
路由器上部署和在电脑上用客户端，该选哪个？
路由器方案的优点是全屋设备统一生效，代价是排查更难、灵活性更低。设备不多时，逐台配置客户端往往更省心，可参考全平台代理客户端梳理。
能不能只让部分设备走代理？
可以，通常通过规则或按设备地址区分来实现。具体做法以你所用插件的当前文档为准，配置前先想清楚哪些设备应当保持直连。
需要先升级固件吗？
不一定，但如果当前固件版本过旧、软件源已经不再提供匹配的包，升级固件往往比想办法迁就旧版本更省事。升级前同样要先备份配置。
要不要保留一台不受影响的设备？
强烈建议。改动路由器时，手边有一台走手机流量、不依赖这台路由器的设备，是你出问题时唯一还能查资料、还能远程处理的退路。
路由器性能不够会怎样？
典型表现是设备本身发热、管理页变卡、整体吞吐上不去。这类瓶颈无法靠配置解决，只能降低期望或更换硬件。
改坏了怎么恢复？
先用备份的配置恢复；不行再恢复出厂并重新配置。这也是为什么第一步就要确认恢复方式。
