一键虚拟化项目

简体中文

English

简体中文

English

主题

Incus ​

原生包安装的 Incus 会在 daemon 启动时缓存可用存储驱动。安装 Btrfs/LVM 等工具并确认内核支持后，安装器会再次核对 daemon 的驱动列表；仅当列表有效、所需驱动仍缺失且不存在存储池时，才重启 daemon 并等待就绪。已有驱动不会触发重启，已有存储池或查询失败也不会触发此自动刷新。刷新后仍不可用才继续原有后端回退，不要求仅为识别新工具而重装系统。

配置查询必须返回且只返回一个合法 JSON 对象；空输出、仅空白、多段 JSON、错误响应以及字段类型不匹配都会终止当前初始化步骤，不会被当成缺少配置后写入默认值。该检查兼容 Debian 12 的 jq 1.6。有效的自定义 DNS、ipv4.nat=false 和 ipv6.address=none 会保留；若查询失败，请先检查 daemon 状态与日志，再重新执行初始化。

安装器和面板初始化通过 JSON 查询存储池与网桥，兼容不支持列表 -c 参数的 LTS 客户端。查询失败或返回无效数据会报错，不应视为空环境。首次安装 btrfs/LVM/ZFS 工具后，若内核支持已可用或模块加载成功，会继续初始化；仅在模块确实不可用时保留重试标记并尝试其他后端，不会仅因刚安装软件包而要求重启。

nftables 持久化同样按发行版选择服务读取的主配置：Debian/Ubuntu/Arch 为 /etc/nftables.conf，CentOS/Fedora 为 /etc/sysconfig/nftables.conf，Alpine 为 /etc/nftables.nft。保存自有快照及 include 后才启用启动服务，启用失败会报错，不主动启动或重载全局规则；卸载清理这三个标准路径中的自有配置。自定义服务覆盖配置或自定义 rules_file 不在标准路径自动识别范围内，需核对实际启动配置。

创建脚本会为每次创建写入独立标记，回滚前核对该标记和实例 UUID。Incus/LXD 的创建与批量脚本共用一把锁，避免覆盖彼此的日志和辅助文件；子脚本沿用父脚本的锁。创建期间不要从面板或其他 CLI 删除、重建相同名称：运行时不支持按 UUID 条件删除，外部工具不受该锁约束。无法确认归属时会保留实例并报错，需核对后手动处理。

统一的 noninteractive=true 开关、旧变量兼容、交互入口及网络检查方法见节点环境的交互与自动化。

安装器的 nftables/iptables 补充 NAT 只处理 incusbr0 的 IPv4 流量，并保留 ipv4.nat=false 的选择。IPv6 路由和 NAT 由 Incus 网桥配置控制，独立 IPv6 不再被安装器的全局双栈伪装规则改写。公网 IPv6 仍需宿主机上游路由以及独立外部 SSH、HTTP 访问验证。

从 iptables 切换到 nftables 时，安装器会同时清理 iptables-nft、iptables-legacy 中带有本项目精确标记的旧 NAT，以及持久化文件中的对应规则；保留其他规则、文件权限和符号链接。无法确定归属的旧全局 MASQUERADE 不会自动删除，应检查后按实际用途处理。

使用 firewalld 回退时，自有 IPv4 NAT 同时登记到运行态和永久配置，重复执行、关闭 NAT、切换到 nftables 或卸载时仅处理精确归属规则；不会重载整个 firewalld。保留网桥已有区域，未分配区域的网桥才加入 trusted；卸载仅在网桥已不存在时清理 trusted 引用，保留自定义区域。旧版本添加的 public 全局 masquerade 无法确认归属，不会自动关闭，需核对其他网络的依赖。

没有 firewalld 时，iptables 持久化使用发行版标准路径及对应启动服务：Debian/Ubuntu 为 /etc/iptables/rules.v4，CentOS/Fedora 为 /etc/sysconfig/iptables，Arch 为 /etc/iptables/iptables.rules，Alpine 为 /etc/iptables/rules-save。相关软件包或启动服务启用失败会报错。Incus/LXD 的安装器 NAT 配置和卸载防火墙阶段共用进程锁，防止这两个脚本同时覆盖防火墙状态；它不协调管理员或其他服务的独立修改。

iptables 回退路径只保存本次相关的 IPv4 运行态快照：先在同一目录写入临时文件，全部成功后再原子替换。保存失败会保留旧文件并报错；已有权限、属主和符号链接保持，新文件权限为 600，IPv6 持久化文件不会被连带覆盖。补装 nftables 时不主动启动或重载全局防火墙服务，避免现有配置中的清空规则影响其他网络。

如果宿主机没有 IPv6 子网但你希望给容器分配 IPv6 地址，请先查看 incus 模块 自定义 分区中的 给宿主机附加免费的IPv6地址段，先给宿主机附加 IPv6 子网后再进行环境安装。

开设虚拟内存(SWAP)(非必须的可选项) ​

TIP

如果宿主机内存不足且硬盘空间充足，建议增加 swap 以降低 OOM 风险。

单位换算：输入 1024 产生 1G SWAP-虚拟内存，虚拟内存占用硬盘空间。

当实际内存不够用时将自动使用虚拟内存做内存使用，但随之带来IO高占用以及CPU性能占用。

虚拟内存大小可参考 该说明。

物理内存大小推荐 SWAP 大小
≤ 2G内存的 2 倍
2G < 内存 ≤ 8G等于物理内存大小
≥ 8G约 8G 即可
需要休眠 (hibernation)至少等于物理内存大小

