К руководству

Документация 9.6.24

Лицензия и обновление

Храните лицензию в секрете. Удаляйте токены со скриншотов.

Только на сервере#

Используйте server.cfg. Не размещайте лицензию в shared config, NUI, клиентских событиях и публичных репозиториях. Токены загрузки не заменяют серверную лицензию.

Официальное руководство Cfx

Обновите старые ключи#

Замените файлы пакетом 9.6.24 и перезапустите ресурсы во время обслуживания. Старые версии могли передать долговременные ключи клиентам. Остановите все старые экземпляры, затем совместно с администратором смените затронутые лицензии и старые ключи панели/API. Обновите настройки и проверьте связь. Установка обновления сама по себе не отзывает ранее раскрытые ключи.

Лицензионный ключ обязателен#

Пакеты, загруженные начиная с 7 октября 2026 года, не запускают античит без лицензионного ключа этого сервера. Без ключа или с ключом другого сервера сервер не принимает игроков, отключает подключённых и пишет причину в консоль.

Скопируйте ключ со страницы «Серверы» в панели и добавьте его в server.cfg перед строками ensure: set tosun_ac_license "ЛИЦЕНЗИЯ_СЕРВЕРА". Поле licenseKey в configs/anticheat_server.lua тоже подходит. Ключ, введённый позже (поздняя строка server.cfg или set в консоли), открывает сервер без перезапуска.

Если вы обновили лицензию в панели, старый пакет больше не совпадает с новым ключом; скачайте и установите пакет заново.

Правильные учётные данные#

Лицензия Tosun идентифицирует сервер и отличается от FiveM sv_licenseKey. API-токены компонентов могут иметь собственные области прав. Краткоживущие токены доказательств разрешают только загрузку; они не дают управление панелью или доступ мосту базы.

Выберите сервер в Servers и укажите его действующую лицензию через set в server.cfg. Замените пример своим значением. Не помещайте её в NUI, shared/client Lua и публичные репозитории. Мост использует ту же лицензию; действия панели также требуют прав аккаунта.

set tosun_ac_license "YOUR_SERVER_LICENSE"

Проверка действительно работающей версии#

Сохраните ресурс и настройки, скачайте нужный пакет и сравните инструкции интеграции. Заменяйте во время обслуживания. Убедитесь, что активна одна копия: новые файлы в другом каталоге не останавливают старый ресурс.

Локальная проверка формата или license-lock не подтверждает оплату. При inactive tenant или suspended server проверяйте подписку и реальный статус. Не скрывайте сбой авторизации отключением защиты.

  1. Сравните версию manifest и сообщения запуска со скачанным пакетом.
  2. Перенесите поддерживаемые настройки и проверьте телепорты, инвентарь и инструменты персонала.
  3. Начиная с 9.6.14 соединение с панелью и изменение баланса персонажей онлайн включены по умолчанию. Старые строки set tosun_db_bridge_enabled и set tosun_db_bridge_money_write игнорируются, их можно удалить; пакетам старше 9.6.14 они по-прежнему нужны. Если раньше соединение или изменение баланса было выключено, нажмите «Disable connection» в карточке Tosun Connect сервера или используйте ручной режим (set tosun_db_bridge_manual "1"), в котором значения из server.cfg действуют как раньше. Проверьте соединение небольшим чтением и обычную игру, прежде чем персонал начнёт менять балансы.

Замена раскрытого ключа#

Новые файлы не отзывают опубликованную лицензию или ключ, отправленный клиентам. Перегенерируйте лицензию в Servers, обновите защищённую настройку и проверьте подключение. Замену отдельных API-ключей согласуйте с администратором.

При просрочке проверьте счёт и действие оплаты в Billing. Замена ключа не исправляет платёж. При неясном результате провайдера сначала проверьте счёт; поддержке отправьте номер и очищенную ошибку, не лицензию.

  • Найдите все экземпляры и интеграции с ключом; остановите устаревшие перед заменой.
  • По возможности удалите секреты из публичной истории, скриншотов, резервных копий и обращений поддержки.
  • Новый ключ храните только в необходимой конфигурации, не включайте в общие диагностические команды.
  • При ошибках запишите ID сервера, время и очищенное сообщение; сначала проверьте сервер и подписку.

Планируйте смену ключа как техническое обслуживание#

Сопоставьте имя и ID выбранного сервера с работающей установкой. Запишите начало ошибки, версию ресурса и круг лиц с доступом к конфигурации. Просроченная подписка, выбор другого сервера и сетевой сбой требуют разных решений. Ошибка подключения сама по себе не подтверждает утечку.

При необходимости используйте обновление лицензии выбранной записи в разделе серверов. Меняется ключ той же записи; создавать новый сервер и занимать квоту не нужно. Остановите старые копии и частные интеграции, обновите защищённый server.cfg и перезапустите по плану обслуживания. Не помещайте постоянный ключ в браузерный код.

Сохраняйте запись сервера при переустановке#

