Fedora环境完善（一）

上一期我们完成了incus部署，本期主要解决Windows虚拟机的访问问题以及incus场景下的软路由配置，以实现更灵活的网络访问。最后提供一个本人Vibe Coding出的incus TUI管理脚本，方便日常使用。

incus Windows VM相关#

更合理的部署方式#

上期我们提到，在incus中配置Windows虚拟机时需要注入VirtIO驱动，并使用手动加载的方法成功进行了注入。后来我又尝试了使用Distrobuilder重新封装Windows的iso镜像这种方法，这里一并介绍。这种方法需要先在本机安装Distrobuilder，我这里采用的是从源码构建的方法（官方未提供Fedora环境下的预编译包）。

1
wget https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-3.3.1.tar.gz
2
tar -zxvf distrobuilder-3.3.1.tar.gz
3
cd distrobuilder-3.3.1/
4
make
5
sudo dnf install perl-hivex genisoimage swtpm
6
# genisoimage是distrobuilder最后会调用的iso生成工具，swtpm是Win11虚拟机中设置tpm模块需要的

进行镜像封装与系统初始化

1
sudo /home/zero/go/bin/distrobuilder repack-windows --windows-arch=amd64 --windows-version=w11 /var/lib/incus/iso/win11.iso ~/win11-incus.iso --drivers=/usr/share/virtio-win/virtio-win.iso
2
sudo mv ~/win11-incus.iso /var/lib/incus/iso/
3
sudo chmod 644 /var/lib/incus/iso/win11-incus.iso
4
sudo chcon -t svirt_home_t /var/lib/incus/iso/win11-incus.iso
5

6
incus init win11 --empty --vm
7
incus config set win11 image.os Windows
8
incus config set win11 limits.cpu 4
9
incus config set win11 limits.memory 8GiB
10
incus config device override win11 root size=64GiB
11
incus config set win11 security.csm false
12
incus config set win11 security.secureboot true
13
incus config device add win11 vtpm tpm
14
incus config device add win11 install-media disk source=/var/lib/incus/iso/win11-incus.iso boot.priority=10

随后进入VM进行系统安装即可直接识别磁盘。

incus-agent编译安装#

incus-agent是运行在Incus 虚拟机 (VM) 内部的一个守护进程。它的主要作用是作为宿主机Incus服务与虚拟机内部系统之间的“桥梁”，实现原本只有容器（Container）才能轻松完成的高级交互功能。

直接执行命令
文件传输
状态监控与指标
生命周期管理（更优雅的关机/重启，命令没变，但是变成了incus-agent向VM发送相关指令）

dnf可以直接安装incus-agent，但这通常只包含与宿主机系统架构一致的版本，比如本机就只有x86_64环境下Linux平台的incus-agent。如果要支持多平台的虚拟机，比如Linux+Windows，需要自己编译好对应平台的incus-agent，并为incus设置好环境变量INCUS_AGENT_PATH

1
sudo systemctl edit incus
2

3
# 写入下面内容
4
[Service]
5
Environment=INCUS_AGENT_PATH=/opt/incus/agent
6

7
# 重载incus服务并检查是否修改成功
8
sudo systemctl daemon-reload
9
sudo systemctl restart incus
10
systemctl cat incus
11
systemctl show incus -p Environment

下面我们就需要手动编译Windows平台的incus-agent并置于INCUS_AGENT_PATH中，下面是我的操作过程

1
git clone https://github.com/lxc/incus ~/src/incus
2
cd ~/src/incus/
3
# 最好与从Fedora仓库安装的incus版本一致
4
git tag | grep 6.19
5
incus version
6
git checkout v6.19.1
7

8
sudo mkdir -p /opt/incus/agent
9
sudo CGO_LDFLAGS_ALLOW="-Wl,-z,now" CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -trimpath -tags=agent,netgo -o /opt/incus/agent/incus-agent.windows.x86_64 ./cmd/incus-agent/

这里需要注意的是，如果设置了INCUS_AGENT_PATH，需要把本系统通过包管理器安装的incut_agent文件也放过来（可以使用符号链接的方式），并遵从命名规则（如incus-agent.linux.x86_64）。随后对于Windows，需要手动加载Agent驱动。

1
incus config device add win11 agent disk source=agent:config

在Win中进入对应CD以管理员权限执行install.ps1脚本即可。这里的安装脚本我运行后会在中途退出，并且查看系统服务，发现Incus Agent这个服务无法启动，最后是通过将编译出的incus-agent.exe这个文件粘贴进C:\Program Files/incus-agent这个目录下再启动服务成功的。

RDP访问#

