openwrt-passwall 目前暂不支持自动更新，如需更新，请自行编译或下载ipk然后手动安装
首发时间:#最新版本：25.3.9，目前暂不支持自动更新，如需更新，请自行编译或下载ipk然后手动安装。
第一次从Release下载passwall ipk升级时，请加上--force-reinstall参数安装，之后再升级不需要 #2489
从release下载ipk升级luci-app-passwall的，如果当前版本是自编译版或从其他渠道下载的，在安装时，请务必带上--force-reinstall参数，否则之前因为依赖关系而自动安装的Xray、SS等组件在升级安装时，将被系统自动移除。
只是第一次需要--force-reinstall，之后再从release页面下载更新，可以照常安装，不受影响。
如果已经因为升级导致组件被移除，可以从release下载路由器对应架构的packages，解压后，找到需要的组件，重新按照。如果是组件更新页可以直接下载的组件，也可以直接下载使用。
背景
本人在 Openwrt 上一直使用的 PassWall 进行外国学习，但是由于每次都是使用的别人编译的固件，每次要更新什么组件都比较麻烦，自从上次为了升级内核到 6.x 都是全新重装，后面不想再次折腾每次都重装再导入配置，因为一直用得很稳定，没有任何必要不会重装，主要还是怕出各种问题浪费时间，这次为了在 OpenWrt 上面使用 hysteria2，所以考虑直接手动升级插件就行了。
介绍
PassWall 最新的版本 4.71-2支持 sing-box 1.53，sing-box 自 1.5.0-beta.2 后支持 Hysteria 2，所以这次需要把 PassWall 升级到 4.71-2 ，升级前就是下载各种 .ipk 包，然后命令终端执行安装即可。当然你也可以在后台通过界面挨个下载并安装，但是我还是会了粗暴一点，直接全部下载。
操作步骤
教程参考网上的教程，自己亲测升级成功了，链接贴最后，如果还是不会可以跳过去看视频教程（youtube）
重点：在实操前对整个镜像做个快照备份，以防搞炸！！！
本教程主要针对不想重刷 OpenWrt 升级 PassWall 组件，希望你的 OpenWrt 版本不是特别特别低，不然可能导致升级失败，若按照教程操作报错，建议自行排查。
1.下载最新 passwall 及组件包
前往 openwrt-passwall 最新发布页需要下载这些：
软件包 luci-app-passwall_4.xx-x_all.ipk
中文包 luci-i18n-passwall-zh-cn_git-2xxxx_all.ipk
对应CPU构架的组件包 passwall_packages_ipk_x86_64 注意自己操作系统构架，命令 cat /etc/os-release |grep ARCH 可查看
依赖包 luci-lua-runtime 如果安装报错则再下载这个包luci-lua-runtime_all_fake.zip
2.安装
手动将所有下载的包上传到 /tmp/upload，然后在命令终端执行下面的命令：
复制
# 进入安装包所在目录
cd /tmp/upload
# 查看目录下所有文件
ls
# 解压安装包 并上传下载的所有.ipk到同一个目录下
unzip luci-lua-runtime_all_fake.zip
unzip passwall_packages_ipk_x86_64.zip
# 查看目录下所有文件
ls
# 安装所有软件包
opkg install *.ipk --force-reinstall
此后还要手动升级就直接运行
opkg install *.ipk
如果只是提示提sing-box没有安装上，没有其他特别的报错日志，那么回到界面刷新应该就可以看到 PassWall 升级完成了。
OpenWrt 下 手动升级 PassWall
总结
本文通过手动下载 PassWall 相关组件包，通过命令的方式升级，实现无需重装 OpenWrt 升级插件版本，举一反三，如果要升级其他组件，只要知道相关依赖的组件包也同样可以使用手动下载安装上传达到升级的目的。
https://github.com/xiaorouji/openwrt-passwall
https://github.com/xiaorouji/openwrt-passwall/releases
https://www.51it.wang/ll/1997