Переустановка файлов отличается от удаления сервера в панели. Если файлы повреждены, снова скачайте пакет правильного существующего сервера. Отдельно сохраните редактируемые настройки, а старую папку держите вне активного пути ресурсов.

Сравните версию манифеста, порядок зависимостей и конфигурацию. После запуска проверьте нужный сервер в панели. Для включённого моста достаточно небольшого чтения, чтобы проверить авторизацию; не изменяйте баланс. Принимайте установку после проверки одной активной копии, ожидаемой версии и обычных игровых сценариев.

Описывайте сбой без секретов#

Укажите ID, версию, время первой ошибки, последнего успешного соединения и последовательность изменений. Различайте отказ авторизации и сетевую недоступность. Удалите лицензию, заголовки Authorization, строки подключения и персональные данные из журналов. Передавайте нужный фрагмент, а не полную приватную резервную копию.

После смены не возвращайте скомпрометированный ключ. При откате файлов перенесите действующий ключ в восстановленную конфигурацию. Устраните источник утечки, например открытый репозиторий. Завершите обслуживание датированной записью о восстановленной связи, остановленных старых копиях и удалённых ненужных доступах.

Читайте лицензионные сессии при переезде#

Перед переносом остановите старую копию. Сопоставьте fingerprint, последнюю IP, версию и активность в загрузках со своей записью. Это установки сервера, не сессии игроков. Освобождение неверной строки затрагивает другую установку; не удаляйте все строки только из-за их количества. Новый сервер панели не заменяет управление сессией.

После остановки освободите правильную старую сессию в панели. Работающая копия может зарегистрироваться снова. Текущая политика освобождает неактивные активные сессии примерно через двадцать минут; явно отозванные не считаются автоматически истёкшими. Для seat_taken проверьте использование и строку, не путайте с license_rotated или подпиской. Подтвердите новую машину запуском, сессией и обычным соединением.

Пакеты, загруженные до 7 октября 2026 года, могли отправлять новый отпечаток сервера при каждой проверке лицензии. Сервер принимал собственную сессию за второй сервер, получал seat_taken и через несколько минут после каждого запуска переставал принимать игроков ("Lisans dogrulanamadi"). Служба лицензий снова принимает такие пакеты до 5 ноября 2026 года: один раз перезапустите ресурс и до этой даты загрузите пакет заново, чтобы получить исправленный клиент лицензии.

Различайте Build ID и license_rotated#

Build ID обозначает распространяемый пакет, не лицензию. Сравните версию файла и префикс Build ID с историей. Чужой серверный пакет остаётся неверным под похожим именем. unknown_build, revoked, license_mismatch и license_rotated обозначают разные проверки. Постоянное создание ключей затрудняет диагностику. Сохраните точный результат без приватных значений.

Обновление ключа в серверах оставляет прежние пакеты привязанными к старому дайджесту. server.cfg не обновляет эту связь сам. Скачайте текущий пакет той же правильной записи и обновите защищённую настройку. При откате не считайте пакет старого ключа действующим. История помогает отслеживать распространение, не доказывает личного распространителя. Сверьте пакет, ключ и результат, оплату отдельно.

Назначение уровней защиты#

Пакет не требует Tebex или Asset Escrow; обычная серверная лицензия Cfx.re нужна отдельно. AES-256-GCM защищает хранящийся ZIP, но не скрывает файлы от владельца игрового сервера.

Ed25519 проверяет подписанные ответы лицензии; закрытый ключ не поставляется. SHA-256 обнаруживает изменения, но не шифрует содержимое. Обфускация Lua обратима. Build ID помогает найти запись распространения, но не доказывает личность автора утечки. Ошибка сети не равна подтверждённому отказу лицензии.

Подготовка обновления и отката#

Сохраните частную резервную копию configs, admins, editable, bridge, языков и server.cfg. Скачивайте для того же сервера. Допустимый кэшированный пакет может сохранить Build ID; скачивание не продлевает подписку и не меняет лицензию.

Сравнивайте настройки, не заменяйте новый общий конфиг старым целиком. Секреты оставляйте на сервере, защищённое ядро не редактируйте. Проверьте запуск, вход обычного игрока и небольшой запрос панели. После смены лицензии старый пакет может быть недействительным даже с новым server.cfg.

Скопируйте лицензию Tosun нужного сервера#

Откройте раздел серверов TosunDev, выберите свой FiveM-сервер и скопируйте его лицензию Tosun AC. tac_live_ — не лицензия Cfx.re, не sv_licenseKey, не токен Discord и не API-ключ панели.

  1. Замените YOUR_SERVER_LICENSE внутри кавычек в server.cfg.
  2. Поместите tosun_ac_license перед ensure tosun-ac; используйте set, не setr и не sets.
  3. Другой вариант — credentials.licenseKey в configs/anticheat_server.lua. Непустой convar имеет приоритет.
  4. Не публикуйте лицензию в скриншотах, чате, shared config или клиентских файлах.
set tosun_ac_license "YOUR_SERVER_LICENSE"
# Alternative: configs/anticheat_server.lua
# credentials.licenseKey = "YOUR_SERVER_LICENSE"