以上数值仅为推荐设置，实际数值请按照自身需求来，不要盲目照抄数值

国际

shell
curl -L https://raw.githubusercontent.com/spiritLHLS/addswap/main/addswap.sh -o addswap.sh && chmod +x addswap.sh && bash addswap.sh

国内

shell
curl -L https://cdn.spiritlhl.net/https://raw.githubusercontent.com/spiritLHLS/addswap/main/addswap.sh -o addswap.sh && chmod +x addswap.sh && bash addswap.sh

Incus主体安装 ​

WARNING

如果是全新的服务器，务必保证curl命令可用且update无问题再执行本脚本。

  • 环境要求：Ubuntu 20+(不推荐Incus请使用LXD), Debian 11+(推荐), RockyLinux 9+, AlmaLinux 9+, CentOS 9+, Alpine(自行安装bash后), Arch
  • 安装过程中会提示输入存储池创建路径以及大小，你所有要开的虚拟机或容器最终占用的空间是在存储池中
  • 环境安装过程后需要重启服务器以加载一些默认配置
  • 默认启用lxcfs相关配置，使得容器内查询容器信息变更为容器本身的信息而不是宿主机信息
  • 实测本安装程序在物理机器或非物理机器上都可使用
  • 如需无交互安装，统一使用 export noninteractive=true 指定无交互模式，脚本会按默认策略处理可选项

国际

shell
curl -L https://raw.githubusercontent.com/oneclickvirt/incus/main/scripts/incus_install.sh -o incus_install.sh && chmod +x incus_install.sh && bash incus_install.sh

国内

shell
curl -L https://cdn.spiritlhl.net/https://raw.githubusercontent.com/oneclickvirt/incus/main/scripts/incus_install.sh -o incus_install.sh && chmod +x incus_install.sh && bash incus_install.sh

如果脚本已下载到当前目录，也可以执行：

shell
bash incus_install.sh

脚本下载完成后，无交互安装命令如下：

shell
export noninteractive=true && bash incus_install.sh

初始化配置示例：

如果不需要指定非系统盘的路径做默认存储池，那么选择是否自定义存储池路径时直接回车或输入n即可，不需要指定路径。

如果需要指定非系统盘的路径做默认的存储池，那么需要选择y，然后输入对应的路径(你挂载的盘的实际的绝对路径)。

如果对应的盘除去已占用空间还有18G硬盘空余，想要开设15G的存储池，按照命令行的提示则输入15

TIP

执行过程中可能会要求手动重启加载存储类型到内核中，安装完毕执行到最后会自动进行服务器重启，首次完整安装完毕后的自动重启最多大概耗时400~500秒，请耐心等待

WARNING

如果你需要在一台服务器上开启超过200个INCUS容器，那么不推荐你使用本项目，可能会出现lxcfs访问漂移的问题，产生IO占用无法释放。(系lxc原生问题无法修复)

卸载 Incus 环境 ​

一键卸载 Incus 全套环境，包括所有容器、虚拟机、镜像、存储池、网络配置、systemd 服务、软件包及相关配置文件：

Debian 系统按实际安装状态选择 Incus 软件包，兼容 Debian 原生包和 Zabbly 的不同包名；包删除失败会停止后续数据目录清理。卸载也会清理 Incus 自身的持久化防火墙文件，保留其他规则；只有 lxcfs 程序已被卸载时，才停止其残留服务，避免影响仍使用它的其他运行时。

iptables 清理只删除带有本脚本归属标记的 IPv4 NAT。旧版本没有标记的宿主机全局 MASQUERADE、端口 DROP 规则可能被其他服务共用，因此保留；需要清理时应先核对其归属和其他网络的依赖。

国际

shell
bash <(curl -sSL https://raw.githubusercontent.com/oneclickvirt/incus/main/scripts/uninstall_incus.sh)

国内

shell
bash <(curl -sSL https://cdn.spiritlhl.net/https://raw.githubusercontent.com/oneclickvirt/incus/main/scripts/uninstall_incus.sh)

手动安装(备选) ​

不推荐，只是为了一些奇葩环境一键脚本跑不动的时候进行安装，或则你想要了解最基础的Incus安装流程。

关闭防火墙 ​

bash
apt update
apt install curl wget sudo dos2unix ufw jq -y
ufw disable

开设虚拟内存SWAP ​

内存看你开多少服务器，这里如果要开8个，换算需要2G内存，实际内存如果是512MB内存，还需要开1.5G，保守点开2G虚拟内存即可

执行下面命令，输入1，再输入2048，代表开2G虚拟内存

国际

shell
curl -L https://raw.githubusercontent.com/oneclickvirt/incus/main/scripts/swap.sh -o swap.sh && chmod +x swap.sh && bash swap.sh

国内

shell
curl -L https://cdn.spiritlhl.net/https://raw.githubusercontent.com/oneclickvirt/incus/main/scripts/swap.sh -o swap.sh && chmod +x swap.sh && bash swap.sh

安装incus ​

下述命令直接通过zabbly源进行安装

sudo -i
mkdir -p /etc/apt/keyrings/
curl -fsSL https://pkgs.zabbly.com/key.asc | gpg --dearmor -o /etc/apt/keyrings/zabbly.gpg
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.gpg
EOF'
apt-get update
apt-get install incus -y
incus -h

如果无异常，继续执行

incus admin init

一般的选项回车默认即可

选择配置物理盘大小(提示默认最小1GB那个选项)，一般我填空闲磁盘大小减去内存大小后乘以0.95并向下取整，这里我填了10GB

提示带auto的更新image的选项记得选no，避免更新占用系统

incus -h