Резервне копіювання та міграція 3x-ui на інший VPS без втрати користувачів

Ефективна міграція 3x-ui на новий VPS без втрати користувачів та їхніх конфігурацій вимагає збереження бази даних x-ui.db, що містить усі облікові записи та налаштування, а також каталогу з SSL-сертифікатами, зазвичай розташованого в /root/.acme.sh, з подальшим розгортанням на новому сервері.

Перенесення інфраструктури, особливо критично важливих сервісів, таких як 3x-ui, є поширеним завданням для системних адміністраторів та розробників. Чи то необхідність у більш потужному обладнанні, зміна регіону для покращення затримки, оптимізація витрат або підвищення відмовостійкості, процес має бути продуманим та безшовним. 3x-ui, як популярна панель керування для Xray-серверів, активно використовується для створення та управління проксі-серверами, що підтримують різні протоколи, такі як VLESS, Reality, XTLS, VMess, Shadowsocks та інші. Втрата даних користувачів або некоректне налаштування після перенесення може призвести до серйозних проблем з доступністю сервісу. У цій статті ми детально розглянемо кожен крок, від підготовки до фінальної перевірки, щоб забезпечити максимально гладке перенесення 3x-ui на новий сервер.

Де 3x-ui зберігає свої дані і чому це важливо для резервного копіювання?

Для успішного резервного копіювання 3x-ui та подальшої міграції вкрай важливо розуміти, де панель зберігає свої конфігурації, дані користувачів та сертифікати. 3x-ui використовує базу даних SQLite для зберігання всієї оперативної інформації про користувачів, їхні облікові дані, статистику трафіку, а також налаштування проксі-серверів. Крім цього, для забезпечення безпечного з'єднання за TLS (включаючи протоколи VLESS з XTLS/Reality) потрібні SSL-сертифікати. Ці два компоненти є ключовими для збереження функціональності після перенесення.

Основні компоненти даних 3x-ui

• База даних x-ui.db: Це серце вашої панелі 3x-ui. Вона містить:
  • Усі створені користувачі з їхніми UUID, портами, протоколами та додатковими налаштуваннями.
  • Статистика використання трафіку для кожного користувача.
  • Налаштування вхідних та вихідних з'єднань (inbounds/outbounds).
  • Загальні налаштування панелі 3x-ui (порт, логін/пароль адміністратора, ліміти).

  За замовчуванням x-ui.db розташовується в каталозі, де встановлено 3x-ui. У більшості випадків, при стандартній установці, це буде /etc/x-ui/x-ui.db. Однак, якщо ви встановлювали 3x-ui вручну або використовували скрипт, який дозволяє вибрати шлях, він може відрізнятися. Завжди перевіряйте розташування файлу перед початком резервного копіювання.

• SSL-сертифікати: Для роботи протоколів, що вимагають TLS-шифрування (VLESS, VMess, Shadowsocks з TLS, Reality), необхідні діючі SSL-сертифікати. Найчастіше вони випускаються за допомогою Let's Encrypt через скрипт acme.sh. Каталог, де acme.sh зберігає сертифікати та ключі, зазвичай знаходиться в /root/.acme.sh/. У цьому каталозі ви знайдете підкаталоги, названі за вашими доменами, всередині яких зберігаються файли сертифікатів (fullchain.cer) та приватних ключів (.key).
• Файли конфігурації 3x-ui (опціонально): Хоча основна конфігурація зберігається в базі даних, деякі скрипти установки можуть створювати додаткові файли конфігурації або системні юніти (systemd service files). Однак для більшості сценаріїв міграції достатньо резервного копіювання x-ui.db та сертифікатів.

Чому так важливе повне резервне копіювання x-ui.db та сертифікатів?

Без x-ui.db ви втратите всіх своїх користувачів, їхні UUID, налаштування та статистику. Фактично, це буде еквівалентно новій установці 3x-ui, де вам доведеться заново створювати всіх користувачів та пересилати їм нові конфігурації. Це не тільки трудомістко, але й вкрай незручно для ваших клієнтів.

