XigmaNAS QEMU 虚拟机部署安装指南

目标：在 X86_64 Linux 宿主机上用 QEMU 部署一台 XigmaNAS 虚拟机（嵌入式 embedded 模式安装到 40G 数据盘），完成系统安装、分区、重启与 WebGUI 访问确认。本文步骤、控制台输出均在本机（无 /dev/kvm，使用 TCG 纯软件模拟）实测。你也可直接运行该镜像（LiveCD）而不安装，做成「测试/维护环境」。

1. 前置准备

1.1 所需文件

XigmaNAS LiveCD ISO：下载见《XigmaNAS 简介、版本与镜像下载指南》，本机位于 /opt/data/quzuo/ops/XigmaNAS-x64-LiveCD-14.3.0.5.10566.iso。
数据盘：安装目标盘 xigmadata.qcow2（40 GiB，qcow2 稀疏分配，实际占用小）。

1.2 宿主机环境

推荐有硬件虚拟化（/dev/kvm），启动快；本机无 /dev/kvm，用 -machine q35,accel=tcg 纯软件模拟（不含 KVM 标志），启动与运算较慢但流程一致。

# 检查是否有 KVM
ls -l /dev/kvm          # 不存在则只能走 TCG
egrep -c '(vmx|svm)' /proc/cpuinfo   # 0 说明 CPU 不支持 VT

2. 创建数据盘

cd /opt/data/quzuo/ops
qemu-img create -f qcow2 xigmadata.qcow2 40G

3. 启动安装虚拟机（带 ISO）

qemu-system-x86_64 -machine q35,accel=tcg -m 4096 -smp 2 \
  -cdrom /opt/data/quzuo/ops/XigmaNAS-x64-LiveCD-14.3.0.5.10566.iso \
  -drive file=/opt/data/quzuo/ops/xigmadata.qcow2,if=virtio,format=qcow2 \
  -netdev user,id=n0,hostfwd=tcp::18080-:80,hostfwd=tcp::18022-:22 \
  -device virtio-net-pci,netdev=n0 \
  -monitor unix:/opt/data/quzuo/ops/xigm_mon.sock,server,nowait \
  -serial unix:/opt/data/quzuo/ops/xigm_serial.sock,server,nowait \
  -display none -daemonize -pidfile xigmanas.pid

hostfwd=tcp::18080-:80 / ::18022-:22：把宿主机 18080/18022 转发到虚拟机的 80(WebGUI)/22(SSH)。
-display none：无界面（可另开 VNC 或靠 QEMU monitor screendump 看屏）。

4. 进入控制台菜单并启动安装

引导进入后台后，登录控制台即可操作：

默认登录：root，密码：xigmanas（只有先登录 tty 才会出现控制台菜单）。
菜单选择 9) Install 开始安装。

键盘提示（QEMU monitor 注入）：空格用 spc、- 用 minus、字母用小写，否则会报 "invalid parameter"。

5. 嵌入式安装与分区（实测流程）

安装程序按如下顺序询问（以 embedded GPT 为例）：

选择安装类型 → embedded (CF/SD/USB/…)。
确认是否擦除目标盘。
安装源介质：选 cd0（LiveCD）。
安装目标盘：选 vtbd0（40G virtio 数据盘）。
分区方案：embedded 会创建 GPT 分区，参数如下：

分区	挂载/用途	实测大小
p1	freebsd-boot（引导代码）	512K
p2	OS（系统，持久化配置目录 /cf 所在）	2048M
p3	SWAP（交换分区）	1024M
p4	DATA（数据分区，剩余空间）	默认 ALL

确认后执行文件系统创建与镜像写入，日志类似：

Creating filesystems ... done
XigmaNAS-x64-embedded.xz 写入 ... OK

安装完成后重启（菜单 7 Reboot），并从**数据盘（不再挂 ISO）**引导。

6. 二次引导（从硬盘启动）

# 移除 -cdrom，改从 xigmadata.qcow2 引导
qemu-system-x86_64 -machine q35,accel=tcg -m 4096 -smp 2 \
  -drive file=/opt/data/quzuo/ops/xigmadata.qcow2,if=virtio,format=qcow2 \
  -netdev user,id=n0,hostfwd=tcp::18080-:80,hostfwd=tcp::18022-:22 \
  -device virtio-net-pci,netdev=n0 \
  -monitor unix:/opt/data/quzuo/ops/xigm_mon.sock,server,nowait \
  -serial unix:/opt/data/quzuo/ops/xigm_serial.sock,server,nowait \
  -display none -daemonize -pidfile xigmanas.pid

引导日志会出现 Booting platform: embedded，随后进入登录界面，说明配置已持久化到 /dev/vtbd0p2。

7. 登录与 WebGUI 确认（实测）

XigmaNAS: 14.3.0.5 (revision 10566)
Compiled: Tue Oct 28 20:18:07 CET 2025 Platform: x64-embedded

Console Menu
------------------
1) Configure Network Interfaces     10) Configure Hosts Allow for WebGUI
2) Configure Network IP Address     11) Restart WebGUI
3) Reset WebGUI Password            12) Restart WebGUI, force HTTP on port 80
4) Reset to Factory Defaults        20) Console Keyboard Map
5) Ping Host
6) Shell
7) Reboot Server
8) Shut down Server

Enter a number:

控制台 / SSH 登录：root / xigmanas。
WebGUI 登录账号为 admin，密码 xigmanas（可通过菜单 3 重置为默认 xigmanas）。

网络配置后控制台会显示 WebGUI 地址：

Initializing interface. Please wait...
The IP address has been set to:
LAN Network IPv4 Address: 10.0.2.15
You can access the WebGUI using the following URL:
http://10.0.2.15

8. 宿主机经端口转发访问 WebGUI（实测）

NAT 网段为 10.0.2.0/24，宿主机通过转发端口访问：

curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:18080/   # 302（跳转登录）
curl -sL -o /dev/null -w "final=%{url_effective} code=%{http_code}\n" http://127.0.0.1:18080/

登录成功且会话有效时，访问主页得到系统信息页：

curl -s -b session.txt -o index.html -w "%{http_code} %{size_download}\n" http://127.0.0.1:18080/index.php
# 200 23024   -> 标题 <title>xigmanas.internal - System Information</title>

9. 实测环境汇总（安装完成后）

项目	值
版本	14.3.0.5 - Jalanto（revision 10566）
内核	FreeBSD 14.3-RELEASE-p5 / XigmaNAS Kernel Build
平台	x64-embedded
主机名	xigmanas.internal
内存	3.66 GiB（分配 4GiB）
交换分区	/dev/vtbd0p3（1.07 GB）

后续的存储挂载、SMB/NFS 共享与命令运维见《XigmaNAS Web 界面配置详解》《XigmaNAS 常用命令行与运维指南》。