3. Подключение магазина к Rust серверу

Обзор интерфейса

Страница «Подключить магазин» (/admin/connect-shop) позволяет настроить RCON-соединение с вашим сервером Rust для автоматической выдачи товаров.

Важно: какой RCON поддерживается

Панель поддерживает Rust WebRCON (WebSocket) и делает авто-fallback на старый TCP RCON (Source RCON), если WebRCON недоступен.

• WebRCON (рекомендуется): режим Rust +rcon.web 1. Подключение выполняется по схеме ws://HOST:PORT/PASSWORD.
• TCP RCON (legacy): режим Rust +rcon.web 0. Используйте только если вынужденно.

1. Статус подключения

В верхней части страницы отображается блок с текущим статусом сервера:

• Индикатор ON (Зеленый): Магазин успешно подключился к серверу по RCON. Выводится имя сервера (Hostname) и IP:Port.
• Индикатор OFF (Красный): Не удалось подключиться. Проверьте правильность IP, порта и пароля, а также доступность порта (Firewall).

Система уведомлений использует цветные блоки для наглядности: зеленый для успеха (например, настройки сохранены) и красный для ошибок (например, неверный пароль).

2. Диагностика: режим и ошибки

После попытки подключения отображается блок «Диагностика RCON»:

• Режим подключения: WEBRCON или TCP (какой режим реально выбрался).
• Человекопонятные ошибки: например «порт закрыт/недоступен», «WebSocket не 101 Switching Protocols», «не тот режим rcon.web», «таймаут».
• Raw ошибки: доступны в раскрывающемся блоке для точной диагностики.

3. Управление подключением

В блоке статуса доступны кнопки:

• Редактировать: Прокручивает страницу к форме ввода данных для их изменения.
• Удалить: Сбрасывает текущие настройки RCON (удаляет IP, порт и пароль из конфигурации).

4. Настройка через форму

1. Заполните поля:
   • IP сервера: Публичный IP адрес вашего сервера.
   • RCON порт: Порт для RCON подключений (обычно 28016 или 28082).
   • RCON пароль: Пароль, заданный в rcon.password в параметрах запуска сервера.
2. Нажмите кнопку «Сохранить настройки».
3. Система проверит соединение. Если всё верно, индикатор станет зеленым.

5. Безопасность RCON (если сайт и Rust на разных машинах)

Нельзя открывать RCON порт «для всех». Это прямой удалённый доступ к консоли сервера.

1. Ограничьте доступ по IP: разрешите подключение к RCON порту только с IP веб-сервера (где расположен сайт).
2. Проверьте rcon.ip: если указан 127.0.0.1, подключение с сайта не заработает. Для внешнего подключения обычно нужен 0.0.0.0 или конкретный внешний IP.
3. Сложный пароль: 20+ символов, не из словаря.
4. При возможности: VPN (WireGuard) между серверами и слушать RCON только на VPN интерфейсе.

Альтернативный метод: Команда консоли (Pull-режим)

Если у вас установлен плагин RustCMSShop на сервере, вы можете подключить его командой из консоли сервера (или другого RCON клиента):

rustcms.connect "https://ваш-сайт.ru" "ВАШ_API_SECRET"

Ваш API Secret можно найти на странице настроек или подключения.

Как это работает:

• В этом режиме сервер сам опрашивает сайт (Pull) через API /api/oxide/pull каждые несколько минут.
• Это позволяет выдавать товары даже если RCON недоступен или находится за NAT.
• Для мгновенной выдачи всё же рекомендуется настроить RCON (Push-режим), чтобы сайт мог "толкнуть" сервер сразу после покупки.

4. Секретные ключи

Внизу страницы находится скрытый блок «Показать секретные ключи». При клике на него открываются:

• Токен (CSRF): Токен безопасности для форм.
• Сидер (SEED_TOKEN): Токен для генерации демо-данных.
• API_SECRET: Ваш секретный ключ для связи с плагинами.

Для каждого ключа доступна кнопка копирования.