txAdmin установка и рецепты: развертывание FiveM сервера шаг за шагом
Как установить txAdmin в первый раз, связать вашу учетную запись Cfx.re, выбрать рецепт (ESX Legacy, QBCore, QBox или пользовательский), ввести детали базы данных и что делает развертывание.
Вы загрузили артефакты FiveM сервера, запустили их, и теперь txAdmin запрашивает PIN, учетную запись и шаблон. Этот гайд проходит вас через первый старт, связывание вашей учетной записи Cfx.re, выбор рецепта и что происходит во время развертывания.
Первый старт и PIN
В Windows запустите FXServer.exe. В Linux запустите run.sh из артефактов. Первый старт выводит URL txAdmin и одноразовый PIN в консоль. Откройте URL в браузере и введите PIN. Только человек, который может читать консоль сервера, может это сделать, что является целью.
PIN работает только один раз. Если вы его потеряете, остановите сервер и запустите его снова, чтобы получить новый, пока вы не завершили установку учетной записи. Если вы уже это сделали и забыли свой вход, смотрите txAdmin forgot password.
Свяжите вашу учетную запись Cfx.re
txAdmin просит вас создать основную учетную запись. Вы связываете ее с вашей учетной записью Cfx.re, которая является одной и той же учетной записью, которую вы используете на форуме FiveM и на портале Cfx.re. Войдите с Cfx.re, когда будет предложено, затем выберите резервный пароль для учетной записи, чтобы вы все еще могли войти, если вход Cfx.re неработающий.
Сохраните этот пароль где-то в безопасном месте. Вы добавите других администраторов позже со страницы администратора txAdmin, каждого с их собственными разрешениями.
Имя сервера и тип развертывания
Мастер установки просит имя сервера, затем тип развертывания. Формулировка меняется между версиями txAdmin, но вы увидите варианты вроде этих:
- Популярные рецепты: готовые шаблоны, включая ESX Legacy, QBCore и QBox.
- Шаблон удаленного URL: рецепт, который вы вставляете из ссылки, например один из репозитория фреймворка.
- Местный шаблон или пользовательский рецепт: ваш собственный файл рецепта.
- Существующие данные сервера: у вас уже есть папка данных сервера с
server.cfgи вы хотите, чтобы txAdmin это запустил.
Если это новый сервер, выберите популярный рецепт. Фреймворки обновляют свои рецепты, поэтому вы получаете текущую установку без поиска ссылок для загрузки.
Выбор шаблона
| Что вы хотите | Выберите |
|---|---|
| Фреймворк, для которого написано большинство скриптов | ESX Legacy или QBCore |
| Более новый стек, построенный вокруг ox_lib, ox_inventory и ox_target | QBox |
| Только базовую игру, чтобы построить все самостоятельно | Пустой или пользовательский рецепт |
Не уверены? Прочитайте install ESX Legacy, install QBCore и install QBox перед выбором, потому что перемещение фреймворков позже означает преобразование ваших данных.
Папка и параметры рецепта
После выбора рецепта txAdmin показывает папку данных сервера. Это место, где развертывание размещает server.cfg и папку resources. Держите его вне папки артефактов, чтобы вы могли обновить артефакты без касания ваших данных (смотрите update FiveM server artifacts).
Затем идет форма с параметрами рецепта. Типичные поля:
- Ключ лицензии Cfx.re: ключ, который нужен вашему серверу для запуска. Создайте его на портале Cfx.re. Если вы получите ошибку об этом, прочитайте the server license key error.
- Настройки базы данных: хост, пользователь, пароль и имя базы данных.
- Максимальное количество игроков, имя сервера и другие параметры, которые предлагает рецепт.
Внимание: ключ лицензии личный. Не публикуйте
server.cfgв скриншотах или сообщениях Discord без его скрытия.
Учетные данные базы данных во время развертывания
Фреймворки держат игроков, деньги, транспортные средства и многое другое в базе данных MySQL или MariaDB. Рецепту нужно войти для создания его таблиц. У вас есть два обычных набора:
- Сервер базы данных, который вы уже запускаете (локальный MariaDB, XAMPP или один от вашего хоста). Введите его хост, пользователя и пароль. Пользователь должен иметь разрешение на создание базы данных.
- Значения формы txAdmin по умолчанию, которые подходят для локальной настройки, где база данных работает на одной машине.
Развертывание строит строку подключения для вас, поэтому вам не нужно писать ее вручную. В server.cfg вы найдете это как:
set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"Если сервер позже говорит, что он не может подключиться, исправление находится в oxmysql connection error.
Что рецепт на самом деле делает
Рецепт - это список задач, которые txAdmin запускает по порядку. На простом языке:
- Загружает ресурсы: фреймворк, его ресурсы, oxmysql и другие зависимости, обычно как ZIP файлы с GitHub.
- Распаковывает и перемещает их в папку
resources. - Создает базу данных и импортирует SQL файл фреймворка, используя введенные учетные данные.
- Пишет
server.cfg: имя вашего сервера, ключ лицензии, строку подключения, строкиensureи разрешения.
Когда развертывание завершается, txAdmin показывает созданный server.cfg для вашего просмотра. Это правильный момент для его чтения строка за строкой: смотрите server.cfg explained. Вы можете отредактировать это, затем сохранить и запустить сервер.
После развертывания
Запустите сервер с приборной панели txAdmin и следите за консолью. Здоровый старт заканчивается с перечисленными ресурсами как запущенные и без красных ошибок. Затем подключитесь с FiveM и проверьте, что вы достигаете экрана символа или спавна.
Если ресурс не удается, couldn't start resource и reading a script error охватывают, что означают сообщения. Для ваших собственных прав администратора в игре смотрите ACE permissions.
Совет: возьмите копию папки данных сервера и экспорт базы данных сразу после чистого развертывания. Если вы что-то сломаете во время экспериментов, вы можете вернуться в известное хорошее состояние. Гайд backup guide показывает, как.
Контрольный список
| Симптом | Решение |
|---|---|
| Потеряли PIN txAdmin | Остановите и запустите сервер перед завершением установки, чтобы получить новый |
| Не может войти с Cfx.re | Используйте резервный пароль, который вы установили, или следуйте гайду забытого пароля |
| Развертывание не работает на этапе базы данных | Проверьте хост, пользователя, пароль и что пользователь может создавать базы данных |
| Не уверены, какой шаблон выбрать | Выберите фреймворк, который поддерживают ваши скрипты; ESX Legacy и QBCore - наиболее распространены |
| Сервер запускается, но вы не можете присоединиться | Проверьте endpoints и port forwarding |
| Хотите просмотреть, что было написано | Прочитайте server.cfg в папке данных сервера перед первым запуском |
Короткие ответы
Что такое рецепт txAdmin?
Рецепт - это небольшой файл YAML, который говорит txAdmin, что загружать, где распаковывать, какую базу данных создать и что писать в server.cfg. Развертывание рецепта дает вам работающий сервер за несколько минут.
Могу ли я развернуть рецепт на сервере, который уже имеет данные?
Развертывайте в пустую папку. Рецепт пишет server.cfg и создает базу данных, поэтому запуск его на существующем сервере может перезаписать ваши файлы и таблицы.
Какой рецепт выбрать: ESX Legacy, QBCore или QBox?
Выберите фреймворк, скрипты которого вы планируете запускать. Большинство скриптов магазина поддерживают ESX и QBCore, а QBox запускает большинство скриптов QBCore через его уровень совместимости.
