高墙之外❤️

PassWall和PassWall2的区别：按核心、DNS与迁移成本选择

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

简答：已有 PassWall 且运行稳定，不必为了“升级”迁移；新装机则先核对核心、DNS、固件和依赖。两者是独立插件，配置不能默认直接互通，按检查结果选择后再安装。

定义：PassWall与PassWall2都是运行在OpenWrt上的LuCI网络管理插件，但使用独立代码仓库、软件包名称和UCI配置入口。

先看结论：不要把 PassWall2 当成必然升级版

本文是第三方使用指南，不代表相关项目官方。先给直接结论：如果你已经在使用 PassWall，并且节点、DNS和局域网分流都稳定，通常没有必要仅因为名称中的“2”就迁移；如果你正在新装系统，应先按需要的代理核心、DNS复杂度、固件版本和可用存储核对两个项目的当前依赖。

判断条件优先核对 PassWall优先核对 PassWall2
已有稳定配置继续使用，减少迁移成本只有在有明确功能需求时再评估
核心选择当前构建文件提供多项可选核心和辅助组件当前构建文件提供 Xray、SingBox 或 All 三种基础核心选项
透明代理按系统选择 iptables 或 nftables 相关依赖同样需要按 firewall4 或旧防火墙后端核对依赖
DNS与规则当前构建依赖中包含 chinadns-ng、dns2socks、dnsmasq-full 等组件当前构建依赖中包含 chinadns-ng、dnsmasq-full 和地理数据组件
配置迁移原地升级更容易保留原有设置，但仍需备份应按节点、DNS、分流和访问控制逐项重建

这张表只反映截至 2026-10-26 对两个项目代码仓库和构建文件的核对结果，不等同于性能排名，也不代表某个协议在所有架构和版本上都一定可用。PassWall的构建文件可见多个可选组件；PassWall2则在构建文件中单独定义基础核心选择。可分别查看PassWall代码仓库、PassWall2代码仓库和两者的PassWall构建文件、PassWall2构建文件。

两者到底有什么不同？先看项目和核心边界

从仓库结构看，luci-app-passwall与luci-app-passwall2是两个独立的软件包，分别位于同一GitHub组织下的不同仓库。PassWall2不是把原有软件包名称简单改写，也不能默认读取PassWall的全部配置。

从截至 2026-10-26 可见的构建定义看，PassWall提供了较多独立的可选组件，例如SingBox、Xray、Hysteria、NaiveProxy、Shadowsocks Rust、V2ray插件、SmartDNS和地理数据等。这里的“可选组件较多”只表示构建开关和依赖范围更宽，不代表每台路由器都能安装，也不代表运行性能更高。

PassWall2的构建文件把基础核心设置为三选一：Xray、SingBox或All，同时提供透明代理方式和部分辅助组件的选择。这个结构更适合先确定核心再安装依赖的用户，但是否更省空间、是否更适合你的设备，仍要看架构、固件软件源和实际安装计划。

选择节点协议时，不要只看插件名称。一个节点能否使用，至少要同时满足三个条件：插件界面能生成对应配置；路由器安装了需要的核心和依赖；当前核心版本支持该协议及其传输方式。仓库中的构建定义只能证明依赖或构建选项存在，不能替代具体节点配置的兼容性测试。

按五个问题做选择：核心、DNS、存储、固件和迁移

  1. 你是否已经有稳定的 PassWall 配置？

    如果答案是“是”，先保留现有插件，记录当前节点、DNS监听端口号、分流规则和访问控制。没有明确需求时，迁移本身可能增加排查工作量。

  2. 你需要哪个代理核心？

    如果必须使用某个特定核心或辅助组件，先打开对应仓库的构建文件核对依赖，不要根据旧教程中的宣传表格决定。PassWall2当前构建定义提供 Xray、SingBox 和 All 三种基础核心选项。

  3. 你的DNS和分流是否复杂？

    如果只是单节点、简单的局域网代理，重点是核心能否启动、DNS是否能解析和规则是否生效。如果要区分国内外域名、不同设备或不同出口，应先画出DNS监听、dnsmasq转发和透明代理的关系，再决定是否迁移。

  4. 存储空间是否足够？

    不要用插件名称推断占用大小。核心、地理数据、透明代理依赖和语言包都可能影响实际安装计划。先查看软件包管理器将安装哪些依赖，并保留系统恢复空间。

  5. 固件使用什么包管理器？

    OpenWrt官方文档说明，OpenWrt 24.10及更早版本通常使用 opkg，OpenWrt 25.12及更新版本使用 apk。但不能仅凭“某个命令存在”判断系统版本，因为设备可能残留兼容工具。应同时查看固件信息、软件源配置和实际软件包数据库。

可以先执行以下只读检查，再决定安装方式：

  • cat /etc/openwrt_release：查看发行版版本、目标平台和架构信息。
  • ubus call system board：查看设备型号和架构概况。
  • command -v opkg; command -v apk：仅查看命令是否存在，不把结果单独当作最终判断。
  • grep -R "^src" /etc/opkg /etc/apk 2>/dev/null：在对应目录存在时检查软件源配置。

OpenWrt的软件包管理入口位于LuCI的“系统 → 软件”，官方文档也说明了更新列表、搜索软件包和安装 luci-app-* 软件包的路径。相关差异可参考OpenWrt官方软件包管理文档和OpenWrt官方APK包管理文档。

从 PassWall 切换到 PassWall2：先备份，再逐项验证

