Copia de seguridad y migración de 3x-ui a otro VPS sin perder usuarios

La migración eficiente de 3x-ui a un nuevo VPS sin perder usuarios ni sus configuraciones requiere la conservación de la base de datos x-ui.db, que contiene todas las cuentas y configuraciones, así como el directorio con los certificados SSL, generalmente ubicado en /root/.acme.sh, para su posterior despliegue en el nuevo servidor.

La migración de infraestructura, especialmente de servicios críticos como 3x-ui, es una tarea común para administradores de sistemas y desarrolladores. Ya sea por la necesidad de un hardware más potente, un cambio de región para mejorar la latencia, la optimización de costos o el aumento de la tolerancia a fallos, el proceso debe ser bien planificado y sin interrupciones. 3x-ui, como un popular panel de control para servidores Xray, se utiliza activamente para crear y gestionar servidores proxy que soportan varios protocolos, como VLESS, Reality, XTLS, VMess, Shadowsocks y otros. La pérdida de datos de usuarios o una configuración incorrecta después de la migración puede provocar graves problemas de disponibilidad del servicio. En este artículo, examinaremos en detalle cada paso, desde la preparación hasta la verificación final, para asegurar una migración de 3x-ui lo más fluida posible a un nuevo servidor.

¿Dónde almacena 3x-ui sus datos y por qué es importante para la copia de seguridad?

Para un **backup de 3x-ui** exitoso y la posterior migración, es crucial entender dónde el panel almacena sus configuraciones, datos de usuario y certificados. 3x-ui utiliza una base de datos SQLite para almacenar toda la información operativa sobre los usuarios, sus credenciales, estadísticas de tráfico, así como la configuración de los servidores proxy. Además, para asegurar una conexión segura mediante TLS (incluyendo los protocolos VLESS con XTLS/Reality), se requieren certificados SSL. Estos dos componentes son clave para mantener la funcionalidad después de la migración.

Componentes principales de los datos de 3x-ui

• Base de datos x-ui.db: Este es el corazón de su panel 3x-ui. Contiene:
  • Todos los usuarios creados con sus UUID, puertos, protocolos y configuraciones adicionales.
  • Estadísticas de uso de tráfico para cada usuario.
  • Configuraciones de conexiones entrantes y salientes (inbounds/outbounds).
  • Configuraciones generales del panel 3x-ui (puerto, nombre de usuario/contraseña del administrador, límites).

  Por defecto, x-ui.db se encuentra en el directorio donde está instalado 3x-ui. En la mayoría de los casos, con una instalación estándar, será /etc/x-ui/x-ui.db. Sin embargo, si instaló 3x-ui manualmente o utilizó un script que permite elegir la ruta, podría ser diferente. Siempre verifique la ubicación del archivo antes de iniciar la copia de seguridad.

• Certificados SSL: Para el funcionamiento de los protocolos que requieren cifrado TLS (VLESS, VMess, Shadowsocks con TLS, Reality), se necesitan certificados SSL válidos. Con mayor frecuencia, se emiten utilizando Let's Encrypt a través del script acme.sh. El directorio donde acme.sh almacena los certificados y claves suele ser /root/.acme.sh/. En este directorio, encontrará subdirectorios nombrados según sus dominios, dentro de los cuales se almacenan los archivos de certificado (fullchain.cer) y las claves privadas (.key).
• Archivos de configuración de 3x-ui (opcional): Aunque la configuración principal se almacena en la base de datos, algunos scripts de instalación pueden crear archivos de configuración adicionales o unidades de sistema (systemd service files). Sin embargo, para la mayoría de los escenarios de migración, un backup de x-ui.db y los certificados es suficiente.

¿Por qué es tan importante una copia de seguridad completa de x-ui.db y los certificados?

Sin x-ui.db, perderá a todos sus usuarios, sus UUID, configuraciones y estadísticas. De hecho, esto sería equivalente a una nueva instalación de 3x-ui, donde tendría que crear de nuevo a todos los usuarios y enviarles nuevas configuraciones. Esto no solo es laborioso, sino también extremadamente inconveniente para sus clientes.

