PVE 部署 iStoreOS（带 iStore OpenWrt）

 

适用场景：仅 PVE 虚拟机创建 + 固件导入 + 基础网络配置，不涉及 OpenWrt 后续插件设置

1. 前言与环境说明

# PVE 部署 iStoreOS（带iStore OpenWrt）完整教程

## 环境约定 - PVE 宿主网桥：vmbr0（默认局域网桥接） - 虚拟机 ID：100（可自行修改） - 存储池：local-lvm（默认系统存储） - 旁路由 IP：192.168.123.2 - 主路由网关：192.168.123.1 - 固件：iStoreOS x86_64 官方稳定版（内置 iStore 商店）

 

2. 登录 PVE SSH

## 2. SSH 登录 PVE 节点 ```bash # 替换为你的 PVE 管理 IP ssh root@192.168.123.3

--- ## 3. 下载并解压固件 ```markdown

## 3. 下载 iStoreOS 固件（国内加速，无 401/404） ```bash

# 进入 ISO 镜像存放目录 cd /var/lib/vz/template/iso/

# 下载带 iStore 的 OpenWrt 固件 wget https://mirror.ghproxy.com/https://github.com/linkease/istoreos/releases/download/2024.05.25/istoreos-x86-64-generic-squashfs-combined.img.gz

# 解压 img.gz 为原生镜像 gunzip istoreos-x86-64-generic-squashfs-combined.img.gz

# 查看解压后的镜像文件 ls -lh

 

--- ## 3. 下载并解压固件 ```markdown ## 3. 下载 iStoreOS 固件（国内加速，无 401/404） ```bash # 进入 ISO 镜像存放目录 cd /var/lib/vz/template/iso/ # 下载带 iStore 的 OpenWrt 固件 wget https://mirror.ghproxy.com/https://github.com/linkease/istoreos/releases/download/2024.05.25/istoreos-x86-64-generic-squashfs-combined.img.gz # 解压 img.gz 为原生镜像 gunzip istoreos-x86-64-generic-squashfs-combined.img.gz # 查看解压后的镜像文件 ls -lh

--- ## 5. 导入镜像并设置启动盘 ```markdown ## 5. 导入固件镜像为系统盘 ```bash # 将 img 镜像导入到虚拟机 100 的磁盘 qm importdisk 100 istoreos-x86-64-generic-squashfs-combined.img local-lvm # 挂载磁盘为 scsi0 qm set 100 --scsi0 local-lvm:vm-100-disk-0 # 设置从 scsi0 优先启动 qm set 100 --boot order=scsi0

 

 

--- ## 6. 启动虚拟机并进入控制台 ```markdown ## 6. 启动并进入 OpenWrt 控制台 ```bash # 启动虚拟机 qm start 100 # 进入串口控制台 # 退出方式：Ctrl + A → 按 D qm terminal 100 # 登录信息 # 用户名：root # 密码：无，直接回车

 

--- ## 7. 配置 OpenWrt 固定 IP ```markdown ## 7. 配置 LAN 口静态 IP（旁路由模式） ```bash # 设置本机 IP uci set network.lan.ipaddr='192.168.123.2' # 设置网关为主路由 uci set network.lan.gateway='192.168.123.1' # 设置阿里公共 DNS uci set network.lan.dns='223.5.5.5' # 保存配置 uci commit network # 重启网络生效 /etc/init.d/network restart

 

--- ## 8. 网络连通性测试 ```markdown ## 8. 网络连通性验证 ```bash # 查看 br-lan 网卡 IP ifconfig br-lan # ping 网关测试内网通断 ping 192.168.123.1 -c 3 # ping 外网 DNS 测试联网 ping 223.5.5.5 -c 3

 

--- ## 9. 后台访问地址 ```markdown ## 9. OpenWrt 后台访问 浏览器打开： http://192.168.123.2 用户名：root 密码：（空，首次登录可自行设置） 左侧菜单栏自带：iStore 应用商店

 

10. 常见错误快速修复

## 10. 常见问题修复命令 ### 串口找不到（unable to find serial interface） ```bash qm stop 100 qm set 100 --serial0 socket qm start 100 qm terminal 100

 

无法访问后台： 

# 重启 OpenWrt 网络 /etc/init.d/network restart