passwall github 官方仓库怎么选？PassWall、PassWall2、版本与安装核验

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

简答：如果你搜索 passwall github，优先核对 Openwrt-Passwall 组织下的 openwrt-passwall 或 openwrt-passwall2 仓库；先查看路由器的 OpenWrt 版本、架构和包管理器，再选择对应 IPK 或 APK。排查后仍不兼容，就不要强装。

定义：PassWall GitHub 通常指面向 OpenWrt LuCI 的 PassWall 源码仓库与发行文件页面，但同名项目不止一个，必须按项目组织、功能说明和软件包格式核验。

先确认：你要找的是哪个 passwall github

本文是第三方使用指南，不是「高墙之外❤️ -」官方页面。搜索 passwall github 时，最容易遇到的问题不是不会下载，而是把同名项目、PassWall 和 PassWall2 混在一起。

搜索结果	可以确认的定位	适合做什么	下载入口
Openwrt-Passwall/openwrt-passwall	仓库包含 `luci-app-passwall`，页面标注 GPL-3.0，并提供通过 OpenWrt feeds 编译的说明	查看 PassWall 源码、编译配置和项目更新	优先看 Code；需要发行文件时再看 Releases
Openwrt-Passwall/openwrt-passwall2	页面将 PassWall2 描述为 OpenWrt 的 LuCI 代理应用，并提供 IPK、APK 安装说明	按 OpenWrt 包管理器下载并安装 PassWall2	进入 Releases，再看 Assets
WhyFear/passwall	页面自述为支持 Web 的代理管理与测速工具，不等同于 Openwrt-Passwall 组织下的 LuCI 项目	仅在你明确需要该 Web 项目时再研究	不要把它当作 OpenWrt PassWall 安装包来源

截至 2026-10-26，两个 Openwrt-Passwall 仓库的 Releases 页面分别显示：openwrt-passwall 的 Latest 为 26.10.22-2，openwrt-passwall2 的 Latest 为 26.10.20-1。版本会继续变化，安装前仍应以对应 Releases 页面当时显示的文件为准。

下载前先做三项核验：版本、架构和包管理器

查看 OpenWrt 版本。通过 SSH 登录路由器后执行 cat /etc/openwrt_release，重点看 DISTRIB_RELEASE、DISTRIB_ARCH 等字段。不要只凭路由器型号猜架构，因为同一型号可能存在不同固件分支。
确认包管理器。在路由器 SSH 中执行 opkg --version；如果设备使用 APK，再执行 apk --version。PassWall2 的项目说明把 IPK 对应到 OPKG，把 APK 对应到 APK，并提醒包管理器不同，安装命令也不同。
在 Releases 的 Assets 中核对文件。不要把 Code 页面上的源码压缩包直接当成可安装包。PassWall2 的说明要求 OPKG 用户查找类似 luci-app-passwall2_VERSION_all.ipk 的文件，APK 用户查找类似 luci-app-passwall2_VERSION_all.apk 的文件；其中 VERSION 应替换为页面实际版本。

如果 Release 页面提供 SHA256 或校验文件，可以一并核对；如果没有提供，不要自行编造校验值，至少检查下载页面是否仍在对应项目仓库、文件名是否与版本一致、扩展名是否匹配包管理器，以及架构和 OpenWrt 分支是否适配。

PassWall2 的基本安装路径：IPK 与 APK 分开处理

下面只适用于你已经确认自己下载的是 PassWall2 对应文件的情况。安装前建议备份配置，并确保路由器有足够的可写空间；项目页面说明其依赖会随功能和固件构建变化。

OPKG 固件安装 IPK

从 PassWall2 的 GitHub Releases 页面下载与版本匹配的 .ipk 文件，上传到路由器，例如放在临时目录。
在 SSH 中进入文件所在目录，先更新软件包索引，再执行 opkg update 和 opkg install luci-app-passwall2_*.ipk。实际文件名不一致时，应改用完整文件名，不要盲目照抄通配符。
如果提示缺少 xray-core 或其他依赖，先停止重复安装，检查软件源和 PassWall packages feed 是否为当前固件版本提供。项目 README 明确提示，依赖缺失时需要补充相应 feed。

APK 固件安装 APK

从同一 Releases 页面选择 .apk 文件并上传到路由器。
执行 apk add --allow-untrusted 文件名.apk 前，先确认你理解该参数会绕过包签名验证。项目 README 对此有明确安全提示；如果你无法核验文件来源，不建议继续。
安装完成后，按项目说明执行 /etc/init.d/rpcd restart，再重新打开 LuCI。

PassWall2 README 还提供了通过 APK 仓库和签名密钥安装的路径。这个方法涉及仓库地址、发行版本和架构变量，适合已经确认设备使用 APK 且能核对仓库配置的用户；不建议把面向其他版本的仓库地址直接复制到生产路由器。

只想研究 PassWall 源码：Code、feeds 和 Releases 怎么看

如果你要找的是 openwrt-passwall，而不是直接安装 PassWall2，项目 README 重点给出的是源码编译方法。仓库中可以看到 luci-app-passwall 目录、GPL-3.0 许可证和编译提示。