对于incus环境中的Windows虚拟机，使用RDP的方式访问体验是最好的，下面是rdp访问的相关设置。

在Windows的设置中开启远程访问功能并为当前用户添加相关权限。
在宿主机（Fedora）中安装xfreerdp（wayland下最佳的RDP解决方案）
使用xfreerdp进行RDP访问

1
xfreerdp \
2
/v:"$HOST" \
3
/u:"$USER" \
4
/p:"$PASSWORD" \
5
/gfx +dynamic-resolution /cert:ignore /network:auto /scale:180

这里其实不建议以明文的方式传入密码，会在系统日志、.bash_history中以明文形式存储（当然个人电脑其实也无所谓）。如果想要更高的安全性，可以使用secret-tool，这是一个用于安全存储和管理敏感信息的命令行工具，可以避免敏感信息的硬编码。secret-tool本身不存储数据，它通过D-Bus与后端服务进行通信。常见的后端有GNOME Keyring、KeePassXC、KWallet等。由于我本人使用KeePassXC进行密码管理，所以就沿用KeePassXC的方案了。

在KeePassXC中的软件设置中启用保密服务集成后，在数据库自身的设置->保密服务集成中设定一个保存secret的群组。随后即可使用命令行添加、查询与删除敏感信息（也可以直接在KeePassXC的GUI界面直接操作），基本语法如下：

1
# 添加敏感信息
2
secret-tool store --label="我的标签" 属性名1 属性值1 属性名2 属性值2 ...
3
## 示例
4
secret-tool store --label="GitHub API Key" service github user alice
5

6
# 查询敏感信息
7
## lookup是精确匹配，属性对必须写全
8
secret-tool lookup service github user alice
9
## search可以匹配部分属性，会打印出该条目的标签、敏感信息值及所有属性
10
secret-tool search service github
11

12
# 删除敏感信息（精确匹配/部分匹配均可）
13
secret-tool clear service github user alice
14
secret-tool clear service github

借助secret-tool，我Vibe Coding了以下脚本实现便捷的RDP登陆，实现的效果是列出脚本中储存的RDP主机显示名，回车后直接连接进入RDP桌面，其HOST、USER、PASSWORD均由脚本自动获取。

1
#!/usr/bin/env bash
2
set -euo pipefail
3

4
command -v fzf >/dev/null 2>&1 || {
5
  echo "缺少 fzf"
6
  exit 1
7
}
8

9
# 格式：显示名|HOST|USER
10
# USER 直接写最终传给 xfreerdp /u: 的内容
11
# 本地账号示例：.\admin
12
# 微软账号示例：[email protected]
13
ENTRIES=(
14
  "工位主机|x.x.x.x|.\admin"
15
  "incus_Win11|192.168.x.x|.\Administrator"
16
)
17

18
selected="$(
19
  printf '%s\n' "${ENTRIES[@]}" |
20
    awk -F'|' '{printf "%s\t%s\t%s\n", $1, $2, $3}' |
21
    fzf --delimiter=$'\t' --with-nth=1,2,3 \
22
      --prompt='RDP > ' \
23
      --height=40% \
24
      --reverse
25
)" || exit 0
26

27
IFS=$'\t' read -r NAME HOST USER <<<"$selected"
28

29
PW="$(secret-tool lookup service rdp server "$HOST" 2>/dev/null || true)"
30

31
[[ -n "$PW" ]] || {
32
  echo "没找到密码：$HOST / $USER"
33
  exit 1
34
}
35

36
nohup xfreerdp \
37
  /v:"$HOST" \
38
  /u:"$USER" \
39
  /p:"$PW" \
40
  /gfx +dynamic-resolution /scale:180 /f /cert:ignore /network:auto \
41
  /log-level:OFF \
42
  </dev/null >/dev/null 2>&1 &
43

44
disown 2>/dev/null || true

incus openwrt软路由部署#

部署openwrt的思路其实很简单，就是配置两个网卡，一个网卡使用NAT接通主机网络，另一个网卡为非NAT，并将需要由Openwrt路由的VM置于其中。

首先我们需要创建一个仅内网虚拟机用的子网，即Openwrt的LAN口所在的网络，用于给其他VM提供网络。

1
incus network create lablan \
2
  ipv4.address=192.168.50.254/24 \ # 这里可以填成想要的其他网段
3
  ipv4.dhcp=false \
4
  ipv4.nat=false \
5
  ipv6.address=none \
6
  dns.mode=none

安装Openwrt系统，这里直接使用eSir大佬集成好基本插件的固件。