Без SSL-сертифікатів ваші проксі-сервери, що використовують TLS, перестануть працювати. Користувачі отримуватимуть помилки з'єднання, оскільки сервер не зможе встановити захищене з'єднання. Хоча сертифікати можна перевипустити на новому сервері, це вимагає часу та коректного налаштування DNS, а також може призвести до короткочасного простою. Збереження існуючих сертифікатів дозволяє мінімізувати простій та уникнути необхідності переналаштовувати клієнтські пристрої, якщо ви не змінюєте домен.

Розуміння цих ключових компонентів дозволяє скласти точний план дій для міграції 3x-ui, гарантуючи, що всі важливі дані будуть збережені та коректно відновлені на новому сервері.

Повне резервне копіювання 3x-ui: що потрібно зберегти перед міграцією?

Перш ніж приступити до перенесення 3x-ui, необхідно виконати повне резервне копіювання всіх критично важливих даних з поточного VPS. Цей процес включає зупинку сервісу 3x-ui, копіювання бази даних та SSL-сертифікатів, а потім їх безпечне переміщення на локальну машину або в хмарне сховище. Суворе дотримання цих кроків гарантує цілісність даних та мінімізує ризики.

Зупинка сервісу 3x-ui для цілісності резервної копії

Перш ніж копіювати базу даних, обов'язково зупиніть сервіс 3x-ui. Це запобіжить будь-яким операціям запису в x-ui.db під час копіювання, виключаючи ризик пошкодження або неповного резервного копіювання. Якщо база даних використовуватиметься під час копіювання, ви можете отримати неконсистентний файл, який буде складно або неможливо відновити.

Підключіться до вашого старого VPS по SSH та виконайте наступні команди:

sudo systemctl stop x-ui
sudo systemctl disable x-ui # Опціонально: запобігає запуску при перезавантаженні

Переконайтеся, що сервіс зупинено:

sudo systemctl status x-ui

Вивід повинен показати, що сервіс неактивний (inactive (dead)).

Копіювання бази даних x-ui.db та SSL-сертифікатів

Тепер, коли сервіс зупинено, можна безпечно скопіювати необхідні файли.

1. Резервне копіювання бази даних x-ui.db:
   Знайдіть файл x-ui.db. У більшості випадків він знаходиться за шляхом /etc/x-ui/x-ui.db. Якщо ви встановлювали 3x-ui іншим способом, шлях може відрізнятися. Ви можете використовувати команду find / -name x-ui.db для його пошуку.
   Скопіюйте файл у безпечне місце, наприклад, у домашній каталог користувача, щоб потім легко його завантажити:

   cp /etc/x-ui/x-ui.db ~/x-ui.db.bak
   

2. Резервне копіювання SSL-сертифікатів:
   Каталог із сертифікатами зазвичай знаходиться за шляхом /root/.acme.sh/. Скопіюйте його цілком. Якщо ви використовуєте кілька доменів, цей каталог міститиме всі необхідні сертифікати.
   

   Якщо ви не використовували acme.sh або у вас сертифікати лежать в іншому місці, переконайтеся, що ви скопіювали fullchain.cer та відповідний .key файл для кожного використовуваного домену. Якщо ви використовуєте Reality, резервне копіювання сертифікатів не таке критичне, оскільки вони генеруються на льоту, але якщо ви використовуєте VLESS/VMess з TLS, це обов'язково.

   cp -r /root/.acme.sh/ ~/.acme.sh.bak
   

   Тепер у вас є два файли/каталоги для завантаження: ~/x-ui.db.bak та ~/.acme.sh.bak.

Завантаження файлів резервної копії на локальну машину

Після того як файли скопійовано в домашній каталог, ви можете завантажити їх на свою локальну машину за допомогою scp або SFTP-клієнта (наприклад, WinSCP, FileZilla).

Використовуючи scp:

# Відкрийте термінал на вашій ЛОКАЛЬНІЙ машині
scp user@your_old_vps_ip:~/x-ui.db.bak .
scp -r user@your_old_vps_ip:~/.acme.sh.bak .