Sin certificados SSL, sus servidores proxy que utilizan TLS dejarán de funcionar. Los usuarios recibirán errores de conexión, ya que el servidor no podrá establecer una conexión segura. Aunque los certificados se pueden volver a emitir en el nuevo servidor, esto requiere tiempo y una configuración DNS correcta, y también puede provocar una interrupción temporal. La conservación de los certificados existentes minimiza el tiempo de inactividad y evita la necesidad de reconfigurar los dispositivos cliente si no cambia el dominio.

Comprender estos componentes clave permite elaborar un plan de acción preciso para la migración de 3x-ui, garantizando que todos los datos importantes se conserven y se restauren correctamente en el nuevo servidor.

Copia de seguridad completa de 3x-ui: ¿qué guardar antes de la migración?

Antes de proceder con la migración de 3x-ui, es necesario realizar una copia de seguridad completa de todos los datos críticos desde el VPS actual. Este proceso incluye detener el servicio 3x-ui, copiar la base de datos y los certificados SSL, y luego moverlos de forma segura a una máquina local o a un almacenamiento en la nube. Seguir estrictamente estos pasos garantiza la integridad de los datos y minimiza los riesgos.

Detención del servicio 3x-ui para la integridad de la copia de seguridad

Antes de copiar la base de datos, asegúrese de detener el servicio 3x-ui. Esto evitará cualquier operación de escritura en x-ui.db durante la copia, eliminando el riesgo de corrupción o una copia de seguridad incompleta. Si la base de datos se utiliza durante la copia, podría obtener un archivo inconsistente que sería difícil o imposible de restaurar.

Conéctese a su VPS antiguo por SSH y ejecute los siguientes comandos:

sudo systemctl stop x-ui
sudo systemctl disable x-ui # Opcional: evitará el inicio al reiniciar

Asegúrese de que el servicio esté detenido:

sudo systemctl status x-ui

La salida debería mostrar que el servicio está inactivo (inactive (dead)).

Copia de la base de datos x-ui.db y los certificados SSL

Ahora que el servicio está detenido, puede copiar de forma segura los archivos necesarios.

1. Copia de seguridad de la base de datos x-ui.db:
   Localice el archivo x-ui.db. En la mayoría de los casos, se encuentra en la ruta /etc/x-ui/x-ui.db. Si instaló 3x-ui de otra manera, la ruta puede variar. Puede usar el comando find / -name x-ui.db para buscarlo.
   Copie el archivo a un lugar seguro, por ejemplo, al directorio de inicio del usuario, para poder descargarlo fácilmente después:

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

2. Copia de seguridad de los certificados SSL:
   El directorio con los certificados suele estar en la ruta /root/.acme.sh/. Cópielo por completo. Si utiliza varios dominios, este directorio contendrá todos los certificados necesarios.
   

   Si no utilizó acme.sh o sus certificados están en otra ubicación, asegúrese de copiar el archivo fullchain.cer y el archivo .key correspondiente para cada dominio utilizado. Si utiliza Reality, la copia de seguridad de los certificados no es tan crítica, ya que se generan sobre la marcha, pero si utiliza VLESS/VMess con TLS, es obligatorio.

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

   Ahora tiene dos archivos/directorios para descargar: ~/x-ui.db.bak y ~/.acme.sh.bak.

Descarga de los archivos de copia de seguridad a la máquina local

Una vez que los archivos se hayan copiado al directorio de inicio, puede descargarlos a su máquina local utilizando scp o un cliente SFTP (por ejemplo, WinSCP, FileZilla).

Usando scp:

# Abra una terminal en su MÁQUINA LOCAL
scp user@your_old_vps_ip:~/x-ui.db.bak .
scp -r user@your_old_vps_ip:~/.acme.sh.bak .

