高墙之外❤️

PassWall2 安装失败怎么办？按 OpenWrt 版本选择 ipk 或 apk

更新于 2026-10-26 · passwall.lol

简答：PassWall2 安装的关键不是先找包，而是先确认固件版本和包管理器：OpenWrt 24.10 及更早通常用 opkg 与 ipk，25.12 及更新版本用 apk 与 apk 包。装错格式、架构或依赖时，按本文顺序核对即可定位问题。

定义：PassWall2 是运行在 OpenWrt 路由器上的 LuCI 网络代理管理界面，插件本体、语言包、代理核心和系统依赖需要分别确认。

先确认这 4 项，再下载 PassWall2

本文是第三方使用指南，仅用于帮助你核对安装方法，不代表 PassWall2 项目官方。PassWall2 项目仓库将其定义为 OpenWrt 的 LuCI 网络代理管理应用，并要求 OpenWrt 21.02 或更高版本；如果你的系统低于这个要求，不要直接套用当前发布包。

检查项目SSH 命令如何判断
固件版本cat /etc/openwrt_release记录 DISTRIB_RELEASE 和 DISTRIB_ARCH
包管理器opkg --version
apk --version		能正常返回哪个命令，就优先使用对应格式
CPU 架构ubus call system board将架构与 Release 资产名称、软件源路径逐项核对
剩余空间df -h确认 overlay 或可安装分区有足够空间；具体需求随协议组件变化

OpenWrt 官方文档说明，25.12 及更新版本使用 apk，24.10 及更早版本使用 opkg；OpenWrt 25.12 的发布说明也记录了从 opkg 切换到 apk 的变化。OpenWrt 软件包管理文档　OpenWrt 官方发布说明

因此可以先按下面的规则选择：24.10 及更早版本通常下载 .ipk；25.12 及更新版本通常下载 .apk。不要因为文件名里有 apk 就把它当成安卓安装包，它是 OpenWrt 的包格式。

从哪里下载：先核对 Release 资产和版本

优先从 PassWall2 项目 Release 页面选择与你的包管理器匹配的资产。页面在 2026 年 10 月 26 日显示的最新发布条目为 26.10.20-1，发布日期为 2026 年 10 月 20 日；发布页同时列出 ipk、apk、简体中文语言包及相应 SHA256 值。版本会继续变化，下载前仍应以当时的 Release 页面为准。

  • 插件本体：opkg 系统选择类似 luci-app-passwall2_版本_all.ipk 的文件；apk 系统选择类似 luci-app-passwall2-版本-r1.apk 的文件。
  • 中文语言包：需要中文界面时，再选择 luci-i18n-passwall2-zh-cn 对应的 ipk 或 apk。
  • 代理核心：Xray、sing-box 等属于可选协议组件，不等于插件本体。根据实际节点协议安装，不要为了“装全”而盲目全部安装。
  • 校验文件：如果 Release 页面提供 SHA256 或校验文件，可以核对；如果某个资产没有提供，就只核对下载来源、文件名、版本和架构，不要假设所有文件都有校验值。

PassWall2 README 列出的核心依赖包括 coreutils、curl、ip-full、Lua、LuCI 兼容组件、tcping、unzip、geoview、v2ray-geoip 和 v2ray-geosite，实际依赖会随固件软件源和所选功能变化。PassWall2 项目 README：安装、系统要求与依赖

方法一：通过 LuCI 网页上传安装包

  1. 在电脑上从 Release 页面下载与固件匹配的 PassWall2 插件包；需要中文界面时同时下载对应语言包。
  2. 登录路由器 LuCI，进入 系统 → 软件包。不同固件的翻译可能略有差异，但入口通常是软件包管理页面。
  3. 先点击更新软件包列表，确认系统软件源可以正常访问；如果更新失败，先修复固件软件源，不要直接反复上传插件包。
  4. 在手动安装或上传区域选择本地文件，先安装插件本体，再安装语言包。若系统提示依赖缺失，记录完整报错，不要强行忽略。
  5. 安装结束后重启 LuCI 相关服务或重新登录管理页面，然后检查 服务 → PassWall2 是否出现。

网页上传适合不熟悉 SSH 的用户，但它不能自动修复不匹配的固件版本、架构或内核模块。若 apk 系统对外部本地包提示不受信任，优先使用带签名的软件源；直接使用 --allow-untrusted 会绕过包签名验证，只应在你已经核对来源并理解风险时使用。

方法二：通过 SSH 安装 ipk 或 apk

SSH 命令应在路由器终端执行。先把安装包上传到临时目录，或者使用带明确版本号的下载地址。示例中的“版本号”请替换为 Release 页面当前实际版本，不要照抄旧版本。

OpenWrt 24.10 及更早、使用 opkg：

opkg update
opkg install /tmp/luci-app-passwall2_版本号_all.ipk
opkg install /tmp/luci-i18n-passwall2-zh-cn_版本号_all.ipk

如果报依赖缺失，先检查软件源和系统版本是否匹配，再根据报错安装依赖。PassWall2 README 明确提示，缺少 Xray 等依赖时，需要配置项目提供的软件源；软件源地址会随版本和构建方式变化，应以当前 README 的依赖或软件源章节为准，不要长期复制旧地址。

OpenWrt 25.12 及更新、使用 apk：

apk update
apk add /tmp/luci-app-passwall2-版本号-r1.apk
apk add /tmp/luci-i18n-passwall2-zh-cn-版本号.apk