Замініть user на ваше ім'я користувача (зазвичай root або користувача з sudo-правами), а your_old_vps_ip на IP-адресу вашого старого VPS.

Після успішного завантаження переконайтеся, що файли не пошкоджені та мають розумний розмір. На цьому етапі резервне копіювання завершено. Тепер ви можете або видалити файли резервної копії зі старого VPS, або залишити їх як додатковий запобіжний захід. Якщо ви плануєте повністю видалити старий VPS, переконайтеся, що у вас є надійна копія резервної копії.

Тепер, коли у нас є всі необхідні дані, можна переходити до підготовки нового сервера для 3x-ui на новий сервер.

Підготовка нового VPS для перенесення 3x-ui

Перш ніж приступати до відновлення даних, необхідно підготувати новий VPS. Цей етап включає вибір відповідного сервера, його базове налаштування, встановлення необхідних залежностей і, звичайно ж, встановлення самої панелі 3x-ui. Правильна підготовка нового сервера забезпечить стабільну роботу та безпроблемне перенесення 3x-ui.

Вибір оптимального VPS для 3x-ui: на що звернути увагу?

Вибір VPS залежить від передбачуваного навантаження. Для 3x-ui основними факторами є кількість активних користувачів, обсяг переданого трафіку та протоколи, які ви плануєте використовувати (Reality, XTLS, TLS вимагають більше ресурсів CPU). Valebyte.com пропонує різні тарифи, що підходять для різних завдань. Наприклад, для невеликої кількості користувачів (до 20-30) з помірним трафіком, базового тарифу з 1 vCPU, 1-2 GB RAM та 20-30 GB NVMe диска буде цілком достатньо. Для більш вимогливих сценаріїв, наприклад, для Hiddify на VPS або Marzban на VPS, які можуть обробляти сотні користувачів, краще розглянути тарифи з 2-4 vCPU, 4-8 GB RAM та швидшим диском.

Ключові параметри:

• Процесор (vCPU): 1-2 ядра для більшості випадків, 2+ для високих навантажень або Reality.
• Оперативна пам'ять (RAM): 1-2 GB достатньо для Xray/3x-ui, але 2-4 GB дають більше буфера.
• Диск (SSD/NVMe): 20-40 GB NVMe буде більш ніж достатньо. NVMe забезпечує кращу продуктивність вводу-виводу, що важливо для баз даних та логів.
• Мережевий канал: 100 Mbps - 1 Gbps. Чим ширший канал, тим краще для проксі.
• Розташування сервера: Вибирайте локацію, яка забезпечує мінімальну затримку для ваших користувачів.
• Операційна система: Ubuntu 20.04/22.04 LTS, Debian 10/11/12 або CentOS 7/8. Ubuntu LTS версії є найбільш поширеним вибором.

Приблизні характеристики VPS для 3x-ui:

Категорія використання	vCPU	RAM	Диск (NVMe)	Мережевий канал	Приблизна ціна (Valebyte.com)
Малий (до 20-30 користувачів)	1 ядро	1-2 GB	20 GB	100 Mbps	$5 - $8/міс
Середній (до 50-100 користувачів)	2 ядра	2-4 GB	30-40 GB	250-500 Mbps	$8 - $15/міс
Високий (100+ користувачів, Reality/XTLS)	4+ ядра	4-8 GB	50+ GB	500 Mbps - 1 Gbps	$15 - $30+/міс

Базове налаштування нового VPS та встановлення 3x-ui

Після активації нового VPS (багато провайдерів, включаючи Valebyte.com, пропонують VPS з моментальною активацією) підключіться до нього по SSH.

1. Оновлення системи:
   Завжди починайте з оновлення пакетного менеджера та встановлених пакетів.

   sudo apt update && sudo apt upgrade -y # Для Debian/Ubuntu
   # sudo yum update -y # Для CentOS/RHEL
   

