如何在VPS上部署Incus系统容器
了解Incus系统容器与Docker的区别,并在VPS上完成虚拟化检查、存储池和网络配置,同时识别嵌套容器及内核版本导致的常见故障。
什么是 Incus 系统容器
VPS 上的 Incus 系统容器提供的是一台拥有独立 init 系统和用户账户的完整机器,而不是附带文件系统的单个进程。容器会启动,以 PID 1 运行 init,并由自身的服务管理器管理。在 Debian 和 Ubuntu 等使用 systemd 的镜像中,该服务管理器是 systemctl;在使用 OpenRC 的 Alpine 中,则是 rc-service。容器与主机共享内核,因此不是虚拟机。除内核外的所有部分,其行为都类似于一台独立机器。
Incus 是 LXD 的社区分支,由 Linux Containers 项目维护。其客户端命令是 incus。传入 --vm 时,它还可以通过 QEMU 运行真正的虚拟机。但大多数人安装 Incus 的主要原因是使用系统容器,本文其余内容也将介绍系统容器。
Docker 对比为何会误导用户
Docker 打包一个进程。Incus 打包一个操作系统。Incus 文档直接说明了这种区别:“应用容器(例如 Docker 提供的容器)打包单个进程或应用。系统容器则模拟完整的操作系统,类似于主机或虚拟机中运行的操作系统。”
这种区别会改变您日常管理它的方式。
- Docker 容器通常直接运行应用,因此其中的
systemctl在没有运行中的 systemd init 时会失败。Incus 容器运行 init 系统,因此服务和定时器的工作方式与服务器上的相同。 - Docker 容器通常应根据 Dockerfile 销毁并重新构建。Incus 容器则用于保留、打补丁和创建快照。
- Docker 镜像是要推送到注册表的构建产物。Incus 实例是存储池中的磁盘状态,应使用
incus export移动。 - Docker 隔离工作负载。Incus 隔离整台机器,因此一个容器可以承载多个工作负载和多个用户账户。
您可以在 Incus 系统容器中运行 Docker。Incus 还记录了由第三方提供的 Docker 镜像,可用于在特权 Docker 容器中运行 Incus。如果您实际需要的是每个容器运行一个进程,并通过镜像构建步骤生成容器,请先阅读 VPS 上的 Podman 和 Docker,其中会比较这两种方案。如果您希望每个工作负载使用独立内核,而不是共享内核,请阅读 VPS 上的 Firecracker microVM,该方案的方向相反。
Incus 能在 VPS 中运行吗?
这取决于 VPS 的虚拟化类型和内核,因此安装前应同时检查这两项。不要仅依据服务商的宣传页面判断。在服务器上运行以下 4 条命令。
systemd-detect-virt
uname -r
stat -fc %T /sys/fs/cgroup
cat /sys/fs/cgroup/cgroup.controllerssystemd-detect-virt 输出 kvm 或 qemu,表示 VPS 是拥有独立内核的虚拟机。这是较简单的情况,因为 Incus 在其中的行为与运行在物理硬件上相同。lxc、lxc-libvirt 或 openvz 输出,表示 VPS 本身是与服务商共享内核的容器。在其中运行的 Incus 容器属于嵌套容器,只有服务商为你的容器启用了嵌套功能时才能运行。你无法在容器内部启用该功能,因为此设置位于你无法控制的宿主机上。
stat -fc %T /sys/fs/cgroup 应输出 cgroup2fs。输出其他内容表示服务器使用 cgroup(控制组)v1 或混合布局,而当前 Incus 不以此为目标环境。
cat /sys/fs/cgroup/cgroup.controllers 会列出该 cgroup 可用于启用的控制组控制器。Incus 文档将 blkio、cpuset、devices、freezer、memory 和 pids 列为必需项。这些名称不对应 cgroup v2 文件中的逐项检查清单:块 I/O 使用 io,设备过滤使用 BPF,冻结功能使用 cgroup.freeze。在嵌套 VPS 中,该列表通常比 KVM VPS 更短,因为服务商决定向下层提供哪些控制器。缺少某个资源控制器时,子 cgroup 无法启用它,因此依赖该控制器的实例限制对你不可用。
内核版本的重要性比过去更高。截至 2026 年 10 月,上游同时维护 2 个 LTS(长期支持)系列,即 6.0 和 7.0,并持续发布当前功能版本;这些版本系列的最低要求并不相同。6.0 LTS 文档写明:“支持的最低内核版本为 5.4。”当前文档写明:“支持的最低内核版本为 6.12。”2026 年 5 月发布的 7.0 LTS 公告则将 Linux 6.12 列为最低要求之一。同一公告还说明 6.0 LTS 已进入仅提供安全更新的阶段。Ubuntu 24.04 在自己的仓库中提供 6.0 LTS 系列软件包,并配套使用 6.8 内核,这是受支持的组合。若在同一内核版本为 6.8 的系统上,从 Zabbly 第三方仓库安装 stable 或 7.0 LTS 构建版本,就会低于文档规定的最低版本,因此选择仓库前应阅读 uname -r。
如果你的目标是运行完整虚拟机,而不是容器,限制条件会不同,也更严格。请参阅VPS 中的嵌套虚拟化,了解 VPS 是否能够提供 /dev/kvm;如果硬件归你所有,请参阅在租用的 VPS 上运行 Proxmox。
在 Ubuntu 或 Debian 上安装 Incus
Debian 13、Ubuntu 24.04 及更高版本会在各自的软件仓库中提供 Incus。
sudo apt update
sudo apt install -y incus在 Debian 上,incus-base 会安装容器支持,但不包含虚拟机组件。在 Ubuntu 上,如果还需要 --vm 实例,请添加 qemu-system。
如果需要的版本比发行版提供的版本更新,Zabbly 会在 pkgs.zabbly.com 提供第三方软件包。Incus 上游发布的是 tarball,而不是官方软件包。该软件仓库提供 lts-6.0、lts-7.0 和 stable 通道。下面的命令取自 Zabbly 软件仓库的 README,使用的是 stable。如果内核需要 LTS 系列,请同时替换文件名中的通道名称和 URIs: 行中的通道名称。
sudo apt update && sudo apt install -y curl
sudo mkdir -p /etc/apt/keyrings/
sudo curl -fsSL https://pkgs.zabbly.com/key.asc -o /etc/apt/keyrings/zabbly.asc
sudo sh -c 'cat <<EOF > /etc/apt/sources.list.d/zabbly-incus-stable.sources
Enabled: yes
Types: deb
URIs: https://pkgs.zabbly.com/incus/stable
Suites: $(. /etc/os-release && echo ${VERSION_CODENAME})
Components: main
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/zabbly.asc
EOF'
sudo apt-get update
sudo apt-get install -y incus然后让您的用户访问守护进程套接字。
sudo usermod -aG incus-admin "$USER"
newgrp incus-admin
incus infoincus info 输出服务器配置,表示套接字可以正常使用。如果出现权限错误,说明组变更尚未应用到当前 shell;newgrp incus-admin 会为当前 shell 修复此问题,重新登录则会正确生效。应将加入 incus-admin 视为拥有主机上的 root 级权限,因为访问该套接字就等于完全控制以 root 身份运行的守护进程。一些发行版还会创建普通的 incus 组,用于受限的用户访问。
现在初始化守护进程。
sudo incus admin init请回答这些问题,不要直接使用 incus admin init --minimal。最小化路径会选择 dir 存储驱动;但如果底层文件系统是 Btrfs 且该驱动可用,则不会选择该驱动。下一节将说明这一选择为何会持续影响后续配置。
启动一个实例并确认其正常工作。
incus launch images:debian/13 web
incus list
incus exec web -- bashincus list 应显示 web 的状态为 RUNNING,并在 incusbr0 子网中拥有一个 IPv4 地址。没有地址表示 DHCP(动态主机配置协议)未完成,网络部分会介绍该问题。启动失败的容器会在 incus info web --show-log 中打印失败原因,守护进程级别的故障会记录在 sudo journalctl -u incus -n 50 中。在 systemd-detect-virt 返回 lxc 或 openvz 的 VPS 上,这次启动是确认您是否能够使用嵌套功能的实际测试。
为什么默认存储后端很重要
存储后端决定快照是即时完成,还是完整复制容器磁盘。这是安装时唯一一个之后无法低成本更改的选择。
Incus 支持 dir、btrfs、lvm、zfs、Ceph 以及多个远程驱动。在单磁盘 VPS 上,实际需要在 dir 和 btrfs 之间选择。
dir 驱动会将每个容器保存为 /var/lib/incus 下的普通文件和目录。Incus 文档称其“比其他所有驱动都慢得多”,因为它必须解包每个镜像并创建实际副本,而不是引用共享块。在 Incus 功能对比中,只有该驱动不支持优化的快照创建。因此,在 dir 存储池上,对 4 GiB 容器创建快照时会完整复制磁盘:写入 4 GiB 数据,耗时与复制同等数据量相同。在 btrfs、lvm 或 zfs 上,同样的快照会经过优化,不会复制整个磁盘。磁盘配额仅在 ext4 或 XFS 启用项目配额时有效。大多数 VPS 镜像默认未启用该功能,因此 dir 存储池上的磁盘限制通常不会生效。
btrfs 和 zfs 使用写时复制,因此快照只记录创建后发生变化的块。Incus 将这两种驱动列为推荐的后端。快照几乎可以即时完成。磁盘配额通过文件系统自身的配额支持实现。
大多数 VPS 方案只提供一个磁盘,没有空闲分区,因此应将存储池放在 loop 文件中。不提供 source= 时,Incus 会自动完成此配置。
sudo apt install -y btrfs-progs
incus storage create fast btrfs size=30GiB
incus profile device set default root pool=fast
incus launch images:debian/13 web2 -s fast不设置 size= 时,基于 loop 的存储池会占用可用磁盘空间的 20%,最小为 5 GiB,最大为 30 GiB。请明确设置该值。存储池达到自身大小后就会停止扩展,因此即使主机仍有可用空间,存储池也可能先写满。这是基于 loop 的存储池耗尽空间的常见原因。loop 文件本身位于主机文件系统中,因此设置存储池大小时还要考虑主机自身的空间需求,不要将所有可用空间都分配给它。
Debian 上的 ZFS 使用 DKMS 模块,因此每次升级内核时都会重新构建,并且可能在某次升级后构建失败。Ubuntu 将 ZFS 包含在默认的 Linux 内核软件包中。在 Debian 上,btrfs 可以避免这项 DKMS 维护工作。
三种网络模式及其各自的暴露范围
接受推荐答案后,incus admin init 会创建名为 incusbr0 的受管网桥,并将其附加到 default 配置文件。因此,使用该配置文件创建的新实例都会连接到此网桥。您也可以改用现有网桥或接口。受管网桥是连接容器的三种方式之一。另外两种方式之所以存在,是因为第一种方式会通过 NAT(网络地址转换)将容器隐藏在后面。
受管网桥。 incusbr0 会获得一个私有子网。主机会占用该子网的第一个地址并充当网关,Incus 会在该子网上运行 DHCP 和 DNS(域名系统)。出站流量通过主机的公网地址离开,并执行源 NAT。除非您明确配置,否则外部无法访问容器。使用 proxy 设备转发端口。
incus config device add web http proxy listen=tcp:203.0.113.10:8080 connect=tcp:0.0.0.0:80 nat=true将 203.0.113.10 替换为主机的公网 IPv4 地址。通配符连接地址会选择实例的 IPv4 地址。在 6.0 LTS 上,添加 NAT proxy 之前,请先在实例的 Incus 网卡上配置静态地址。
nat=true 使用 netfilter 规则进行转发,而不是通过单独的用户空间连接代理,因此客户端的真实地址会保留在容器日志中。Incus 仅在主机是实例网关时支持此模式,这正是 incusbr0 情况。
macvlan。 容器会在主机的物理网络上获得自己的 MAC(介质访问控制)地址。在大多数 VPS 平台上,这种方式会失败,因为虚拟交换机端口绑定的是虚拟机的 MAC 地址,并会丢弃其他 MAC 地址发出的帧。即使 macvlan 能够正常工作,还有一个限制也经常导致问题。Incus 文档指出:“macvlan 设备可以彼此通信,也可以与外部通信,但无法与其父设备通信。这意味着,如果实例需要与主机本身通信,就不能使用 macvlan。”
路由模式。 这是在具有额外地址的 VPS 上通常可用的模式。Incus 文档将该设备描述为:“创建一对虚拟设备以连接主机和实例,并设置静态路由以及代理 ARP/NDP 条目,使实例能够加入指定父接口所在的网络。”ARP 是地址解析协议。容器会保留一个公网地址。主机会为该地址响应 ARP,因此服务商看到的仍然只有主机的 MAC 地址。
incus config device add web eth0 nic nictype=routed parent=enp1s0 ipv4.address=203.0.113.20从主机上的 ip route show default 获取父接口名称。该名称由 VPS 自身的内核和镜像决定,可能是 enp1s0 或 ens3 这类可预测名称,而不是 eth0,因此请读取实际名称,不要自行猜测。在容器内部,接口名称不同:Incus 文档说明,default 配置文件中的网络接口“会在实例中变为 eth0”。将设备命名为 eth0 会覆盖 default 配置文件提供的设备,因此容器最终会连接到路由接口,而不是网桥。进入容器后,使用 ip a 和 ip route 检查结果。
容器为何能够访问主机上的服务
incusbr0上的容器拥有独立的网络命名空间。但这并不构成针对主机的防火墙边界。托管的 Incus 网桥添加的防火墙规则,按文档中的说法,是“确保完整功能”,而不是将主机隔离在外。主机通过网关地址连接到该网桥,因此从容器内部看,主机是可直接访问的邻居。除非主机防火墙规则丢弃数据包,否则所有绑定到 0.0.0.0 的主机服务都会在该地址响应。
请自行检查。在主机上列出正在监听的服务。
sudo ss -tlnp然后从容器内部,访问 ip route 报告的网关。
ip route show default
nc -zv 10.0.0.1 6379如果主机上的数据库、指标端点或管理面板绑定到 0.0.0.0,且主机防火墙没有阻止来自网桥的数据包,该检查就会成功。数据包从未离开这台机器,因此提供商的网络防火墙根本没有看到它。这就是大多数“它怎么能访问到那个服务”的问题背后的原因:NAT 将容器与互联网隔离,而容器与主机之间的隔离程度,只取决于主机防火墙实施的规则。
尽可能将主机服务绑定到 127.0.0.1。然后在主机上过滤来自网桥的流量。在使用 ufw 的主机上,默认拒绝策略已经会阻止容器访问主机,但这也会破坏 Incus 的 DNS 和 DHCP。Incus 文档给出的修复方法是 sudo ufw allow in on incusbr0。该命令会重新允许所有容器访问主机上的每个端口。应改为仅允许容器实际需要的端口。
sudo ufw allow in on incusbr0 to any port 53 proto udp
sudo ufw allow in on incusbr0 to any port 53 proto tcp
sudo ufw allow in on incusbr0 to any port 67 proto udp
sudo ufw route allow in on incusbr0
sudo ufw route allow out on incusbr0这两条 ufw route 规则允许实例流量经过主机访问互联网。没有这些规则,ufw 的路由策略会丢弃转发的数据包,因此容器虽然能够获取地址,却无法访问任何目标。
快照和配置文件
快照是存储池中实例在某个时间点的副本。
incus snapshot create web pre-upgrade
incus info web
incus snapshot restore web pre-upgrade
incus snapshot delete web pre-upgradeincus info web 列出实例持有的快照。按实例分别设置快照计划。
incus config set web snapshots.schedule=@daily
incus config set web snapshots.expiry=4w快照位于同一个存储池、同一块磁盘和同一台服务器上。它可以防止升级失败,但无法防止磁盘损坏或实例被删除。备份使用 incus export,并且必须将文件复制到服务器之外。
incus export web /root/web-backup.tar.gz
incus import /root/web-backup.tar.gz配置文件是一组命名的配置键和设备,可应用于实例。除非另行指定,每个实例都会获得 default 配置文件;该配置文件为实例提供根磁盘和网络接口。编辑 default 会影响所有使用它的实例。这很有用,但也意味着可以一次性断开 20 个容器的网络。
incus profile create small
incus profile set small limits.memory=512MiB
incus profile set small limits.cpu=1
incus launch images:debian/13 api -p default -p small配置文件按顺序应用,因此最后列出的配置文件中的键具有最高优先级。使用 incus config show api --expanded 查看实例最终实际获得的配置。
在 Incus 容器中运行 Docker
在 Incus 系统容器中运行 Docker 时,必须启用嵌套功能。因为 Docker 会创建自己的命名空间和挂载,而容器默认无权执行这些操作。
incus config set web security.nesting=true
incus restart webIncus 将 security.nesting 说明为“是否允许在实例内部进行嵌套”,容器的默认值为 false。Incus FAQ 还直接说明了另外两点。容器无法加载内核模块,因此 Docker 需要的模块必须在宿主机上加载,并通过 incus config set web linux.kernel_modules overlay,br_netfilter 列出。在容器内创建 /.dockerenv 文件后,Docker 会跳过一些在嵌套环境中会失败的检查。
在 Ubuntu 24.04 宿主机上,AppArmor 对非特权用户命名空间的限制可能会阻止 runc 执行 pivot_root。容器内的 Docker 会输出:
failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: error jailing process inside rootfs: pivot_root .: permission denied宿主机上的 dmesg 会显示包含 apparmor="DENIED" operation="pivotroot" class="mount" 的行。许多人会尝试修改 kernel.apparmor_restrict_unprivileged_userns。关闭这项限制并不是可靠的修复方法:针对这一确切拒绝事件的 Incus 上游 bug 报告记录表明,将其设置为 0 仍未解决问题。请先阅读 dmesg 中的拒绝记录,确认问题确实由 AppArmor 导致,再修改安全默认设置。
如果您希望直接在 VPS 上运行容器并跳过一层,在 VPS 上运行 Docker 将单独介绍这种配置。
故障现象及对应提示信息
在主机上安装 Docker 后,实例失去所有网络连接。 Incus 文档说明了原因:“Docker 会将全局 FORWARD 策略设置为 drop,从而阻止 Incus 转发流量,导致实例失去网络连接。”实例仍保留 IP 地址,但无法访问任何目标。将 ip-forward-no-drop 设置为 true,写入 /etc/docker/daemon.json,然后使转发设置持久化,并允许网桥通过 Docker 自己的链。
echo "net.ipv4.conf.all.forwarding=1" | sudo tee /etc/sysctl.d/99-forwarding.conf
sudo systemctl restart systemd-sysctl
sudo iptables -I DOCKER-USER -i incusbr0 -j ACCEPT
sudo iptables -I DOCKER-USER -o incusbr0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT这些 iptables 规则不会自动跨重启保留。请将其持久化。
容器因 cgroup 错误而无法启动。 Incus FAQ 记录了这一情况。如果容器突然因 Failed to mount "/sys/fs/cgroup" 失败,FAQ 表示主机上运行 VPN 客户端可能是原因之一:VPN 客户端会将 net_cls cgroup v1 控制器挂载到 Incus 使用的 cgroup v2 层级之上。这只是需要检查的可能原因,并非唯一原因。如果确实是该问题,FAQ 建议的最简单修复方法是停止 VPN 客户端,然后运行 sudo umount /sys/fs/cgroup/net_cls。如果必须继续运行 VPN 客户端,FAQ 建议将 net_cls 挂载到其他位置,并重新配置客户端使用该位置。
实例没有获得 IPv4 地址。 incus list 显示实例正在运行,但地址列为空。主机发出的 DHCP 响应被丢弃,最常见的原因是主机防火墙未识别该网桥。在 ufw 中,sudo ufw allow in on incusbr0 to any port 67 proto udp 可恢复网络连接。使用 sudo tcpdump -ni incusbr0 port 67 监控请求是否到达。
实例在嵌套 VPS 上拒绝启动。 先阅读 incus info <name> --show-log,再阅读 sudo journalctl -u incus -n 50。如果 systemd-detect-virt 返回 lxc 或 openvz,缺失的功能由服务提供商控制,VPS 内部的设置无法改变它。
快照速度很慢,磁盘空间持续减少。 你使用的是 dir 存储池。incus storage list 会显示每个存储池的驱动程序。迁移到写时复制存储池时,需要先创建新存储池,再使用 incus copy web web-new -s fast 将实例复制到其中;确认副本可以启动后,再删除原实例。
FAQ
Incus 容器和 Docker 容器是同一种东西吗?
不是。Docker 封装单个进程或应用。Incus 系统容器模拟完整的操作系统,拥有自己的 init、用户、服务和软件包管理器。Incus 容器需要像服务器一样保留并打补丁。Docker 容器则应从镜像重新构建,而不是长期保留。通过在容器上设置 security.nesting=true,可以在 Incus 容器中运行 Docker。Incus 还记录了用于在特权 Docker 容器中运行 Incus 的第三方镜像。
我可以在 VPS 上运行 Incus 吗?
在 KVM VPS 上可以。systemd-detect-virt 输出 kvm 或 qemu 时,表示你拥有自己的内核,Incus 的行为与在物理硬件上一样。如果输出 lxc、lxc-libvirt 或 openvz,说明你的 VPS 本身就是一个容器,因此其中的 Incus 容器属于嵌套容器,只有提供商为你的容器启用了嵌套功能时才能运行。还要检查 uname -r,因为截至 2026 年 10 月,当前 Incus 版本和 7.0 LTS 系列要求内核版本为 6.12 或更高,而 6.0 LTS 系列记录的要求是 5.4。
在 VPS 上使用 Incus 时,应选择哪个存储后端?
在 loop 文件上使用 btrfs,除非你有可供它使用的备用块设备。dir 驱动的文档说明其速度明显慢于其他驱动,因为它复制文件,而不是使用写时复制,所以每个快照都会再次写入整个容器。incus admin init --minimal 会选择 dir,除非后端文件系统是 Btrfs 且该驱动可用。这就是为什么值得花两分钟回答交互式问题。使用 incus storage create fast btrfs size=30GiB 创建存储池。
为什么我的 Incus 容器可以访问主机上运行的服务?
因为默认的 incusbr0 网桥会将主机放在与容器相同的子网中,并使用网关地址;Incus 为该网桥添加的防火墙规则用于保证网络正常工作,而不是阻止容器访问主机。绑定到 0.0.0.0 的任何主机服务都会在该地址响应,除非主机防火墙规则丢弃数据包。由于这些数据包不会离开本机,提供商的防火墙也看不到它们。将主机服务绑定到 127.0.0.1;在使用 ufw 的主机上,仅允许 DNS 和 DHCP 通过 incusbr0 入站,不要使用范围过大的 sudo ufw allow in on incusbr0。
如何备份 Incus 容器?
incus export web /root/web-backup.tar.gz 会将实例及其快照写入一个文件,incus import 可在同一台服务器或另一台服务器上恢复该文件。使用 incus snapshot create 创建的快照不是备份:它们位于同一磁盘上的同一存储池中,因此可以在升级失败后保留,却无法在服务器损坏后恢复。使用 incus config set web snapshots.schedule=@daily 定期创建快照,并将导出的文件复制到其他主机。