Установка по шагам (мастер)

Ниже — установка строка в строку: что печатает консоль, какие экраны показывает мастер, каждое поле с его значением по умолчанию. Поля с пометкой (расш.) спрятаны в «расширенных» — раскрывать их обычно не нужно.

Шаг 0. Консоль: get-club.sh

После двух команд запуска скрипт печатает этапы:

[*] Проверки
  [OK] Proxmox VE обнаружен (qm/pvesm есть)
[*] Комплект с портала: gc-setup              (только при онлайн-установке)
  [OK] мета получена: gc-setup.tar.gz, … МБ, версия …
  [OK] места хватает: нужно … ГБ, свободно … ГБ
  [OK] скачано и сверено: … (sha256 …)
  [OK] комплект получен с портала: …
[*] Комплект gc-provisioner
  [OK] архив распакован (sha256: …)
[*] Хранилище snippets (cloud-init)
  [OK] snippets включены на storage local (…)   (или: snippets уже включены…)
[*] Установка gc-provisioner в /opt/gc-provisioner
  [OK] поставлены пакеты: python3-venv rsync genisoimage wimtools   (или: системные пакеты на месте)
  [OK] код активации сохранён для мастера (одноразовый seed)
  [OK] файлы скопированы
  [OK] venv готов
[*] sheldon-pve (образы VM)
  [OK] sheldon-pve установлен: sheldon-pve status | restore | offsite
[*] systemd-unit
  [OK] gc-provisioner.service запущен
[*] Готово
=========================================================
  Мастер установки клуба (с голого Proxmox)
  Откройте в браузере:  http://<ip-сервера>:8010
  Код установки:        ABCD-EFGH
  Fingerprint комплекта: <длинная строка>
  (сверьте fingerprint с письмом поставщика)
  Памятка сохранена:    cat /var/lib/gc-provisioner/install-info.txt
=========================================================

Пакеты ставятся только при первом запуске; при повторном будет «системные пакеты на месте».

Что с этим делать:

• Откройте в браузере адрес http://<ip-сервера>:8010 с любого компьютера в той же сети.
• Код установки — одноразовый пароль входа в мастер, вида ABCD-EFGH. Потеряли — актуальный лежит в cat /var/lib/gc-provisioner/setup-code (код меняется при перезапуске сервиса).
• Fingerprint — сверьте с письмом поставщика: совпадает = комплект подлинный.

Возможные сообщения:

Строка	Что значит
это не Proxmox-хост (нет qm/pvesm)	Запускаете не на Proxmox — установщик работает только на нём
не удалось получить комплект с портала	Нет интернета/код неверный — проверьте код активации или ставьте офлайн с комплекта
[!] не удалось авто-включить snippets…	Некритично: включите вручную в Proxmox — Datacenter → Storage → local → Content → добавить Snippets

Вход в мастер

Браузер → http://<ip-сервера>:8010 → введите код установки из консоли. Дальше — экраны мастера: ① проверка сервера, ② состав клуба, ③ диски TrueNAS, ④ клуб, ⑤ сеть, затем установка и отчёт. Ниже — поля экранов ②–⑤ (проверка сервера идёт сама).

Экран ② «Состав клуба»

Пять галочек — что ставить:

Поле	По умолчанию	Пояснение мастера
Панель клуба	✅ (обязательно)	Сервер управления клубом (админка, PWA, API)
Steam-кэш	✅	Кэш загрузок Steam — ускоряет установку игр и экономит канал. DNS-перехват на роутере настраивается после установки
Хранилище TrueNAS (VM)	✅	VM хранилища игр (iSCSI/SMB). Нужен шаблон/ISO TrueNAS и отдельный диск под игры; если нет — шаг честно пропускается
FOG-сервер (образы ПК)	☐	Ставится автоматически; требует статический IP (задать на экране «Сеть»). Раздача по PXE по умолчанию выключена
Windows-VM машины обновлений	☐	Windows ставится начисто из ISO (autounattend + VirtIO). Нужен Windows-ISO (триал ок, активация своим ключом потом) + VirtIO-ISO. Требует UEFI-хост

Копии образов VM

Под составом — блок «Копии образов VM». Это снимки виртуальных машин целиком (система, программы, настройки), которые Proxmox делает каждую ночь в 04:00 и хранит на самом сервере (две последние копии). Они нужны, чтобы после поломки сервера поднять клуб за полчаса, не переустанавливая ничего. Данные клуба (база, оплаты, настройки) защищены отдельно — ночными копиями в облако из админки (Настройки → Бэкапы), это разные вещи.