Reemplace user con su nombre de usuario (normalmente root o un usuario con privilegios sudo), y your_old_vps_ip con la dirección IP de su VPS antiguo.

Después de una descarga exitosa, asegúrese de que los archivos no estén dañados y tengan un tamaño razonable. En este punto, la copia de seguridad está completa. Ahora puede eliminar los archivos de copia de seguridad del VPS antiguo o dejarlos como una medida de precaución adicional. Si planea eliminar completamente el VPS antiguo, asegúrese de tener una copia de seguridad fiable.

Ahora que tenemos todos los datos necesarios, podemos pasar a la preparación del nuevo servidor para 3x-ui en el nuevo servidor.

Preparación del nuevo VPS para la migración de 3x-ui

Antes de proceder con la restauración de datos, es necesario preparar el nuevo VPS. Esta etapa incluye la selección de un servidor adecuado, su configuración básica, la instalación de las dependencias necesarias y, por supuesto, la instalación del propio panel 3x-ui. Una preparación correcta del nuevo servidor garantizará un funcionamiento estable y una migración de 3x-ui sin problemas.

Selección del VPS óptimo para 3x-ui: ¿qué considerar?

La elección del VPS depende de la carga prevista. Para 3x-ui, los factores principales son el número de usuarios activos, el volumen de tráfico transmitido y los protocolos que planea usar (Reality, XTLS, TLS requieren más recursos de CPU). Valebyte.com ofrece varias tarifas adecuadas para diferentes tareas. Por ejemplo, para un número pequeño de usuarios (hasta 20-30) con tráfico moderado, una tarifa básica con 1 vCPU, 1-2 GB de RAM y 20-30 GB de disco NVMe será suficiente. Para escenarios más exigentes, como Hiddify en VPS o Marzban en VPS, que pueden manejar cientos de usuarios, es mejor considerar tarifas con 2-4 vCPU, 4-8 GB de RAM y un disco más rápido.

Parámetros clave:

• Procesador (vCPU): 1-2 núcleos para la mayoría de los casos, 2+ para cargas altas o Reality.
• Memoria RAM: 1-2 GB es suficiente para Xray/3x-ui, pero 2-4 GB ofrecen más margen.
• Disco (SSD/NVMe): 20-40 GB NVMe será más que suficiente. NVMe proporciona un mejor rendimiento de E/S, lo cual es importante para bases de datos y registros.
• Ancho de banda de red: 100 Mbps - 1 Gbps. Cuanto mayor sea el ancho de banda, mejor para el proxy.
• Ubicación del servidor: Elija una ubicación que proporcione la mínima latencia para sus usuarios.
• Sistema operativo: Ubuntu 20.04/22.04 LTS, Debian 10/11/12 o CentOS 7/8. Las versiones LTS de Ubuntu son la opción más común.

Características aproximadas de VPS para 3x-ui:

Categoría de uso	vCPU	RAM	Disco (NVMe)	Ancho de banda de red	Precio aproximado (Valebyte.com)
Pequeño (hasta 20-30 usuarios)	1 núcleo	1-2 GB	20 GB	100 Mbps	$5 - $8/mes
Mediano (hasta 50-100 usuarios)	2 núcleos	2-4 GB	30-40 GB	250-500 Mbps	$8 - $15/mes
Alto (más de 100 usuarios, Reality/XTLS)	4+ núcleos	4-8 GB	50+ GB	500 Mbps - 1 Gbps	$15 - $30+/mes

Configuración básica del nuevo VPS e instalación de 3x-ui

Después de activar el nuevo VPS (muchos proveedores, incluido Valebyte.com, ofrecen VPS con activación instantánea), conéctese a él por SSH.

1. Actualización del sistema:
   Siempre comience actualizando el gestor de paquetes y los paquetes instalados.

   sudo apt update && sudo apt upgrade -y # Para Debian/Ubuntu
   # sudo yum update -y # Para CentOS/RHEL
   