1
cd ~/Downloads
2
# 解压为img
3
gzip -dk 'openwrt-stable-24.10.5-buddha-version-v1[2026]-x86-64-generic-squashfs-uefi.img.gz'
4
ls -lh *.img

从硬盘镜像导入incus VM，需要使用incus-tools

1
sudo dnf install incus-tools
2

3
sudo incus-migrate
4
The local Incus server is the target [default=yes]:
5

6
What would you like to create?
7
1) Container
8
2) Virtual Machine
9
3) Virtual Machine (from .ova)
10
4) Custom Volume
11

12
Please enter the number of your choice: 2
13
Name of the new instance: openwrt
14
Please provide the path to a disk, partition, or qcow2/raw/vmdk image file: /home/zero/Downloads/openwrt-stable-24.10.5-buddha-version-v1[2026]-x86-64-generic-squashfs-uefi.img
15
Does the VM support UEFI booting? [default=yes]:
16
Does the VM support UEFI Secure Boot? [default=yes]: no
17

18
Instance to be created:
19
  Name: openwrt
20
  Project: default
21
  Type: virtual-machine
22
  Source: /home/zero/Downloads/openwrt-stable-24.10.5-buddha-version-v1[2026]-x86-64-generic-squashfs-uefi.img
23
  Source format: raw
24
  Config:
25
    security.secureboot: "false"
26

27
Additional overrides can be applied at this stage:
28
1) Begin the migration with the above configuration
29
2) Override profile list
30
3) Set additional configuration options
31
4) Change instance storage pool or volume size
32
5) Change instance network
33
6) Add additional disk
34
7) Change additional disk storage pool
35

36
Please pick one of the options above [default=1]: 1
37
Instance openwrt successfully created

为Openwrt添加LAN口网卡（WAN口的NAT是默认配置，不需要手动添加）：

1
incus config device add openwrt lan nic network=lablan   hwaddr=00:16:3e:50:00:02

进入Openwrt进行网络配置：

1
incus start openwrt --console
2
# 这里可能最后需要手动按一下Enter才能进入shell

1
vim /etc/config/network
2

3
config interface 'loopback'
4
        option device 'lo'
5
        option proto 'static'
6
        option ipaddr '127.0.0.1'
7
        option netmask '255.0.0.0'
8

9
config globals 'globals'
10
        option ula_prefix 'fda8:dbe1:e3c9::/48'
11
        option packet_steering '1'
12

13
config device
14
        option name 'br-lan'
15
        option type 'bridge'
16
        list ports 'eth1' # 这里填ip list里那张LAN口对应的网卡，默认的eth0应该是NAT卡，所以这里通常应该需要是eth1
17

18
config interface 'lan'
19
        option device 'br-lan'
20
        option proto 'static'
21
        option ipaddr '192.168.50.2' # 这里改成你LAN口所在网络的网段内，填2是怕与宿主机冲突
22
        option netmask '255.255.255.0'
23
        option ip6assign '60'
24

25
config interface 'wan'
26
        option device 'eth0' # 这里注意是eth0了
27
        option proto 'dhcp'
28

29
config interface 'wan6'
30
        option device 'eth0' # eth0
31
        option proto 'dhcpv6'
32

33

34
# 修改完后执行
35
/etc/init.d/network restart

之后打开设置的LAN地址即可访问到Openwrt的配置站点（这里是192.168.50.2）。

随后的问题就是如何将新建的/已有的VM设置为使用Openwrt做路由。首先我们先创建一个使用Openwrt路由的incus Profile，此后新建的VM只要使用这个Profile就会自动接入这个网络了，同理，已有的VM也可以通过使用该Profile接入Openwrt软路由。

1
incus profile create openwrt-lan
2
incus profile device add openwrt-lan eth0 nic network\=lablan name\=eth0
3
incus profile show openwrt-lan

将已有的VM的Profile覆盖为openwrt-lan（在incus中，Profile中的设置按层级关系确定，即高层覆盖低层，低层已定义但高层未修改的部分沿用）

1
# 先关闭相关的虚拟机
2
incus stop ubuntu24
3
# 指定Profile（覆盖)
4
incus profile assign ubuntu24 default,openwrt-lan
5
incus start ubuntu24

启动新虚拟机时指定Profile（incus中允许指定多个profile，后面的profile优先级更高）

1
incus launch images:ubuntu/24.04 ubuntu2 --profile default --profile openwrt-lan

incus VM/Container管理脚本#

为了方便incus的使用，Vibe Coding了一个TUI管理脚本，实现的功能有incus后台服务的启停、VM/Container管理，主要涉及状态管理、信息查询、快照的简单管理等。

1
#!/usr/bin/env bash
2
set -euo pipefail
3

