OpenWrt 24.10 安装 Passwall 科学上网插件 (2026)

PassWall 是一款运行在 OpenWrt 上的常用科学上网代理插件之一。最近 PassWall 的官方GitHub更新了最新的安装方式，可以通过添加软件源通过命令方式在线安装。

但对于初次安装且暂时没有科学上网环境的 OpenWrt 固件，通过命令安装可能会缺少依赖文件或无法通过在线更新的方式获取到内核应用。

如果你使用了iStoreOS固件,可以通过 iStore .run 安装passwall、OpenClash 插件更加方便快捷。本次我们仍然通过手动安装的方式进行安装PassWall。

安装 PassWall

PassWall 官方 GitHub 地址

插件名称	最新版本号	最新更新日期	下载地址
PassWall			GitHub 仓库

查看 OpenWrt CPU 架构

在 TTYD终端 或通过 Finalshell 登录 OpenWrt，输入以下命令查看 CPU 架构。

cat /etc/os-release |grep ARCH

需要下载的文件：

• 23.05-24.10_luci-app-passwall_x.x.x_all.ipk：软件包
• 23.05-24.10_luci-i18n-passwall-zh-cn_x.x.x_all.ipk：中文语言包
• passwall_packages_ipk_xxx.zip：依赖文件，根据自己CPU架构选择。

安装 PassWall 依赖文件

将我们下载的 passwall_packages_ipk_xxx.zip 依赖文件解压后得到.ipk的软件包，通过「系统」 - 「软件包」 - 「上传软件包」安装。依次全部安装，不要漏安装依赖文件。

安装 dnsmasq-full

OpenWrt 自带的基础版 DNS 服务是 dnsmasq，PassWall 必须依赖 dnsmasq-full 才能运行， dnsmasq-full 是它的增强版（支持更高级的加密、过滤等功能）。

1、更新列表

我们先更新软件源列表，避免卸载dnsmasq后导致短暂的断网或 DNS 解析失败。

2、卸载 dnsmasq

在「系统」 - 「软件包」 - 「过滤器」搜索 dnsmasq ，点击「已安装」标签页找到 dnsmasq 移除。

3、安装 dnsmasq-full

在「过滤器」搜索 dnsmasq-full ，点击「可用」标签页找到 dnsmasq-full 点击 安装。

安装过程中如果出现以下提示忽略即可：
Collected errors:* resolve_conffiles: Existing conffile /etc/config/dhcp is different from the conffile in the new package. The new conffile will be placed at /etc/config/dhcp-opkg.
这个错误提示其实是一个温和的提醒，而不是安装失败。它的意思是：现有配置文件 /etc/config/dhcp 与新软件包中的配置文件不同。新的配置文件将被放置在 /etc/config/dhcp-opkg。

nftables 透明代理需要基础依赖 kmod-nft-socket、kmod-nft-tproxy，同样的方法，安装 kmod-nft-socket、kmod-nft-tproxy。

安装 PassWall 插件

最后我们先安装 23.05-24.10_luci-app-passwall_x.x.x_all.ipk 软件包、在安装23.05-24.10_luci-i18n-passwall-zh-cn_x.x.x_all.ipk 中文语言包。

安装完成后，在「服务」 菜单下找到 「PassWall」。

我们通过依次安装依赖，手动安装 Passwall 可以在没有科学上网环境的前提下完整的安装Passwall。通过 Passwall 配置好科学上网环境后，再更新各种组件。或者按照openwrt-passwall-build仓库的说明添加 opkg 密钥以及 opkg 仓库，在线更新Passwall。

Passwall.run 文件安装请参考：iStoreOS 通过 iStore .run 安装passwall、OpenClash 插件。

Passwall 使用方法请参考：OpenWrt 科学上网插件 PassWall 快速入门使用教程。