2. Instalación de utilidades necesarias:
   Instale curl, wget, git y unzip, si aún no están instalados. Pueden ser necesarios para la instalación de 3x-ui y el manejo de archivos.

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

3. Instalación de 3x-ui:
   Utilice el script oficial para instalar 3x-ui. Esto garantiza que todas las dependencias se instalen correctamente y que el panel funcione con las rutas adecuadas.

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

   Siga las instrucciones del script. Después de la instalación, 3x-ui se iniciará con una base de datos vacía. No necesita configurar usuarios ni puertos en esta etapa, ya que restauraremos los datos desde la copia de seguridad. Simplemente asegúrese de que el panel esté instalado y que el servicio x-ui esté presente en el sistema.

4. Detención del nuevo servicio 3x-ui:
   Al igual que en el servidor antiguo, necesitamos detener 3x-ui para reemplazar la base de datos de forma segura.

   sudo systemctl stop x-ui
   sudo systemctl disable x-ui # Opcional, pero recomendado
   

Ahora su nuevo VPS está listo para recibir los datos de la copia de seguridad. Tiene una copia limpia de 3x-ui instalada, pero aún no contiene sus usuarios y configuraciones. El siguiente paso es la restauración de datos.

Migración paso a paso de 3x-ui: restauración de datos y usuarios

La etapa más crítica de la migración de 3x-ui es la restauración de los datos guardados en el nuevo servidor. Este proceso incluye la carga de los archivos de copia de seguridad al nuevo VPS, el reemplazo de la base de datos de 3x-ui y la restauración de los certificados SSL. Es importante seguir las instrucciones con precisión para evitar la pérdida de datos o un funcionamiento incorrecto del servicio.

Carga de los archivos de copia de seguridad al nuevo VPS

Transfiera los archivos x-ui.db.bak y .acme.sh.bak, que descargó previamente a su máquina local, a su nuevo VPS. Puede usar scp o un cliente SFTP.

Usando scp:

# Abra una terminal en su MÁQUINA LOCAL
scp ~/x-ui.db.bak user@your_new_vps_ip:/tmp/
scp -r ~/.acme.sh.bak user@your_new_vps_ip:/tmp/

Reemplace user con el nombre de usuario (normalmente root), y your_new_vps_ip con la dirección IP de su nuevo VPS. Los archivos se cargarán en el directorio temporal /tmp/ en el nuevo servidor.

Restauración de la base de datos de 3x-ui

Conéctese al nuevo VPS por SSH. Ahora reemplazaremos la base de datos vacía de 3x-ui con la que ha copiado.

1. Movimiento de la base de datos:
   Mueva el archivo de copia de seguridad x-ui.db.bak de /tmp/ al directorio de destino de 3x-ui, reemplazando el archivo x-ui.db vacío existente. El directorio predeterminado de 3x-ui es /etc/x-ui/.

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

2. Configuración de permisos:
   Asegúrese de que el archivo de la base de datos tenga los permisos y el propietario correctos para que 3x-ui pueda trabajar con él. Normalmente, esto es root:root y permisos 0600 o 0640.

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

Restauración de certificados SSL

Si utilizó TLS o Reality, debe restaurar los certificados.

1. Movimiento del directorio .acme.sh:
   Mueva el directorio de copia de seguridad .acme.sh.bak al directorio de inicio /root/, reemplazándolo si existe (aunque en un nuevo servidor, es probable que no exista).

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

2. Configuración de permisos:
   Asegúrese de que el directorio y los archivos dentro de él tengan los permisos y el propietario correctos.

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

Después de completar estos pasos, todos sus datos y certificados estarán en su lugar en el nuevo VPS. Ahora puede iniciar el servicio 3x-ui.

Inicio de 3x-ui y verificación de la funcionalidad

Inicie el servicio 3x-ui y asegúrese de que se haya iniciado correctamente:

sudo systemctl start x-ui
sudo systemctl enable x-ui # Para que el servicio se inicie al arrancar el sistema
sudo systemctl status x-ui

