## 前言
PassWall2 是 OpenWrt 上另一款热门的科学上网插件,相比 OpenClash 更加轻量,占用内存更少,非常适合低配软路由和 N1 盒子使用。本教程从安装到配置,每一步都有截图级详细说明,小白跟着做就能成功。
PassWall2 支持 VMess、VLESS、Trojan、Shadowsocks、Hysteria2 等主流协议,功能完全不输 OpenClash。
## 一、前期准备
### 硬件要求
| 项目 | 最低要求 | 推荐配置 |
|——|———|———|
| 设备 | N1 盒子 / x86 小主机 | x86 双网口软路由 |
| 内存 | 256MB | 512MB 以上 |
| OpenWrt 版本 | 21.02+ | 23.05+ |
| 存储空间 | 10MB 可用 | 30MB 以上 |
### 必备文件下载
| 文件 | 下载地址 | 说明 |
|——|———|——|
| PassWall2 插件包 | https://github.com/xiaorouji/openwrt-passwall2/releases | 下载对应架构的 ipk |
| sing-box 内核 | https://github.com/SagerNet/sing-box/releases | amd64 或 arm64 |
| Hysteria2 内核 | https://github.com/apernet/hysteria/releases | 可选,仅 Hysteria2 协议需要 |
| WinSCP | https://winscp.net/eng/download.php | 文件上传工具 |
| PuTTY | https://www.putty.org/ | SSH 连接工具 |
### 确认系统架构
“`bash
# SSH 连接软路由后执行
opkg print-architecture | awk ‘{print $2}’
# 输出 aarch64_cortex-a53 则是 N1 盒子
# 输出 x86_64 则是 x86 软路由
“`
## 二、旁路由基础配置
如果你的软路由还没配置旁路由模式,按以下步骤操作:
### 第1步:设置软路由 IP
1. 浏览器打开 `192.168.1.1`(OpenWrt 默认地址)
2. 进入 **网络 → 接口 → LAN → 修改**
3. 设置参数:
“`
IPv4 地址:192.168.31.2 # 改成你主路由网段的IP,不要和已有设备冲突
子网掩码:255.255.255.0
网关:192.168.31.1 # 你主路由的IP
DNS:223.5.5.5 # 阿里公共DNS
“`
4. 保存后,用新 IP 重新连接软路由
### 第2步:关闭 DHCP
“`
网络 → 接口 → LAN → DHCP 服务器
勾选”忽略此接口” → 保存
“`
### 第3步:修改主路由网关
登录你的主路由(小米/华为/TP-Link 等),找到 DHCP 设置:
“`
默认网关:192.168.31.2 # 软路由IP
DNS 服务器:192.168.31.2 # 软路由IP
“`
保存后重启主路由,所有设备重新连接 WiFi 即可。
## 三、安装 PassWall2
### 方法一:opkg 在线安装
“`bash
# 1. 更新软件源
opkg update
# 2. 安装依赖包
opkg install \
iptables \
iptables-mod-tproxy \
iptables-mod-extra \
iptables-mod-nat-extra \
kmod-ipt-nat \
kmod-ipt-tproxy \
kmod-tun \
ipset \
dnsmasq-full \
coreutils \
coreutils-base64 \
coreutils-nohup \
curl \
ca-certificates \
ca-bundle \
jsonfilter \
lua \
luci-lib-base
# 3. 下载 PassWall2(根据你的 OpenWrt 版本选择)
# 先确认版本
cat /etc/openwrt_release | grep ARCH
# 下载最新版 PassWall2
curl -L https://github.com/xiaorouji/openwrt-passwall2/releases/download/v1.28/luci-app-passwall2_1.28_all.ipk -o /tmp/passwall2.ipk
# 4. 安装
opkg install /tmp/passwall2.ipk –force-depends
# 5. 重启
reboot
“`
### 方法二:离线安装(下载慢的用这个)
1. 电脑打开 https://github.com/xiaorouji/openwrt-passwall2/releases
2. 下载 `luci-app-passwall2_x.xx_all.ipk`
3. WinSCP 上传到软路由 `/tmp/`
4. SSH 执行:
“`bash
opkg install /tmp/luci-app-passwall2_*.ipk –force-depends
reboot
“`
## 四、下载和安装内核
PassWall2 需要内核才能工作,默认不自带。
### 下载 sing-box 内核
“`bash
# 创建目录
mkdir -p /usr/share/passwall2/
# 下载 sing-box(x86_64 版本)
curl -L https://github.com/SagerNet/sing-box/releases/download/v1.11.0/sing-box-1.11.0-linux-amd64.tar.gz -o /tmp/sing-box.tar.gz
# 解压
cd /tmp && tar -xzf sing-box.tar.gz
# 移动到 PassWall2 内核目录
mv /tmp/sing-box-*/sing-box /usr/share/passwall2/sing-box
chmod +x /usr/share/passwall2/sing-box
“`
N1 盒子(arm64)请下载对应版本:
“`bash
curl -L https://github.com/SagerNet/sing-box/releases/download/v1.11.0/sing-box-1.11.0-linux-arm64.tar.gz -o /tmp/sing-box.tar.gz
“`
### 验证内核
“`bash
/usr/share/passwall2/sing-box version
“`
输出版本号即安装成功。
## 五、添加节点
### 方法一:订阅链接导入(最常用)
1. 进入 **服务 → PassWall2 → 节点订阅**
2. 点击 **添加**
3. 填写:
“`
备注:我的机场
订阅地址:https://你的订阅链接
自动更新:开启
更新时间:每天 06:00
通过代理更新:关闭
“`
4. 点击 **保存并应用**
5. 点击 **手动更新订阅**
6. 等待节点列表出现
### 方法二:手动添加节点
如果你有单独的节点信息,点击 **节点 → 添加**:
“`
类型:VMess / VLESS / Trojan / Shadowsocks
地址:your-server.com
端口:443
UUID:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
加密:auto
传输:ws
路径:/your-path
TLS:开启
“`
## 六、配置代理规则
### 基础设置
进入 **服务 → PassWall2 → 基本设置**:
“`
TCP 代理模式:绕过中国大陆(推荐)
UDP 代理模式:绕过中国大陆
本地 DNS:使用本机 DNS
远程 DNS:8.8.8.8
分流规则:使用默认规则集
“`
### 节点选择
1. 切换到 **节点** 标签
2. 勾选一个延迟低的节点
3. 点击 **应用**
### 测试连接
“`
点击”全部测试” → 查看各节点延迟
选择延迟最低的节点 → 保存应用
“`
## 七、启动 PassWall2
1. 在基本设置页面,点击 **主开关** 开启
2. 等待 5-10 秒
3. 查看日志:
“`bash
logread | grep passwall2 | tail -20
“`
看到 `watchdog started` 即启动成功。
## 八、验证代理
### 电脑端验证
“`bash
# Windows PowerShell
curl https://ipinfo.io/json
# Mac/Linux Terminal
curl https://ipinfo.io/json
“`
返回的 IP 应该是代理节点的 IP,不是你家的 IP。
### 在线测试
1. 访问 https://www.google.com — 能打开即成功
2. 访问 https://ip138.com — 查看 IP 归属地
3. 访问 https://www.youtube.com — 测试视频播放
### 手机验证
手机重新连接 WiFi,直接打开 Google 或 YouTube,无需安装任何 App。
## 九、进阶配置
### 1. 开启 Fake-IP 模式
“`
基本设置 → DNS 设置
模式:Fake-IP
Fake-IP 范围:198.18.0.1/16
“`
### 2. 配置分流规则
“`
基本设置 → 分流规则
代理规则集:添加以下规则
– GeoIP:CN → 直连
– GeoSite:CN → 直连
– 其他 → 代理
“`
### 3. 设置开机自启
“`
系统 → 启动项 → passwall2
点击”启用” → 确保开机自动运行
“`
## 十、常见报错解决
| 报错 | 原因 | 解决方案 |
|——|——|———|
| `sing-box not found` | 内核未安装 | 下载 sing-box 放到 /usr/share/passwall2/ |
| `permission denied` | 内核没有执行权限 | `chmod +x /usr/share/passwall2/sing-box` |
| `节点全部超时` | 订阅过期或网络不通 | 检查订阅链接,确认软路由能访问外网 |
| `DNS 解析失败` | DNS 设置错误 | 远程 DNS 设为 8.8.8.8,本地 DNS 设 223.5.5.5 |
| `国内网站打不开` | 分流规则有问题 | TCP 模式改为”绕过中国大陆” |
| `开启后完全无法上网` | iptables 规则残留 | 停止 PassWall2,执行 `iptables -F && iptables -t nat -F` |
| `YouTube 缓冲慢` | 节点速度不够 | 换一个速度更快的节点 |
| `N1 盒子内存不足` | 运行内存太小 | 减少并发连接数,或关闭日志 |
## 十一、避坑总结
1. 内核一定要手动下载,PassWall2 默认不带内核
2. 架构一定要选对:x86 下 amd64,N1 下 arm64
3. 旁路由模式比主路由模式更安全,不影响原有网络
4. 首次配置建议先用 Global 模式测试,确认能上网再切 Rule
5. Fake-IP 模式比 Real-IP 模式兼容性更好
6. 定期更新订阅,节点会失效
7. 如果不稳定,尝试切换 sing-box 和 Xray 内核
本文由技术保姆网 JSBMW.CN 原创,转载请注明出处。