VPS에서 Incus 시스템 컨테이너 설정 및 운영 가이드
VPS 환경에서 Incus 시스템 컨테이너를 구축하는 방법을 설명합니다. 가상화 체크, 스토리지 풀 구성, 네트워크 설정 및 운영 중 발생할 수 있는 주요 문제와 해결책을 정리했습니다. Docker와 비교하여 시스템 컨테이너가 가지는 고유한 장점과 관리 방식을 확인하십시오.
Incus system container란
VPS의 Incus system container는 파일 시스템이 연결된 단일 프로세스가 아니다. 자체 init system과 자체 user account를 갖춘 전체 machine에 가깝다. container는 boot할 때 PID 1로 init을 실행하고 자체 service manager의 명령을 따른다. Debian과 Ubuntu 같은 systemd image에서는 systemctl가 이를 담당한다. OpenRC를 사용하는 Alpine에서는 rc-service가 이를 담당한다. container는 host의 kernel을 공유하므로 virtual machine은 아니다. kernel 위의 모든 동작은 하나의 machine처럼 작동한다.
Incus는 Linux Containers project에서 유지 관리하는 LXD의 community fork다. client command는 incus다. --vm를 지정하면 QEMU를 통해 실제 virtual machine도 실행할 수 있다. 그러나 대부분의 사용자가 Incus를 설치하는 이유는 system container다. 이 가이드의 나머지 내용도 system container를 다룬다.
Docker 비교가 오해를 불러일으키는 이유
Docker는 하나의 프로세스를 패키징합니다. Incus는 하나의 운영 체제를 패키징합니다. Incus 문서에서는 이러한 차이를 다음과 같이 명확히 설명합니다. "애플리케이션 컨테이너(예: Docker)는 단일 프로세스나 애플리케이션을 패키징합니다. 반면, 시스템 컨테이너는 호스트나 가상 머신에서 실행하는 것과 유사한 전체 운영 체제를 시뮬레이션합니다."
이러한 차이는 일상적인 운영 방식에 변화를 줍니다.
- Docker 컨테이너는 일반적으로 애플리케이션을 직접 실행하므로, 실행 중인 systemd init 없이는
systemctl가 실패합니다. Incus 컨테이너는 init 시스템을 실행하므로 서비스와 타이머가 서버에서와 동일하게 작동합니다. - Docker 컨테이너는 Dockerfile을 통해 파괴하고 재구축하도록 설계되었습니다. Incus 컨테이너는 유지 관리하고 패치하며 스냅샷을 생성하도록 설계되었습니다.
- Docker 이미지는 레지스트리로 푸시하는 빌드 산출물입니다. Incus 인스턴스는 스토리지 풀의 디스크 상태이며,
incus export을 사용하여 이동합니다. - Docker는 워크로드를 격리합니다. Incus는 머신을 격리하므로, 하나의 컨테이너 안에 여러 워크로드와 여러 사용자 계정을 담을 수 있습니다.
Incus 시스템 컨테이너 내부에서 Docker를 실행할 수 있습니다. 또한 Incus는 권한이 있는 Docker 컨테이너 내부에서 Incus를 실행하기 위한 타사 Docker 이미지에 대해서도 문서화하고 있습니다. 이미지 빌드 단계를 포함하여 컨테이너당 하나의 프로세스를 실행하는 것이 실제 목적이라면, VPS에서의 Podman 및 Docker를 먼저 읽어보시기 바랍니다. 공유 커널 대신 워크로드별로 별도의 커널을 사용하려면 VPS에서의 Firecracker microVM이 다른 대안이 될 수 있습니다.
Incus를 VPS에서 실행할 수 있습니까?
VPS의 가상화 유형과 커널에 따라 다르므로 설치 전에 두 가지를 모두 확인해야 합니다. 제공업체의 마케팅 페이지 내용을 그대로 믿지 마십시오. 서버에서 다음 네 가지 명령을 실행하십시오.
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(control group) 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월 기준으로 업스트림은 현재 기능 릴리스와 함께 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가 /dev/kvm을(를) 노출할 수 있는지 여부는 VPS에서의 중첩 가상화를 참조하고, 하드웨어를 직접 소유한 경우라면 임대 VPS와 Proxmox 비교를 확인하십시오.
Ubuntu 또는 Debian에 Incus 설치하기
Debian 13 및 Ubuntu 24.04 이상 버전은 자체 저장소에서 Incus를 제공합니다.
sudo apt update
sudo apt install -y incusDebian에서는 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 명령으로 서버 설정을 출력할 수 있다면 소켓이 정상적으로 작동하는 것입니다. 권한 오류가 발생한다면 그룹 변경 사항이 현재 셸에 반영되지 않은 것이며, newgrp incus-admin 명령으로 현재 셸에서 즉시 해결하거나 새로 로그인하여 완전히 적용할 수 있습니다. incus-admin 그룹 멤버십은 호스트의 root 권한과 동일하게 취급해야 합니다. 해당 소켓에 접근하는 것은 root 권한으로 실행되는 데몬을 완전히 제어하는 것과 같기 때문입니다. 일부 배포판은 제한된 사용자 접근을 위해 별도의 incus 그룹을 생성하기도 합니다.
이제 데몬을 초기화합니다.
sudo incus admin initincus admin init --minimal 명령을 바로 사용하기보다 질문에 직접 응답하여 설정하십시오. 최소 경로로 설정하면 백엔드 파일 시스템이 Btrfs이고 해당 드라이버를 사용할 수 있는 경우가 아닌 이상 dir 스토리지 드라이버가 선택됩니다. 다음 섹션에서는 이 선택이 왜 중요한지 다룹니다.
컨테이너를 실행하여 정상 작동 여부를 확인합니다.
incus launch images:debian/13 web
incus list
incus exec web -- bashincus list 명령을 실행하면 web 상태가 RUNNING로 표시되고 incusbr0 서브넷의 IPv4 주소가 할당되어야 합니다. 주소가 없다면 DHCP(Dynamic Host Configuration Protocol)가 완료되지 않은 것이며, 이는 네트워킹 섹션에서 다룹니다. 컨테이너 시작에 실패하면 incus info web --show-log에 실패 원인이 출력되며, 데몬 수준의 오류는 sudo journalctl -u incus -n 50에 기록됩니다. systemd-detect-virt 명령 결과가 lxc 또는 openvz인 VPS 환경이라면, 이 실행 테스트를 통해 중첩 가상화(nesting) 사용 가능 여부를 확실히 확인할 수 있습니다.
기본 스토리지 백엔드가 중요한 이유
스토리지 백엔드는 스냅샷을 즉시 생성할지, 아니면 컨테이너 디스크 전체를 복사할지를 결정합니다. 이는 설치 시점에 선택해야 하며, 나중에 변경하려면 비용이 많이 드는 유일한 설정입니다.
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은 쓰기 시 복사(copy-on-write) 방식을 사용하므로, 스냅샷은 생성 이후 변경된 블록만 기록합니다. Incus는 이 두 가지를 권장 백엔드로 지정합니다. 스냅샷은 거의 즉시 생성됩니다. 디스크 할당량은 파일 시스템 자체의 할당량 지원 기능을 통해 작동합니다.
대부분의 VPS 플랜은 여유 파티션이 없는 단일 디스크를 제공하므로, 풀을 루프 파일(loop file)에 배치해야 합니다. 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 fastsize=이 없으면 루프 기반 풀은 여유 디스크 공간의 20%를 차지하며, 최소 5 GiB에서 최대 30 GiB로 제한됩니다. 이 크기는 의도적으로 설정하십시오. 풀은 설정된 크기에서 멈추므로 호스트에 여유 공간이 있더라도 풀이 가득 찰 수 있으며, 이것이 루프 기반 풀의 용량이 부족해지는 일반적인 원인입니다. 루프 파일 자체는 호스트 파일 시스템의 파일이므로, 모든 여유 공간을 할당하기보다는 호스트의 필요를 고려하여 풀 크기를 결정하십시오.
Debian의 ZFS는 DKMS 모듈을 사용하므로 커널이 업그레이드될 때마다 다시 빌드되며, 이 과정에서 빌드에 실패할 수 있습니다. Ubuntu는 기본 Linux 커널 패키지에 ZFS를 포함하고 있습니다. Debian에서는 btrfs를 사용하면 이러한 DKMS 유지 관리 문제를 피할 수 있습니다.
세 가지 네트워크 모드와 각 모드의 노출 범위
권장 설정을 수락하면 incus admin init은 incusbr0라는 관리형 브리지를 생성하고 이를 default 프로필에 연결합니다. 따라서 해당 프로필을 사용하는 모든 새 인스턴스는 이 브리지에 배치됩니다. 기존 브리지나 인터페이스를 직접 지정할 수도 있습니다. 관리형 브리지는 컨테이너를 연결하는 세 가지 방법 중 하나이며, 나머지 두 방식은 첫 번째 방식이 NAT(네트워크 주소 변환) 뒤에 컨테이너를 숨기기 때문에 존재합니다.
관리형 브리지(Managed bridge). incusbr0는 사설 서브넷을 할당받습니다. 호스트는 해당 서브넷의 첫 번째 주소를 점유하여 게이트웨이 역할을 수행하며, Incus는 그 위에서 DHCP와 DNS(도메인 이름 시스템)를 실행합니다. 아웃바운드 트래픽은 소스 NAT가 적용된 상태로 호스트의 공인 주소를 통해 나갑니다. 사용자가 명시적으로 허용하지 않는 한 외부에서 컨테이너로 접근할 수 없습니다. 포트를 전달하려면 프록시 장치를 사용하십시오.
incus config device add web http proxy listen=tcp:203.0.113.10:8080 connect=tcp:0.0.0.0:80 nat=true203.0.113.10를 호스트의 공인 IPv4 주소로 교체하십시오. 와일드카드 연결 주소는 인스턴스의 IPv4 주소를 선택합니다. 6.0 LTS 버전에서는 NAT 프록시를 추가하기 전에 인스턴스의 Incus NIC에 고정 주소를 설정하십시오.
nat=true은 별도의 사용자 공간 연결을 거치는 프록시 방식 대신 netfilter 규칙을 사용하여 포워딩하므로, 클라이언트의 실제 주소가 컨테이너 로그에 그대로 남습니다. Incus는 호스트가 인스턴스의 게이트웨이인 경우에만 이 모드를 지원하며, 이는 정확히 incusbr0의 경우에 해당합니다.
macvlan. 컨테이너는 호스트의 물리적 네트워크상에서 자신만의 MAC(미디어 접근 제어) 주소를 갖습니다. 대부분의 VPS 플랫폼에서는 가상 스위치 포트가 VM의 MAC 주소에 고정되어 있어 다른 MAC 주소에서 오는 프레임을 차단하므로 이 방식이 실패합니다. 작동하는 환경에서도 두 번째 제약이 존재합니다. Incus 문서에 따르면 "macvlan 장치는 상호 간이나 외부와 통신할 수는 있지만, 부모 장치와는 통신할 수 없습니다. 즉, 인스턴스가 호스트 자체와 통신해야 하는 경우 macvlan을 사용할 수 없습니다."
라우팅(Routed). 이 모드는 추가 주소를 제공하는 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의 커널과 이미지에서 결정되며, eth0 대신 enp1s0나 ens3과 같은 예측 가능한 이름일 수 있으므로 추측하지 말고 직접 확인해야 합니다. 컨테이너 내부의 이름은 다릅니다. 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호스트의 데이터베이스, metrics endpoint 또는 admin panel이 0.0.0.0에 바인딩되어 있고 호스트 방화벽 규칙이 브리지를 차단하지 않으면 이 확인은 성공합니다. 패킷이 시스템 밖으로 나가지 않았으므로 provider의 네트워크 방화벽에는 패킷이 도달하지 않습니다. 대부분의 “어떻게 저 서비스에 연결되었나”라는 질문의 원인은 여기에 있습니다. 컨테이너는 NAT를 통해 인터넷과 격리되며, 호스트와의 격리는 호스트 방화벽이 적용하는 규칙에 의해서만 이루어집니다.
가능한 경우 호스트 서비스를 127.0.0.1에 바인딩합니다. 그런 다음 호스트에서 브리지 트래픽을 필터링합니다. ufw를 사용하는 호스트에서는 기본 deny 정책이 이미 컨테이너에서 호스트로 가는 트래픽을 차단합니다. 이로 인해 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의 routed 정책이 전달된 패킷을 삭제하므로 컨테이너는 주소를 할당받아도 아무 곳에도 연결되지 않습니다.
스냅샷과 프로필
스냅샷은 스토리지 풀 내 인스턴스의 특정 시점 복사본입니다.
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를 실행하려면 nesting 기능을 활성화해야 합니다. Docker는 기본적으로 컨테이너가 생성할 수 없는 자체 네임스페이스와 마운트를 생성하기 때문입니다.
incus config set web security.nesting=true
incus restart webIncus 문서는 security.nesting를 "인스턴스 내부의 중첩(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 버그 리포트에 따르면, 해당 값을 0로 설정해도 문제가 해결되지 않았습니다. 보안 기본값을 변경하기 전에 먼저 dmesg를 읽어보고 AppArmor가 실제로 문제의 원인인지 확인하십시오.
계층을 하나 줄이고 VPS에서 직접 컨테이너를 실행하고 싶다면, VPS에서 Docker 실행하기에서 해당 설정을 다룹니다.
실패 유형 및 확인 가능한 메시지
호스트에 Docker를 설치한 후 인스턴스의 네트워크가 모두 끊깁니다. Incus 문서에서는 그 원인을 다음과 같이 설명합니다. "Docker가 전역 FORWARD 정책을 drop로 설정하면 Incus가 트래픽을 전달하지 못하게 되어 인스턴스의 네트워크 연결이 끊깁니다." 인스턴스는 IP 주소를 유지하지만 외부와 통신할 수 없습니다. /etc/docker/daemon.json에서 ip-forward-no-drop를 true로 설정한 다음, 포워딩을 영구적으로 적용하고 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 클라이언트가 Incus가 사용하는 cgroup v2 계층 구조 위에 net_cls cgroup v1 컨트롤러를 마운트했을 가능성을 언급합니다. 이는 확인해야 할 원인 중 하나일 뿐입니다. 만약 이 문제라면, FAQ에서 제시하는 가장 쉬운 해결책은 VPN 클라이언트를 중지하고 sudo umount /sys/fs/cgroup/net_cls을 실행하는 것입니다. VPN 클라이언트를 계속 실행해야 한다면, 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를 실행하면 각 풀의 드라이버를 확인할 수 있습니다. Copy-on-write 풀로 이전하려면 새 풀을 생성하고, 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 컨테이너는 중첩된 형태가 됩니다. 이는 제공업체가 컨테이너에 중첩 기능을 활성화한 경우에만 작동합니다. 2026년 10월 기준으로 현재 Incus 릴리스와 7.0 LTS 시리즈는 6.12 이상의 커널을 요구하며, 6.0 LTS 시리즈는 5.4 버전을 명시하고 있으므로 uname -r도 함께 확인하십시오.
VPS에서 Incus를 위해 어떤 스토리지 백엔드를 선택해야 합니까?
별도의 블록 장치를 사용할 수 있는 상황이 아니라면 루프 파일 기반의 btrfs을 사용하십시오. dir 드라이버는 copy-on-write를 사용하지 않고 파일을 복사하기 때문에 다른 드라이버보다 훨씬 느리다고 명시되어 있습니다. 이 방식은 스냅샷을 생성할 때마다 컨테이너 전체를 다시 쓰기 때문입니다. incus admin init --minimal은 기본 파일 시스템이 Btrfs이고 해당 드라이버를 사용할 수 있는 경우가 아니라면 dir를 선택합니다. 따라서 초기 설정 시 대화형 질문에 응답하는 데 2분 정도 투자하는 것이 좋습니다. 풀은 incus storage create fast btrfs size=30GiB으로 생성하십시오.
Incus 컨테이너가 호스트에서 실행 중인 서비스에 접근할 수 있는 이유는 무엇입니까?
기본 incusbr0 브리지가 호스트를 컨테이너와 동일한 서브넷의 게이트웨이 주소에 배치하기 때문입니다. Incus가 해당 브리지에 추가하는 방화벽 규칙은 네트워크 통신을 원활하게 하기 위한 것이지 호스트를 차단하기 위한 것이 아닙니다. 호스트 방화벽 규칙이 패킷을 드롭하지 않는 한, 0.0.0.0에 바인딩된 모든 호스트 서비스는 해당 주소로 응답합니다. 또한 이 패킷들은 머신 외부로 나가지 않으므로 제공업체의 방화벽은 이를 감지하지 못합니다. 호스트 서비스는 127.0.0.1에 바인딩하고, ufw를 사용하는 호스트라면 sudo ufw allow in on incusbr0와 같이 전체를 허용하기보다 incusbr0를 통해 DNS와 DHCP만 허용하십시오.
Incus 컨테이너는 어떻게 백업합니까?
incus export web /root/web-backup.tar.gz은 인스턴스와 그 스냅샷을 하나의 파일로 기록하며, incus import은 이를 동일한 서버나 다른 서버에 복원합니다. incus snapshot create로 생성한 스냅샷은 백업이 아닙니다. 스냅샷은 동일한 디스크의 동일한 스토리지 풀에 저장되므로, 잘못된 업그레이드에서는 살아남을 수 있지만 서버가 물리적으로 고장 나면 함께 소실됩니다. incus config set web snapshots.schedule=@daily를 사용하여 백업을 예약하고, 내보낸 파일은 서버 외부로 복사해 두십시오.