配置起点:PassWall 在 OpenWRT 中提供代理管理入口。安装界面并不等于核心已经运行,理解两者的分工有助于安排后续操作。
转发由防火墙规则与代理核心配合完成,涉及 iptables、nftables 和 TProxy 等组件。硬件能力与网络条件不同,不能据此承诺带宽或延迟;应先检查本机环境能否满足安装要求。
先理解界面、核心与转发规则的分工
提示 准备提醒:配置前先确认已有服务是否提供适用的订阅格式;相关服务说明可在 服务页面 查看。
开始安装之前,可以从转发、协议、出口选择和域名解析几个方面理解插件的配置项。
- 转发路径:透明代理依靠系统网络组件接管数据,不需要为每台终端分别设置客户端;是否适合当前设备,应结合固件和资源占用判断。
- 核心选择:协议由底层程序处理。Xray 与 sing-box 等核心的适用范围应结合所装软件核对,界面能够添加的配置也需与核心能力相符。
- 出口安排:TCP 与 UDP 可以分别指定去向,分流规则也能按域名或地址划分。配置主备出口时,先确认所引用的出口名称存在。
- 解析安排:DNS 设置决定域名查询交给哪类服务器处理。分流器与解析缓存需要相互配合,不能用单个选项保证所有域名都得到正确结果。
安装包选择从设备架构开始
软件包必须适配处理器与固件环境。先在终端读取架构,再核对文件名,避免把界面安装成功误当作整个代理服务可用。
通过终端连接路由管理系统
- Windows 端:可使用系统命令行或 SSH 工具发起连接。
- 桌面终端:在 Mac 上可从终端应用进入命令行。
SSH 连接应填写实际的 路由器管理地址;不能直接照搬下方示例中的地址。
ssh t.me/jichangyyds
按提示输入管理员口令后提交;密码输入过程可能不会在屏幕上显示字符。
读取架构信息再选择软件包
下面的命令用于查看处理器架构标识。
uname -m
表格展示架构标识与包名的对应形式;实际安装前仍需核对固件适配情况。
| 设备报告的标识 | 设备类型说明 | 包文件标识示例 |
|---|---|---|
| x86_64 | 个人电脑、工控设备或虚拟机,按实际架构判断 | x86_64.ipk |
| aarch64 | ARM 设备应以系统报告的信息选择文件 | aarch64_cortex-a53.ipk |
| arm_cortex-a7_neon-vfpv4 | 部分路由硬件,仍需检查处理器指令集 | arm_cortex-a7.ipk |
先解决软件源与依赖问题
依赖缺失会妨碍安装,但不能凭报错推断它占所有失败原因的比例。先核对软件源能否访问,再依据提示补齐所缺组件。
刷新可安装软件的索引
可通过下面的命令请求更新软件包目录。
opkg update
若遇到签名校验失败或请求超时,先查看 WAN 连接和软件源返回的错误,再决定后续处理。
根据系统环境补充所需模块
下方命令列出原页涉及的下载、解压、证书及网络转发组件;安装前应检查所用固件是否提供对应包。
opkg install curl wget unzip ca-certificates iptables-mod-tproxy iptables-mod-extra ipset kmod-ipt-nat
系统使用 nftables 时,应核对相应模块,而不是直接套用另一套防火墙依赖。
opkg install kmod-nft-tproxy kmod-nft-nat nftables
把管理界面与运行核心分别装好
依赖就绪之后,再准备插件界面、语言文件和适配处理器的代理核心。
辨认下载文件的用途
项目发布区列出的 Openwrt-Passwall/openwrt-passwall 包文件,应按界面、语言和核心用途区分,安装包格式为 .ipk。
luci-app-passwall_xxx_all.ipk:提供浏览器中的管理界面。luci-i18n-passwall-zh-cn_xxx_all.ipk:提供界面的中文显示内容。xray-core_xxx_架构.ipk与sing-box_xxx_架构.ipk:选择适配机器的运行核心。
传入文件并检查安装结果
利用文件传输工具把包放到路由器的 /tmp 目录,再从 SSH 会话检查安装过程的输出。
cd /tmp
opkg install *.ipk
完成后刷新管理页面,查看 “服务” 分类中是否出现 “PassWall”,并继续确认运行核心状态。
让配置源进入插件的管理列表
订阅负责提供出口配置。添加之前,先确认复制的是服务后台给出的适用格式。
从账户页面复制配置源
- 进入所用服务的账户控制台。
- 在订阅或导出区域,按客户端支持情况选择 通用格式 或 相应核心格式,再复制地址。
填写来源并发起一次更新
- 在管理界面依次找到 “服务” 下的 “PassWall” 入口。
- 打开用于管理 订阅来源 的页面。
- 使用 新增入口 后填写以下信息:
- 名称:取一个能区分来源的备注即可。
- 地址:把控制台复制的内容 贴入 相应输入栏。
- 更新安排:按需要启用定时拉取,
执行时间由使用者自行安排。
- 填写结束后提交 保存与应用 操作。
- 随后执行一次 手动拉取,检查是否出现解析或连接错误。
- 确认列表有可识别的出口配置,再继续设置流量去向;不要预设导入后的条目数量。
将出口策略与域名解析一起检查
分流是否符合预期,取决于流量规则和 DNS 的组合。修改后需分别检查直连目标与代理目标。
确定常用连接的处理方式
从 PassWall 的 基础配置入口 开始核对:
- TCP 出口:在已有列表中指定要使用的连接,避免选中已失效或未成功导入的条目。
- UDP 出口:可以沿用 TCP 选择,也可按协议支持情况另行指定。
- 规则模式:按目标选择 直连或代理分流,并检查命中规则;不能只凭规则名称判断所有应用的流量去向。
分清本地查询与远程查询
接着进入 DNS 配置页,检查以下项目:
- 解析分流:使用 ChinaDNS-NG 时,仍需确认各类查询的上游设置正确。
- 直连上游:应填写
解析服务器地址,确认适合当前网络环境并且可以访问。 - 远程上游:核对
解析地址与查询路径,需要时再检查 TCP 查询选项。 - 查询缓存:按需开启,减少重复域名查询;变更后注意观察解析结果。
- 核对后执行 保存与应用,使修改生效。
为电视与游戏设备补充流量规则
共享路由代理时,不同终端可能需要不同的域名规则与 UDP 设置,应分别检查设备使用的连接方式。
检查电视应用的域名去向
- 在 进阶设置 内检查 DNS 查询相关选项,确认它们与当前出口方案一致。
- 按应用涉及的域名安排规则,并确认所指向的出口可用;服务可用范围以商家页面为准。
查看联机所需的防火墙与 UDP 配置
- NAT 项目:在路由器防火墙配置中检查 FullCone NAT 是否适用于当前环境。
- 核对 UDP 转发设置 中的 TProxy 与系统模块是否配套。
- 联机异常还应结合出口与防火墙检查,不能把开启某个选项当作解决所有断线问题的保证。
遇到报错时的三个检查入口
依赖包找不到时,先看哪里?
- 定位方向:先查看软件源是否包含报错提到的组件,再检查固件适配情况。
- 处理顺序:确认路由联网后运行
opkg update;如需离线安装,所选iptables-mod-tproxy等包也应适配当前固件。
导入后始终超时,应核对什么?
- 校准时间:检查系统时钟与 NTP 设置,排除时间偏差对加密连接的影响,不套用未经核对的误差阈值。
- 查看核心:从状态页确认代理进程是否启动,启动失败时阅读日志并核对处理器架构。
本地应用打开异常,如何检查解析?
- 查询路径:查看直连域名是否被交给不合适的远程上游,导致返回的地址与使用环境不符。
- 调整方式:重新检查
DNS 分流器与本地上游,应用后再核对解析结果。
旁路由转发的补充说明
- 防火墙因素:旁路由无法转发时,应查看数据包是否被规则拦截或缺少所需转发配置。
- 示例说明:下方展示 NAT 规则的一种写法;使用前应理解影响。
其中网卡名应按本机实际情况填写。iptables -t nat -I POSTROUTING -o eth0 -j MASQUERADE
把安装检查与连接检查连起来
可按“架构是否匹配、依赖是否齐备、核心是否启动、订阅是否解析、DNS 是否走对路径”逐项定位。每完成一项再继续下一项,便于区分安装失败与连接失败。
使用提醒:路由配置与服务出口共同影响连接。涉及套餐或服务承诺时,应查看 服务说明入口,不能用硬件参数推断晚间表现或应用可用范围。
后续排查:连接仍未恢复时,可继续阅读 超时与网络故障处理说明。
路由器配置涉及全屋设备,修改后应分别确认各终端仍能访问所需网络。
项目文档与引用入口

配图可帮助辨认页面入口;实际界面请结合已安装的软件查看,遇到差异时再对照项目文档。
链接说明:服务条款和支付条件以商家页面为准。