一、前言iStoreOS 是一款面向家庭和小型办公场景的开源软路由系统基于 OpenWrt 深度优化拥有简洁的 Web 管理界面和丰富的插件生态。本文将详细介绍如何在 Proxmox VEPVE虚拟化环境中通过磁盘镜像直接导入的方式部署 iStoreOS彻底规避传统光驱引导的兼容性问题实现一次部署成功。二、前期准备2.1 环境要求已部署好的 Proxmox VE 节点本文以 PVE 8.x 为例硬件至少 2 核 CPU、2GB 内存、20GB 以上 SSD 存储空间网络桥接正常默认 vmbr02.2 下载 iStoreOS 镜像方法一下载到本地上传手动上传下载地址https://fw.koolcenter.com/iStoreOS/直接下载到E盘根目录改个简短的名字上传到PVE在 PowerShell 里运行如下命令scp E:\istoreos-efi.img.gz root192.168.3.111:/var/lib/vz/template/iso/注Windows OpenSSH 不支持中文、空格路径E:\istoreos-efi.img.gz 为镜像的本地地址192.168.3.111 为PVE的地址提示 root192.168.3.111s password: 时输入你的 PVE root 密码输入时屏幕不显示正常输完回车/var/lib/vz/template/iso/是要上传到的PVE的目录查看是否上传成功直接在 PVE Shell 里输入下面这行查看文件到底传上去没有如果看到 istoreos-efi.img.gz说明已经上传成功了ls /var/lib/vz/template/iso/解压PVE 8 只会识别 .iso、.img 等后缀为 ISO 镜像.img.gz 不会被自动识别解压为img文件让PVE识别。# 到上传目录 cd /var/lib/vz/template/iso/ # 解压 gunzip -k istoreos-efi.img.gzgunzip -k解压并保留原 .gz 文件解压后会得到 istoreos-efi.img方法二直接命令下载在 PVE 节点的 Shell 中执行以下命令下载并解压 iStoreOS 磁盘镜像到iso目录# 进入 ISO 存储目录PVE 默认 ISO 上传路径cd /var/lib/vz/template/iso/下载# 下载最新版 iStoreOS EFI 镜像也可使用已有的 istoreos-efi.imgwget https://download.istoreos.com/istoreos-24.04-x86-64-generic-squashfs-combined-efi.img.gz解压# 解压得到可直接启动的 .img 磁盘镜像gunzip istoreos-24.04-x86-64-generic-squashfs-combined-efi.img.gz若你已手动上传 istoreos-efi.img可直接跳过下载步骤确保镜像位于 /var/lib/vz/template/iso/ 目录下即可。重启PVE并刷新运行如下命令然后 F5 刷新网页去 local → ISO 镜像你会看到 istoreos-efi.img 已经显示出来了systemctl restart pvedaemon pveproxy pvestatd三、创建 istoreos虚拟机登录 PVE 管理后台点击「创建虚拟机」常规选项卡名称istoreos自定义VM ID100自定义后续命令需对应节点选择你的 PVE 节点这里是zilong操作系统选项卡勾选「不使用任何介质」后续直接导入磁盘镜像类型Linux版本6.x - 2.6 Kernel系统选项卡BIOSSeaBIOS兼容性最佳避免 UEFI 引导失败问题机型i440fxSCSI 控制器VirtIO SCSI single磁盘选项卡创建一个空磁盘大小设置为 20GB 以上推荐 32GB存储选择 local-lvmSSD 存储性能更好格式原始磁盘映像 (raw)勾选「IO thread」提升磁盘性能CPU选项卡核心2根据物理 CPU 核心数调整类别host直通 CPU 特性性能最优内存选项卡内存2048 MiB软路由基础需求可按需调整网络选项卡模型VirtIO半虚拟化网卡性能最佳桥接vmbr0PVE 默认网桥确认配置点击「完成」创建虚拟机。四、导入 iStoreOS 镜像为系统盘4.1 执行磁盘导入命令在 PVE 节点 Shell 中执行以下命令将 iStoreOS 镜像导入为虚拟机磁盘# 格式qm importdisk VM ID 镜像路径 目标存储 qm importdisk 100 /var/lib/vz/template/iso/istoreos-efi.img local-lvm100对应你创建的虚拟机 IDlocal-lvm对应虚拟机创建时选择的 SSD 存储等待命令执行完成镜像将被导入为「未使用的磁盘」4.2 挂载新磁盘回到 PVE 管理后台进入虚拟机 100 →「硬件」选项卡找到「未使用的磁盘」点击「编辑」总线 / 设备选择VirtIO Block点击「添加」4.3 替换启动磁盘选中原来的空磁盘如 scsi0点击「分离」确认分离操作再次选中分离后的「未使用的磁盘」点击「移除」彻底删除空磁盘进入「选项」选项卡 →「引导顺序」将新导入的 virtio0 磁盘移至最顶部设置为第一启动项保存配置五、启动并初始化 iStoreOS5.1 启动虚拟机点击「启动」按钮启动虚拟机点击「控制台」打开虚拟机终端等待系统启动看到提示 iStoreOS is ready! Please press Enter to activate this console. 即启动完成5.2 控制台登录与密码修改按 Enter 激活控制台输入默认账号密码用户名root密码password执行以下命令修改默认密码务必修改保障安全passwd按提示输入新密码并确认看到 passwd: password changed. 即修改成功。5.3 查看管理 IP执行以下命令查看 iStoreOS 的局域网 IPip addr找到 br-lan 接口记录 IPv4 地址示例192.168.3.218/24。5.4 登录 Web 管理后台打开浏览器访问http://你的iStoreOS-IP这里是http://192.168.3.218使用 root 账号和你刚设置的新密码登录进入 iStoreOS 管理界面。六、iStoreOS 基础配置6.1 网络配置软路由模式进入「网络」→「接口」配置 WAN 口若为 PPPoE 拨号新增接口协议选择 PPPoE输入宽带账号密码若为 DHCP 上网选择 DHCP 客户端绑定对应物理网口配置 LAN 口设置静态 IP如 192.168.3.1/24开启 DHCP 服务为下游设备分配 IP保存配置并应用重启网络服务。6.2 安装常用插件进入「应用商店」可安装以下常用插件科学上网passwall/clash广告拦截adguardhome文件共享samba动态 DNSddns-go七、常见问题避坑7.1 光驱引导失败code 0004原因iStoreOS .img 是磁盘镜像不适合作为光驱 ISO 引导解决本文采用的「直接导入磁盘」方式彻底规避此问题7.2 UEFI 引导找不到设备原因UEFI 模式对光驱 / 磁盘识别兼容性差解决创建虚拟机时 BIOS 选择 SeaBIOS7.3 启动后无 IP 地址原因网络桥接配置错误或虚拟机网卡未绑定解决检查虚拟机网络桥接是否为 vmbr0确认物理网口正常八、总结通过「磁盘镜像直接导入」的方式在 PVE 中部署 iStoreOS不仅规避了传统光驱引导的兼容性问题还能实现系统直接从 SSD 启动性能更稳定。iStoreOS 简洁的 Web 界面和丰富的插件生态使其成为家庭软路由的理想选择配合 PVE 虚拟化环境可轻松实现多系统共存与资源灵活分配。九、参考资料iStoreOS 官方文档Proxmox VE 官方文档
PVE 部署 iStoreOS 软路由完整教程（避坑版）
发布时间：2026/5/17 22:21:45
一、前言iStoreOS 是一款面向家庭和小型办公场景的开源软路由系统基于 OpenWrt 深度优化拥有简洁的 Web 管理界面和丰富的插件生态。本文将详细介绍如何在 Proxmox VEPVE虚拟化环境中通过磁盘镜像直接导入的方式部署 iStoreOS彻底规避传统光驱引导的兼容性问题实现一次部署成功。二、前期准备2.1 环境要求已部署好的 Proxmox VE 节点本文以 PVE 8.x 为例硬件至少 2 核 CPU、2GB 内存、20GB 以上 SSD 存储空间网络桥接正常默认 vmbr02.2 下载 iStoreOS 镜像方法一下载到本地上传手动上传下载地址https://fw.koolcenter.com/iStoreOS/直接下载到E盘根目录改个简短的名字上传到PVE在 PowerShell 里运行如下命令scp E:\istoreos-efi.img.gz root192.168.3.111:/var/lib/vz/template/iso/注Windows OpenSSH 不支持中文、空格路径E:\istoreos-efi.img.gz 为镜像的本地地址192.168.3.111 为PVE的地址提示 root192.168.3.111s password: 时输入你的 PVE root 密码输入时屏幕不显示正常输完回车/var/lib/vz/template/iso/是要上传到的PVE的目录查看是否上传成功直接在 PVE Shell 里输入下面这行查看文件到底传上去没有如果看到 istoreos-efi.img.gz说明已经上传成功了ls /var/lib/vz/template/iso/解压PVE 8 只会识别 .iso、.img 等后缀为 ISO 镜像.img.gz 不会被自动识别解压为img文件让PVE识别。# 到上传目录 cd /var/lib/vz/template/iso/ # 解压 gunzip -k istoreos-efi.img.gzgunzip -k解压并保留原 .gz 文件解压后会得到 istoreos-efi.img方法二直接命令下载在 PVE 节点的 Shell 中执行以下命令下载并解压 iStoreOS 磁盘镜像到iso目录# 进入 ISO 存储目录PVE 默认 ISO 上传路径cd /var/lib/vz/template/iso/下载# 下载最新版 iStoreOS EFI 镜像也可使用已有的 istoreos-efi.imgwget https://download.istoreos.com/istoreos-24.04-x86-64-generic-squashfs-combined-efi.img.gz解压# 解压得到可直接启动的 .img 磁盘镜像gunzip istoreos-24.04-x86-64-generic-squashfs-combined-efi.img.gz若你已手动上传 istoreos-efi.img可直接跳过下载步骤确保镜像位于 /var/lib/vz/template/iso/ 目录下即可。重启PVE并刷新运行如下命令然后 F5 刷新网页去 local → ISO 镜像你会看到 istoreos-efi.img 已经显示出来了systemctl restart pvedaemon pveproxy pvestatd三、创建 istoreos虚拟机登录 PVE 管理后台点击「创建虚拟机」常规选项卡名称istoreos自定义VM ID100自定义后续命令需对应节点选择你的 PVE 节点这里是zilong操作系统选项卡勾选「不使用任何介质」后续直接导入磁盘镜像类型Linux版本6.x - 2.6 Kernel系统选项卡BIOSSeaBIOS兼容性最佳避免 UEFI 引导失败问题机型i440fxSCSI 控制器VirtIO SCSI single磁盘选项卡创建一个空磁盘大小设置为 20GB 以上推荐 32GB存储选择 local-lvmSSD 存储性能更好格式原始磁盘映像 (raw)勾选「IO thread」提升磁盘性能CPU选项卡核心2根据物理 CPU 核心数调整类别host直通 CPU 特性性能最优内存选项卡内存2048 MiB软路由基础需求可按需调整网络选项卡模型VirtIO半虚拟化网卡性能最佳桥接vmbr0PVE 默认网桥确认配置点击「完成」创建虚拟机。四、导入 iStoreOS 镜像为系统盘4.1 执行磁盘导入命令在 PVE 节点 Shell 中执行以下命令将 iStoreOS 镜像导入为虚拟机磁盘# 格式qm importdisk VM ID 镜像路径 目标存储 qm importdisk 100 /var/lib/vz/template/iso/istoreos-efi.img local-lvm100对应你创建的虚拟机 IDlocal-lvm对应虚拟机创建时选择的 SSD 存储等待命令执行完成镜像将被导入为「未使用的磁盘」4.2 挂载新磁盘回到 PVE 管理后台进入虚拟机 100 →「硬件」选项卡找到「未使用的磁盘」点击「编辑」总线 / 设备选择VirtIO Block点击「添加」4.3 替换启动磁盘选中原来的空磁盘如 scsi0点击「分离」确认分离操作再次选中分离后的「未使用的磁盘」点击「移除」彻底删除空磁盘进入「选项」选项卡 →「引导顺序」将新导入的 virtio0 磁盘移至最顶部设置为第一启动项保存配置五、启动并初始化 iStoreOS5.1 启动虚拟机点击「启动」按钮启动虚拟机点击「控制台」打开虚拟机终端等待系统启动看到提示 iStoreOS is ready! Please press Enter to activate this console. 即启动完成5.2 控制台登录与密码修改按 Enter 激活控制台输入默认账号密码用户名root密码password执行以下命令修改默认密码务必修改保障安全passwd按提示输入新密码并确认看到 passwd: password changed. 即修改成功。5.3 查看管理 IP执行以下命令查看 iStoreOS 的局域网 IPip addr找到 br-lan 接口记录 IPv4 地址示例192.168.3.218/24。5.4 登录 Web 管理后台打开浏览器访问http://你的iStoreOS-IP这里是http://192.168.3.218使用 root 账号和你刚设置的新密码登录进入 iStoreOS 管理界面。六、iStoreOS 基础配置6.1 网络配置软路由模式进入「网络」→「接口」配置 WAN 口若为 PPPoE 拨号新增接口协议选择 PPPoE输入宽带账号密码若为 DHCP 上网选择 DHCP 客户端绑定对应物理网口配置 LAN 口设置静态 IP如 192.168.3.1/24开启 DHCP 服务为下游设备分配 IP保存配置并应用重启网络服务。6.2 安装常用插件进入「应用商店」可安装以下常用插件科学上网passwall/clash广告拦截adguardhome文件共享samba动态 DNSddns-go七、常见问题避坑7.1 光驱引导失败code 0004原因iStoreOS .img 是磁盘镜像不适合作为光驱 ISO 引导解决本文采用的「直接导入磁盘」方式彻底规避此问题7.2 UEFI 引导找不到设备原因UEFI 模式对光驱 / 磁盘识别兼容性差解决创建虚拟机时 BIOS 选择 SeaBIOS7.3 启动后无 IP 地址原因网络桥接配置错误或虚拟机网卡未绑定解决检查虚拟机网络桥接是否为 vmbr0确认物理网口正常八、总结通过「磁盘镜像直接导入」的方式在 PVE 中部署 iStoreOS不仅规避了传统光驱引导的兼容性问题还能实现系统直接从 SSD 启动性能更稳定。iStoreOS 简洁的 Web 界面和丰富的插件生态使其成为家庭软路由的理想选择配合 PVE 虚拟化环境可轻松实现多系统共存与资源灵活分配。九、参考资料iStoreOS 官方文档Proxmox VE 官方文档
相关文章
S32K3低功耗模式实战：如何用WKPU和Pad-Keeping实现高效唤醒（附代码示例）
S32K3低功耗模式深度优化：WKPU与Pad-Keeping的工程实践 在汽车电子领域，低功耗设计早已不是简单的"关闭电源"就能解决的问题。现代车载系统需要在极低功耗状态下保持关键功能的响应能力，这对MCU的唤醒机制提出了严苛要求。NXP的S32…
开源媒体播放器Tsukimi：打造个人媒体中心的终极指南
开源媒体播放器Tsukimi：打造个人媒体中心的终极指南 【免费下载链接】tsukimi A simple third-party Emby client 项目地址: https://gitcode.com/gh_mirrors/ts/tsukimi 想要在Linux系统上享受流畅的Jellyfin媒体播放体验吗？开源媒体播放器Tsuki…
终极文档处理方案：AnythingLLM如何实现PDF/TXT/DOCX全格式智能解析
终极文档处理方案：AnythingLLM如何实现PDF/TXT/DOCX全格式智能解析 【免费下载链接】anything-llm 这是一个全栈应用程序，可以将任何文档、资源（如网址链接、音频、视频）或内容片段转换为上下文，以便任何大语言模型&am…
HttpOnly Cookie 深度解析
一、什么是 HttpOnly Cookie HttpOnly 是一个可以附加在 Set-Cookie 响应头上的标志位（flag）。当一个 Cookie 被标记为 HttpOnly 后，客户端脚本（如 JavaScript）将无法通过 document.cookie 等 API 访问该 Cookie&…
GA/T 1400视图库实战：从零部署Easy1400平台到设备级联全流程解析
1. 初识GA/T 1400与Easy1400平台 第一次接触GA/T 1400标准时，我完全被各种专业术语绕晕了。简单来说，这是一套专门针对视频监控领域的行业标准，规定了视频图像信息在采集、传输、存储等环节的技术要求。而Easy1400就是基于这个标准开发的一套…
OAuth 2.0 and OIDC 三大安全机制对比：State vs Nonce vs PKCE
一、问题背景 OAuth 2.0 和 OpenID Connect 的授权流程依赖浏览器重定向，这天然暴露了多种攻击面： 攻击类型描述CSRF攻击者诱导用户的浏览器携带恶意授权码完成绑定Token 重放窃取的 id_token 被重复提交给客户端授权码劫持恶意应用在同一设备上拦截授…
AI驱动i18n翻译：基于LLM的JSON本地化文件批量处理实践
1. 项目概述与核心价值最近在折腾一个多语言项目，需要把几百条中文文案翻译成英文、日文、法文等十几种语言。手动翻译？不现实，成本高、周期长、一致性还难保证。用传统的翻译API？虽然方便，但面对专业术语、产品特有名…
Cloudflare Sandbox SDK：本地开发无缝调用云端服务的RPC解决方案
1. 项目概述：一个被低估的云端开发利器如果你正在寻找一种能让你在本地开发环境中，就能安全、高效地调用云端服务的方法，那么cloudflare/sandbox-sdk绝对是一个值得你花时间研究的项目。乍看之下，这个名字可能有些抽象——“沙盒S…
基于MCP协议构建巴西开放数据网关：架构设计与工程实践
1. 项目概述：一个为巴西数据开放平台量身定制的MCP服务器如果你正在开发一个需要接入巴西官方开放数据平台（Dados Abertos）的应用，或者你是一名数据分析师、研究员，希望以编程化的方式高效、稳定地获取巴西的各类公共数…
【实用小程序】超轻量级文件上传下载中心 (File Download Server)
站内源码及jar包下载 一、项目概述 文件下载中心一个基于 Java 内置 HTTP 服务器（com.sun.net.httpserver）构建的轻量级文件管理服务。它零第三方依赖，单 JAR 包即可运行，适合在内网环境或临时场景中快速搭建文件共享站点。 你的团队需要临时共享一批日志文件或交付物，…
py每日spider案例之某website之xin东方选课搜索接口(难度一般 扣取代码即可)
加密位置: 逆向接口参数: 逆向接口: const g = globalThis; g.window = g; g.self = g; g.location = {<
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南 【免费下载链接】markor Text editor - Notes & ToDo (for Android) - Markdown, todo.txt, plaintext, math, .. 项目地址: https://gitcode.com/gh_mirrors/ma/markor 在移动设备上寻找一款…
【实用小程序】超轻量级文件上传下载中心 (File Download Server)
站内源码及jar包下载 一、项目概述 文件下载中心一个基于 Java 内置 HTTP 服务器（com.sun.net.httpserver）构建的轻量级文件管理服务。它零第三方依赖，单 JAR 包即可运行，适合在内网环境或临时场景中快速搭建文件共享站点。 你的团队需要临时共享一批日志文件或交付物，…
py每日spider案例之某website之xin东方选课搜索接口(难度一般 扣取代码即可)
加密位置: 逆向接口参数: 逆向接口: const g = globalThis; g.window = g; g.self = g; g.location = {<
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南 【免费下载链接】markor Text editor - Notes & ToDo (for Android) - Markdown, todo.txt, plaintext, math, .. 项目地址: https://gitcode.com/gh_mirrors/ma/markor 在移动设备上寻找一款…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…