OpenWrt 安装与首次设置：装插件之前要做好的几件事

OpenWrt 是一套开源的路由器 Linux 系统。装上它，路由器就能像电脑一样安装软件，科学上网插件、广告过滤、组网工具都靠这一点。装系统本身不难，难在前面的选择：用哪个版本的固件、设备走哪条安装路线、装好后先改哪些设置。这几步顺了，后面装插件基本不会卡住。

分清官方版和衍生版

同样叫“OpenWrt”，实际能下载到的固件有好几类：

个人编译版要多留个心：固件里装了什么，你无从核对。来源不明的固件，建议不刷进做主路由的设备。iStoreOS 上怎么选科学上网插件，另见 iStoreOS 科学上网。

确认设备能装

品牌路由器：到 OpenWrt 项目的硬件支持表（Table of Hardware）里查型号，注意硬件版本号，同一型号的 v1 和 v2 可能是完全不同的芯片。OpenWrt 官方的说法是：任何设备至少 16MB 闪存、64MB 内存，内存建议 128MB 以上；想多装几个软件包，至少 16MB 闪存加 128MB 内存；新买设备避开只有 16MB 闪存的，建议 32MB 以上。这些只够跑基本功能和少量软件包；要跑代理插件，闪存和内存都要大得多。

x86 小主机：大多数 64 位电脑都能装。要留意网卡芯片，Intel 和常见 Realtek 网卡一般有驱动，冷门芯片可能要另装驱动包。

虚拟机：PVE、ESXi、Hyper-V、VirtualBox 都能跑 OpenWrt，适合一台主机同时跑几个系统。

ARM 板子与电视盒子：R2S、R4S 这类板子在官方和衍生版里都有固件；N1 一类盒子需要先降级、开启线刷或 U 盘启动，步骤因设备而异。硬件怎么挑见软路由选购。

走三条安装路线之一

路线一：给路由器刷机

1. 在 OpenWrt 的固件选择器（Firmware Selector）里输入型号，找到对应固件。
2. 认清两种文件：factory 用于从原厂系统第一次刷入，sysupgrade 用于已经是 OpenWrt 时升级。第一次装选 factory。
3. 在原厂后台的固件升级页面上传 factory 文件。部分型号原厂不允许刷第三方固件，要走 TFTP、串口或 U-Boot 恢复模式，按该型号的 Wiki 页操作。
4. 刷机期间不要断电、不要拔网线。
5. 刷好后，电脑用网线接路由器 LAN 口，网卡设为自动获取地址，浏览器打开 192.168.1.1。

路线二：写进 x86 小主机

1. 在 x86/64 目标下下载 combined 镜像。文件名带 efi 的对应 UEFI 启动，不带的对应传统 BIOS 启动。

2. 在 ext4 和 squashfs 之间选一个：squashfs 能恢复出厂，ext4 扩容更方便。

3. 把镜像写进小主机的硬盘。常见做法是用 U 盘启动一个 Linux 临时系统，再执行：

   gunzip openwrt-*-x86-64-generic-ext4-combined-efi.img.gz
   dd if=openwrt-*-x86-64-generic-ext4-combined-efi.img of=/dev/sdX bs=4M status=progress
   sync

   解压时可能提示 trailing garbage ignored，这是镜像末尾的填充数据，不影响使用。/dev/sdX 要换成小主机硬盘的实际名称，写错盘会清空那块盘的数据。在 Windows 上，也可以用 balenaEtcher、Rufus 这类写盘工具，把镜像写到硬盘或 U 盘上。

4. 进 BIOS 把启动项设为这块硬盘。

5. 多网口机器上，系统识别到的第一个网口（eth0）默认是 LAN，第二个（eth1）是 WAN，其余网口默认不配置。eth0 不一定是机身上标在最前面的那个口，不确定时逐个插网线，看哪个口能打开 192.168.1.1。

6. 扩容根分区。combined 镜像的根分区默认只有一百来 MB，装几个插件就满。ext4 镜像可按 OpenWrt Wiki 里 x86 扩容根分区的步骤，先用 parted 扩大分区，再用 losetup 和 resize2fs 扩大文件系统，把剩余空间并进来。

路线三：装进虚拟机

1. 解压得到 .img 文件。

2. PVE 上建一台不挂系统盘的虚拟机，把镜像导入为磁盘：

   qm importdisk 100 openwrt.img local-lvm

   100 换成你的虚拟机编号，导入后在硬件页把这块盘挂上，并设为第一启动项。

3. 其他平台先转换格式：

   qemu-img convert -f raw -O vmdk openwrt.img openwrt.vmdk
   qemu-img convert -f raw -O vhdx openwrt.img openwrt.vhdx

   前者给 ESXi，后者给 Hyper-V。Hyper-V 第二代虚拟机只走 UEFI 启动，要用带 efi 的镜像转换，并关掉安全启动，否则引导不起来。

