Что-то не работает¶

Типовые проблемы: что проверить самому за пару минут — и когда звать поддержку поставщика. Внутрь серверов лезть не нужно.

ПК не в сети (в админке серый / «агент оффлайн»)¶

ПК включён и подключён кабелем? Кабель/порт коммутатора целы?
Перезагрузите ПК — агент стартует сам.
Не в сети все ПК сразу → проблема не в ПК: проверьте коммутатор и что панель жива (открывается ли админка).
Не помогло → поддержка (сообщите номер ПК).

ПК заперт в лаунчере, пароль Ctrl+P не подходит¶

Три способа выйти без переустановки Windows — в разделе Игровой ПК → Аварийный выход.

Не запускается игра¶

Игра не запускается на одном ПК: перезагрузите этот ПК; если не помогло — админка → Инфраструктура → этот ПК → пересоздать игровой диск (займёт пару минут), затем снова попробовать.
Не запускается на всех ПК: почти всегда это хранилище. Проверьте в админке раздел Инфраструктура → Хранилище (доступно ли). Если недоступно — не перезагружайте ничего массово, звоните в поддержку.
Конкретная игра просит обновление — дождитесь ночного обновления или запустите её обновление вручную через админку (машина обновлений).
Игра из RentalGames (аренда аккаунтов) не входит, просит токен или не выдаёт аккаунт — в консоли поддержки сценарий «RentalGames: ошибка, не входит…»: он сам проверит серверы поставщика, версию клиента, заморозку и сеть и скажет, где причина (см. Консоль поддержки).

Windows на ПК предлагает «проверить диск» (chkdsk)¶

Нажимать ничего не нужно — проверку система чинит автоматически на стороне хранилища. Если такое окно стало появляться регулярно — сообщите поддержке.

Медленно качается игра (кэш не работает)¶

Признак: загрузка в Steam идёт со скоростью интернета, а не локальной сети.

Проверьте DNS-настройку на роутере — инструкция: на игровом ПК команда nslookup lancache.steamcontent.com должна возвращать адрес кэша.
Первая загрузка новой игры всегда идёт из интернета — быстро будет со второго ПК.
Диск кэша переполнен маленьким объёмом? Кэш сам вытесняет старое, но при маленьком диске польза падает — рассмотрите увеличение.

При установке компонент «пропущено», хотя галочка стояла¶

Галочка в составе — это «хочу компонент», но шагу нужен ещё и источник/ условие, иначе он честно пропускается (причина написана в строке шага):

Компонент	Что ему нужно кроме галочки
TrueNAS	Источник образа: поле «TrueNAS-ISO» (имя файла в ISO-хранилище Proxmox или URL), или шаблон, или образ в комплекте
FOG	Обязательный «Статический IP FOG» на экране «Сеть»
Windows-VM	«Windows-ISO» (или живой код активации — тогда ISO приедет с портала)

Исправление: задайте недостающее поле в мастере и перезапустите установку — она продолжит с места остановки, готовые компоненты не пересоздаются, добавится только недостающее.

Удалить виртуальную машину в Proxmox (если что-то пошло не так)¶

Иногда при установке нужно снести созданную виртуальную машину и попробовать заново — например, машина зависла на загрузке или вы ошиблись в настройках. Есть два пути.

Путь 1 — через мастер (обычно достаточно)¶

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

Путь 2 — вручную командой (если мастер недоступен)¶

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

Сначала посмотрите список машин и найдите нужный номер (VMID):

qm list

Слева в столбце VMID — номер машины, рядом её имя (gc-panel, gc-cache, gc-fog, gc-truenas, gc-winupd). Машины, созданные установщиком, имеют номера от 200 и выше.

Удалить одну машину по её номеру (замените 202 на нужный VMID):

qm stop 202            # выключить (если запущена)
qm destroy 202 --purge # удалить машину и все её диски

--purge заодно вычищает машину из бэкапов и заданий — VMID полностью освобождается.

Проверьте номер дважды

Команда qm destroy необратима — диск удаляется вместе с машиной. Прежде чем удалять, убедитесь по qm list, что это именно созданная установщиком машина (номер ≥ 200, имя gc-*), а не ваш рабочий клуб или другая нужная VM. При малейших сомнениях — позвоните в поддержку.

