PassWall2：OpenWrt 路由代理管理面板

项目简介

PassWall2 是运行在 OpenWrt 上的 LuCI Web 界面应用，使用 Lua 编写，为路由器提供代理服务、流量管理与访问控制能力。安装后可在 LuCI 的「服务 → PassWall2」中配置节点、DNS 与透明代理，让接入路由器的设备统一通过代理上网。

主要功能

多协议支持

• Xray：HTTP、Socks、Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard
• Sing-Box：HTTP、Socks、SSH、Shadowsocks、VMess、VLESS、Trojan、TUIC、Hysteria、Hysteria2、WireGuard、AnyTLS
• Shadowsocks-Rust，以及旧版 ShadowsocksR 支持
• HAProxy：高性能 TCP/HTTP 负载均衡

流量管理

• 负载均衡：在多个节点之间分摊流量
• 智能路由：基于域名与地理位置的规则分流
• DNS 控制：DNS 过滤与 DoH/DoT 支持
• 透明代理：对整个网络生效

节点管理

• 订阅导入：从订阅链接批量导入节点
• 内置延迟与连通性测试
• 故障转移：自动切换到备用节点
• 二维码生成与扫描，便于分享节点

访问控制

• 按设备设置代理规则
• 域名/IP 白名单与黑名单
• 基于时间的规则调度

安装与使用

环境要求：OpenWrt 21.02 或更高版本、LuCI 17.01 或更高版本，建议至少 256MB 内存，并为所选协议预留足够存储空间。先到 GitHub Releases 按照路由器架构与包管理器下载对应安装包。

OPKG 系统：

opkg update
opkg install luci-app-passwall2_*.ipk

APK 系统：

apk add --allow-untrusted luci-app-passwall2_*.apk

也可以先添加 PassWall2 的 apk 软件源与签名密钥，之后直接执行 apk add luci-app-passwall2 安装并从软件源更新。安装完成后重启 rpcd：

/etc/init.d/rpcd restart

基本配置流程：进入 LuCI → 服务 → PassWall2，在「节点列表」中添加节点并选择协议、填写服务器信息；设置默认节点与 DNS，启用透明代理，最后点击「保存并应用」。

界面支持简体/繁体中文与波斯语，语言包在 Releases 中单独提供（如 luci-i18n-passwall2-zh-cn）。

注意事项

• 若因缺少依赖（如 xray-core）安装失败，需要先在 /etc/opkg/customfeeds.conf 中添加 PassWall 软件源。
• --allow-untrusted 会跳过安装包签名校验，请确认来源可信。
• 服务无法启动时可用 logread | grep passwall2 查看系统日志；在「其他设置」中开启调试日志后，可查看 /tmp/log/passwall2.log 与 /tmp/log/passwall2_server.log。
• 遇到 DNS 问题时，可关闭浏览器自带的安全 DNS 并清理 DNS 缓存后重试。
• 本项目仅供合法用途，使用者需自行遵守所在地区的法律法规。

本作品整理自 GitHub 开源项目 Openwrt-Passwall/openwrt-passwall2，原作者 @Openwrt-Passwall，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。