4
SCRIPT_SELF="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)/$(basename -- "${BASH_SOURCE[0]}")"
5

6
need() {
7
  command -v "$1" >/dev/null 2>&1 || {
8
    printf '缺少命令: %s\n' "$1" >&2
9
    exit 1
10
  }
11
}
12

13
for cmd in incus fzf systemctl awk sed grep date; do
14
  need "$cmd"
15
done
16

17
RED=$'\033[31m'
18
GREEN=$'\033[32m'
19
YELLOW=$'\033[33m'
20
BOLD=$'\033[1m'
21
RESET=$'\033[0m'
22

23
SERVICE_SOCKET="incus.socket"
24
SERVICE_UNIT="incus.service"
25

26
fzf_has_footer=0
27
if fzf --help 2>&1 | grep -q -- '--footer'; then
28
  fzf_has_footer=1
29
fi
30

31
fzf_base=(
32
  --ansi
33
  --layout=reverse
34
  --height=100%
35
  --border
36
  --cycle
37
  --no-info
38
  --tabstop=8
39
)
40

41
service_running() {
42
  systemctl is-active --quiet "$SERVICE_SOCKET" &&
43
    systemctl is-active --quiet "$SERVICE_UNIT"
44
}
45

46
service_emoji() {
47
  if service_running; then
48
    printf '🟢'
49
  else
50
    printf '🔴'
51
  fi
52
}
53

54
service_action_text() {
55
  if service_running; then
56
    printf '停止相关服务'
57
  else
58
    printf '启动相关服务'
59
  fi
60
}
61

62
instance_state_emoji() {
63
  case "$1" in
64
  RUNNING) printf '🟢' ;;
65
  STOPPED | STOPPING) printf '🔴' ;;
66
  *) printf '🟡' ;;
67
  esac
68
}
69

70
sanitize_csv_field() {
71
  local v="${1:-}"
72
  v="${v#\"}"
73
  v="${v%\"}"
74
  printf '%s' "$v"
75
}
76

77
pause_msg() {
78
  printf '\n%b%s%b\n' "$BOLD" "$1" "$RESET" >&2
79
  printf '按回车继续...' >&2
80
  read -r _
81
}
82

83
confirm() {
84
  local prompt="${1:-确认？}"
85
  local ans
86
  local opts=("${fzf_base[@]}" --height=10 --prompt="$prompt > " --header='Enter 确认 / Esc 取消')
87
  ((fzf_has_footer)) && opts+=(--footer='Enter 确认  ·  Esc 取消')
88

89
  if ! ans="$(
90
    printf '%s\n' "否" "是" |
91
      fzf "${opts[@]}"
92
  )"; then
93
    return 1
94
  fi
95

96
  [[ "$ans" == "是" ]]
97
}
98

99
count_kind() {
100
  local kind="$1"
101
  local rows total=0 running=0 state
102

103
  if ! service_running; then
104
    printf '0\t0\n'
105
    return 0
106
  fi
107

108
  rows="$(incus list "type=$kind" -c s -f csv,noheader 2>/dev/null || true)"
109

110
  while IFS= read -r state; do
111
    [[ -z "${state:-}" ]] && continue
112
    state="$(sanitize_csv_field "$state")"
113
    ((total += 1))
114
    [[ "$state" == "RUNNING" ]] && ((running += 1))
115
  done <<<"$rows"
116

117
  printf '%s\t%s\n' "$total" "$running"
118
}
119

120
kind_cn() {
121
  case "$1" in
122
  virtual-machine) printf '虚拟机' ;;
123
  container) printf '容器' ;;
124
  *) printf '%s' "$1" ;;
125
  esac
126
}
127

128
main_statusline() {
129
  local vm_total vm_running ct_total ct_running service_text
130

131
  IFS=$'\t' read -r vm_total vm_running < <(count_kind "virtual-machine")
132
  IFS=$'\t' read -r ct_total ct_running < <(count_kind "container")
133

134
  if service_running; then
135
    service_text="$(printf '%b运行中%b' "$GREEN" "$RESET")"
136
  else
137
    service_text="$(printf '%b未启动%b' "$RED" "$RESET")"
138
  fi
139

140
  printf '服务: %s    VM: %s/%s    容器: %s/%s' \
141
    "$service_text" "$vm_running" "$vm_total" "$ct_running" "$ct_total"
142
}
143

144
render_main_row() {
145
  local key="$1"
146
  local icon="$2"
147
  local label="$3"
148
  printf '%s\t%s %s\n' "$key" "$icon" "$label"
149
}
150

