VPS 上如何安裝與執行 Incus system container
了解 Incus system container 與 Docker 的差異,並在 VPS 上完成虛擬化檢查、storage pool、網路設定,避開常見故障。
Incus 系統容器是什麼
VPS 上的 Incus 系統容器提供一個具有獨立 init 系統與使用者帳號的完整環境,而不是附加檔案系統的單一程序。容器會開機,以 PID 1 執行 init,並由自身的服務管理員處理服務。在 Debian 和 Ubuntu 等使用 systemd 的映像檔中,這是 systemctl;在使用 OpenRC 的 Alpine 中,則是 rc-service。容器會共用主機的 kernel,因此不是虛擬機器。除了 kernel 之外的部分,其行為都如同一台獨立機器。
Incus 是 LXD 的社群分支,由 Linux Containers 專案維護。其用戶端命令是 incus。傳入 --vm 時,它也會透過 QEMU 執行真正的虛擬機器;但大多數人安裝它的主要原因是系統容器,本指南其餘內容也都以此為主。
為什麼 Docker 比較會誤導使用者
Docker 封裝一個程序。Incus 封裝一個作業系統。Incus 文件直接說明兩者的區別:「應用程式容器(例如 Docker 提供的容器)會封裝單一程序或應用程式。另一方面,系統容器會模擬完整的作業系統,類似於您在主機或虛擬機器上執行的作業系統。」
這項差異會改變您每天管理該環境的方式。
- Docker 容器通常直接執行應用程式,因此其中的
systemctl若沒有執行中的 systemd init 就會失敗。Incus 容器會執行 init 系統,因此服務與計時器的運作方式和伺服器相同。 - Docker 容器的設計用途是依據 Dockerfile 銷毀後重新建置。Incus 容器則是設計為保留、套用修補程式並建立快照。
- Docker image 是要推送至 registry 的建置產物。Incus instance 是儲存池中的磁碟狀態,並使用
incus export搬移。 - Docker 隔離工作負載。Incus 隔離整台機器,因此單一容器可以容納多個工作負載與多個使用者帳戶。
您可以在 Incus system container 內執行 Docker。Incus 也記載了第三方 Docker image,可在具備 privileged 權限的 Docker container 內執行 Incus。如果您實際需要的是每個容器執行一個程序,並透過 image 建置步驟產生容器,請先閱讀 VPS 上的 Podman 與 Docker。如果您希望每個工作負載使用獨立 kernel,而不是共用 kernel,請參閱相反方向的 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 啟用,因此依賴該控制器的執行個體限制也無法使用。
核心版本的重要性比過去更高。截至 October 2026,upstream 維護 6.0 和 7.0 兩個 LTS(長期支援)系列,並同時維護目前的功能版本;這些版本系列的最低需求並不相同。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 upstream 會發布 tarball,而不是官方套件。該套件庫提供 lts-6.0、lts-7.0 和 stable channel。以下命令取自 Zabbly 套件庫的 README,使用的是 stable。如果核心需要 LTS 系列,請在檔名和 URIs: 行中替換 channel 名稱。
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接著讓使用者存取 daemon socket。
sudo usermod -aG incus-admin "$USER"
newgrp incus-admin
incus infoincus info 顯示伺服器設定,表示 socket 可正常運作。權限錯誤表示群組變更尚未套用到目前的 shell;newgrp incus-admin 可套用到目前的 shell,而重新登入才能正確套用。請將 incus-admin 的成員資格視同主機上的 root 權限,因為存取該 socket 等同完全控制以 root 身分執行的 daemon。部分發行版也會建立一般的 incus 群組,供受限制的使用者存取。
現在初始化 daemon。
sudo incus admin init請回答這些問題,不要直接使用 incus admin init --minimal。除非後端檔案系統是 Btrfs 且該驅動程式可用,否則最簡設定會選擇 dir 儲存驅動程式;下一節會說明這項選擇為何會持續影響後續設定。
啟動一個實例並確認其運作正常。
incus launch images:debian/13 web
incus list
incus exec web -- bashincus list 應顯示 web 為 RUNNING,並在 incusbr0 子網路上取得 IPv4 位址。沒有位址表示 DHCP(動態主機設定通訊協定)未完成,網路設定一節會說明這個問題。無法啟動的容器會在 incus info web --show-log 中顯示原因,而 daemon 層級的失敗會記錄在 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 啟用 project quota 時有效,而大多數 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 檔案本身仍是主機檔案系統上的檔案,因此設定儲存池大小時,應一併考量主機自身的需求,不要將所有可用 GiB 都配置給它。
Debian 上的 ZFS 使用 DKMS 模組,因此每次升級核心時都會重新建置,也可能在其中一次升級後建置失敗。Ubuntu 將 ZFS 納入預設的 Linux 核心套件。在 Debian 上,btrfs 可避免這項 DKMS 維護工作。
三種網路模式,以及各自公開的內容
接受建議的答案後,incus admin init 會建立名為 incusbr0 的受管橋接介面,並將它附加至 default 設定檔,因此所有使用該設定檔的新執行個體都會連接到這個橋接介面。您也可以改用現有的橋接介面或網路介面。受管橋接介面是連接容器的三種方式之一;另外兩種模式之所以存在,是因為第一種模式會透過 NAT(network address translation)將容器隱藏在後方。
受管橋接介面。 incusbr0 會取得私有子網路。主機使用該子網路的第一個位址,並作為閘道;Incus 會在其中執行 DHCP 與 DNS(domain name system);對外流量則會經由主機的公開位址離開,並套用來源 NAT。除非您明確設定,外部流量無法連入容器。使用 proxy device 轉送連接埠。
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 NIC 上設定靜態位址。
nat=true 會使用 netfilter 規則轉送,而不是透過個別的 userspace 連線進行 proxy,因此用戶端的實際位址會保留在容器的日誌中。Incus 只在主機是執行個體閘道時支援此模式,這正是 incusbr0 情況。
macvlan。 容器會在主機的實體網路上取得自己的 MAC(media access control)位址。在大多數 VPS 平台上,這會失敗,因為虛擬交換器連接埠綁定至 VM 的 MAC 位址,並會丟棄來自其他位址的框架。即使 macvlan 可正常運作,還有另一項容易被忽略的限制。Incus 文件指出:「macvlan device 雖然能彼此通訊,也能與外部通訊,但無法與其父裝置通訊。這表示只要您有任何需求需要讓執行個體與主機本身通訊,就不能使用 macvlan。」
路由模式。 這是在具備額外位址的 VPS 上通常可正常運作的模式。Incus 文件將此裝置描述為「建立虛擬裝置配對以連接主機與執行個體,並設定靜態路由及 proxy ARP/NDP 項目,讓執行個體加入指定父介面的網路」。ARP 是 address resolution protocol。容器會保留公開位址。主機會代替該位址回應 ARP,因此供應商仍只會看到主機的 MAC 位址。
incus config device add web eth0 nic nictype=routed parent=enp1s0 ipv4.address=203.0.113.20從主機的 ip route show default 取得父介面名稱。該名稱來自 VPS 自身的 kernel 與映像檔,可能是 enp1s0 或 ens3 等可預測名稱,而不是 eth0,因此請直接讀取名稱,不要自行猜測。在容器內,介面名稱則不同:Incus 文件指出,default 設定檔中的網路介面「會在執行個體中成為 eth0」。將裝置命名為 eth0 會覆寫 default 設定檔提供的名稱,因此容器最終會連接至路由介面,而不是橋接介面。請在容器內使用 ip a 與 ip route 檢查結果。
為何容器能連線到主機上的服務
incusbr0 上的容器具備自己的 network namespace,但這並不構成隔離主機的防火牆邊界。受管理的 Incus bridge 所加入的防火牆規則,依文件中的說法,是「確保完整功能」,而不是將主機隔離在外。主機會以 gateway address 位於該 bridge 上,因此從容器內看,主機是可直接連線的鄰近節點。除非主機防火牆規則丟棄封包,否則所有繫結至 0.0.0.0 的主機服務都會在該處回應。
請自行確認。在主機上列出目前正在監聽的項目。
sudo ss -tlnp接著從容器內連線至 ip route 回報的 gateway。
ip route show default
nc -zv 10.0.0.1 6379如果主機上的資料庫、metrics endpoint 或管理面板繫結至 0.0.0.0,且主機沒有封鎖 bridge 的防火牆規則,該測試就會成功。因為封包從未離開這台機器,所以 provider 的 network firewall 根本看不到它。這就是大多數「它怎麼能連到那裡」問題背後的原因:NAT 會將容器與網際網路隔離,而容器與主機之間的隔離程度,取決於主機防火牆實際強制執行的規則。
請盡可能將主機服務繫結至 127.0.0.1。接著在主機上過濾 bridge 流量。在使用 ufw 的主機上,預設的 deny policy 已會封鎖容器到主機的流量,導致 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 規則允許 instance 流量經由主機轉送至網際網路。若沒有這些規則,ufw 的 routed policy 會丟棄轉送封包,因此容器雖然取得 address,卻無法連線到任何地方。
快照與設定檔
快照是儲存集區中執行個體在特定時間點的副本。
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 說明為「是否允許在 instance 內啟用巢狀功能」,而容器的預設值為 false。另外兩點直接來自 Incus FAQ。容器無法載入 kernel module,因此 Docker 所需的 module 必須在主機上載入,並列在 incus config set web linux.kernel_modules overlay,br_netfilter 中。在容器內建立 /.dockerenv 檔案,則可讓 Docker 略過某些在巢狀環境中會失敗的檢查。
在 Ubuntu 24.04 主機上,AppArmor 對非特權 user namespace 的限制可能會阻擋 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 report 記錄指出,將其設為 0 並未解決問題。請先閱讀 dmesg 中的拒絕事件,確認問題確實來自 AppArmor,再變更安全性預設值。
如果您希望直接在 VPS 上執行容器並省略一層,在 VPS 上執行 Docker 會單獨說明該設定。
故障模式與你會看到的字串
在主機上安裝 Docker 後,執行個體失去所有網路連線。 Incus 文件說明原因:「Docker 將全域 FORWARD 政策設為 drop,導致 Incus 無法轉送 network traffic,因此執行個體失去網路連線。」執行個體仍保有原本的位址,但無法連線到任何位置。將 ip-forward-no-drop 設為 true,寫入 /etc/docker/daemon.json,接著讓 forwarding 設定持久化,並允許 bridge 通過 Docker 自有的 chain。
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 規則不會自行保留在重新開機後。請將其持久化。
Containers 停止啟動,並顯示 cgroup 錯誤。 Incus FAQ 說明了這種情況。如果 containers 突然因 Failed to mount "/sys/fs/cgroup" 而啟動失敗,FAQ 指出原因可能是主機上執行 VPN client,將 net_cls cgroup v1 controller 掛載到 Incus 使用的 cgroup v2 hierarchy 上。這是需要檢查的可能原因,但不是唯一原因。如果確實是此問題,FAQ 建議最簡單的修正方式是停止 VPN client,並執行 sudo umount /sys/fs/cgroup/net_cls。如果 VPN client 必須持續執行,FAQ 建議將 net_cls 掛載到其他位置,並重新設定 client 使用該位置。
執行個體沒有 IPv4 位址。 incus list 顯示它正在執行,但位址欄是空的。主機傳送的 DHCP 回覆遭到丟棄,最常見的原因是主機 firewall 不知道 bridge 的存在。在 ufw 上,sudo ufw allow in on incusbr0 to any port 67 proto udp 可恢復連線。使用 sudo tcpdump -ni incusbr0 port 67 monitor requests 是否送達。
執行個體在 nested VPS 上拒絕啟動。 先閱讀 incus info <name> --show-log,再閱讀 sudo journalctl -u incus -n 50。如果 systemd-detect-virt 顯示 lxc 或 openvz,表示缺少的設定在 provider 端,VPS 內的任何設定都無法改變這項限制。
Snapshots 速度緩慢,磁碟空間持續耗盡。 你使用的是 dir pool。incus storage list 會列出每個 pool 使用的 driver。遷移到 copy-on-write pool 需要建立新的 pool,使用 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,表示你擁有自己的 kernel,Incus 的行為會與在實體硬體上一樣。若輸出 lxc、lxc-libvirt 或 openvz,表示你的 VPS 本身就是容器,因此其中的 Incus 容器屬於巢狀容器;只有供應商在你的容器上啟用巢狀功能時才能運作。也請檢查 uname -r,因為截至 October 2026,目前的 Incus releases 與 7.0 LTS series 需要 6.12 或更新版本的 kernel,而 6.0 LTS series 的文件記載需求為 5.4。
在 VPS 上使用 Incus 時,應選擇哪個儲存後端?
除非你有可提供給它使用的備用 block device,否則請在 loop file 上使用 btrfs。dir driver 的文件指出其速度遠低於其他 driver,因為它會複製檔案,而不是使用 copy-on-write,因此每次 snapshot 都會再次寫入整個容器。incus admin init --minimal 會選擇 dir,但如果 backing filesystem 是 Btrfs 且該 driver 可用,則會選擇其他設定;因此花兩分鐘回答互動式問題是值得的。使用 incus storage create fast btrfs size=30GiB 建立 pool。
為什麼我的 Incus 容器可以連線到主機上執行的服務?
因為預設的 incusbr0 bridge 會讓主機與容器位於同一個 subnet,主機使用 gateway address,而 Incus 加入該 bridge 的 firewall rules 是為了讓網路正常運作,不是為了阻擋主機。除非主機的 firewall rule 丟棄封包,否則任何繫結至 0.0.0.0 的主機服務都會在該位址回應;這些封包不會離開機器,因此 provider 的 firewall 永遠看不到它們。請將主機服務繫結至 127.0.0.1。如果主機使用 ufw,請只允許 DNS 和 DHCP 透過 incusbr0 進入,不要使用寬鬆的 sudo ufw allow in on incusbr0。
如何備份 Incus 容器?
incus export web /root/web-backup.tar.gz 會將 instance 及其 snapshots 寫入單一檔案,incus import 則可在同一台伺服器或另一台伺服器上還原。使用 incus snapshot create 建立的 snapshots 不是備份:它們位於同一個 storage pool 的同一顆磁碟上,因此能在升級失敗時保留,卻無法在伺服器故障時保留。使用 incus config set web snapshots.schedule=@daily 排程建立 snapshots,並將 exports 複製到該主機以外的位置。