Si todo salió bien, el estado debería ser active (running). Intente acceder al panel de control de 3x-ui a través de un navegador web utilizando la dirección IP de su nuevo VPS y el puerto del panel (por defecto 2053). Debería ver a todos sus usuarios y sus configuraciones. Verifique los logs de 3x-ui en busca de errores:

journalctl -u x-ui -f

En caso de problemas, esto ayudará a identificar la causa. Los problemas comunes incluyen permisos de archivo incorrectos o errores en la base de datos (si la copia de seguridad se realizó incorrectamente, lo cual es poco probable si el servicio se detuvo).

Con esto, el proceso principal de restauración ha finalizado. El siguiente paso es la verificación de las configuraciones y, si es necesario, el cambio de dominio.

Cambio de dominio después de la migración de 3x-ui: certificados y configuración

En algunos casos, al migrar 3x-ui a un nuevo VPS, puede ser necesario cambiar el nombre de dominio utilizado para acceder a los servidores proxy. Esto puede deberse a que el dominio antiguo está vinculado a la IP antigua, o simplemente desea utilizar un nuevo dominio. El cambio de dominio implica la necesidad de volver a emitir los certificados SSL y actualizar las configuraciones de los usuarios.

¿Cuándo es necesario cambiar el dominio?

• Cambio de dirección IP y la imposibilidad de reasignar el dominio antiguo: Si su dominio antiguo está fuertemente vinculado al VPS antiguo o no puede actualizar los registros DNS por alguna razón.
• Deseo de utilizar un dominio nuevo y más adecuado: Quizás quiera mejorar la marca o simplemente usar un nombre más conveniente.
• Problemas con el dominio actual: El dominio ha sido incluido en listas negras, bloqueado o tiene otros problemas.

Si simplemente migró el VPS, pero mantuvo el nombre de dominio y actualizó su registro DNS A a la nueva dirección IP, la reemisión de certificados no siempre es obligatoria si los certificados antiguos aún son válidos y se transfirieron con éxito. Sin embargo, para garantizar la máxima fiabilidad y actualidad, se recomienda volver a emitirlos.

Reemisión de certificados SSL para el nuevo dominio

Supongamos que su dominio antiguo era old.example.com, y el nuevo será new.example.com.

1. Actualice el registro DNS A:
   Asegúrese de que el registro A para new.example.com apunte a la dirección IP de su nuevo VPS. Esto es crucial para el funcionamiento de Let's Encrypt y el correcto funcionamiento del servidor proxy. Espere a que los registros DNS se propaguen completamente (puede tardar desde unos minutos hasta varias horas).
2. Eliminación de certificados antiguos (opcional, pero recomendado para mayor limpieza):
   Puede eliminar los registros antiguos para old.example.com de /root/.acme.sh/ si ya no son necesarios, o simplemente permitir que acme.sh maneje el nuevo dominio.
3. Emisión de un nuevo certificado usando acme.sh:
   Detenga 3x-ui si utiliza el puerto 80/443 para obtener el certificado (por defecto, 3x-ui utiliza otros puertos para el panel, pero Xray puede escuchar en el 443).

   Ejecute el comando para emitir un nuevo certificado. Asegúrese de tener acme.sh instalado (normalmente viene con la instalación de 3x-ui o se puede instalar manualmente).

   # Asegúrese de que 3x-ui esté detenido si entra en conflicto con el puerto 80/443
   sudo systemctl stop x-ui
   
   # Emita el certificado para el nuevo dominio (usando webroot o standalone)
   # Webroot:
   acme.sh --issue -d new.example.com --webroot /var/www/html/ # si tiene un servidor web en el puerto 80
   # Standalone (el más simple si el puerto 80 está libre):
   acme.sh --issue -d new.example.com --standalone
   
   # Después de la emisión, instale el certificado en las rutas correctas.
   # Xray normalmente requiere los archivos fullchain.cer y .key.
   # 3x-ui puede detectarlos automáticamente desde .acme.sh,
   # pero es mejor especificar explícitamente las rutas en la configuración de los 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"
   

   Después de la emisión e instalación exitosa del certificado, inicie 3x-ui:

   sudo systemctl start x-ui
   