151
render_action_row() {
152
  local key="$1"
153
  local icon="$2"
154
  local label="$3"
155
  printf '%s\t%s %s\n' "$key" "$icon" "$label"
156
}
157

158
instance_record() {
159
  local kind="$1"
160
  local name="$2"
161
  local out
162

163
  out="$(incus list "type=$kind" -c ns4S -f csv,noheader 2>/dev/null || true)"
164
  awk -F',' -v n="$name" '$1 == n { print; exit }' <<<"$out"
165
}
166

167
instance_meta() {
168
  local kind="$1"
169
  local name="$2"
170
  local row state ip snaps
171

172
  row="$(instance_record "$kind" "$name")"
173

174
  if [[ -z "$row" ]]; then
175
    printf 'UNKNOWN\t-\t0\n'
176
    return 0
177
  fi
178

179
  IFS=',' read -r _name state ip snaps <<<"$row"
180

181
  state="$(sanitize_csv_field "${state:-}")"
182
  ip="$(sanitize_csv_field "${ip:-}")"
183
  snaps="$(sanitize_csv_field "${snaps:-}")"
184

185
  [[ -z "$ip" ]] && ip="-"
186
  [[ -z "$snaps" ]] && snaps="0"
187

188
  printf '%s\t%s\t%s\n' "$state" "$ip" "$snaps"
189
}
190

191
render_instance_row() {
192
  local name="$1"
193
  local state="$2"
194

195
  printf '%s\t%s %s\n' \
196
    "$name" \
197
    "$(instance_state_emoji "$state")" \
198
    "$name"
199
}
200

201
build_instance_rows() {
202
  local kind="$1"
203
  local out name state
204

205
  if ! service_running; then
206
    printf '__SERVICE__\t🔴 Incus 服务未运行\n'
207
    return 0
208
  fi
209

210
  out="$(incus list "type=$kind" -c ns -f csv,noheader 2>/dev/null || true)"
211

212
  if [[ -z "${out//[$'\t\r\n ']/}" ]]; then
213
    printf '__EMPTY__\t📭 当前没有%s\n' "$(kind_cn "$kind")"
214
    return 0
215
  fi
216

217
  while IFS=',' read -r name state; do
218
    [[ -z "${name:-}" ]] && continue
219

220
    name="$(sanitize_csv_field "$name")"
221
    state="$(sanitize_csv_field "${state:-}")"
222

223
    render_instance_row "$name" "$state"
224
  done <<<"$out"
225
}
226

227
toggle_service() {
228
  if service_running; then
229
    confirm "停止 Incus 相关服务？" || return 0
230
    sudo systemctl stop "$SERVICE_SOCKET" "$SERVICE_UNIT"
231
  else
232
    confirm "启动 Incus 相关服务？" || return 0
233
    sudo systemctl start --now "$SERVICE_SOCKET" "$SERVICE_UNIT"
234
  fi
235
}
236

237
toggle_instance() {
238
  local kind="$1"
239
  local name="$2"
240
  local state ip snaps
241

242
  IFS=$'\t' read -r state ip snaps < <(instance_meta "$kind" "$name")
243

244
  if [[ "$state" == "RUNNING" ]]; then
245
    incus stop "$name"
246
  else
247
    incus start "$name"
248
  fi
249
}
250

251
launch_vm_vga() {
252
  local name="$1"
253

254
  if ! command -v remote-viewer >/dev/null 2>&1 && ! command -v spicy >/dev/null 2>&1; then
255
    pause_msg "未检测到 SPICE 客户端（remote-viewer 或 spicy），无法打开 VGA 控制台。"
256
    return 0
257
  fi
258

259
  if command -v setsid >/dev/null 2>&1; then
260
    setsid -f sh -c '
261
      exec incus console "$1" --type=vga >/dev/null 2>&1 </dev/null
262
    ' sh "$name" || true
263
  else
264
    nohup sh -c '
265
      exec incus console "$1" --type=vga >/dev/null 2>&1 </dev/null
266
    ' sh "$name" >/dev/null 2>&1 &
267
    disown 2>/dev/null || true
268
  fi
269
}
270

271
enter_container_shell() {
272
  local name="$1"
273

274
  clear
275
  incus exec "$name" -- sh -lc '
276
    if command -v bash >/dev/null 2>&1; then
277
      exec bash -l
278
    elif command -v ash >/dev/null 2>&1; then
279
      exec ash
280
    else
281
      exec sh
282
    fi
283
  '
284
}
285

286
snapshot_show_any() {
287
  local inst="$1"
288
  local snap="$2"
289
  incus snapshot show "$inst" "$snap" 2>/dev/null ||
290
    incus snapshot show "$inst/$snap" 2>/dev/null ||
291
    true
292
}
293