本地 apk 若没有受信任签名，系统可能拒绝安装。PassWall2 README 提供了添加签名密钥和软件源的方式，推荐优先采用该方式；不要把 ipk 直接交给 apk，也不要把 apk 直接交给 opkg。安装完成后可执行：

/etc/init.d/rpcd restart
logread | grep -i passwall2

方法三：软件源或一键脚本是否值得用

对于 apk 系统，PassWall2 README 提供了添加 APK 仓库和签名密钥的安装方式：读取 /etc/openwrt_release 获取发行版与架构，写入对应的软件源，执行 apk update，再安装 luci-app-passwall2。这类方式比手动下载单个包更容易处理依赖，也便于后续更新，但仍要确认软件源与你的固件分支和架构一致。

一键脚本则要谨慎。公开仓库 Passwall2-Installer 提供了自动安装脚本，但它不是 PassWall2 官方仓库，且脚本会以路由器管理员权限修改软件源、密钥和已安装软件。查不到脚本来源、维护状态、适配版本和回滚说明时，不建议直接执行“下载后立刻通过管道运行”的命令。

如果你确实需要审计脚本，应先下载到本地查看，再运行：

wget -O install.sh https://脚本来源/install.sh
sed -n '1,240p' install.sh
grep -nE 'apk|opkg|wget|curl|rm |/etc/apk|/etc/opkg|uci|/etc/init.d' install.sh
sh install.sh

上面的地址只是命令结构示例，不是固定下载入口。审计重点是：是否检测了固件版本和架构、是否区分 opkg 与 apk、是否写入可信密钥、是否覆盖已有软件源、是否安装不需要的组件、是否提供卸载或恢复方法。无法核实这些内容时，选择 Release 手动安装或 README 中的软件源方法更稳妥。

安装后检查：菜单、依赖和服务状态

  1. 重新登录 LuCI，进入 服务 → PassWall2。如果菜单没有出现，先重启 rpcd，再清理浏览器缓存或换一个浏览器测试。
  2. 在 SSH 中查看插件日志：logread | grep -i passwall2。启用调试后，还可以检查 /tmp/log/passwall2.log 和 /tmp/log/passwall2_server.log。
  3. 如果提示核心不存在，只安装了 LuCI 插件而没有安装对应的 Xray 或 sing-box 组件；根据实际协议安装匹配核心，不要把核心版本和固件架构混用。
  4. 如果提示 dnsmasq 冲突或透明代理无法启动，先检查系统中 dnsmasq 相关包是否满足当前 PassWall2 依赖，再检查防火墙和内核模块。dnsmasq-full、kmod-nft-socket、kmod-nft-tproxy 等包是否需要安装，取决于固件分支、内核和所用模式，不能脱离报错直接照抄。
  5. 如果安装包不匹配，重点回看三项：ipk/apk 是否选错、Release 版本是否适配固件、CPU 架构是否一致。不要用“转换包”或强制参数掩盖格式不兼容。

安装成功只代表 LuCI 插件和依赖能够加载，不代表节点、DNS 或透明代理已经配置完成。进入 PassWall2 后，再按 节点列表 → 添加节点 添加实际节点，配置默认节点并保存应用；连接测试应作为后续独立验证步骤。

最后核对：2026-10-26

本文依据 2026 年 10 月 26 日检索到的 PassWall2 README、Release 页面和 OpenWrt 包管理文档整理。当前 Release 页面显示 26.10.20-1，但版本、资产和软件源可能继续变化；再次安装时，请重新打开发布页核对版本、文件名、架构、签名或 SHA256 信息。

本文不代替路由器固件的官方升级说明。若你的系统是定制固件、低于 OpenWrt 21.02，或软件源被固件厂商改写，应以该固件的文档为准。

如果你需要线路、DNS、MTU 或跨设备连接问题的技术排查，可了解与本文安装问题相关的边界云加速官网服务；这是本文站点与该服务的关系披露，商业服务不等同于 PassWall2 官方支持。

常见问题

PassWall2 的 apk 是安卓 APK 吗？

不是。这里的 apk 是 OpenWrt 25.12 及更新版本使用的 Alpine Package Keeper 包格式，与安卓应用安装包不是一回事。

OpenWrt 24.10 可以安装 PassWall2 的 apk 吗？

通常不应直接安装。OpenWrt 24.10 及更早版本通常使用 opkg 和 ipk；请先确认实际包管理器，再从 Release 页面选择对应格式。

为什么 PassWall2 安装后 LuCI 没有菜单？

先执行 /etc/init.d/rpcd restart 并重新登录，再查看 logread | grep -i passwall2。若仍无菜单，检查插件格式、固件版本、架构和 LuCI 依赖是否匹配。

安装 PassWall2 是否必须同时安装 Xray 和 sing-box？

不必须。插件本体、代理核心和系统依赖是不同组件，应按实际使用的协议选择 Xray、sing-box 或其他核心，避免无必要地安装全部组件。

一键脚本安装 PassWall2 安全吗？

不能一概而论。脚本通常以管理员权限修改软件源和安装包；来源、适配版本、密钥和回滚方式无法核实时，不建议直接执行下载后管道运行命令，先下载、阅读并审计脚本。

相关阅读

参考资料

  1. PassWall2 项目 README：安装、系统要求、依赖与日志
  2. PassWall2 官方 Release：版本、安装包与校验信息
  3. OpenWrt 软件包管理文档：apk 与 opkg 的版本分界（openwrt.org）
  4. OpenWrt 官方发布说明：25.12 从 opkg 切换到 apk
  5. Passwall2-Installer：第三方一键安装脚本仓库