2. Встановлення необхідних утиліт:
   Встановіть curl, wget, git та unzip, якщо вони ще не встановлені. Вони можуть знадобитися для встановлення 3x-ui та роботи з файлами.

   sudo apt install -y curl wget git unzip # Для Debian/Ubuntu
   # sudo yum install -y curl wget git unzip # Для CentOS/RHEL
   

3. Встановлення 3x-ui:
   Використовуйте офіційний скрипт для встановлення 3x-ui. Це гарантує, що всі залежності будуть встановлені правильно і панель працюватиме з коректними шляхами.

   bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)
   

   Дотримуйтесь інструкцій скрипта. Після встановлення 3x-ui буде запущено з порожньою базою даних. Вам не потрібно налаштовувати користувачів або порти на цьому етапі, оскільки ми будемо відновлювати дані з резервної копії. Просто переконайтеся, що панель встановлена і сервіс x-ui присутній у системі.

4. Зупинка нового сервісу 3x-ui:
   Як і на старому сервері, нам потрібно зупинити 3x-ui, щоб безпечно замінити базу даних.

   sudo systemctl stop x-ui
   sudo systemctl disable x-ui # Опціонально, але рекомендується
   

Тепер ваш новий VPS готовий до прийому даних з резервної копії. У вас встановлена чиста копія 3x-ui, але вона поки що не містить ваших користувачів та налаштувань. Наступний крок — відновлення даних.

Покрокова міграція 3x-ui: відновлення даних та користувачів

Найвідповідальніший етап міграції 3x-ui — це відновлення збережених даних на новому сервері. Цей процес включає завантаження файлів резервної копії на новий VPS, заміну бази даних 3x-ui та відновлення SSL-сертифікатів. Важливо дотримуватися інструкцій точно, щоб уникнути втрати даних або некоректної роботи сервісу.

Завантаження файлів резервної копії на новий VPS

Перенесіть файли x-ui.db.bak та .acme.sh.bak, які ви раніше завантажили на локальну машину, на ваш новий VPS. Ви можете використовувати scp або SFTP-клієнт.

Використовуючи scp:

# Відкрийте термінал на вашій ЛОКАЛЬНІЙ машині
scp ~/x-ui.db.bak user@your_new_vps_ip:/tmp/
scp -r ~/.acme.sh.bak user@your_new_vps_ip:/tmp/

Замініть user на ім'я користувача (зазвичай root), а your_new_vps_ip на IP-адресу вашого нового VPS. Файли будуть завантажені у тимчасовий каталог /tmp/ на новому сервері.

Відновлення бази даних 3x-ui

Підключіться до нового VPS по SSH. Тепер ми замінимо порожню базу даних 3x-ui на ту, яку ви створили резервну копію.

1. Переміщення бази даних:
   Перемістіть файл резервної копії x-ui.db.bak з /tmp/ до цільового каталогу 3x-ui, замінивши існуючий порожній файл x-ui.db. Каталог 3x-ui за замовчуванням — /etc/x-ui/.

   mv /tmp/x-ui.db.bak /etc/x-ui/x-ui.db
   

2. Налаштування прав доступу:
   Переконайтеся, що файл бази даних має правильні права доступу та власника, щоб 3x-ui міг з ним працювати. Зазвичай це root:root та права 0600 або 0640.

   chown root:root /etc/x-ui/x-ui.db
   chmod 600 /etc/x-ui/x-ui.db
   

Відновлення SSL-сертифікатів

Якщо ви використовували TLS або Reality, вам необхідно відновити сертифікати.

1. Переміщення каталогу .acme.sh:
   Перемістіть каталог .acme.sh.bak, для якого було створено резервну копію, до домашнього каталогу /root/, замінивши його, якщо він існує (хоча на новому сервері його, швидше за все, не буде).

   mv /tmp/.acme.sh.bak /root/.acme.sh
   

2. Налаштування прав доступу:
   Переконайтеся, що каталог та файли всередині нього мають правильні права доступу та власника.

   chown -R root:root /root/.acme.sh
   chmod -R 700 /root/.acme.sh
   

Після виконання цих кроків усі ваші дані та сертифікати будуть на своїх місцях на новому VPS. Тепер можна запустити сервіс 3x-ui.