Actualización de configuraciones en el panel 3x-ui

Después de obtener el nuevo certificado, debe actualizar todas las conexiones entrantes (inbounds) en el panel 3x-ui que utilizaban el dominio antiguo y los certificados antiguos. Acceda a la interfaz web de 3x-ui:

1. Vaya a la sección "Inbounds".
2. Para cada inbound que utilizaba el dominio antiguo:
   
   • Edítelo.
   • En el campo "Dominio" (o "Host", "SNI"), especifique new.example.com.
   • En los campos "Certificado SSL" y "Clave privada SSL", especifique las nuevas rutas a los archivos de certificado y clave que obtuvo (por ejemplo, /etc/x-ui/new.example.com.pem y /etc/x-ui/new.example.com.key).
   • Guarde los cambios.
3. Si utiliza Reality, asegúrese de que en la configuración de los inbounds se especifiquen correctamente el dest (dominio de destino que está clonando) y los serverNames (dominios SNI que se utilizarán). Estos no dependen de su certificado, pero deben estar configurados correctamente.

Después de actualizar todos los inbounds, 3x-ui recargará automáticamente la configuración de Xray. Sus usuarios ahora deberán actualizar sus aplicaciones cliente, especificando el nuevo dominio new.example.com y, posiblemente, nuevos puertos si los cambió. Asegúrese de proporcionarles las configuraciones actualizadas.

Una gestión eficiente de los certificados y la actualización oportuna de las configuraciones son la clave para un funcionamiento exitoso y seguro de su servidor proxy. Si busca alternativas a 3x-ui que también ofrezcan funciones avanzadas y facilidad de gestión, considere sing-box en VPS, que es un servidor universal para VLESS, Reality e Hysteria.

Verificación y pruebas después de la migración de 3x-ui

Una vez completados todos los pasos para la migración de 3x-ui a un nuevo servidor, es crucial realizar una verificación exhaustiva de la funcionalidad. Esto asegurará que todos los usuarios puedan conectarse, que el tráfico fluya sin problemas y que todas las configuraciones se hayan conservado y funcionen correctamente. Ignorar esta etapa puede llevar a interrupciones inesperadas y quejas de los usuarios.

Etapas principales de verificación de la funcionalidad

1. Acceso al panel 3x-ui:
   Intente acceder a la interfaz web de 3x-ui utilizando la nueva dirección IP o dominio (si lo cambió) y el puerto (por defecto 2053). Asegúrese de poder iniciar sesión, ver a todos sus usuarios y sus configuraciones. Verifique los logs del panel en busca de errores (sección "Logs" en 3x-ui).
2. Verificación del funcionamiento del servidor Xray:
   Asegúrese de que el servidor Xray, gestionado por 3x-ui, esté en funcionamiento y escuchando en los puertos correctos. Puede usar el comando ss -tulnp (o netstat -tulnp) para verificar los puertos abiertos.

sudo ss -tulnp | grep xray

Debería ver los puertos que configuró para sus inbounds en 3x-ui (por ejemplo, 443, 80, 2053).

3. Prueba de conexiones de clientes:
   
   • Conexión desde un dispositivo de prueba: Tome uno de los dispositivos cliente (por ejemplo, un smartphone con v2rayNG o Hiddify) e intente conectarse al nuevo servidor.
   • Verificación de todos los protocolos: Si utiliza VLESS, Reality, VMess, Shadowsocks, Hysteria2 u otros protocolos, pruebe cada uno de ellos.
   • Verificación de estadísticas: Después de unos minutos de uso, verifique las estadísticas de tráfico en el panel 3x-ui para el usuario de prueba. Asegúrese de que el tráfico se esté contabilizando.