Удалить сразу все машины установщика (безопасно: удаляются только машины с меткой 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

После удаления машин запускайте установку заново — см. «Начать с чистого листа».

Установка: «клубу не выпущена лицензия» на шаге активации¶

Это не ошибка связи: портал получил ваш код, клуб создан, но поставщик ещё не выпустил лицензию. Код активации не потрачен. Свяжитесь с поставщиком («выпустите лицензию клубу»), затем в мастере нажмите «Повторить».

«Клуб не активирован» / предупреждение о лицензии¶

Есть ли на сервере интернет? (Клуб подтверждает лицензию у портала; без интернета какое-то время работает резервный режим — это штатно.)
Лицензия могла истечь — статус в Система → Лицензия. Продление — там же оплатой или у поставщика; новый код активации вводится в разделе «Система». Клуб в это время работает на Free — см. Редакции и лицензия.
Раздел с замком «Входит в Lite» / «Входит в Pro» — это не ошибка: раздела нет в вашей редакции.
Интернет есть, срок не вышел, а предупреждение висит больше суток — поддержка.

Оплата прошла, а баланс не пополнился¶

Подождите 1–2 минуты и обновите — уведомления иногда приходят с задержкой.
Проверьте платёж в личном кабинете ЮKassa: если он там «успешен», а баланса нет — не дошло уведомление. Убедитесь, что адрес уведомлений в ЮKassa указан верно (какой) и что публичный домен клуба открывается по HTTPS.
Гостя можно выручить сразу: пополнить баланс вручную из админки (с пометкой), а причину разобрать потом.
Повторяется — поддержка (пришлите номер платежа из ЮKassa).

Приложение игрока не открывается с телефона¶

Телефон в сети клуба (Wi-Fi)? Локальный адрес :3002 доступен только изнутри клуба.
Через публичный домен — проверьте, что домен открывается по HTTPS из мобильного интернета; если нет — проблема с доменом/сертификатом, поддержка.

Гость не может войти — код из SMS не приходит¶

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

Бронь не подтверждается¶

Откройте Настройки → Бронирования и проверьте:
включено ли автоподтверждение броней;
лимиты (сколько броней на гостя, на какой срок вперёд) — гость мог упереться в лимит;
аванс — если бронь требует предоплату, без неё подтверждение ждёт оплаты.
Гость просит перенести бронь, а кнопка неактивна — перенос за пределами лимитов гостя может сделать администратор (Сессии и брони).

Сессия зависла и не закрывается¶

Админка → карта зала → клик по зависшему ПК → «Завершить сессию» (принудительно).
⚠️ Деньги, уже списанные за игру, не вернутся — если гость обиделся из-за сбоя, оформите возврат вручную с описанием причины (как).
ПК после этого остался «занятым» → перезагрузите его с карты зала.

«ПК не на связи — команда не отправлена»

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

Баннер или новость не видит гость¶

Проверьте статус объявления — оно должно быть «активно», а не «черновик» или «завершено».
Проверьте расписание: даты показа и время — баннер мог ещё не начаться или уже закончиться.
Проверьте где показывать: целевая платформа pwa (приложение на телефоне) или shell (экран игрового ПК) — гость может смотреть не туда, куда вы отправили баннер.

Обновление шелла не пришло на ПК¶

Проверьте канал обновлений клуба (Система → Обновления): stable-клуб никогда не получит beta-версию — если версия beta, на stable она просто не появится.
Нажмите «Проверить сейчас» (не чаще раза в минуту).
Обновление видно, но на ПК старая версия → откройте вкладку «Версии на ПК» и раскатайте версию на нужные ПК вручную (подробнее).

Обновление игры «висит» на машине обновлений¶

Откройте удалённый экран машины из админки — что там происходит? Большие обновления могут идти часами, это нормально.
Реально зависло → отмените загрузку в самом лаунчере (Steam и т.п.) или перезапустите агент обновлений из админки.
‼️ Не завершайте процессы лаунчеров «через диспетчер задач» наугад — у некоторых есть системные процессы, убийство которых роняет Windows в синий экран.

Админка не открывается¶

С другого устройства тоже не открывается?
Сервер включён? (Экран/индикаторы, доступен ли веб-интерфейс Proxmox.)
Электричество мигало? Дайте серверу 5–10 минут после включения — всё поднимается само.
Не поднялось — поддержка. Не перезагружайте сервер многократно.

Где искать логи (поддержка может попросить)¶

Сами логи разбирать не нужно — но если поддержка просит «пришлите лог», вот где они лежат.

На игровом ПК (открывать PowerShell «от имени администратора»):

Что	Где
Служба агента (ошибки запуска)	`C:\Windows\Microsoft\GameServices\gs_service\agent\service_stderr.log`
Оболочка (лаунчер на экране гостя)	`%LOCALAPPDATA%\club.gamezone.shell\logs\shell-v2.log`

Быстро скопировать хвост лога:

Get-Content 'C:\Windows\Microsoft\GameServices\gs_service\agent\service_stderr.log' -Tail 30
Get-Content "$env:LOCALAPPDATA\club.gamezone.shell\logs\shell-v2.log" -Tail 30

На машине обновлений: C:\gameupdatebot\logs\bot.log.

На сервере логи собирает поддержка сама — туда лезть не нужно.

Отчёт о ПК для поддержки¶

Когда вы спрашиваете ИИ-техподдержку про конкретный ПК, она сама снимает с него отчёт: версии программ, связь с сервером, диски с играми, устройства, последние ошибки Windows. Пароли и ключи в отчёт не попадают, вам ничего делать не нужно. ПК должен быть включён и в сети; сбор занимает 1–3 минуты.

Если ПК не в сети, а поддержка просит отчёт, снимите его руками:

На ПК откройте папку агента C:\Windows\Microsoft\GameServices\gs_service\agent.
Правой кнопкой по diagnose.bat → Запуск от имени администратора.
Через пару минут откроется Блокнот с gc-diagnose.txt — этот файл и пришлите в поддержку.

Файл, снятый руками, содержит настройки ПК без маски

Отправляйте его только в поддержку, не в общие чаты.

Отчёт обновляется вместе с программой на ПК: отдельно его ставить не нужно.

Когда звоните в поддержку — что подготовить¶

Что не работает и с какого времени; один ПК или все.
Скриншот/фото ошибки.
Что делали перед этим (обновление, отключение света, перестановка сети).
Номер платежа/ПК/игры — если про них речь.

Так диагностика займёт минуты, а не часы.

Установка: шаг Steam-кэша красный¶

Сообщение «Установка Steam-кэша завершилась ошибкой». На живом прогоне так случалось из-за разового сбоя сети при скачивании: нажмите «Повторить», шаг продолжится с места обрыва. Если ошибка повторяется, в тексте ошибки будет последняя строка вывода установщика кэша — продиктуйте её поддержке.

Мастер установки открылся с первого экрана посреди установки¶

Так бывает после перезапуска сервера или повторного запуска команды установщика. Ответы сохранены: войдите новым кодом установки (cat /var/lib/gc-provisioner/setup-code), пройдите экраны «Далее», на экране «Клуб» введите пароль владельца ещё раз и нажмите «Создать клуб». Уже готовые машины не переделываются.

Коды ошибок мастера установки¶

Если мастер установки (http://<ip-сервера>:8010) показал красный шаг — в окне ошибки есть код вида GC-SETUP-NNN. Продиктуйте его поддержке или пришлите фото экрана. Что можно проверить самому:

Код	Что случилось	Что сделать самому
GC-SETUP-001	Ошибка без своего кода	Нажмите «Повторить»; не помогло — скачайте диагностический отчёт и в поддержку
GC-SETUP-010	Установка уже завершена — мастер не поднимается	Это защита от переналива живого клуба. Хотите переустановить — следуйте подсказке в консоли (файл `force-wizard`)
GC-SETUP-020	Хост не готов (нет места/моста/старый Proxmox)	Исправьте перечисленное на сервере, «Проверить снова»
GC-SETUP-021	Подсказка по ресурсам: места или памяти меньше желательного	Это не ошибка. Прочитайте, сколько желательно каждому сервису; снимите лишнее на экране «Состав» или отметьте «Понятно, продолжаем» и нажмите «Проверить снова»
GC-SETUP-030	Некорректный статический IP (опечатка)	Исправьте поле на экране «Сеть» (формат `192.168.1.88` или `192.168.1.88/24`), «Повторить»
GC-SETUP-031	Статический IP уже занят другим устройством	Возьмите другой адрес (мастер подсказывает свободные), «Повторить»
GC-SETUP-032	Некорректный шлюз	Обычно шлюз = как у Proxmox-хоста; мастер подставляет его сам. Исправьте, «Повторить»
GC-SETUP-040	VM не завершила первичную загрузку	Чаще всего — занятый/неверный IP или шлюз (VM без интернета). Проверьте сеть на экране «Сеть», консоль VM в Proxmox, «Повторить»
GC-SETUP-041	VM не сообщила IP-адрес	Проверьте DHCP в сети клуба, «Повторить»
GC-SETUP-050	Установка панели внутри VM упала	«Повторить»; повторно — диагностический отчёт в поддержку
GC-SETUP-051	Не прочитан ключ агента панели	Повторите установку панели, затем Windows-VM
GC-SETUP-060	FOG-VM без доступа в интернет	Почти всегда — занятый/неверный IP или шлюз FOG. Проверьте и «Повторить»
GC-SETUP-061	Автоустановка FOG упала	«Повторить» или снимите галочку FOG (клуб доедет без него)
GC-SETUP-062	FOG установлен, но ключ API не прочитан	«Повторить»; ключи можно вписать в панель позже вручную
GC-SETUP-070	Портал отказал (claim-код сгорел или комплект не готов)	Код активации сгорел или комплект ещё не готов — обратитесь к поставщику
GC-SETUP-071	Портал недоступен	Проверьте интернет на сервере и статус подписки; докачка продолжится с места обрыва
GC-SETUP-072	Комплект поставки неполный (нет образов клуба)	Распакуйте полный комплект или используйте код активации — мастер докачает сам
GC-SETUP-080 / 081	Не удалось связать панель с компонентами	«Повторить»; повторно — отчёт в поддержку
GC-SETUP-090	Финальная проверка панели не прошла	«Повторить» через минуту; повторно — отчёт в поддержку
GC-SETUP-100	TrueNAS: включён проброс дисков, но диски не отмечены	Отметьте диски на экране «Диски» или снимите галочку проброса
GC-SETUP-101	TrueNAS: один диск отмечен и под игры, и под сохранения	Уберите диск из одного из списков
GC-SETUP-102	TrueNAS: дисков мало под выбранный тип массива	Добавьте дисков или понизьте тип (mirror≥2, raidz1≥2, raidz2≥3)
GC-SETUP-103	TrueNAS: выбранное хранилище не принимает диски VM	Выберите другое хранилище на экране «Диски» (не бэкапное/ISO)
GC-SETUP-110	TrueNAS в режиме «подключу диски сам» без пароля	Задайте «Пароль администратора TrueNAS» (Сеть → Дополнительно), или смените режим дисков на «Виртуальные диски»
GC-SETUP-111	TrueNAS: выбранные физические диски исчезли с сервера	«Проверить снова» на экране проверки хоста, выбрать диски заново
GC-SETUP-120	Активация: некорректный адрес портала	Проверьте адрес портала (https://…) и повторите
GC-SETUP-121	Активация: клубу не выпущена лицензия (код НЕ потрачен)	Попросите поставщика выпустить лицензию клубу и нажмите «Повторить»; либо уберите код, чтобы поставить без лицензии
GC-SETUP-122	Активация: код неверный, использован или истёк	Возьмите новый код активации у поставщика
GC-SETUP-123	Активация: портал недоступен	Проверьте интернет на сервере и адрес портала, «Повторить»
GC-SETUP-124	Активация: код недопустимого формата	8–128 символов A–Z, 0–9, «-», «_»
GC-SETUP-125	Активация: портал вернул неполный ответ	«Повторить»; при повторе — к поставщику
GC-SETUP-126 / 127 / 128	Активация: не удалось записать/применить/проверить лицензию на панели	«Повторить»; при повторе — скачайте отчёт
GC-SETUP-129	Активация: лицензия принадлежит другому клубу	К поставщику: выдан код от чужой лицензии

Образы VM не уходят в облако / «образов пока нет»¶

На Proxmox-хосте: sheldon-pve status — есть ли локальные образы у VM (столбец «последний образ») и настроено ли облако. «не настроено» → sheldon-pve offsite setup.
«VM N не входит ни в одно задание vzdump» — задание sheldon-images не создалось при установке (не было хранилища с типом «Backup»): Datacenter → Storage → добавьте хранилище с содержимым «VZDump backup file», затем Datacenter → Backup → Add, VM по списку из отчёта установки, 04:00, хранить 2 копии.
Первая выгрузка в облако — по расписанию 1-го числа 07:30; руками сейчас: sheldon-pve offsite upload. Лог: /var/log/sheldon-pve.log. Предупреждение «локального vzdump нет» означает, что ночное задание для этой VM ещё не отработало — выгрузка остальных VM при этом проходит.
Нет связи с облаком / «пароль образов не подходит» — sheldon-pve offsite check; ключи и пароль лежат в /etc/sheldon/offsite.env (только root).