4. 网卡至少给一块，桥接到接局域网的物理网口。要它做主路由，还得把接光猫的网口也交给它，可以用网卡直通，也可以单独建一个网桥。

完成首次设置

1. 登录。 官方版默认地址 192.168.1.1，用户名 root，没有密码。iStoreOS 等衍生版的默认地址和密码可能不同，看对应项目的说明。

2. 设密码。 在“系统 → 管理权”的“路由器密码”里设置 root 密码。没设密码时，局域网里任何人都能进后台。

3. 改 LAN 地址。 光猫也常用 192.168.1.1，两者撞车时把 OpenWrt 改到 192.168.2.1 之类的地址。

4. 配置 WAN。 光猫改了桥接，就在 WAN 口选 PPPoE 填宽带账号；光猫自己拨号，WAN 口用 DHCP 客户端即可。只打算当旁路由，按旁路由那篇设 LAN 口，不必管 WAN。

5. 设时区与时间同步。 在“系统 → 系统”里选 Asia/Shanghai，打开 NTP。时间不准，后面所有走 TLS 的连接都会失败。

6. 装中文界面。 用 SSH 登录后执行：

   opkg update
   opkg install luci-i18n-base-zh-cn

   从 25.12 版起，官方版改用 apk 包管理器，对应命令是 apk update 和 apk add，包名不变。其他命令的写法也有变化，OpenWrt Wiki 有一份 opkg 转 apk 的对照表。

7. 备份配置。 在“系统 → 备份/升级”里生成一份备份，存到电脑上。

装插件前备好五样东西

1. 架构名。 执行 opkg print-architecture（apk 版本用 apk –print-arch），记下结果，下载插件时按它找安装包。

2. 剩余空间。 执行 df -h，看 /overlay 还剩多少。插件加内核、规则文件，动辄要几十 MB。

3. 防火墙类型。 执行 opkg list-installed | grep firewall（apk 版本用 apk list –installed | grep firewall）：显示 firewall4 是 nftables，显示 firewall 是旧版 iptables。插件需要的内核模块随之不同，例如透明代理要的 tproxy 模块，两种防火墙各有各的包名。

4. 完整版 dnsmasq。 OpenClash 等插件需要 dnsmasq-full。直接卸载 dnsmasq 会让路由器暂时失去域名解析，导致新包下载不了，所以先下载再替换：

   opkg update
   cd /tmp && opkg download dnsmasq-full
   opkg remove dnsmasq
   opkg install /tmp/dnsmasq-full*.ipk

   dnsmasq-full 还依赖几个库，路由器上缺的话，最后一步会因为解析不了域名而下载失败。这时临时在 /etc/resolv.conf 里加一行公共 DNS 的 nameserver，装好后重启 dnsmasq 即可。用 apk 的版本，上面几条命令要换成 apk 的对应写法。

5. 其他依赖。 TUN 模式要 kmod-tun，下载证书要 ca-bundle，常见的还有 curl、ip-full。各插件的说明页都列着依赖，以说明页为准。

顺带一个区分：搜“openwrt vpn”的人，有一部分想要的是 WireGuard 或 OpenVPN，用来连自己的服务器或回家，对应的是 luci-proto-wireguard 这类包。这和导入机场订阅的科学上网插件是两回事，别装混。

绕开安装时的常见问题

• 升级后插件没了。 用 sysupgrade 升级时，默认保留配置，但不保留你后来手动装的软件包。升级前列出装过的包，升级后重新装一遍。
• 网卡不识别。 x86 机器上某个网口在系统里看不到，多半缺驱动。官方 x86-64 通用镜像已经自带 Intel、Realtek 常见网卡的驱动，例如 Intel I225 / I226 这类 2.5G 网卡对应的 kmod-igc；个人编译版不一定带全，冷门芯片也要另找驱动包。装上驱动包再重启。
• 刷错版本。 硬件版本对不上，轻则启动不了，重则要拆机救砖。刷之前把机身标签上的版本号和固件页面核对一遍。
• 后台进不去。 电脑同时连着 Wi-Fi 和网线时，浏览器可能走了别的网卡，先断开 Wi-Fi 再试。

系统装好后接上订阅

OpenWrt 装好、依赖备齐，下一步就是装插件、导入订阅。全家设备共用一条订阅，选套餐时月流量要宽裕一些。下单前先问客服订阅给的是什么格式、同时在线设备数怎么算，再回来决定装哪款插件。候选机场可以在推荐号位里看，例如 闪跃 的资料页。