4. Verificación de certificados SSL (para TLS/Reality):
   Si utiliza protocolos con cifrado TLS, asegúrese de que los certificados sean válidos. Puede usar herramientas en línea para verificar SSL o el comando openssl en el servidor.

# Verificación del certificado en el puerto 443 para su dominio
echo | openssl s_client -servername your_domain.com -connect your_vps_ip:443 2>/dev/null | openssl x509 -noout -dates

Asegúrese de que las fechas de inicio y fin de validez del certificado sean correctas.

5. Verificación de rendimiento y latencia:
   Ejecute pruebas de velocidad y verifique la latencia (ping) al nuevo VPS. Compárelas con las métricas del servidor antiguo. El nuevo VPS debería mostrar características mejoradas o similares, especialmente si se mudó debido a problemas de rendimiento. Para optimizar la latencia y evitar bloqueos, consulte los artículos sobre zapret en VPS y router o VPS para evitar bloqueos en Irán.

Solución de posibles problemas

Si encuentra problemas, aquí hay algunas soluciones comunes:

• No se puede conectar al panel 3x-ui:
  • Verifique si el servicio x-ui está en ejecución (sudo systemctl status x-ui).
  • Asegúrese de que el puerto del panel 3x-ui (por defecto 2053) esté abierto en el firewall del VPS (ufw status o reglas iptables).
  • Verifique si hay conflictos de puertos con otros servicios en ejecución (sudo ss -tulnp).
• Los clientes no pueden conectarse al proxy:
  • Asegúrese de que Xray esté en ejecución y escuchando en los puertos correctos (ver arriba).
  • Verifique el firewall del VPS: ¿están abiertos los puertos utilizados por sus inbounds (por ejemplo, 443)?
  • Si usa un dominio, asegúrese de que su registro A apunte a la nueva dirección IP y que el DNS se haya actualizado completamente.
  • Verifique los logs de Xray a través de 3x-ui o con el comando journalctl -u x-ui -f en busca de errores relacionados con certificados SSL, puertos o configuración.
  • Asegúrese de que la aplicación cliente tenga los parámetros correctos (dirección IP/dominio, puerto, UUID, SNI, etc.).
• Problemas con certificados SSL:
  • Asegúrese de que los archivos fullchain.cer y .key existan en las rutas especificadas en la configuración de los inbounds de 3x-ui.
  • Verifique los permisos de los archivos de certificado (deben ser accesibles para el usuario bajo el cual se ejecuta Xray, normalmente nobody o root, pero es mejor nobody).
  • Intente volver a emitir el certificado si ha caducado o está dañado.

Unas pruebas exhaustivas y una resolución rápida de problemas garantizarán una transición fluida y una mínima interrupción para sus usuarios. Si todo funciona de manera estable, ¡ha completado con éxito la migración de 3x-ui!

Lista de verificación para una migración exitosa de 3x-ui

Para asegurar una migración de 3x-ui lo más fluida y sin problemas posible, es útil tener una lista de verificación a mano. Siguiendo esta lista de verificación, minimizará los riesgos y se asegurará de que no se omita ningún paso importante.

Etapa preparatoria (VPS antiguo)

1. ☐ Notificación a los usuarios (si aplica) sobre los trabajos próximos y la posible interrupción temporal.
2. ☐ Detención del servicio 3x-ui: sudo systemctl stop x-ui.
3. ☐ Creación de una copia de seguridad de la base de datos x-ui.db: cp /etc/x-ui/x-ui.db ~/x-ui.db.bak.
4. ☐ Creación de una copia de seguridad del directorio de certificados SSL: cp -r /root/.acme.sh/ ~/.acme.sh.bak.
5. ☐ Descarga de los archivos de copia de seguridad (x-ui.db.bak y .acme.sh.bak) a la máquina local usando scp o SFTP.
6. ☐ Verificación de la integridad de los archivos descargados (por ejemplo, el tamaño de los archivos).

Configuración del nuevo VPS