📷 Скриншот: Экран «Состав клуба»: блок «Копии образов VM» — будет добавлен.

Галочка	По умолчанию	Что входит в образ	Что НЕ входит
Образ панели клуба	✅ (не снимается)	система, docker, данные панели	—
Образ TrueNAS	✅	системный диск TrueNAS (ОС и настройки)	диски игр и сохранений (игры скачиваются заново, сохранения — зеркальный массив); настройки TrueNAS есть ещё и в ночной копии данных
Образ FOG-сервера	✅	ОС и образы ПК — обычно 20–30 ГБ	— (снимите, если образы ПК проще снять заново)
Образ Steam-кэша	☐	ОС + весь кэш (сотни ГБ)	— (кэш пересоздаётся сам, поэтому выключено)
Образ Windows-VM машины обновлений	☐	вся Windows (~80 ГБ)	— (Windows ставится из ISO автоматически)

Галочка показывается только для отмеченного компонента. Установщик сам создаст задание резервного копирования в Proxmox (Datacenter → Backup, задание sheldon-images) на хранилище с типом «Backup» — если такого хранилища нет, в отчёте будет замечание, что и как добавить. В облако (защита от пожара и кражи сервера) образы уходят раз в месяц после короткой настройки на Proxmox-хосте — см. «Образы виртуальных машин».

Там же, в свёрнутом блоке «Ресурсы VM», — сколько выделить каждой VM. Мастер сам поднимет значения до минимума, если введёте меньше (минимумы).

Поле	По умолчанию
Панель: ядра CPU	8
Панель: память, ГБ	16
Панель: диск, ГБ	200
Кэш: ядра CPU	2
Кэш: память, ГБ	4
Кэш: диск, ГБ (сами загрузки Steam кэшируются в пределах 150 ГБ — подробнее)	300
TrueNAS: ядра CPU	4
TrueNAS: память, ГБ	8
FOG: ядра CPU	2
FOG: память, ГБ	4
FOG: диск, ГБ — место под образы ПК	200
Windows-VM: ядра CPU	4
Windows-VM: память, ГБ	8
Windows-VM: диск, ГБ	100

Экран ③ «Диски TrueNAS»

Отдельный экран: где будут жить игры и сохранения. Три пути на выбор (переключатель сверху), поля показываются по выбранному:

• Физические диски сервера целиком (проброс) — быстрее всего; выбранные диски будут стёрты (подробнее);
• Виртуальные диски на хранилище Proxmox — классика: мастер нарежет диски нужного числа и размера;
• Подключу диски сам (вручную в TrueNAS) — мастер поставит TrueNAS без дисков под игры: после установки сами подключите диски к VM, соберёте пул nvme-games в веб-интерфейсе TrueNAS и настроите хранилище в админке панели. ⚠️ Обязательно задайте «Пароль администратора TrueNAS» (экран «Сеть» → Дополнительно) — без него в веб-интерфейс не войти, мастер это проверит.

Поле	По умолчанию	Пояснение
Физические диски пула игр	—	Чекбокс-список свободных дисков (появляется после «Проверки хоста»); отметьте по минимуму массива
Тип массива пула игр	Single	Single — вся ёмкость без защиты · Mirror ≥2 · RAID-Z1 ≥2 · RAID-Z2 ≥3, у каждого варианта — подсказка
Хранилище Proxmox для виртуальных data-дисков	—	Без проброса; в списке только хранилища, куда можно класть диски VM (бэкапные/ISO не подходят). Пусто = туда же, куда системный диск
Число виртуальных data-дисков	1	Минимум по типу массива
Размер одного data-диска, ГБ	500	Итоговая ёмкость зависит от типа массива
Отдельный массив под сохранения игроков	☐	Игры на NVMe, сейвы на HDD-зеркале (зачем); откроет свои поля дисков/массива
Мастер-том игр, ГБ (расш.)	200	Том, с которого клонируются диски ПК; «тонкий», 0 = не создавать
Имя пула сохранений (расш.)	saves-pool	При включённом отдельном массиве

Мастер сам проверит «дисков хватает под выбранный массив» ещё до отправки — и повторно перед созданием VM.

Экран ④ «Клуб» (и активация лицензии)

