Что получится
шаблон debian-13-standard_13.6-1 из репозитория шаблонов Proxmox
контейнер 201, files1: непривилегированный, 1 ядро, 512 МБ памяти, диск 8 ГБ
сеть 10.0.0.21 в домашней сети через vmbr0, вход root по ключу
каталог /srv/share хоста виден в контейнере как /srv/share
проверка nginx отвечает на http://10.0.0.21
Команды — в Shell узла от root. В интерфейсе то же делает мастер Create CT; поля мастера совпадают с опциями
pct create, поэтому ниже они рядом. Сеть и адреса — как в «Установка Proxmox»: роутер 10.0.0.1, хост 10.0.0.2.
Публичный ключ для входа лежит в /root/example-user.pub — как в «Шаблон VM с cloud-init».
Шаги
Скачиваем шаблон Debian
pveam update # свежий список шаблонов pveam available --section system | grep debian # system debian-12-standard_12.12-1_amd64.tar.zst # system debian-13-standard_13.6-1_amd64.tar.zst pveam download local debian-13-standard_13.6-1_amd64.tar.zst pveam list local # local:vztmpl/debian-13-standard_13.6-1_amd64.tar.zstВ интерфейсе:
local› CT Templates › Templates. Шаблон — архив готовой системы, около 120 МБ. В том же списке Ubuntu 24.04 и 26.04, Alpine, Rocky, Fedora и готовые приложения TurnKey.Создаём контейнер
pct create 201 local:vztmpl/debian-13-standard_13.6-1_amd64.tar.zst \ --hostname files1 --unprivileged 1 --features nesting=1 \ --cores 1 --memory 512 --swap 512 \ --rootfs local-lvm:8 \ --net0 name=eth0,bridge=vmbr0,ip=10.0.0.21/24,gw=10.0.0.1 \ --nameserver 10.0.0.1 \ --ssh-public-keys /root/example-user.pub \ --onboot 1 --start 1Опция Поле мастера Что значит --unprivileged 1Unprivileged container uid внутри сдвинуты на 100000: root контейнера на хосте никто («VM или LXC») --features nesting=1Nesting свежему systemdв госте нужен доступ к/procи/sys, который даёт эта опция; мастер включает её сам--memory 512 --swap 512Memory, Swap предел cgroups, а не выделенная память: занято столько, сколько ест система внутри --rootfs local-lvm:8Disks корневой том 8 ГБ на тонком пуле; на ZFS — local-zfs:8--net0 …Network eth0в мостеvmbr0, свой адрес;ip=dhcp— адрес от роутера--ssh-public-keysSSH public key(s) ключ попадает в /root/.ssh/authorized_keysконтейнера--onboot 1Start at boot запуск после перезагрузки хоста Пароль root не задаём: внутрь входим по ключу, а с хоста —
pct enter. Контейнер стартует за пару секунд.Входим и обновляем
ssh [email protected] # с компьютера, по ключу # или с хоста, без сети и пароля: pct enter 201Внутри — обычный Debian:
apt update && apt full-upgrade -y uname -r # 7.0.14-25-pve — ядро хоста, своего нет free -m # total 512: предел cgroups виден как вся памятьСвой пользователь и вход без root — как на любом сервере («Первый вход на сервер»). Ядро, модули и
sysctlуровня ядра в контейнере не настраиваются: это делается на хосте и действует на всех.Подключаем каталог хоста
Данные, которые нужны и хосту, и контейнеру, — например, общая папка, — держим в каталоге хоста и подключаем в контейнер. Сначала отдаём каталог root контейнера: на хосте это uid 100000.
mkdir -p /srv/share chown 100000:100000 /srv/share pct set 201 -mp0 /srv/share,mp=/srv/share pct reboot 201mp0— первая точка монтирования; следующие —mp1,mp2.- Путь на хосте — без символических ссылок: Proxmox их не принимает.
- Каталог хоста подключает только
root@pam, и только командой: мастер точек монтирования в интерфейсе создаёт тома на хранилищах, а каталоги хоста не предлагает. - Если в контейнере писать будет пользователь с uid 1000 — на хосте это
101000:101000.
В бэкап контейнера такой каталог не попадает: vzdump копирует только тома Proxmox. Каталог хоста бэкапим отдельно, с хоста.
Ставим nginx для проверки
pct exec 201 -- apt install -y nginx pct exec 201 -- sh -c 'echo "files1 работает" > /var/www/html/index.html'pct execвыполняет команду в контейнере прямо с хоста, без SSH и пароля, — так контейнеры настраивают скриптом. С компьютера открываемhttp://10.0.0.21— страница с текстомfiles1 работает.Делаем снимок
pct snapshot 201 clean --description "Debian 13 после настройки" pct listsnapshot 201Перед опытом с контейнером откат —
pct rollback 201 clean. Снимок лежит там же, где диск контейнера, и бэкапом не считается («Снимок — не бэкап»); ночные копии — «Бэкапы в Proxmox».
Если не работает
pveam download — 400 Parameter verification failed или шаблона нет
- Причина
- Список шаблонов на хосте старый, а в имени шаблона — версия:
13.6-1сменилась на новую. - Делаем
pveam update, затемpveam available --section system | grep debian— берём имя оттуда целиком.
ssh [email protected] с паролем — Permission denied
- Причина
- В Debian root по SSH входит только по ключу:
PermitRootLogin prohibit-passwordпо умолчанию. - Делаем
- Входим по ключу из
--ssh-public-keysили с хоста командойpct enter 201— без пароля и без сети.
После входа: perl: warning: Setting locale failed или setlocale: LC_ALL: cannot change locale
- Причина
- SSH передаёт локаль компьютера (например,
ru_RU.UTF-8), а в минимальном шаблоне она не сгенерирована. - Делаем
- В контейнере:
dpkg-reconfigure locales, отмечаем свою локаль; или убираемSendEnv LANG LC_*вssh_configна компьютере.
В подключённом каталоге файлы принадлежат nobody, запись — Permission denied
- Причина
- Контейнер непривилегированный: root внутри — uid 100000 на хосте, пользователь 1000 — uid 101000. Каталог хоста принадлежит root хоста, и для контейнера он чужой.
- Делаем
- На хосте:
chown -R 100000:100000 /srv/shareдля root контейнера или101000:101000для его пользователя 1000.
В бэкапе контейнера нет файлов из /srv/share
- Причина
- Каталоги хоста, подключённые в контейнер (bind mount), в бэкап контейнера не попадают: vzdump копирует только тома Proxmox.
- Делаем
- Каталог хоста бэкапим отдельно — Kopia или rsync с хоста («Бэкап, который переживёт сервер»). Или храним данные на томе Proxmox:
pct set 201 -mp0 local-lvm:50,mp=/srv/share— такой том попадает в бэкап.
apt update в контейнере: Temporary failure resolving 'deb.debian.org'
- Причина
- В контейнере нет рабочего DNS: без
--nameserverон берёт DNS хоста, а тот недоступен из сети контейнера. - Делаем
pct set 201 --nameserver 10.0.0.1иpct reboot 201. Проверка:cat /etc/resolv.confвнутри.
Как проверить
С хоста:
pct list # 201 running files1
pct config 201 # unprivileged: 1, features: nesting=1, mp0: /srv/share,mp=/srv/share
pct exec 201 -- touch /srv/share/test-from-ct
ls -ln /srv/share # владелец файла — 100000: root контейнера на хосте сдвинут
С компьютера: ssh [email protected] hostname печатает files1, curl http://10.0.0.21 возвращает страницу.
После pct reboot 201 контейнер снова отвечает через пару секунд.