iStoreOS 安装教程：从下载地址到 PVE、ESXi、X86 部署与改 IP

家里那台 N100 小主机，去年还在跑 OpenWrt 官方版，插件全靠手动传 ipk。后来为了 iStore 应用中心和 Docker，换成了 iStoreOS，一用就是一年多。上个月帮朋友装一台双网口的工控机，顺手把三种平台的装法（物理机、PVE、ESXi）都走了一遍，索性把过程写全，省得下次再翻聊天记录。

iStoreOS 本质是基于 OpenWrt 的发行版，加了 iStore 应用中心、Docker 和一套对小白友好的首页，所以它保留了 OpenWrt 的所有习惯：SquashFS 固件、overlay 分区、uci 配置。装法和 OpenWrt 一脉相承，但默认 IP、密码和 quickstart 工具是它自己的。

一、先搞清楚：去哪下、下哪个包

很多人卡在第一步不是不会装，而是下错了包。iStoreOS 的官方固件只有一个服务器：fw.koolcenter.com/iStoreOS/。GitHub 上的 istoreos/istoreos 仓库只有源码，没有 Releases，编译产物全在 koolcenter 这台服务器上，别在 GitHub 上白翻。

打开目录会看到几十个设备子目录，x86 用户只需要关心三个：

文件名本身就是说明书，拿最新这个拆开看：

istoreos-25.12.5-2026092410-x86-64-squashfs-combined.img.gz
         └─版本─┘ └┘└────构建时间────┘└─架构─┘└────格式────┘└─压缩─┘
                    2026年09月24日10时构建

版本线怎么选，我的标准很简单：机器要长期跑服务的选上一代稳的，想尝鲜或者新装的选最新主线。

二、X86 物理机安装（U 盘 + quickstart）

物理机安装的思路是「U 盘先跑起来一个临时系统，再把固件写进机器自己的硬盘」。iStoreOS 把这一步做成了 quickstart 命令，比 OpenWrt 时代的 dd 简单太多。

1. 做启动盘

固件是 .img.gz 压缩包。Rufus 不认压缩包，要先解压——我第一次就是直接把 .gz 拖进去，提示镜像无效，还以为是下载坏了。Windows 上用 7-Zip 解出 .img，或者干脆用 balenaEtcher，它可以直接吃 .gz。

# Linux / macOS
gzip -dk istoreos-25.12.5-2026092410-x86-64-squashfs-combined.img.gz

# Windows：7-Zip 右键解压，得到 .img；或直接用 balenaEtcher 选 .gz

2. 写入与启动

解压出的 .img 用 Rufus（选 DD 模式）或 Etcher 写进一个 1G 以上的 U 盘。然后把 U 盘、键盘、显示器接到机器上，开机按启动菜单键——绝大多数 x86 是 F11 或 F12，具体看主板。选中 U 盘启动后，会直接进入一个终端登录界面，用户 root、密码 password。

3. 写入硬盘

登录后输 quickstart（输 qu 再按 Tab 也能补全），菜单里选 Install X86，然后一路确认。它会自己找到那块 U 盘之外的硬盘写进去。

写完选 poweroff 关机，拔掉 U 盘和键盘显示器，通电重启。想确认网线插在了哪个口、LAN 口拿到什么 IP，用 quickstart 里的 Show Interfaces 一目了然。

三、PVE 安装：img 导入与扩容

PVE 这条路我走得最多，本质上就三个动作：把 img 变成一块虚拟磁盘、挂给虚拟机、设启动顺序。iStoreOS 官方也提了「PVE 用户直接用 img」的路线，比找第三方转换工具稳。

1. 上传固件

从 x86_64/ 目录下载 img.gz 并解压成 .img，然后传到 PVE。我习惯直接 scp 到宿主机任意目录，不用进网页传：

# 上传到 PVE 宿主机
scp istoreos-25.12.5-2026092410-x86-64-squashfs-combined.img.gz root@192.168.11.100:/tmp/

# 解压
cd /tmp && gzip -dk istoreos-25.12.5-2026092410-x86-64-squashfs-combined.img.gz

2. 建虚拟机并导入磁盘

# 建一台不带磁盘的空壳（BIOS 引导，机型 i440fx 就够用）
qm create 105 --name istoreos --memory 1024 --cores 2 
  --net0 virtio,bridge=vmbr0 --ostype l26 --serial0 socket

# 把 img 导入为虚拟磁盘
qm importdisk 105 istoreos-25.12.5-2026092410-x86-64-squashfs-combined.img local-lvm