Поле	Обяз.	Пояснение
Название клуба	да	Показывается игрокам в лаунчере и чеках
Часовой пояс	да	Список российских зон, по умолчанию Europe/Moscow
Логин владельца	да	Ваша учётка в админке (по умолчанию owner)
Пароль владельца	да	Минимум 10 символов. Технические секреты (пароли БД, ключи) создаются сами — их запоминать не нужно
Адрес портала активации	—	Предзаполнен https://licenses.shldn.su — менять только если поставщик дал другой
Код активации (claim-код от поставщика)	нет	Одноразовый claim-код от поставщика (8–128 символов). Если вводили его в консоли при запуске get-club.sh — уже подставлен. Пусто = клуб без лицензии, активируете позже. Код гасится после успешной активации
Резервный bootstrap (если портал недоступен) (расш.)	нет	Только если портал недоступен: вставьте текст лицензии, который пришлёт поставщик

Не путайте три кода

Код активации (claim-код) — от поставщика, активирует лицензию (это поле). Код установки — печатается в консоли при запуске get-club.sh; это только вход на страницу мастера, к лицензии отношения не имеет. Номер лицензии — внутренний номер у поставщика; вводить его никуда не нужно.

Экран ⑤ «Сеть и размещение»

Основные поля:

Поле	По умолчанию	Пояснение
IP-адресация VM	Авто (DHCP)	«Авто (DHCP; резервации подскажем в отчёте)» / «Статические адреса (задать вручную)». Мы советуем статические — см. этап 4
Продолжить, даже если ресурсов меньше желательного	☐	Галочка видна всегда. Нужна, только если на экране ① была «Подсказка по ресурсам» и вы решили продолжить. Фатальные проблемы (нет места/моста) так не обойти
Сетевой мост Proxmox	vmbr0	Обычно менять не нужно
FOG: включить раздачу по PXE (proxyDHCP)	☐	Оставьте выключенной. Загрузка ПК по сети настраивается после установки — см. FOG

Мастер почти всё заполняет сам

После «Проверки хоста» мастер сам подставляет: шлюз (берётся у самого Proxmox), свободные статические IP для каждой роли (проверив, что адреса никем не заняты) и хранилище с наибольшим свободным местом. В большинстве случаев на этом экране ничего вводить не нужно.

Стандартные адреса клуба (единая схема у всех клиентов — так поддержке проще помогать): панель — .86, TrueNAS — .87, FOG — .88, Steam-кэш — .89 от вашей подсети (например 192.168.1.86). Если стандартный адрес занят, мастер предложит ближайший свободный начиная с .90.

IP можно вводить и без маски (192.168.1.88) — мастер сам допишет /24 вашей подсети. Опечатка в адресе или шлюзе теперь ловится сразу при вводе (поле подсветится красным), а не в середине установки.

Расширенные поля (открывайте при необходимости):

Поле	По умолчанию	Когда трогать
Шлюз (для статики)	шлюз Proxmox-хоста (автоматически)	Менять только если VM должны ходить через другой шлюз
Статический IP панели (CIDR)	свободный .86 (автоматически)	Пусто при авто-режиме
Статический IP кэша (CIDR)	свободный .89 (автоматически)	То же
Статический IP TrueNAS (CIDR)	свободный .87 (автоматически)	Рекомендуется оставить: панель ходит к хранилищу постоянно; DHCP-адрес может смениться
Пароль администратора TrueNAS	—	≥6 символов; пусто = сгенерируется случайный (попадёт в финальный отчёт)
Имя пула данных TrueNAS	nvme-games	Не менять: панель ждёт именно nvme-games
Статический IP FOG (CIDR) — обязателен	свободный .88 (автоматически)	Без него FOG пропускается
Хранилище дисков VM (Proxmox)	хранилище с максимумом места (автоматически)	Куда класть диски VM; список появляется после проверки хоста
Базовый VMID	200	С какого номера искать свободные ID; существующие VM неприкосновенны
VMID cloud-шаблона Ubuntu	—	Если есть шаблон — клонирование быстрее; пусто = импорт образа из комплекта
VMID шаблона TrueNAS	—	Пусто = TrueNAS ставится сам из ISO/образа комплекта
TrueNAS-ISO (файл или URL)	—	Имя в ISO-хранилище Proxmox или прямая ссылка; установка полностью автоматическая
Windows-ISO (файл или URL)	—	По ссылке Proxmox докачает сам (один раз, с кэшем). Рекомендуется официальный триал Microsoft. Пусто = Windows-VM пропускается
SHA256 Windows-ISO	—	Проверка скачанного; пусто = без проверки
VirtIO-драйверы (ISO или URL)	virtio-win.iso	Без них Windows не увидит диск/сеть
SHA256 VirtIO-ISO	—	То же
Редакция Windows (для autounattend)	Windows 11 Pro	Точное имя образа в ISO; если в ISO один образ — мастер возьмёт его сам
Пароль локального админа Windows-VM	—	Пусто = сгенерируется случайный

