从LuCI进入安装流程
LuCI是OpenWrt的Web管理界面。软件包管理的位置会随固件变化，安装前先核对 luci-app-passwall 与实际系统；语言包改善界面翻译，不能替代运行组件。
连接，从理解你的路由器开始
PassWall插件下载、OpenWrt安装与路由器基础配置指南
从设备准备，到第一次连接。
循序了解OpenWrt版本识别、软件包选择、
LuCI插件安装、节点添加与日常使用。
OPENWRT · PassWall准备 / 安装 / 配置 / 验证
STONE & CONNECTION — 山野中的通道
01 / ROUTER FIELDBOOK
先了解设备，再开始安装。
固件、架构与可写空间，决定了正确的安装起点。
OPENWRT 环境准备
让每一项准备，
都有清楚的依据。
OpenWrt PassWall安装前，先从系统状态页记录固件版本、路由器型号和目标平台。CPU类别不等于完整的软件包架构，RAM余量也不等于可写存储足够。
打开安装前检查清单 →OpenWrt 24.10 及更早opkg / .ipk
通常使用opkg，核对当前固件与软件源。
OpenWrt 25.12 及更新apk / .apk
默认采用apk；这里的APK与Android应用无关。
派生固件与自定义构建可能不同，请以实际设备为准。
03 / ROUTER FIELDBOOK
资源来源，要比下载更早确认。
从PassWall GitHub项目标识到软件包来源，分清源码、构建与适配条件。
找到资源，
也找到它的依据。
查找PassWall官网相关资料时，应核对项目标识 Openwrt-Passwall/openwrt-passwall。仓库中的LuCI插件源码、Release构建和第三方软件源各有用途，下载前确认固件系列、包架构及维护来源。
本站整理PassWall使用指南，不代表该项目的真实维护团队或授权发布渠道；不提供未经确认的版本号及兼容清单。
04 / ROUTER FIELDBOOK
界面与核心，各司其职。
核对需要的运行依赖
菜单出现不等于服务可用。Xray-core、sing-box等组件是否需要安装，取决于实际版本和选用功能。检查包来源、依赖关系与核心兼容，再确认安装结果。
理解LuCI与运行核心 →05 / ROUTER CARE
配置有记录，
维护有余量。
PassWall路由器的日常使用，从两件容易忽略的小事开始。
06 / 第一次连接
从一个节点开始，
完成一次真实验证。
PassWall配置教程从可信资料开始：核对协议、地址、端口与认证参数，保存并应用后，依次观察当前选择、服务状态和实际网络请求。
- 核对资料
- 保存应用
- 检查连接
07 / ROUTER FIELDBOOK
六篇手记，把关键步骤说清楚。
围绕设备、安装与基础配置逐步展开。按问题阅读，也可以从第一篇开始。
先确认版本，再选择包管理器
理清 24.10 与 25.12 的变化，避免把旧版安装命令直接用在新系统。
阅读全文
架构相同，为什么仍不兼容
CPU只是起点。目标平台、ABI、固件系列与依赖需要一起核对。
阅读全文
能打开界面，不等于核心已运行
分清管理界面与实际处理连接的程序，逐层确认依赖是否齐备。
阅读全文
从页面填写到运行生效
理解表单、持久化配置与运行状态之间的关系，让每次修改可追溯。
阅读全文
内存有余量，安装为何仍失败
分开观察临时内存与持久存储，为核心和依赖预留真实可用空间。
阅读全文让第一个节点完成连接闭环
从合法获得的节点资料开始，分别确认保存、启动与实际请求结果。
阅读全文08 / 常见问题
动手之前，
再确认一下。
把常见疑问变成清楚的下一步。
01OpenWrt 25.12安装PassWall时，为什么不能直接照搬旧版opkg命令？
25.12起默认采用apk，旧版opkg命令与IPK包不能直接混用。先查询实际固件与命令是否存在。阅读包管理器指南 →
02PassWall软件包下载完成后，为什么还要核对CPU架构和固件版本？
下载完成只说明文件已保存；目标平台、ABI和依赖仍会影响兼容性。核对软件包匹配条件 →
03LuCI插件页面能够打开，是否意味着相关代理核心已经正确安装？
不能。管理应用、语言包和运行核心各有职责，应按实际版本核对已安装组件。了解运行依赖 →
04路由器保存了节点配置，为什么仍需要检查实际服务状态和联网情况？
保存、服务启动与实际访问分别验证不同环节，节点存在不等于请求已经成功。查看首次连接检查 →