basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    МануалHomelabProxmox

    Первый контейнер LXC в Proxmox: Debian из шаблона, сеть, SSH по ключу и общий каталог с хостом

    Контейнер Debian 13 из шаблона Proxmox — маленький сервер, который стартует за пару секунд и в покое занимает десятки мегабайт памяти. Скачиваем шаблон, создаём непривилегированный контейнер с адресом в домашней сети и ключом SSH, подключаем к нему каталог хоста и ставим nginx для проверки. Под Docker такой контейнер не берём — для него машина.

    Что получится

    шаблон      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».

    Шаги

    1. Скачиваем шаблон 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.

    2. Создаём контейнер

      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 1 Unprivileged container uid внутри сдвинуты на 100000: root контейнера на хосте никто («VM или LXC»)
      --features nesting=1 Nesting свежему systemd в госте нужен доступ к /proc и /sys, который даёт эта опция; мастер включает её сам
      --memory 512 --swap 512 Memory, Swap предел cgroups, а не выделенная память: занято столько, сколько ест система внутри
      --rootfs local-lvm:8 Disks корневой том 8 ГБ на тонком пуле; на ZFS — local-zfs:8
      --net0 … Network eth0 в мосте vmbr0, свой адрес; ip=dhcp — адрес от роутера
      --ssh-public-keys SSH public key(s) ключ попадает в /root/.ssh/authorized_keys контейнера
      --onboot 1 Start at boot запуск после перезагрузки хоста

      Пароль root не задаём: внутрь входим по ключу, а с хоста — pct enter. Контейнер стартует за пару секунд.

    3. Входим и обновляем

      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 уровня ядра в контейнере не настраиваются: это делается на хосте и действует на всех.

    4. Подключаем каталог хоста

      Данные, которые нужны и хосту, и контейнеру, — например, общая папка, — держим в каталоге хоста и подключаем в контейнер. Сначала отдаём каталог root контейнера: на хосте это uid 100000.

      mkdir -p /srv/share
      chown 100000:100000 /srv/share
      pct set 201 -mp0 /srv/share,mp=/srv/share
      pct reboot 201
      • mp0 — первая точка монтирования; следующие — mp1, mp2.
      • Путь на хосте — без символических ссылок: Proxmox их не принимает.
      • Каталог хоста подключает только root@pam, и только командой: мастер точек монтирования в интерфейсе создаёт тома на хранилищах, а каталоги хоста не предлагает.
      • Если в контейнере писать будет пользователь с uid 1000 — на хосте это 101000:101000.

      В бэкап контейнера такой каталог не попадает: vzdump копирует только тома Proxmox. Каталог хоста бэкапим отдельно, с хоста.

    5. Ставим 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 работает.

    6. Делаем снимок

      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 контейнер снова отвечает через пару секунд.