Запуск 3x-ui та перевірка працездатності

Запустіть сервіс 3x-ui та переконайтеся, що він успішно стартував:

sudo systemctl start x-ui
sudo systemctl enable x-ui # Щоб сервіс запускався при старті системи
sudo systemctl status x-ui

Якщо все пройшло успішно, статус має бути active (running). Спробуйте зайти в панель керування 3x-ui через веб-браузер за IP-адресою вашого нового VPS та портом панелі (за замовчуванням 2053). Ви повинні побачити всіх своїх користувачів та їхні конфігурації. Перевірте логи 3x-ui на наявність помилок:

journalctl -u x-ui -f

У разі проблем, це допоможе виявити їхню причину. Часті проблеми включають неправильні права доступу до файлів або помилки в базі даних (якщо резервна копія була зроблена некоректно, що малоймовірно при зупинці сервісу).

На цьому основний процес відновлення завершено. Наступний крок — це перевірка конфігурацій та, за необхідності, зміна домену.

Зміна домену після міграції 3x-ui: сертифікати та конфігурація

У деяких випадках, при перенесенні 3x-ui на новий VPS, може виникнути необхідність змінити доменне ім'я, що використовується для доступу до проксі-серверів. Це може бути пов'язано з тим, що старий домен прив'язаний до старої IP-адреси, або ви просто хочете використовувати новий домен. Зміна домену тягне за собою необхідність перевипуску SSL-сертифікатів та оновлення конфігурацій користувачів.

Коли потрібна зміна домену?

• Зміна IP-адреси та відсутність можливості переприв'язати старий домен: Якщо ваш старий домен жорстко прив'язаний до старого VPS або ви не можете оновити DNS-записи з будь-якої причини.
• Бажання використовувати новий, більш відповідний домен: Можливо, ви хочете покращити брендинг або просто використовувати зручніше ім'я.
• Проблеми з поточним доменом: Домен потрапив до чорних списків, заблокований або має інші проблеми.

Якщо ви просто перенесли VPS, але зберегли доменне ім'я та оновили його DNS A-запис на нову IP-адресу, то перевипуск сертифікатів не завжди обов'язковий, якщо старі сертифікати ще дійсні та були успішно перенесені. Однак, для забезпечення максимальної надійності та актуальності, рекомендується перевипустити їх.

Перевипуск SSL-сертифікатів для нового домену

Припустимо, ваш старий домен був old.example.com, а новий буде new.example.com.

1. Оновіть DNS A-запис:
   Переконайтеся, що A-запис для new.example.com вказує на IP-адресу вашого нового VPS. Це критично важливо для роботи Let's Encrypt та коректного функціонування проксі-сервера. Дочекайтеся повного розповсюдження DNS-записів (може зайняти від кількох хвилин до кількох годин).
2. Видалення старих сертифікатів (опціонально, але рекомендується для чистоти):
   Ви можете видалити старі записи для old.example.com з /root/.acme.sh/, якщо вони більше не потрібні, або просто дозволити acme.sh обробляти новий домен.
3. Випуск нового сертифіката за допомогою acme.sh:
   Зупиніть 3x-ui, якщо він використовує порт 80/443 для отримання сертифіката (за замовчуванням 3x-ui використовує інші порти для панелі, але Xray може слухати 443).

   Виконайте команду для випуску нового сертифіката. Переконайтеся, що у вас встановлено acme.sh (він зазвичай йде разом з установкою 3x-ui або його можна встановити вручну).

   # Переконайтеся, що 3x-ui зупинено, якщо він конфліктує з портом 80/443
   sudo systemctl stop x-ui
   
   # Випустіть сертифікат для нового домену (використовуючи webroot або standalone)
   # Webroot:
   acme.sh --issue -d new.example.com --webroot /var/www/html/ # якщо у вас є веб-сервер на 80 порту
   # Standalone (найпростіший, якщо 80 порт вільний):
   acme.sh --issue -d new.example.com --standalone
   
   # Після випуску, встановіть сертифікат у потрібні шляхи.
   # Xray зазвичай вимагає fullchain.cer та .key файл.
   # 3x-ui може автоматично підхоплювати їх з .acme.sh,
   # але краще явно вказати шляхи в налаштуваннях inbounds.
   acme.sh --install-cert -d new.example.com \
   --key-file       /etc/x-ui/new.example.com.key  \
   --fullchain-file /etc/x-ui/new.example.com.pem \
   --reloadcmd     "sudo systemctl restart x-ui"
   

   Після успішного випуску та встановлення сертифіката, запустіть 3x-ui:

   sudo systemctl start x-ui
   

