刚装好 iStoreOS，发现应用商店里根本找不到 PassWall？这是正常的。iStoreOS 默认不带 PassWall，需要手动安装第三方离线包。本文覆盖三个阶段：找到安装入口、解决常见报错、完成基础配置。按顺序看，不会绕弯子。
你现在处于哪个阶段？
第一步：搞清楚安装逻辑
iStoreOS 是基于 OpenWrt 二次开发的固件。它自带一个应用商店（iStore），但 PassWall 不在官方源里。原因很简单：PassWall 是第三方插件，需要从 GitHub 下载 .run 格式的离线安装包，再通过 iStore 的手动安装功能装入系统。
下载地址是 GitHub 上的 Are-u-ok 项目（作者 AUK9527 或 bcseputetto 维护的 fork 版本）。下载时注意选择对应你 CPU 架构的版本——x86_64 机器选 x86，N1 盒子或 ARM 路由选 aarch64。架构选错，装进去也跑不起来。
安装步骤：全界面操作，不用敲命令
确认 CPU 架构
登录 iStoreOS 后台（默认地址 192.168.100.1）→ 点击「系统」→「软件包」→ 终端里输入以下命令查看架构：
下载对应架构的 .run 包
前往 GitHub Are-u-ok 项目的 Releases 页面，找到最新版本，下载对应架构的 .run 文件。文件名一般包含 passwall 和架构标识，比如 passwall_aarch64.run。
通过 iStore 手动安装
进入 iStoreOS 后台 → 「iStore 应用商店」→ 右上角点「手动安装」→ 选择刚才下载的 .run 文件 → 点击安装。等待进度条完成，不要关闭页面。
找到 PassWall 菜单
安装完成后，刷新页面。PassWall 会出现在顶部菜单「服务」→「PassWall」下。如果没出现，先清除浏览器缓存，再强制刷新（Ctrl+Shift+R）。
常见报错和解决方法
❌ 依赖缺失 / satisfy_dependencies
架构选错导致。重新下载对应架构版本，或手动安装缺失的 ipk 依赖包（libopenssl、kmod-tun 等）。
❌ 安装后菜单不出现
清除浏览器缓存后强制刷新。若仍没有，去「系统 → 软件包」过滤器搜索 passwall，确认是否安装成功。
❌ 缺少 TUN 模块
部分精简固件没有 kmod-tun。终端执行 opkg install kmod-tun，或下载带 TUN 支持的完整版固件重刷。
❌ 订阅无法更新
更新订阅需要先有可用节点或系统本身能访问外网。先手动添加一个节点测试连通性，再配置订阅链接。
❌ 节点连接失败 / 超时
先检查节点信息是否填写正确（端口、密码、协议）。再看日志（PassWall → 日志），根据报错内容排查。
❌ DNS 污染 / 国内网站变慢
在 PassWall DNS 设置里启用「防 DNS 污染」，上游 DNS 设置为 8.8.8.8 或 1.1.1.1，国内走 114.114.114.114。
基础配置：装好之后怎么用
🌐 全局模式
PassWall 主界面 → 「访问控制」→ 代理模式选「全局代理」。适合临时测试，日常使用建议改分流模式。
🔀 分流模式
代理模式选「GFWList」或「大陆白名单」。国内网站直连，被墙网站走代理，速度和体验的最佳平衡点。
🎮 游戏模式
在规则里将游戏服务器 IP 段设为直连，避免代理引入延迟。UDP 转发需确认节点支持 UDP，否则游戏延迟反而更高。
🐳 Docker 共存
PassWall 开启后，Docker 容器默认走透明代理。如果不想让容器走代理，在访问控制里把 Docker 网段（172.17.0.0/16）设为直连。
🌍 IPv6
PassWall 对 IPv6 支持有限。如需 IPv6，建议在「网络 → DHCPv6」里单独配置，PassWall 本身保持 IPv4 代理即可。
🔧 DNS 设置
推荐开启「远程 DNS」，防止 DNS 泄漏。国内域名解析走本地 DNS，国外域名通过节点远程解析，避免污染。
ip.sb 或 whoer.net，如果显示的是节点所在地 IP 而非本地 IP，说明代理已经生效。也可以在 PassWall 的「节点列表」里点「测速」，直接看延迟数值。iStoreOS 安装 PassWall 的核心只有一步：从 GitHub 下载对应架构的 .run 包，通过 iStore 手动安装。剩下的报错，90% 是架构选错或依赖版本不对，按本文的对应方法逐一排查即可。
配置上不要一开始就追求完美。先装好、先跑通一个节点、再根据实际使用需求调整分流和 DNS 设置——这个顺序会让整个过程顺畅很多。
更多软路由配置教程和网络工具评测，欢迎访问 Sorabin.com。