在 Code 页面确认仓库路径是 Openwrt-Passwall/openwrt-passwall，避免从搜索结果中的同名项目复制脚本。
如果你在 OpenWrt 源码树中编译，README 建议在执行 ./scripts/feeds update -a 前，将 PassWall packages 和 PassWall LuCI 的 src-git 配置加入 feeds.conf.default。
README 给出的两个 feed 分别指向 openwrt-passwall-packages 和 openwrt-passwall。编译前仍要让这两个 feed 与你的 OpenWrt 分支、目标架构和依赖保持一致。
如果只是普通路由器用户，不建议为了“最新代码”直接编译主分支。优先查看 Releases 是否有与你的固件匹配的发行文件；找不到匹配文件时，应先确认固件版本和架构，而不是随意混装。

仓库 README 还列出配套固件和工具入口，但这些并不等于所有设备都适用的通用安装包。本文不把它们当作默认安装方案，具体兼容性以对应项目页面和你的固件为准。

安装失败时按报错位置排查

现象	先看哪里	处理顺序
提示架构不匹配	SSH 输出、`/etc/openwrt_release`、Release 文件名	重新确认 `DISTRIB_ARCH` 与软件包目标架构；不要用“看起来接近”的文件替代。
提示缺少依赖	SSH 安装输出、软件包索引和自定义 feed 配置	先确认 OpenWrt 分支和包管理器，再检查 PassWall packages feed；不要连续重复安装同一个包。
IPK 或 APK 无法安装	下载文件名、扩展名、Release 页面和本地文件大小	重新下载对应项目的 Assets；不要把源码压缩包、其他项目文件或不同版本文件混用。
安装后 LuCI 没有菜单	LuCI 页面和 `rpcd` 服务状态	按项目说明重启 `rpcd`，重新登录 LuCI；若仍无菜单，再查看系统日志和安装输出。
页面出现但节点或核心不可用	PassWall 日志面板、系统日志、核心依赖状态	先区分 LuCI 应用安装成功与核心组件安装成功，不要把“有菜单”当作全部依赖已完成。

一键脚本需要格外谨慎。本文没有找到足以覆盖所有 OpenWrt 版本、架构和回滚场景的通用官方一键脚本，因此不提供未经核实的远程执行命令。假如某个页面要求直接执行远程脚本，至少先下载脚本查看内容、核对仓库来源、检查目标分支和安装路径，并准备可恢复的配置备份；无法审计时不要执行。

最后核对：用这张清单确认没有下错

仓库组织是否为 Openwrt-Passwall，项目名是否与你要安装的 PassWall 或 PassWall2 一致。
你看的是否是对应仓库的 Code、README 或 Releases，而不是搜索结果中的同名项目。
路由器的 OpenWrt 版本、DISTRIB_ARCH 和包管理器是否已经确认。
下载文件是否来自对应仓库的 Release Assets，扩展名是否与 OPKG 或 APK 匹配。
安装失败时是否保留了完整报错，并到 SSH 输出、LuCI 日志或系统日志中定位，而不是重复执行随机命令。
如果页面声称支持某个固件版本，但仓库当前页面没有对应文件或说明，应该标记为“未核实”，以官方为准。

结论很简单：搜索 passwall github 时，先用仓库路径区分项目，再用 Releases 文件名核对版本与包管理器；完成这三步后，才能判断是安装包选错，还是依赖与固件兼容性问题。

常见问题

passwall github 官方仓库是哪一个？

如果你要找 OpenWrt LuCI 版本，优先核对 Openwrt-Passwall 组织下的 openwrt-passwall 和 openwrt-passwall2。前者是 PassWall 项目仓库，后者是 PassWall2 项目仓库。由于 GitHub 上还存在同名项目，不能只看仓库名称中的 passwall。

PassWall 和 PassWall2 应该下载哪个？

先看你准备使用的项目名称和固件说明，不要按版本号猜测。PassWall2 README 明确提供 IPK、APK 和包管理器选择方法；如果页面、固件或已有配置明确写的是 PassWall，就应回到 openwrt-passwall 仓库核对，而不是直接替换成 PassWall2。

PassWall 是否适用于所有 OpenWrt 路由器？

不能直接这样判断。至少要核对 OpenWrt 版本、CPU 架构、包管理器、可写空间和依赖。PassWall2 页面列出 OpenWrt 版本与依赖要求，但实际依赖会随固件构建和选择的功能变化；没有对应架构或依赖时不要强装。

应该从 GitHub 的 Code 还是 Releases 下载？

需要研究源码或自行编译时看 Code 和 README；需要安装发行包时优先看 Releases 的 Assets。源码压缩包通常不是可以直接交给 opkg 或 apk 安装的 IPK、APK 文件。

找不到匹配的软件包怎么办？

先记录路由器的 OpenWrt 版本、DISTRIB_ARCH 和包管理器，再回到对应仓库的 Releases 页面核对。如果没有匹配文件，不要使用其他架构、其他分支或同名项目的安装包；可以改走源码编译，但必须同步核对 feeds、依赖和回滚方案。