Оновлення конфігурацій у панелі 3x-ui

Після отримання нового сертифіката вам потрібно оновити всі вхідні з'єднання (inbounds) у панелі 3x-ui, які використовували старий домен та старі сертифікати. Зайдіть у веб-інтерфейс 3x-ui:

1. Перейдіть до розділу "Inbounds".
2. Для кожного inbound, який використовував старий домен:
   
   • Відредагуйте його.
   • У полі "Домен" (або "Host", "SNI") вкажіть new.example.com.
   • У полі "SSL Сертифікат" та "SSL Приватний ключ" вкажіть нові шляхи до файлів сертифіката та ключа, які ви отримали (наприклад, /etc/x-ui/new.example.com.pem та /etc/x-ui/new.example.com.key).
   • Збережіть зміни.
3. Якщо ви використовуєте Reality, переконайтеся, що в налаштуваннях inbounds вказано правильний dest (цільовий домен, який ви клонуєте) та serverNames (SNI-домени, які будуть використовуватися). Вони не залежать від вашого сертифіката, але мають бути коректно налаштовані.

Після оновлення всіх inbounds, 3x-ui автоматично перезавантажить конфігурацію Xray. Ваші користувачі тепер повинні будуть оновити свої клієнтські програми, вказавши новий домен new.example.com та, можливо, нові порти, якщо ви їх змінювали. Переконайтеся, що ви надали їм актуальні конфігурації.

Ефективне управління сертифікатами та своєчасне оновлення конфігурацій — запорука успішної та безпечної роботи вашого проксі-сервера. Якщо ви шукаєте альтернативи 3x-ui, які також пропонують розширені функції та простоту управління, розгляньте sing-box на VPS, який є універсальним сервером для VLESS, Reality та Hysteria.

Перевірка та тестування після перенесення 3x-ui

Після завершення всіх кроків з міграції 3x-ui на новий сервер, вкрай важливо провести ретельну перевірку працездатності. Це дозволить переконатися, що всі користувачі можуть підключатися, трафік проходить без проблем, а всі налаштування збережені та функціонують коректно. Ігнорування цього етапу може призвести до несподіваних простоїв та скарг користувачів.

Основні етапи перевірки працездатності

1. Доступ до панелі 3x-ui:
   Спробуйте зайти у веб-інтерфейс 3x-ui за новою IP-адресою або доменом (якщо ви його змінювали) та портом (за замовчуванням 2053). Переконайтеся, що ви можете увійти, бачите всіх своїх користувачів та їхні налаштування. Перевірте логи панелі на наявність помилок (розділ "Logs" у 3x-ui).
2. Перевірка роботи Xray-сервера:
   Переконайтеся, що Xray-сервер, керований 3x-ui, запущений та слухає потрібні порти. Ви можете використовувати команду ss -tulnp (або netstat -tulnp) для перевірки відкритих портів.

sudo ss -tulnp | grep xray

Ви повинні побачити порти, які ви налаштували для своїх inbounds у 3x-ui (наприклад, 443, 80, 2053).

3. Тестування клієнтських підключень:
   
   • Підключення з тестового пристрою: Візьміть один із клієнтських пристроїв (наприклад, смартфон з v2rayNG або Hiddify) і спробуйте підключитися до нового сервера.
   • Перевірка всіх протоколів: Якщо ви використовуєте VLESS, Reality, VMess, Shadowsocks, Hysteria2 або інші протоколи, перевірте кожен з них.
   • Перевірка статистики: Після кількох хвилин використання, перевірте статистику трафіку в панелі 3x-ui для тестового користувача. Переконайтеся, що трафік враховується.