Установка: шаги прогресса

Сначала мастер проверяет сервер (экран «Проверка Proxmox-хоста»), затем после «Создать клуб» показывает шаги в этом порядке (каждый — зелёный / жёлтый «пропущен» / красный):

1. Проверка лицензии — код активации проверяется на портале (сам код ещё не тратится)
2. Раскладка VM — план: какие VM, какие VMID/ресурсы
3. Комплект поставки — образы/ISO на месте (докачка при необходимости)
4. Панель клуба (VM + установка) — создаётся VM, внутри ставится панель. Самый долгий шаг
5. Хранилище TrueNAS (VM + автонастройка) — установка из ISO/шаблона, пул, тома, шары
6. Steam-кэш (VM)
7. FOG-сервер (образы ПК) — если включали
8. Windows-VM обновлений — если включали (установка Windows ~15–30 мин)
9. Копии образов VM — ночное задание копий на сервере
10. Связывание компонентов — адреса и ключи всех VM прописываются в админку
11. Активация лицензии — по коду через портал; здесь код тратится
12. Проверка клуба целиком — смоук всех компонентов
13. Регистрация в пульте (позже) — задел на будущее, всегда пропускается
14. Готово — отчёт

При восстановлении из копии добавляются шаги «Параметры копии клуба» и «Панель из образа VM (облако)».

Жёлтый «пропущен» у необязательного компонента — это штатно (нет ISO/галочки): клуб доедет без него, добавить можно потом. Красный шаг — не приговор. В окне ошибки теперь показывается код ошибки вида GC-SETUP-040 — при звонке в поддержку просто продиктуйте его (или пришлите фото экрана), это сильно ускорит разбор (каталог кодов). У окна ошибки четыре кнопки:

• Повторить — мастер продолжит с места обрыва, готовое не переделывает (а если вы перед этим исправили сетевые поля — новые значения доедут до уже созданных VM автоматически);
• Изменить настройки — вернёт к экранам анкеты (например, выбрать другое хранилище на «Дисках»), затем пройдите «Далее» до установки — она продолжится с учётом правок;
• Отменить и начать заново — удалит виртуальные машины, созданные этой установкой (существующие VM сервера не трогаются), ответы анкеты сохранятся;
• Скачать диагностический отчёт — для поддержки.

Во время установки есть кнопка «⏸ Остановить установку»: мастер мягко остановится после текущей операции; дальше те же три пути — продолжить, изменить настройки или начать заново.

Отчёт — распечатайте его

Финальная страница показывает всё, что нужно клубу на бумаге:

• адреса: админка http://<ip-панели>:3003, приложение игрока :3002, TrueNAS, кэш, FOG;
• логины и все автоматически сгенерированные пароли (TrueNAS, база FOG, SMB сохранений…) — показываются один раз;
• IP всех VM и их роли → настройте роутер;
• стандартные порты всех сервисов;
• статус лицензии; что пропущено и почему.

Нажмите «🖨 Версия для печати» и распечатайте страницу. Копия отчёта сохранена на сервере в /var/lib/gc-provisioner/install-report.txt (виден только root): распечатали — удалите файл командой rm /var/lib/gc-provisioner/install-report.txt.

После отчёта мастер сам останавливается (порт 8010 закрывается) — это нормально. Повторная установка/донастройка — снова bash get-club.sh ….

Мастер не верит устаревшим галочкам

Если виртуальные машины клуба были удалены вне мастера (например, вы снесли их в Proxmox), при следующем запуске мастер сам заметит это, вернёт соответствующие шаги в «не сделано» и создаст VM заново — ложного «Клуб создан!» больше не будет.

Установка не удалась — как начать с чистого листа

Сначала попробуйте кнопку. Внизу мастера есть «Отменить и начать заново» — она удаляет только виртуальные машины, созданные этой установкой, и сохраняет ваши ответы: исправляете одно поле и запускаете установку снова.

Если мастер не открывается — полная очистка. На сервере (та же консоль, где запускали get-club.sh), команды по одной:

# 1. Остановить установщик
systemctl stop gc-provisioner

# 2. Удалить виртуальные машины, созданные установкой
#    (у них стоит метка gc-provisioner — чужие машины цикл не тронет)
for id in $(qm list | awk 'NR>1{print $1}'); do
  if qm config "$id" | grep -q '^tags:.*gc-provisioner'; then
    echo "удаляю VM $id"
    qm stop "$id" >/dev/null 2>&1
    qm destroy "$id" --purge
  fi