294
snapshot_delete_any() {
295
  local inst="$1"
296
  local snap="$2"
297
  incus snapshot delete "$inst" "$snap" 2>/dev/null ||
298
    incus snapshot delete "$inst/$snap" 2>/dev/null ||
299
    true
300
}
301

302
build_snapshot_rows() {
303
  local inst="$1"
304
  local out snap taken expires stateful mode
305

306
  printf '__CREATE__\t🆕 新建快照（时间戳）\n'
307

308
  out="$(incus snapshot list "$inst" -c nTEs -f csv,noheader 2>/dev/null || true)"
309

310
  while IFS=',' read -r snap taken expires stateful; do
311
    [[ -z "${snap:-}" ]] && continue
312

313
    snap="$(sanitize_csv_field "${snap:-}")"
314
    taken="$(sanitize_csv_field "${taken:-}")"
315
    expires="$(sanitize_csv_field "${expires:-}")"
316
    stateful="$(sanitize_csv_field "${stateful:-}")"
317

318
    [[ -z "$expires" ]] && expires="-"
319

320
    mode="disk-only"
321
    case "$stateful" in
322
    true | TRUE | yes | YES) mode="stateful" ;;
323
    esac
324

325
    printf '%s\t📸 %s\t%s\t%s\t%s\n' \
326
      "$snap" "$snap" "$taken" "$expires" "$mode"
327
  done <<<"$out"
328
}
329

330
preview_main() {
331
  local vm_total vm_running ct_total ct_running
332

333
  printf '%bIncus 总览%b\n' "$BOLD" "$RESET"
334
  printf '%s\n\n' '=============================='
335

336
  if service_running; then
337
    printf '服务状态 : %b运行中%b\n' "$GREEN" "$RESET"
338
  else
339
    printf '服务状态 : %b未启动%b\n' "$RED" "$RESET"
340
  fi
341

342
  IFS=$'\t' read -r vm_total vm_running < <(count_kind "virtual-machine")
343
  IFS=$'\t' read -r ct_total ct_running < <(count_kind "container")
344

345
  printf '虚拟机   : %s / %s 运行中\n' "$vm_running" "$vm_total"
346
  printf '容器     : %s / %s 运行中\n' "$ct_running" "$ct_total"
347

348
  printf '\n%b说明%b\n' "$BOLD" "$RESET"
349
  printf '• 左侧列表只显示状态与名称\n'
350
  printf '• 详细信息请看右侧预览\n'
351
  printf '• VGA 控制台会后台打开，不阻塞当前 TUI\n'
352
  printf '• 容器连接会进入交互式 shell\n'
353
}
354

355
preview_instance() {
356
  local kind="$1"
357
  local name="$2"
358
  local state ip snaps
359

360
  if [[ "$name" == "__EMPTY__" ]]; then
361
    printf '%b%s%b\n' "$BOLD" "列表为空" "$RESET"
362
    printf '%s\n\n' '=============================='
363
    printf '当前没有%s。\n' "$(kind_cn "$kind")"
364
    printf '你仍然可以按 Esc 返回上一级。\n'
365
    return 0
366
  fi
367

368
  if [[ "$name" == "__SERVICE__" ]]; then
369
    printf '%b%s%b\n' "$BOLD" "服务未运行" "$RESET"
370
    printf '%s\n\n' '=============================='
371
    printf 'Incus 服务当前未启动。\n'
372
    printf '请先回到主页启动相关服务。\n'
373
    return 0
374
  fi
375

376
  IFS=$'\t' read -r state ip snaps < <(instance_meta "$kind" "$name")
377

378
  printf '%b实例概览%b\n' "$BOLD" "$RESET"
379
  printf '%s\n\n' '=============================='
380
  printf '名称     : %s\n' "$name"
381
  printf '类型     : %s\n' "$(kind_cn "$kind")"
382
  printf '状态     : %s\n' "$state"
383
  printf 'IPv4     : %s\n' "$ip"
384
  printf '快照数   : %s\n' "$snaps"
385

386
  printf '\n%b详细信息%b\n' "$BOLD" "$RESET"
387
  printf '%s\n' '------------------------------'
388
  incus info "$name" 2>/dev/null | sed -n '1,40p' || true
389
}
390

391
preview_snapshot() {
392
  local inst="$1"
393
  local snap="$2"
394

395
  printf '%b快照概览%b\n' "$BOLD" "$RESET"
396
  printf '%s\n\n' '=============================='
397
  printf '实例     : %s\n' "$inst"
398
  printf '快照     : %s\n\n' "$snap"
399
  snapshot_show_any "$inst" "$snap"
400
}
401