两个插件使用不同的配置入口。当前构建文件显示，PassWall2包含 /etc/config/passwall2 和 /etc/config/passwall2_server 等配置文件；PassWall使用的是另一套配置文件。因此，不能把“安装新插件”理解为自动导入旧插件设置。

  1. 在旧插件中记录节点的服务器地址、端口号、协议、认证信息、传输方式、TLS参数和SNI。不要把密码、密钥、订阅地址或Cookie发布到截图和日志中。
  2. 记录DNS监听端口号、分流模式、绕过列表、访问控制设备和自定义规则。
  3. 通过LuCI的“系统 → 备份/升级”创建配置备份，并确认能够进入路由器管理页面。
  4. 停用旧插件的透明代理、DNS接管和相关服务，再安装或启用新插件；不要让两个插件同时修改同一套流量入口。
  5. 在新插件中只添加一个已知配置，先测试路由器本机，再测试一台局域网设备。
  6. 确认核心运行、DNS解析、分流规则和局域网访问均正常后，再逐步恢复其他节点和规则。

“能否同时安装”与“能否同时接管流量”不是同一个问题。即使软件包层面没有立即报错，两个插件也可能使用不同的服务、DNS监听或防火墙规则。本文不把这种情况直接判定为必然冲突；更稳妥的自查方法是只启用一个插件，查看服务状态、监听端口和防火墙规则，再决定是否保留另一个软件包。

OpenWrt 22.03及以后版本默认使用基于nftables的firewall4。排查透明代理时，可先执行 fw4 print 查看由fw4生成的规则；官方文档也提醒，手工nftables规则可能与fw4生成的规则冲突。相关说明见OpenWrt nftables说明和OpenWrt Netfilter规则排查文档。

如果启用后无法连接，先在插件页面查看运行日志；SSH中可执行 logread | grep -Ei 'passwall|passwall2|dnsmasq|fw4'。PassWall2仓库README列出的调试日志包括 /tmp/log/passwall2.log 和 /tmp/log/passwall2_server.log，PassWall则应以设备实际生成的日志文件为准。

最后的选择建议：按场景而不是按“新旧”决定

使用场景建议核对重点
已有 PassWall，当前运行稳定先继续使用没有明确迁移理由时，避免重建DNS和分流配置
新装OpenWrt，没有历史配置两个项目都先核对核心、架构、软件源、存储和透明代理依赖
必须使用特定核心或辅助组件选择构建文件中明确提供对应选项的一方不要把构建选项当成所有节点都兼容
使用OpenWrt 22.03及以后版本优先核对nftables与firewall4适配不要直接照搬旧iptables教程
需要大量旧规则和节点优先保留原插件迁移前逐项记录并分阶段验证

一句话判断：已有 PassWall 且稳定运行，就不要为了“升级”强行切换；新装机则根据核心、DNS、固件和依赖逐项核对。PassWall2并非在所有设备、协议和配置场景下都天然更好，PassWall也不代表一定更适合复杂需求。

最后核对：2026-10-26。仓库构建文件、Release资产、依赖名称和OpenWrt包管理方式可能继续变化，安装前应重新查看项目仓库与当前固件文档。

如果你需要跨境办公场景下的线路、延迟、丢包和系统连接问题诊断，可在完成本地插件核对后，查看边界云加速官网的相关服务说明。本文站点与相关插件项目没有官方归属关系。

相关排查入口

如果你已经完成选型，下一步应进入单一问题排查，而不是同时修改多个插件：

常见问题

PassWall2是不是PassWall的升级版？

不能简单这样理解。两者位于同一GitHub组织下的不同仓库，软件包名称和配置入口不同。PassWall2不是自动覆盖升级，旧插件的节点、DNS和规则不能默认直接继承。

PassWall和PassWall2应该怎么选？

已有PassWall且运行稳定，优先保留原插件；新装机则先按核心、DNS、固件、架构和依赖核对。不要仅凭“2”判断功能或性能更好。

PassWall和PassWall2可以同时安装吗？

是否能共存取决于当前软件包和依赖，本文不作兼容承诺。更重要的是不要让两个插件同时接管同一套DNS、透明代理和防火墙流量；排查时建议只启用一个。

PassWall2当前可以选择哪些基础核心？

截至2026-10-26，PassWall2构建文件中列出Xray、SingBox和All三种基础核心选项。实际安装结果还取决于设备架构、软件源和当前Release资产。

从PassWall切换到PassWall2后，节点能直接使用吗？

不要默认可以直接使用。两个插件的UCI配置入口不同，建议先备份并记录节点、DNS和分流设置，再在新插件中添加一个节点测试，确认正常后再恢复其他规则。

OpenWrt应该安装IPK还是APK？

OpenWrt官方文档显示，24.10及更早版本通常使用opkg，25.12及更新版本使用apk。还应结合<code>/etc/openwrt_release</code>、软件源和实际包管理数据库判断，不能只看教程中的文件后缀。

透明代理启用后无法连接，先检查什么？

先确认只启用了一个插件，再查看插件运行日志、DNS监听端口和防火墙后端。OpenWrt 22.03及以后默认使用firewall4，可执行<code>fw4 print</code>查看生成的规则，并用<code>logread</code>筛选相关服务日志。

相关阅读

参考资料

  1. PassWall代码仓库
  2. PassWall2代码仓库
  3. PassWall构建文件与依赖定义
  4. OpenWrt官方软件包管理文档（openwrt.org）
  5. OpenWrt官方APK包管理文档（openwrt.org）
  6. OpenWrt官方nftables说明（openwrt.org）
  7. OpenWrt官方Netfilter规则排查文档（openwrt.org）