4. Перевірка SSL-сертифікатів (для TLS/Reality):
   Якщо ви використовуєте протоколи з TLS-шифруванням, переконайтеся, що сертифікати дійсні. Ви можете використовувати онлайн-інструменти для перевірки SSL або команду openssl на сервері.

# Перевірка сертифіката на порту 443 для вашого домену
echo | openssl s_client -servername your_domain.com -connect your_vps_ip:443 2>/dev/null | openssl x509 -noout -dates

Переконайтеся, що дати початку та закінчення терміну дії сертифіката коректні.

5. Перевірка продуктивності та затримки:
   Запустіть тести швидкості та перевірте затримку (ping) до нового VPS. Порівняйте їх з показниками старого сервера. Новий VPS повинен демонструвати покращені або аналогічні характеристики, особливо якщо ви переїжджали через проблеми з продуктивністю. Для оптимізації затримки та обходу блокувань, розгляньте статті щодо zapret на VPS та роутері або VPS для обходу блокувань в Ірані.

Вирішення можливих проблем

Якщо ви зіткнулися з проблемами, ось кілька поширених рішень:

• Не вдається підключитися до панелі 3x-ui:
  • Перевірте, чи запущено сервіс x-ui (sudo systemctl status x-ui).
  • Переконайтеся, що порт панелі 3x-ui (за замовчуванням 2053) відкрито у брандмауері VPS (ufw status або правила iptables).
  • Перевірте, чи немає конфліктів портів з іншими запущеними службами (sudo ss -tulnp).
• Клієнти не можуть підключитися до проксі:
  • Переконайтеся, що Xray запущений та слухає потрібні порти (див. вище).
  • Перевірте брандмауер VPS: чи відкрито порти, що використовуються вашими inbounds (наприклад, 443).
  • Якщо використовуєте домен, переконайтеся, що його A-запис вказує на нову IP-адресу і DNS повністю оновився.
  • Перевірте логи Xray через 3x-ui або командою journalctl -u x-ui -f на наявність помилок, пов'язаних з SSL-сертифікатами, портами або конфігурацією.
  • Переконайтеся, що в клієнтському додатку вказані коректні параметри (IP-адреса/домен, порт, UUID, SNI тощо).
• Проблеми з SSL-сертифікатами:
  • Переконайтеся, що файли fullchain.cer та .key існують за вказаними шляхами в налаштуваннях inbounds 3x-ui.
  • Перевірте права доступу до файлів сертифікатів (вони повинні бути доступні для користувача, під яким запускається Xray, зазвичай nobody або root, але краще nobody).
  • Спробуйте перевипустити сертифікат, якщо термін дії закінчився або він пошкоджений.

Ретельне тестування та оперативне вирішення проблем забезпечать плавний перехід та мінімальний дискомфорт для ваших користувачів. Якщо все працює стабільно, ви успішно завершили міграцію 3x-ui!

Чек-лист успішної міграції 3x-ui

Щоб забезпечити максимально гладке та безболісне перенесення 3x-ui, корисно мати під рукою перевірочний список. Дотримуючись цього чек-листа, ви мінімізуєте ризики та переконаєтеся, що жоден важливий крок не був пропущений.

Підготовчий етап (Старий VPS)

1. ☐ Повідомлення користувачів (якщо застосовно) про майбутні роботи та можливий короткочасний простій.
2. ☐ Зупинка сервісу 3x-ui: sudo systemctl stop x-ui.
3. ☐ Створення резервної копії бази даних x-ui.db: cp /etc/x-ui/x-ui.db ~/x-ui.db.bak.
4. ☐ Створення резервної копії каталогу SSL-сертифікатів: cp -r /root/.acme.sh/ ~/.acme.sh.bak.
5. ☐ Завантаження файлів резервної копії (x-ui.db.bak та .acme.sh.bak) на локальну машину за допомогою scp або SFTP.
6. ☐ Перевірка цілісності завантажених файлів (наприклад, розмір файлів).