402
main_menu() {
403
  while true; do
404
    local header selected opts=()
405

406
    header="$(printf '%b%s%b\n%s' \
407
      "$BOLD" "Incus 面板" "$RESET" \
408
      "$(main_statusline)")"
409

410
    opts=(
411
      "${fzf_base[@]}"
412
      --delimiter=$'\t'
413
      --with-nth=2
414
      --prompt='主页 > '
415
      --header="$header"
416
      --preview="$SCRIPT_SELF __preview_main"
417
      --preview-window='right:56%:wrap:noinfo'
418
    )
419
    ((fzf_has_footer)) && opts+=(--footer='Enter 选择  ·  Esc 退出')
420

421
    if ! selected="$(
422
      {
423
        render_main_row "svc" "$(service_emoji)" "$(service_action_text)"
424
        render_main_row "vms" "🖥️" "虚拟机列表"
425
        render_main_row "cts" "📦" "容器列表"
426
        render_main_row "ext" "🚪" "退出"
427
      } | fzf "${opts[@]}"
428
    )"; then
429
      break
430
    fi
431

432
    case "${selected%%$'\t'*}" in
433
    svc) toggle_service ;;
434
    vms) instance_list_menu "virtual-machine" ;;
435
    cts) instance_list_menu "container" ;;
436
    ext) break ;;
437
    esac
438
  done
439
}
440

441
instance_list_menu() {
442
  local kind="$1"
443
  local rows selected name header total running opts=()
444

445
  while true; do
446
    rows="$(build_instance_rows "$kind")"
447
    IFS=$'\t' read -r total running < <(count_kind "$kind")
448

449
    header="$(printf '%b%s列表%b\n总数: %s    运行中: %s' \
450
      "$BOLD" "$(kind_cn "$kind")" "$RESET" \
451
      "$total" "$running")"
452

453
    opts=(
454
      "${fzf_base[@]}"
455
      --delimiter=$'\t'
456
      --with-nth=2
457
      --prompt="$(kind_cn "$kind") > "
458
      --header="$header"
459
      --preview="\"$SCRIPT_SELF\" __preview_instance '$kind' {1}"
460
      --preview-window='right:56%:wrap:noinfo'
461
    )
462
    ((fzf_has_footer)) && opts+=(--footer='Enter 实例菜单  ·  Esc 返回')
463

464
    if ! selected="$(
465
      printf '%s\n' "$rows" | fzf "${opts[@]}"
466
    )"; then
467
      return 0
468
    fi
469

470
    name="${selected%%$'\t'*}"
471

472
    case "$name" in
473
    __EMPTY__ | __SERVICE__)
474
      continue
475
      ;;
476
    *)
477
      instance_menu "$kind" "$name"
478
      ;;
479
    esac
480
  done
481
}
482

483
instance_menu() {
484
  local kind="$1"
485
  local name="$2"
486

487
  while true; do
488
    local state ip snaps header selected toggle_key connect_key opts=()
489

490
    IFS=$'\t' read -r state ip snaps < <(instance_meta "$kind" "$name")
491

492
    if [[ "$state" == "RUNNING" ]]; then
493
      toggle_key="stop"
494
    else
495
      toggle_key="start"
496
    fi
497

498
    if [[ "$kind" == "virtual-machine" ]]; then
499
      connect_key="vga"
500
    else
501
      connect_key="shell"
502
    fi
503

504
    header="$(printf '%b%s%b\n状态: %s    IP: %s    快照: %s' \
505
      "$BOLD" "$name" "$RESET" "$state" "$ip" "$snaps")"
506

507
    opts=(
508
      "${fzf_base[@]}"
509
      --delimiter=$'\t'
510
      --with-nth=2
511
      --prompt="${name} > "
512
      --header="$header"
513
      --preview="\"$SCRIPT_SELF\" __preview_instance '$kind' '$name'"
514
      --preview-window='right:56%:wrap:noinfo'
515
    )
516
    ((fzf_has_footer)) && opts+=(--footer='Enter 执行  ·  Esc 返回')
517

518
    if ! selected="$(
519
      {
520
        if [[ "$toggle_key" == "stop" ]]; then
521
          render_action_row "stop" "⏹️" "停止实例"
522
        else
523
          render_action_row "start" "▶️" "启动实例"
524
        fi
525

526
        if [[ "$connect_key" == "vga" ]]; then
527
          render_action_row "vga" "🖥️" "后台打开 VGA 控制台"
528
        else
529
          render_action_row "shell" "⌨️" "进入容器 Shell"
530
        fi
531

532
        render_action_row "snap" "📸" "快照管理"
533
        render_action_row "back" "⬅️" "返回"
534
      } | fzf "${opts[@]}"