1. ☐ Selección de una tarifa de VPS adecuada (Valebyte.com ofrece varias opciones para VPS económicos con pago por hora o con activación instantánea).
2. ☐ Instalación del sistema operativo elegido (se recomienda Ubuntu 20.04/22.04 LTS o Debian 11/12).
3. ☐ Conexión al nuevo VPS por SSH.
4. ☐ Actualización del sistema: sudo apt update && sudo apt upgrade -y.
5. ☐ Instalación de 3x-ui usando el script oficial: bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh).
6. ☐ Detención del servicio 3x-ui en el nuevo VPS: sudo systemctl stop x-ui.

Restauración de datos

1. ☐ Carga de los archivos de copia de seguridad (x-ui.db.bak y .acme.sh.bak) desde la máquina local al nuevo VPS (por ejemplo, en /tmp/).
2. ☐ Movimiento de x-ui.db.bak a /etc/x-ui/x-ui.db: mv /tmp/x-ui.db.bak /etc/x-ui/x-ui.db.
3. ☐ Establecimiento de permisos correctos para x-ui.db: chown root:root /etc/x-ui/x-ui.db && chmod 600 /etc/x-ui/x-ui.db.
4. ☐ Movimiento de .acme.sh.bak a /root/.acme.sh/: mv /tmp/.acme.sh.bak /root/.acme.sh.
5. ☐ Establecimiento de permisos correctos para .acme.sh/: chown -R root:root /root/.acme.sh && chmod -R 700 /root/.acme.sh.

Acciones post-operativas y verificación

1. ☐ Inicio del servicio 3x-ui: sudo systemctl start x-ui && sudo systemctl enable x-ui.
2. ☐ Verificación del estado del servicio 3x-ui: sudo systemctl status x-ui (debe ser active (running)).
3. ☐ Acceso al panel web de 3x-ui a través de la nueva dirección IP/dominio y puerto (por defecto 2053).
4. ☐ Verificación de la presencia de todos los usuarios y sus configuraciones en el panel.
5. ☐ Actualización del registro DNS A del dominio a la nueva dirección IP del VPS (si mantiene el mismo dominio).
6. ☐ Reemisión de certificados SSL para el nuevo dominio (si cambió el dominio, o para actualizar los existentes).
7. ☐ Actualización de las rutas de los certificados y los nombres de dominio en la configuración de los inbounds de 3x-ui (si cambió el dominio o las rutas de los certificados).
8. ☐ Verificación de los puertos Xray abiertos: sudo ss -tulnp | grep xray.
9. ☐ Prueba de conexión desde varios dispositivos cliente para todos los protocolos utilizados.
10. ☐ Verificación de las estadísticas de tráfico en el panel 3x-ui.
11. ☐ Verificación de los logs de 3x-ui/Xray en busca de errores.
12. ☐ Apertura de los puertos necesarios en el firewall del nuevo VPS (si no está configurado automáticamente).
13. ☐ Notificación final a los usuarios sobre la finalización de la migración y, si es necesario, provisión de nuevas configuraciones.

Con esta lista de verificación, podrá realizar la migración de 3x-ui con confianza, manteniendo el control sobre cada etapa y minimizando posibles problemas.

Conclusiones

La migración exitosa de 3x-ui a un nuevo VPS sin pérdida de usuarios es un proceso de varias etapas, pero totalmente factible, que requiere una atención cuidadosa a los detalles. Los pasos clave son una copia de seguridad exhaustiva de la base de datos x-ui.db y los certificados SSL, así como su correcta restauración en un nuevo servidor previamente preparado. La elección de un VPS fiable, como los ofrecidos por Valebyte.com, con características adecuadas y un canal de red estable, es fundamental para garantizar un funcionamiento ininterrumpido después de la migración. Siguiendo las instrucciones detalladas y la lista de verificación, podrá migrar fácilmente su panel 3x-ui, conservando todos los datos y configuraciones de los usuarios, y garantizando un rendimiento y fiabilidad mejorados del servicio.