# 挂上这块盘，用 virtio-scsi 控制器
qm set 105 --scsihw virtio-scsi-pci --scsi0 local-lvm:vm-105-disk-0

# 设启动顺序（新版 PVE）
qm set 105 --boot order=scsi0

如果你的 PVE 开的是 OVMF（UEFI），那就得下 x86_64_efi/ 目录的 efi 包，并且建虚拟机时加一块 EFI 盘（qm set 105 --efidisk0 local-lvm:1），BIOS 参数用 ovmf。引导方式和固件版本对不上，是「启动黑屏」的头号原因。

3. 扩容磁盘

官方 img 自带的分区大概只够系统本身，装 Docker、跑下载器很快就满。导入完先扩容再开机：

qm resize 105 scsi0 +8G

启动后进 iStoreOS 的「系统 → 磁盘管理」，对这块盘做一次应用，新的空间才会进到 overlay 分区。这一步不做，扩了也白扩。

img 导入的更多细节（比如纯命令行建机、两种总线性能差异），我之前专门写过一篇《PVE 安装 img 格式虚拟机教程》，可以对照着看。

四、ESXi 安装：vmdk 的两条路

ESXi 不吃 raw 格式的 img，得转成 vmdk。两条路：官方在 Virtual/ 目录里直接给了 vmdk 包（省事，但版本停在 22.03.7）；或者自己用 qemu-img 把任意版本的 img 转过去。

路线一：官方 vmdk（最省事）

下载 Virtual/istoreos-22.03.7-2024122015-x86-64-squashfs-combined-efi.vmdk.gz，解压得到两个文件：描述符 vmdk 和 -flat.vmdk。两个都要传到 ESXi 的数据存储（网页端「存储 → 数据存储浏览器 → 上传」），少一个虚拟机都开不了机。

路线二：qemu-img 自己转（版本随你选）

# Linux：apt install qemu-utils
# Windows：scoop install qemu

qemu-img convert -f raw -O vmdk -o subformat=streamOptimized 
  istoreos-25.12.5-2026092410-x86-64-squashfs-combined.img 
  istoreos-25.12.5.vmdk

streamOptimized 这个子格式是关键：它是流式压缩的薄盘，单文件，ESXi 网页端可以直接上传，导入时会自动展开——比传 descriptor + flat 两个文件再修路径省心得多。

建虚拟机

新建虚拟机时选「客户机操作系统：其他 → Linux 5.x 内核 64 位」，固件按你手里的包选 EFI 或 BIOS，内存 1G、双核足够。磁盘别新建，选「添加现有硬盘」指向上传的 vmdk，网卡给 VMXNET3。

五、装好第一件事：改登录 IP

不管哪种方式装完，后台都在 http://192.168.100.1，账号 root、密码 password。这个组合全网皆知，而且如果你的主路由网段不是 100.x，浏览器压根连不上——所以装机后的第一件事就是改 IP。

方法一：网页改（最直观）

登录后台，首页就有「内网设置」卡片，填新 IP、掩码，应用即生效。改动瞬间会掉线，用新 IP 重新登录就行。

方法二：quickstart 改（敲命令）

SSH 或控制台进系统，跑 quickstart，菜单里选修改 LAN IP，跟着提示填就行，适合不喜欢在网页里翻菜单的人。

方法三：uci 直接改（可脚本化）

uci set network.lan.ipaddr='192.168.11.10'
uci set network.lan.netmask='255.255.255.0'
uci set network.lan.gateway='192.168.11.1'
uci set network.lan.dns='192.168.11.1'
uci commit network
/etc/init.d/network restart

改完 IP 之后 SSH 会话会断开，用新 IP 重连即可。顺手把密码改了：系统 → 管理权，别让 password 在你的局域网里裸奔。

六、装完顺手要做的几件事

三件事按优先级排：改完密码，进 iStore 应用中心把软件源测一遍（部分网络环境要换镜像源），最后确认磁盘空间——尤其 PVE/ESXi 扩过容的，去「系统 → 磁盘管理」看一眼 overlay 是不是真的吃到了新空间。Docker 镜像目录建议一开始就指到大盘，别等缓存满了再挪。

七、常见问题速查

装好只是开始。iStoreOS 真正值钱的地方在 iStore 应用中心里那套插件生态，下一步我一般会先把 MosDNS 和 AdGuard Home 配起来，全屋去广告加 DNS 分流一套带走，具体可以看我写的《OpenWrt + MosDNS + AdGuard Home 全网去广告搭建教程》，iStoreOS 上的操作基本一致。