535
    )"; then
536
      return 0
537
    fi
538

539
    case "${selected%%$'\t'*}" in
540
    start | stop)
541
      toggle_instance "$kind" "$name"
542
      ;;
543
    vga)
544
      launch_vm_vga "$name"
545
      ;;
546
    shell)
547
      enter_container_shell "$name"
548
      ;;
549
    snap)
550
      snapshot_menu "$name"
551
      ;;
552
    back)
553
      return 0
554
      ;;
555
    esac
556
  done
557
}
558

559
snapshot_menu() {
560
  local inst="$1"
561

562
  while true; do
563
    local rows selected snap header opts=()
564

565
    rows="$(build_snapshot_rows "$inst")"
566

567
    header="$(printf '%b快照管理%b\n实例: %s' \
568
      "$BOLD" "$RESET" "$inst")"
569

570
    opts=(
571
      "${fzf_base[@]}"
572
      --delimiter=$'\t'
573
      --with-nth=2,3,4,5
574
      --prompt="快照 > "
575
      --header="$header"
576
      --preview="if [ {1} = __CREATE__ ]; then printf '将使用时间戳创建新快照\n'; else \"$SCRIPT_SELF\" __preview_snapshot '$inst' {1}; fi"
577
      --preview-window='right:56%:wrap:noinfo'
578
    )
579
    ((fzf_has_footer)) && opts+=(--footer='Enter 选择  ·  Esc 返回')
580

581
    if ! selected="$(
582
      printf '%s\n' "$rows" | fzf "${opts[@]}"
583
    )"; then
584
      return 0
585
    fi
586

587
    snap="${selected%%$'\t'*}"
588

589
    if [[ "$snap" == "__CREATE__" ]]; then
590
      incus snapshot create "$inst" "snap-$(date +%Y%m%d-%H%M%S)"
591
      continue
592
    fi
593

594
    snapshot_action_menu "$inst" "$snap"
595
  done
596
}
597

598
snapshot_action_menu() {
599
  local inst="$1"
600
  local snap="$2"
601

602
  while true; do
603
    local header selected opts=()
604

605
    header="$(printf '%b%s/%s%b\n选择快照操作' \
606
      "$BOLD" "$inst" "$snap" "$RESET")"
607

608
    opts=(
609
      "${fzf_base[@]}"
610
      --delimiter=$'\t'
611
      --with-nth=2
612
      --prompt="快照操作 > "
613
      --header="$header"
614
      --preview="\"$SCRIPT_SELF\" __preview_snapshot '$inst' '$snap'"
615
      --preview-window='right:56%:wrap:noinfo'
616
    )
617
    ((fzf_has_footer)) && opts+=(--footer='Enter 执行  ·  Esc 返回')
618

619
    if ! selected="$(
620
      {
621
        render_action_row "restore" "⏪" "恢复快照"
622
        render_action_row "diskonly" "💽" "仅恢复磁盘"
623
        render_action_row "rename" "✏️" "重命名快照"
624
        render_action_row "delete" "🗑️" "删除快照"
625
        render_action_row "back" "⬅️" "返回"
626
      } | fzf "${opts[@]}"
627
    )"; then
628
      return 0
629
    fi
630

631
    case "${selected%%$'\t'*}" in
632
    restore)
633
      confirm "恢复 ${inst}/${snap}？" || continue
634
      incus snapshot restore "$inst" "$snap"
635
      ;;
636
    diskonly)
637
      confirm "仅恢复 ${inst}/${snap} 的磁盘状态？" || continue
638
      incus snapshot restore "$inst" "$snap" --diskonly
639
      ;;
640
    rename)
641
      printf '新快照名: '
642
      read -r newname
643
      [[ -n "${newname:-}" ]] || continue
644
      incus snapshot rename "$inst" "$snap" "$newname"
645
      snap="$newname"
646
      ;;
647
    delete)
648
      confirm "删除 ${inst}/${snap}？" || continue
649
      snapshot_delete_any "$inst" "$snap"
650
      return 0
651
      ;;
652
    back)
653
      return 0
654
      ;;
655
    esac
656
  done
657
}
658

659
case "${1:-}" in
660
__preview_main)
661
  preview_main
662
  exit 0
663
  ;;
664
__preview_instance)
665
  preview_instance "$2" "$3"
666
  exit 0
667
  ;;
668
__preview_snapshot)
669
  preview_snapshot "$2" "$3"
670
  exit 0
671
  ;;
672
esac
673

674
main_menu