ImmortalWrt 24.10 安装 UU 路由器插件 完整教程（官方适配版）

说明：本教程严格对齐网易UU官方教程思路，专门适配 ImmortalWrt 24.10（nftables / Firewall4）系统，解决官方教程在该系统下缺依赖、不兼容的问题，直接照做即可成功，无需额外修改。

一、适用环境

• 系统版本：ImmortalWrt 24.10（支持 x86_64 / ARM / RK3568 等主流架构）
• 防火墙：系统默认 nftables (Firewall4)（核心适配点）
• 用途：用于 PS5、Xbox、Switch、Steam Deck 等主机游戏加速
• 注意：官方教程仅适配 iptables 老固件，ImmortalWrt 24.10 必须补充兼容层，否则安装后无法正常使用。

二、准备工作

2.1 设备与系统要求

• 已刷入 ImmortalWrt 24.10 系统的路由器，确保路由器可正常访问互联网。
• 操作电脑与路由器处于同一局域网（便于SSH连接和网页后台操作）。

2.2 必备工具

• SSH工具：Putty、Termius、Xshell 任意一款（用于登录路由器命令行）。
• 手机App：安装「UU主机加速」（非电脑版UU加速器，用于绑定路由器和控制加速）。

三、详细安装步骤

步骤1：登录路由器SSH（基础操作）

1. 打开已安装的SSH工具（如Putty），输入路由器IP地址（默认通常为 192.168.1.1）。
2. 登录账号：root（默认用户名，无需修改）。
3. 登录密码：路由器Web管理后台的密码（自行设置，若未修改则为默认密码）。
4. 输入完成后，点击连接，成功登录后将显示命令行界面。

步骤2：安装必备依赖（24.10系统必做，解决兼容问题）

在SSH命令行中，依次执行以下两条命令（复制粘贴即可，避免手动输入出错）：

第一条命令：更新软件源

bash opkg update

第二条命令：安装兼容层及依赖包（核心适配nftables防火墙）

bash opkg install \ kmod-tun \ iptables-nft \ iptables-legacy \ ip6tables-nft \ ip6tables-legacy \ kmod-ipt-nat \ kmod-ipt-extra \ ca-bundle \ libustream-openssl

作用：让UU插件能在nftables防火墙下正常调用iptables规则，同时创建加速所需的tun网卡，避免出现“iptables找不到”“插件启动失败”等问题。

步骤3：执行官方安装脚本（与官方教程一致）

依赖安装完成后，继续在SSH命令行中，依次执行以下4条命令（严格按照顺序，复制粘贴即可）：

1. 进入临时目录（用于存放安装脚本）：
           cd /tmp
2. 下载官方最新安装脚本：wget -O install.sh “https://router.uu.163.com/api/script/install?type=openwrt”
3. 赋予脚本执行权限：
           chmod +x install.sh
4. 执行安装脚本（自动识别路由器架构，无需手动修改）：
           /bin/sh install.sh openwrt $(uname -m)

安装成功提示：当命令行中出现 UU plugin install success! 字样，说明插件安装成功。

步骤4：设置开机自启并启动UU服务

插件安装完成后，需手动设置开机自启（避免路由器重启后插件失效），继续在SSH命令行中执行以下3条命令：

1. 设置开机自启：
           /etc/init.d/uuplugin enable
2. 启动UU插件服务：
          /etc/init.d/uuplugin start
3. 查看插件运行状态（验证是否正常启动）：
           /etc/init.d/uuplugin status

正常状态：命令行输出中会显示 running 字样，说明插件已成功启动；若显示 stopped，则重新执行“启动服务”命令。

步骤5：网页后台防火墙设置（官方要求+24.10优化）

插件启动后，需配置防火墙规则（避免加速流量被拦截），操作如下：

1. 打开电脑浏览器，输入路由器IP地址（默认 192.168.1.1），登录Web管理后台（账号root，密码与SSH登录一致）。
2. 点击左侧导航栏：网络 → 防火墙。
3. 找到“区域”设置，将「lan」区域的「转发」选项改为 接受。
4. 找到“SYN-flood 防御”选项，取消勾选（避免干扰UU加速连接，导致加速不稳定）。
5. 点击页面底部的 保存并应用，等待设置生效（约1-2秒）。

步骤6：手机App绑定路由器（官方标准流程）

防火墙设置完成后，通过手机App绑定路由器，即可控制加速，操作如下：

1. 将手机连接到当前安装了UU插件的路由器WiFi（确保手机与路由器在同一局域网）。
2. 打开手机上的「UU主机加速」App（若未登录，先登录网易账号）。
3. 点击App右下角「我的」，找到「路由器插件」选项，点击进入。
4. App会自动扫描当前局域网内的路由器，找到对应路由器后，点击「绑定」。
5. 绑定成功后，返回App首页，添加需要加速的主机（PS5/Xbox/Switch等），选择对应游戏，点击「启动加速」即可。

四、旁路由/单臂路由额外设置（仅旁路由用户必做）

若你的ImmortalWrt路由器是作为旁路由使用（非主路由），需额外执行以下命令（否则加速后主机可能断网）：

bash ROUTER_IP=”192.168.X.X”  # 请将此处改为你的旁路由IP地址（如192.168.1.2） iptables -t nat -A POSTROUTING -d 127.0.0.0/8 -o br-lan -j ACCEPT iptables -t nat -A POSTROUTING -d 10.0.0.0/8 -o br-lan -j ACCEPT iptables -t nat -A POSTROUTING -d 172.16.0.0/12 -o br-lan -j ACCEPT iptables -t nat -A POSTROUTING -d 192.168.0.0/16 -o br-lan -j ACCEPT iptables -t nat -A POSTROUTING -o br-lan -j SNAT –to $ROUTER_IP

补充说明：旁路由用户还需确保：主路由关闭UPnP、IGMP Snooping功能；所有需要加速的主机，网关必须设置为旁路由的IP地址。

五、常用维护命令（备用，解决常见问题）

5.1 重启UU插件（加速异常时使用）

bash /etc/init.d/uuplugin restart

5.2 查看UU插件日志（排查启动/加速失败问题）

bash logread -e uuplugin

5.3 完全卸载UU插件（重装时使用）

bash /etc/init.d/uuplugin stop /etc/init.d/uuplugin disable opkg remove uuplugin rm -rf /usr/share/uuplugin /etc/uuplugin.conf

六、常见问题说明

• 问题1：安装时提示“iptables: not found”？ → 未执行步骤2安装依赖，重新执行步骤2的两条命令即可。
• 问题2：App搜不到路由器？ → 手机未连接路由器WiFi，或主机/手机网关未指向路由器IP，重启路由器和手机后重试。
• 问题3：插件启动成功，但加速失败？ → 防火墙设置未生效，重新执行步骤5；旁路由用户需确认已执行步骤4的额外命令。
• 问题4：路由器重启后，UU插件失效？ → 未设置开机自启，重新执行步骤4的“设置开机自启”命令。

七、补充说明

本教程在官方教程基础上，仅补充了ImmortalWrt 24.10系统所需的兼容层和必要设置，未修改官方安装流程，确保插件稳定性和兼容性。若执行过程中遇到其他问题，可查看步骤5.2的日志，根据日志提示排查问题。