done

# 3. Стереть память установщика (в т.ч. ответы анкеты — заполнится заново)
rm -rf /var/lib/gc-provisioner

# 4. Запустить установку с начала
bash /opt/gc-provisioner/get-club.sh /opt/gc-provisioner

Откуда путь в шаге 4: при первой установке get-club.sh уже скопировал комплект на сервер в папку /opt/gc-provisioner. Ничего заново скачивать не нужно — ни флешка, ни портал. После запуска консоль снова напечатает адрес мастера и новый код установки; анкету мастер спросит заново, включая код активации на экране ④ (если старый не примут — попросите у поставщика новый).

⚠️ Если на этом же сервере уже есть работающий клуб или другие ваши виртуальные машины — команды из шага 2 их не тронут (удаляются только машины с меткой установщика), но при малейших сомнениях сначала позвоните в поддержку.

Восстановление клуба из копии (сервер сломался)

Если сервер сгорел, украден или вы переезжаете на новое железо, клуб поднимается тем же файлом установки, только с флагом --restore. Отдельно ставить Шелдон и потом «подключать бэкапы» не нужно.

Подготовьте (всё это вы сохраняли при включении бэкапов — в менеджере паролей и на бумаге):

Что	Где взять
Ключ бэкапов	показан один раз в Админке → Бэкапы при включении; без него копии не открыть
Ключи хранилища (Access/Secret key), бакет	личный кабинет облака (Yandex / Selectel / VK) или ваш SFTP/WebDAV
Новый claim-код	у поставщика — по нему скачивается комплект
Пароль образов VM	только если образы сервера уходили в облако (sheldon-pve offsite) — тогда панель поднимется из образа быстрее

# Proxmox (как при установке)
CLAIM_CODE=<код> bash get-club.sh --restore --portal-url https://licenses.shldn.su
# Ubuntu без Proxmox
CLAIM_CODE=<код> sudo -E bash get.sh --restore --portal-url https://licenses.shldn.su

Дальше — мастер, как при установке, но вместо экрана «Клуб» — экран «Копия клуба»:

📷 Скриншот: Экран «Что делаем?» — выбор «Восстановить клуб из копии» — будет добавлен.

📷 Скриншот: Экран «Копия клуба» — будет добавлен.

Поле	Что вводить
Где лежит копия	то же хранилище, что было в Админке → Бэкапы → Внешнее хранилище
Провайдер / адрес / бакет / папка	как были; для Selectel адрес пула из панели Selectel; папка по умолчанию sheldon
Access key / Secret key	ключи хранилища
Ключ бэкапов	из менеджера паролей / с бумаги
Какую копию восстановить	«Самая свежая» (по умолчанию) или конкретная из списка после «Проверить копии»

На Proxmox список копий появится уже внутри панели (мастер на хосте только проверяет поля). На Ubuntu нажмите «Проверить копии» — мастер покажет копии с датой, версией и числом строк:

📷 Скриншот: Список копий, выбор, подтверждение словом — будет добавлен.

Введите слово ВОССТАНОВИТЬ → «Восстановить». Мастер поставит сервисы, затем зальёт копию: база, файлы, настройки, интеграции (боты, платежи, VPN), лицензия. Старые данные (если были) не удаляются — остаются рядом.

📷 Скриншот: Готово: клуб восстановлен — будет добавлен.

После «Готово» войдите в админку прежними логином и паролем владельца. Если изменился IP сервера — укажите новый адрес агентам на игровых ПК и в DNS/прокси. Настройки TrueNAS из копии мастер подскажет в отчёте (файл → TrueNAS → System → General → Manage Configuration → Upload Config).

Что хранить вместе

В одной записи менеджера паролей: ключ бэкапов, claim-код установки, пароль образов VM, ключи хранилища. Без ключа бэкапов копии не открыть никому — ни вам, ни поставщику.

Образы VM у клиента. Если при установке стояли галочки «Копии образов VM» и вы включили облако (sheldon-pve offsite setup), мастер восстановления найдёт образ панели в облаке и поднимет её из образа, а свежие данные наложит из ночной копии (30–60 минут, в основном скачивание). TrueNAS и FOG из облачных образов поднимаются командой на Proxmox — sheldon-pve restore <VMID> --from cloud (подсказка есть в отчёте установки). Если образов не было — панель ставится заново и заливается копией данных (путь выше), TrueNAS/FOG создаются как при установке.