Перейти к содержимому

Статья 106 из 141

Гайды

Бэкап и перенос 3x-ui на новый сервер без потери клиентов

Все настройки 3x-ui — inbound, клиенты, лимиты, настройки панели — хранятся в одном файле базы данных:

/etc/x-ui/x-ui.db

Если у вас есть копия этого файла, вы можете восстановить панель на любом сервере за несколько минут.

Окно терминала
systemctl stop x-ui
cp /etc/x-ui/x-ui.db /root/x-ui-$(date +%F).db
systemctl start x-ui

Останавливать службу нужно, чтобы база не записывалась во время копирования.

Скачайте копию к себе на компьютер:

Окно терминала
scp root@IP_СЕРВЕРА:/root/x-ui-*.db .

Копия, которая лежит только на том же сервере, не спасёт, если сервер удалят или сломают диск.

Простой вариант: ежедневная копия с хранением 7 дней.

Окно терминала
mkdir -p /root/backups
crontab -e

Добавьте строку:

0 4 * * * sqlite3 /etc/x-ui/x-ui.db ".backup '/root/backups/x-ui-$(date +\%F).db'" && find /root/backups -name 'x-ui-*.db' -mtime +7 -delete

sqlite3 .backup делает целостную копию без остановки службы. Если команды sqlite3 нет, установите её: apt install sqlite3.

Чтобы копии уходили за пределы сервера, смотрите бэкапы на VPS.

В 3x-ui также есть встроенная отправка бэкапа в Telegram-бота: настраивается в разделе настроек панели, вкладка Telegram Bot.

Той же или более новой версии, чем на старом. Установка: гайд по 3x-ui.

На новом сервере:

Окно терминала
systemctl stop x-ui
scp root@СТАРЫЙ_IP:/etc/x-ui/x-ui.db /etc/x-ui/x-ui.db
systemctl start x-ui

После запуска войдите в панель со старыми логином, паролем, портом и путём — они тоже хранятся в базе.

Если inbound используют TLS-сертификаты (не Reality), скопируйте их с тем же путём, который указан в настройках inbound. Чаще всего это /root/cert/ или каталог Let’s Encrypt.

Файрвол на новом сервере пустой. Откройте порт панели и порты всех inbound:

Окно терминала
ufw allow ПОРТ_ПАНЕЛИ/tcp
ufw allow 443/tcp

Конфиги клиентов содержат адрес сервера. Здесь два сценария.

Клиенты подключаются по домену. Поменяйте A-запись домена на новый IP (настройка DNS). После обновления DNS клиенты подключатся сами, перевыпускать ничего не нужно. Это главная причина использовать домен, а не голый IP.

Клиенты подключаются по IP. Каждому придётся обновить конфиг. Если клиенты используют ссылку подписки, достаточно обновить подписку в приложении. Если импортировали одиночный QR-код, нужен новый.

Ключи Reality хранятся в базе и переезжают вместе с ней. Если параметры не менялись, клиентам по домену ничего делать не нужно.

  1. Проверьте, что на новом сервере подключаются несколько клиентов с разных устройств.
  2. Подождите сутки после смены DNS: у части провайдеров записи кешируются.
  3. Сделайте финальную копию базы со старого сервера.
  4. Только после этого удаляйте старый VPS.