Обязательно сделайте бекап перед обновлением.
Обновление содержит серьезные изменения в API, перед обновлением сверьтесь с актуальной API-схемой – Remnawave Documentation. Обратите внимание на объект пользователя, так как в нем произошли достаточно серьезные изменения в ответе. Объект пользователя в вебхуках (которые отправляет панель) теперь так же на 100% соотвествует тому объекту, который вы получаете при API-запросах.
Убедитесь, что сторонние инструменты, которые вы используете (боты и тд) поддерживают новую версию панели.
Версия панели (2.3.0) так же требует обновить ноды для последней версии (2.3.0).
Итак, правильный алгоритм обновления:
1. Обновить панель (команда – cd /opt/remnawave && docker compose pull remnawave && docker compose down && docker compose up -d && docker compose logs -f)
2. Если вы использовали настройки HWID (которые в .env) – после обновления они по умолчанию будут отключены, так как эти настройки переехали внутрь панели. Следовательно, если ранее вы использовали HWID лимит – перейдите в панели в раздел "Подписка → Настройки), настройте и включите лимит при необходимости.
3. После обновления панели, можно переходить к обновлению нод – cd /opt/remnanode && docker compose pull remnanode && docker compose down && docker compose up -d. После того, как с вашей стороны все ноды будут обновлены, перезапустите панель для чистого старта всех нод. Или просто достаточно в панели, в разделе “Ноды”, вызвать перезапуск всех нод с флагом “принудительно”.
4. 25-ого октября (с выходом Remnawave Node v2.2.2) переменные APP_PORT, SSL_CERT были объявлены как deprecated. В версии 2.3.0 поддержка старых переменных полностью прекращена. Убедитесь, что используете корректные переменные, в ином случае нода не запустится. (APP_PORT → NODE_PORT, SSL_CERT → SECRET_KEY)
5. Для оптимизации некоторых процессов, Remnawave больше не передает в ядро (в конфиге) username пользователя, который потом в логах ядра отображался в виде поля email. Начиная с новой версии, в поле email будет отображаться id пользователя. Если вы используете инструменты которые занимаются парсингом логов, например, Torrent-Blocker, имейте этот момент в виду. В панели доступен новый эндпоинт – получение пользователя по его ID, он поможет вам получить полный объект пользователя, имея на руках только id.
6. Полный контроль flow для VLESS-инбаундов (более подробно об этом, в разделе “Профили” нажмите справа наверху на желтый знак вопроса, там будет описание и пример)
Прочие изменения:
– Внешние сквады: переопределение настроек HWID, переопределение “примечаний” (по статусам)
– Возможность изменить порядок: внутренние сквады, внешние сквады, профили, шаблоны
– Поддержка balancers в сниппетах
– Табличный вид отображения списка нод (раздел “Ноды”)
– ZSTD-сжатие конфига перед отправкой на ноды (только в случае полного старта/рестарта ноды)
– Новая .env переменная – REDIS_SOCKET (для подключения Redis/Valkey через unix-сокет)
– Выбрать индивиуального Xray-Json для каждого хоста (на основе шаблонов)
– Исключить Хост из определенных внутренних сквадов
– “Теги” для нод (можно указать несколько тегов)
– Массовое изменение активного профиля/инбаундов у нод (мультивыбор нод из табличного вида отображения)
– Новая .env переменная: USER_USAGE_IGNORE_BELOW_BYTES – если указать число, например 10КБ (в байтах это 10000) – то при записи статистики трафика (при опросе нод) – пользователи, которые в рамках 15-ти секунд потратили меньше 10КБ (например connect-пинги и тд) – будут проигнорированы. Использовать с осторожностью.
– Новая .env переменная: SERVICE_DISABLE_USER_USAGE_RECORDS (true/false) – если установить в true – полностью отключить запись истории расхода трафика для всех пользователей. Может быть полезно в определенных ситуациях.
– Рефактор: очереди, фоновые задачи, оптимизация некоторых таблиц в базе данных
– …прочие QoL изменения и исправления незначительных багов