iStoreOS / OpenWrt 安装 PassWall:版本、架构与失败排查
本文目录
PassWall 安装失败,常见原因不是“文件没选对”,而是下载包与当前固件不匹配。安装前先确认固件分支、CPU 架构、包管理器和依赖;不要把其他设备或其他版本的包强行装进路由器。
先确认设备和固件信息
在 iStoreOS 页面查看固件版本和设备型号;SSH 下可执行:
cat /etc/openwrt_release
uname -r
df -h /overlay
再确认系统使用哪种包管理器及设备架构:
command -v apk
command -v opkg
若系统使用 opkg,可查看架构:
opkg print-architecture
若使用 apk,按当前固件文档查看支持的架构和仓库配置。OpenWrt 25.12 系列起使用 apk;较早版本通常使用 opkg。iStoreOS 的实际包管理方式以该固件版本自带的软件源和说明为准,不要混用两套系统的软件包。
推荐安装顺序
- 先在 iStore 或系统“软件”页面刷新软件包列表,搜索 PassWall 或 PassWall2,并优先使用固件提供的软件源。
- 如果软件源没有所需版本,确认你下载的是与固件发行分支、设备 target/subtarget、架构和内核 ABI匹配的包,并核对所有依赖。
- PassWall 与 PassWall2 是不同的软件包/项目;按你实际需要选择,不要把两者的依赖包或 LuCI 界面包混装。
- 先备份路由器配置,确认
/overlay有足够空间,再安装。安装完成后检查软件页面、服务状态和系统日志。
第三方包目录可以作为查找线索,但不能代表所有 iStoreOS 设备都兼容。比如 AUK9527 的仓库按平台和固件分支提供不同构建;下载前应进入对应目录核对说明,而不是直接拿 x86 包安装到 ARM 设备。
常见错误怎么判断
| 现象 | 优先检查 |
|---|---|
| 提示架构不匹配或内核不兼容 | 包的 target、架构、固件分支和内核 ABI 是否与设备完全一致 |
| 提示缺少依赖或软件包格式不支持 | 是否拿错 apk/ipk 格式,软件源是否对应当前固件,依赖是否来自同一组软件源 |
| 安装中断或提示空间不足 | /overlay 可用空间;清理前先确认文件用途,不要删除未知系统目录 |
| 安装后软件页面没有入口 | 检查是否同时需要匹配版本的 LuCI 前端包,并刷新页面或重新登录 |
| 页面有入口但服务启动失败 | 查看服务日志、核心组件和配置;不要通过强制安装其他版本依赖来掩盖问题 |
如果已经装错包,优先通过对应包管理器或 iStore 卸载,再恢复备份或安装匹配构建。避免使用 --force 一类选项跳过依赖、架构和内核检查;这可能让网络或包管理器进入难以恢复的状态。
参考资料
- OpenWrt 软件包管理说明
- OpenWrt apk 使用说明
- PassWall2 上游项目
- AUK9527 第三方软件包目录(第三方构建;请逐项核对平台和固件版本)
PassWall 的其他教程
软件页 →- 文章标题
- iStoreOS / OpenWrt 安装 PassWall:版本、架构与失败排查
- 本文链接
- https://www.gowall.net/software/passwall/istoreos-install-passwall/
- 版权说明
- 版权所有,保留所有权利。