Налаштування нового VPS

1. ☐ Вибір відповідного VPS-тарифу (Valebyte.com пропонує різні опції для дешевий VPS з погодинною оплатою або з моментальною активацією).
2. ☐ Встановлення вибраної операційної системи (рекомендується Ubuntu 20.04/22.04 LTS або Debian 11/12).
3. ☐ Підключення до нового VPS по SSH.
4. ☐ Оновлення системи: sudo apt update && sudo apt upgrade -y.
5. ☐ Встановлення 3x-ui за допомогою офіційного скрипта: bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh).
6. ☐ Зупинка сервісу 3x-ui на новому VPS: sudo systemctl stop x-ui.

Відновлення даних

1. ☐ Завантаження файлів резервної копії (x-ui.db.bak та .acme.sh.bak) з локальної машини на новий VPS (наприклад, у /tmp/).
2. ☐ Переміщення x-ui.db.bak до /etc/x-ui/x-ui.db: mv /tmp/x-ui.db.bak /etc/x-ui/x-ui.db.
3. ☐ Встановлення коректних прав доступу для x-ui.db: chown root:root /etc/x-ui/x-ui.db && chmod 600 /etc/x-ui/x-ui.db.
4. ☐ Переміщення .acme.sh.bak до /root/.acme.sh/: mv /tmp/.acme.sh.bak /root/.acme.sh.
5. ☐ Встановлення коректних прав доступу для .acme.sh/: chown -R root:root /root/.acme.sh && chmod -R 700 /root/.acme.sh.

Післяопераційні дії та перевірка

1. ☐ Запуск сервісу 3x-ui: sudo systemctl start x-ui && sudo systemctl enable x-ui.
2. ☐ Перевірка статусу сервісу 3x-ui: sudo systemctl status x-ui (має бути active (running)).
3. ☐ Вхід у веб-панель 3x-ui за новим IP-адресою/доменом та портом (за замовчуванням 2053).
4. ☐ Перевірка наявності всіх користувачів та їхніх налаштувань у панелі.
5. ☐ Оновлення DNS A-запису домену на нову IP-адресу VPS (якщо ви зберігаєте той самий домен).
6. ☐ Перевипуск SSL-сертифікатів для нового домену (якщо ви змінювали домен, або для оновлення існуючих).
7. ☐ Оновлення шляхів до сертифікатів та доменних імен у налаштуваннях inbounds 3x-ui (якщо змінювали домен або шляхи до сертифікатів).
8. ☐ Перевірка відкритих портів Xray: sudo ss -tulnp | grep xray.
9. ☐ Тестування підключення з кількох клієнтських пристроїв для всіх використовуваних протоколів.
10. ☐ Перевірка статистики трафіку в панелі 3x-ui.
11. ☐ Перевірка логів 3x-ui/Xray на наявність помилок.
12. ☐ Відкриття необхідних портів у брандмауері нового VPS (якщо не налаштовано автоматично).
13. ☐ Остаточне повідомлення користувачів про завершення міграції та, за необхідності, надання нових налаштувань.

З цим чек-листом ви зможете впевнено провести міграцію 3x-ui, зберігаючи контроль над кожним етапом та мінімізуючи можливі проблеми.

Висновки

Успішна міграція 3x-ui на новий VPS без втрати користувачів є багатоетапним, але цілком здійсненним процесом, що вимагає уважного ставлення до деталей. Ключовими кроками є ретельне резервне копіювання бази даних x-ui.db та SSL-сертифікатів, а також їх коректне відновлення на попередньо підготовленому новому сервері. Вибір надійного VPS, такого як пропоновані Valebyte.com, з відповідними характеристиками та стабільним мережевим каналом, критично важливий для забезпечення безперебійної роботи після перенесення. Дотримуючись докладних інструкцій та чек-листа, ви зможете без зусиль перенести свою панель 3x-ui, зберігши всі користувацькі дані та конфігурації, забезпечивши при цьому покращену продуктивність та надійність сервісу.