PassWall 下载：先确认 OpenWrt 版本，再选择安装包
简答：PassWall 主要运行在 OpenWrt 类路由系统的 LuCI 中，不是 Windows 或 Android 的普通客户端。下载前只做三件事：确认设备与固件、确认 apk 或 opkg、确认架构与项目代际；Android APK 不等于 OpenWrt apk。
定义：PassWall 是运行在 OpenWrt 类路由系统上的 LuCI 网络连接管理应用，安装包必须同时匹配项目版本、固件包管理器、软件源和设备架构。
先看三步速查卡：不要把 OpenWrt apk 当成 Android APK
最快判断：①设备是不是路由器；②系统实际使用 apk 还是 opkg；③目标是 PassWall 还是 PassWall2。只要其中一项无法确认，就先停止下载，不要根据文件名或搜索结果猜测。
| 你的情况 | 先确认 | 通常查看的文件或入口 | 停止条件 |
|---|---|---|---|
| OpenWrt 25.12 及以后 | 路由器是否能运行 apk | OpenWrt apk 软件包，常见扩展名为 .apk | 没有 apk 命令或软件源不匹配 |
| OpenWrt 24.10 及更早 | 路由器是否能运行 opkg | ipk 软件包，常见扩展名为 .ipk | 架构、固件分支或依赖不一致 |
| ImmortalWrt、iStoreOS 或定制固件 | 实际包管理器、软件源和架构 | 以设备命令和当前软件源为准 | 不能只凭系统名称套用通用文件 |
| Android 手机 | 是否需要 Android 客户端 | 不要把 OpenWrt 的 .apk 当作 Android APK | 下载页面只说明 OpenWrt、LuCI 或路由器 |
| Windows、macOS 或 iPhone | 是否需要对应平台客户端 | PassWall 本身不是常规桌面或手机安装包 | 不要双击路由器插件包 |
OpenWrt 软件包安装说明写明，OpenWrt 25.12 及以后使用 apk，24.10 及更早版本使用 opkg；OpenWrt apk 文档也特别说明，这里的 apk 与 Android 等系统使用的同名缩写无关。具体设备仍应以实际命令和软件源为准。
PassWall 与 PassWall2：先选项目，再看 Release
PassWall 和 PassWall2 是两个不同项目。它们的插件本体、语言包、依赖和发布资产不能因为名称相似就混装。新手不要先搜索“最新版文件名”，而应先进入对应项目仓库，再进入 Releases 页面查看当前发布内容。
| 目标 | 项目入口 | 下载时核对 | 适合的选择方式 |
|---|---|---|---|
| PassWall | PassWall 项目仓库、PassWall Releases | 发布标签、包格式、软件源、插件本体和依赖 | 已有 PassWall 配置时，优先保持同一项目代际 |
| PassWall2 | PassWall2 项目仓库、PassWall2 Releases | apk/ipk、中文语言包、依赖组件和 SHA-256 | 新装前先确认固件和包管理器，再决定项目 |
本次核验日期为 2026-11-02。PassWall Releases 页面当前将 26.10.29-1 标为 Latest，PassWall2 Releases 页面也将 26.10.29-1 标为 Latest；版本会继续变化，发布时应以当前页面为准，不要把本文日期或版本号当成固定下载指令。
如果你只想找“路由器插件下载”，不要把 Windows、macOS、Android 或 iOS 客户端页面当作 PassWall 安装入口。PassWall 面向的是 OpenWrt 类路由系统的 LuCI 环境，平台不匹配时应停止。
下载前核验：固件、包管理器、架构和依赖
- 查看固件信息：在 LuCI 的系统信息页面查看，或通过 SSH 执行
cat /etc/openwrt_release。不要只根据教程发布日期判断包格式。 - 确认包管理器：执行
command -v apk和command -v opkg。哪一个命令实际存在，就优先按哪一条路径继续；如果两者都没有，先确认系统是否真的是 OpenWrt 类固件。 - 确认架构：执行
ubus call system board，再结合固件软件源显示的架构目录判断依赖。插件文件名带有all，不等于所有核心依赖都跨架构通用。 - 确认项目代际：PassWall 和 PassWall2 分别进入各自的 Release 页面，不要把一个项目的语言包或依赖包装到另一个项目中。
- 确认依赖来源：插件本体不一定包含所有核心组件。当前 PassWall2 Release 页面列出插件、语言包及多个配套组件的版本信息；是否需要安装某个依赖，应以当前 Release 和软件源解析结果为准。
可复制检查命令：
cat /etc/openwrt_release：确认固件发布信息。command -v apk; command -v opkg：确认可用包管理器。ubus call system board：查看设备板卡信息。df -h：确认安装前剩余空间，避免依赖包下载后因空间不足中断。
这些命令只读取系统信息，不会主动修改配置。若你准备执行安装命令，先保存当前配置和终端报错；不要把包含令牌、订阅地址或私密配置的内容粘贴到普通网页或公开工单。
按项目和包管理器选择安装清单
下面是一份手动核验清单，不是自动下载器，也不会替你判断定制固件是否兼容。下载时先选项目，再选包管理器，最后检查架构和依赖。
| 目标 | OpenWrt 25.12 及以后 | OpenWrt 24.10 及更早 | 还要检查什么 |
|---|---|---|---|
| PassWall 插件本体 | 在 PassWall Release 或配套软件源中找 .apk | 在 PassWall Release 或配套软件源中找 .ipk | 项目代际、版本标签、固件分支 |
| PassWall2 插件本体 | 当前 Release 资产中的 luci-app-passwall2-版本-r1.apk 类文件 | 当前 Release 资产中的 luci-app-passwall2_版本-r1_all.ipk 类文件 | 文件名必须以当前页面为准 |
| 中文语言包 | 查看 luci-i18n-passwall2-zh-cn-版本.apk 类资产 | 查看 luci-i18n-passwall2-zh-cn_版本_all.ipk 类资产 | 只下载与目标项目和版本对应的语言包 |
| 核心和其他依赖 | 优先使用已核验的软件源，让 apk 解析依赖 | 优先使用已核验的软件源，让 opkg 解析依赖 | 不要从随机下载站补装同名文件 |
PassWall 项目当前 Release 页面提供两种路径：按照配套构建仓库说明添加软件源，或从其关联的 SourceForge 文件区下载预构建包后上传安装。对应构建仓库的 README 给出了 apk 与 opkg 的软件源路径和手动安装命令，可查看配套构建仓库说明。SourceForge 文件区可作为传输入口，但仍应回到项目 Release 核对版本、包名和校验信息。
如果 GitHub 打不开，不要直接换到不明镜像。优先查看项目 Release 是否明确指向配套文件区；镜像或文件区只解决传输问题，不能替代项目身份、版本和 SHA-256 核验。无法互相印证来源时，不要下载、付款或导入。
安装方式：软件源优先，手动包只在来源已确认时使用
方式一：使用已核验的软件源
- 先阅读配套构建仓库的当前 README，确认固件分支、架构和软件源地址。
- 按照设备实际包管理器添加软件源和密钥，不要复制旧教程中的固定路径。
- 执行软件包列表更新，再按项目名称安装插件，让包管理器解析依赖。
- 安装后重新登录 LuCI；如果菜单没有出现，先查看软件包列表和系统日志。
配套构建仓库当前对 OpenWrt 25.12 及以后给出 apk 软件源路径，对 OpenWrt 24.10 及更早给出 opkg 软件源路径；其 README 还使用 /etc/openwrt_release 中的发布分支和架构生成路径。由于软件源、密钥和资产会变化，实际操作应以该页面当前内容为准。
方式二：上传本地包后安装
- 从对应项目的 Release 或项目明确指向的配套文件区下载包，记录版本、文件名和 SHA-256。
- 通过 LuCI 软件包页面上传，或使用 SCP 将文件放到路由器临时目录。
- OpenWrt 25.12 及以后通常使用
apk add ./文件名.apk；OpenWrt 24.10 及更早通常使用opkg install ./文件名.ipk。 - 如果 apk 对外部本地包提示信任问题，项目 Release 页面给出了
apk add --allow-untrusted的用法；只有在来源和 SHA-256 已确认时才考虑使用，因为它会放宽本地包的信任检查。
PassWall 当前 Release 页面同时列出了手动下载和 Shell 安装提示，包括 opkg install 与 apk add --allow-untrusted；命令适用范围应以实际包管理器和当前页面为准，不要在 Android 手机或桌面系统中执行。
校验、成功标准与安装失败回退
- 文件名校验：项目名、版本标签、扩展名和语言包名称应与当前 Release 页面一致。
- SHA-256 校验：Release 页面提供摘要时，在本地计算文件摘要并逐字符比较；摘要不一致就删除文件并重新下载。
- 来源校验：浏览器地址应能从项目仓库或 Release 页面相互印证；只出现“高速下载”“免验证”的页面，不足以证明来源。
- 安装成功：软件包列表中能查到插件，LuCI 中出现对应菜单，日志没有持续出现架构不匹配或依赖缺失。
- 连接成功另行验证：插件能打开不代表节点、DNS、MTU、路由或防火墙已经正常。安装完成后应再做分层连接测试。
| 现象 | 优先检查 | 回退动作 |
|---|---|---|
| 提示不是有效安装包 | apk/ipk 是否选错，文件是否下载完整 | 删除当前文件，回到对应 Release 重新下载 |
| 提示架构不匹配 | 固件架构、软件源架构和依赖架构 | 停止安装，不要强行覆盖 |
| 提示缺少依赖 | 软件源是否可用，依赖是否属于同一固件分支 | 保留错误日志，按包名逐项核对 |
| 插件安装后不显示 | 插件本体、LuCI 登录状态和 rpcd 日志 | 重新登录 LuCI，再检查软件包列表 |
| 插件可打开但无法连接 | 核心组件、DNS、时间、MTU、路由和防火墙 | 停止反复换包，改做网络分层排查 |
| GitHub 或文件区无法访问 | 项目 Release 是否提供明确的配套入口 | 只使用可由项目页面互相印证的传输入口 |
如果无法同时核对固件、包管理器、架构、项目代际和下载来源，最安全的回退动作是暂停安装。不要为了绕过报错而混用 PassWall、PassWall2、不同固件分支或不同架构的文件。
常见问题
PassWall 可以安装在 Windows 或 Android 手机上吗？
PassWall 主要是 OpenWrt 类路由系统中的 LuCI 应用，不是普通 Windows 安装程序，也不能把 OpenWrt 的 apk 当成 Android APK。电脑和手机应寻找适配自身平台的客户端，路由器则按固件和包管理器安装。
PassWall 和 PassWall2 的安装包能混用吗？
不建议混用。两者是不同项目，插件本体、语言包、依赖和配置路径可能不同。应先确定项目，再从对应仓库和 Releases 页面下载。
OpenWrt 到底下载 ipk 还是 apk？
先确认实际包管理器。OpenWrt 25.12 及以后通常使用 apk，24.10 及更早通常使用 opkg；但 ImmortalWrt、iStoreOS 和定制固件不能只凭版本号推断，应以设备命令和软件源为准。
为什么插件本体能下载，安装时却提示缺少依赖？
插件本体不一定包含核心组件或其他依赖。请检查软件源是否与固件版本、架构一致，再按错误中的包名核对；不要从不明页面下载随机依赖包覆盖。
GitHub 打不开时，可以直接从镜像下载吗？
只有当项目 Release 或配套构建仓库明确指向该文件区时，镜像才可视为传输入口。下载后仍要核对版本、文件名和 SHA-256；来源无法相互印证时，应停止下载。
怎么判断 PassWall 已经安装成功？
先看软件包列表中是否存在插件，再重新登录 LuCI，确认对应菜单出现，并检查日志中没有持续的依赖或架构错误。菜单出现只代表安装环节基本完成，不代表网络连接已经正常。