FASTPANELWIKI

CLI

Bases de datos

En esta página

Obtener una lista de servidores de bases de datos

Comando

mogwai databases servers list

Salida de ejemplo

ID      NAME                    TYPE            LOCAL   HOST    USERNAME        AVAIL
1       mysql(localhost)        mysql           true            fastuser        true
2       postgresql(localhost)   postgresql      true            fastuser        true

El servidor IDs se utiliza en otros comandos.

Obtener una lista de bases de datos

Comando

mogwai databases list

Salida de ejemplo

ID      NAME            SERVER_NAME             LOCAL           HOST    CHARSET OWNER   SIZE    CREATE_AT                              
1       db1             mysql(localhost)        localhost       true    utf8mb4 user    0       2024-05-28 10:03:03.227413266 +0000 UTC
2       database43s     mysql(localhost)        localhost       true    utf8mb4 user82  0       2024-05-28 10:07:15.001640584 +0000 UTC

Sincronizar la lista de bases de datos

Si recientemente ha agregado o eliminado bases de datos, y aún no han aparecido en FASTPANEL, puede forzar la sincronización de las listas

Comando

mogwai databases sync

Crear una nueva base de datos

Comando

mogwai databases create [flags]

Opciones

  • -n, --name=NAME : Nombre de la base de datos.
  • -o, --owner="fastuser" :  Usuario de FASTPANEL al que se agregará la base de datos.
  • -s, --site=SITE : Sitio web en FASTPANEL al que se agregará la base de datos.
  • -c, --charset="utf8mb4" : Codificación de la base de datos.
  • -u, --username=USERNAME : Nombre de usuario de la base de datos.
  • -p, --password=PASSWORD : Contraseña del usuario de la base de datos.

Comando de ejemplo

mogwai databases create --server=1 -n db1 -o fastuser -s example.com -u dbuser -p dbpassword1

Este comando creará una base de datos llamada db1 en el servidor de bases de datos predeterminado (--server=1) y la "vincula" al sitio example.com.

Correo electrónico

En esta página

Obtener una lista de dominios de correo electrónico

Comando

mogwai emails domains list

Ejemplo de salida

ID      NAME            FALLBACK        DKIM    ENABLED OWNER_ID        OWNER           CREATE_AT
1       example.com                     true    true    1               example_com_usr 2024-01-04 15:46:02+03:00

El dominio IDs se utiliza en otros comandos.

Añadir un dominio de correo electrónico

Comando

mogwai emails domains create

Opciones

  • --domain=DOMAIN : Nombre del dominio de correo electrónico.
  • -o, --owner="fastuser" : El usuario de FASTPANEL al que se añadirá el dominio de correo electrónico.

Ejemplo de creación de un dominio de correo electrónico example1.com para el usuario fastuser

mogwai emails domains create --domain=example1.com -o fastuser

Obtener una lista de buzones de correo

Comando

mogwai emails boxes list

Opciones

  • --domain=DOMAIN : Nombre del dominio de correo

Comando de ejemplo

mogwai emails boxes list --domain example.com

Ejemplo de salida

ID      ADDRESS                 ALIASES REDIRECTS       SIZE    QUOTA   ENABLED OWNER_ID        OWNER           CREATE_AT
1       user@example.com                                0       0       true    4               example_com_usr 2024-02-08 11:13:01+03:00

El ID de la salida del comando se utiliza en otros comandos.

Crear un buzón de correo

Comando

mogwai emails boxes create

Opciones

  • --domain=DOMAIN : Nombre del dominio de correo electrónico.
  • -l, --login=LOGIN : El nombre del buzón de correo, sin el dominio.
  • -p, --password=PASSWORD : La contraseña del buzón de correo.

Comando de ejemplo

mogwai emails boxes create  --domain=example.com --login=user --password=MySecretPassword123

Este comando creará un buzón de correo llamado user@example.com con la contraseña MySecretPassword123.

Eliminar un buzón de correo

Comando

mogwai emails boxes delete

Opciones

  • -b, --box=BOX : El ID del buzón de correo..

Comando de ejemplo

mogwai emails boxes delete -b 1

Este comando eliminará el buzón de correo con el ID 1.

Importar buzones de correo y correos electrónicos

Comando

mogwai emails boxes import[sync] [<flags>]

Opciones

  • -i, --import_config=IMPORT_CONFIG : Ruta al archivo de lista de importación
  • --force : Solo para el modo import: borrar los buzones de correo existentes.

Para importar correo, debe preparar una lista de buzones de correo en el servidor con el formato:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Opciones

  • IMAP_HOST : Dirección del servidor de correo IMAP.
  • SOURCE_ADDR : Buzón de correo en el servidor de origen.
  • SOURCE_PASSWORD : Contraseña para la conexión IMAP al buzón de correo en el servidor de origen. Algunos servicios, como Google, requieren crear una contraseña de aplicación para el acceso IMAP https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Buzón de correo en el servidor FASTPANEL al que se transfieren los mensajes.

Contenido de ejemplo del archivo

imap.gmail.com;test@gmail.comu;password;test@example.com
imap.gmail.com;test1@gmail.com;password;test1@example.com

Hay dos modos disponibles:

Modo de importación

mogwai emails boxes import

En este modo, todos los mensajes se copian por completo; los buzones de correo en el servidor FASTPANEL no deben estar creados o deben estar vacíos: cuando se ejecuta el comando, FASTPANEL crea los buzones de correo necesarios. Si ya existen buzones de correo con contenido, se mostrará un error. Puede utilizar la bandera --force; entonces el buzón de correo se vaciará.

Ejemplo de ejecución del comando con una lista de buzones de correo almacenada en el archivo /root/import.txt y utilizando la clave --force

mogwai emails boxes import --import_config=/root/import.txt --force

Modo de sincronización

mogwai emails boxes sync

En este modo, el Panel de Control descarga mensajes del servidor de origen sin eliminar nada. Debe utilizarse si han aparecido mensajes nuevos en el buzón de correo original después de la primera importación, que también deben transferirse.

Comando de ejemplo

mogwai emails boxes sync --import_config=/root/import.txt

Descripción

En esta página

FASTPANEL proporciona una interfaz de línea de comandos (CLI) implementada mediante la utilidad mogwai (/usr/local/bin/mogwai). La utilidad solo funcionará cuando se ejecute como root.

Ayuda

Para ver una lista de comandos disponibles, use:

mogwai --help

Para obtener más información sobre un comando específico, use:

mogwai command --help

Para ver una lista de comandos con descripciones, use:

mogwai --help-long

Sitios web

En esta página

Listado de sitios en un servidor

Comando

mogwai sites list

Ejemplo de salida

ID      SERVER_NAME             ALIASES                         OWNER                   MODE    PHP_VERSION     IPS             DOCUMENT_ROOT
1       example.com             www.example.com                 example_com_usr         mpm_itk 82              127.0.0.1   /var/www/example_com_usr/data/www/example.com

Nota: Los IDs del sitio de esta lista se usan en otros comandos.

Creación de un nuevo sitio

Comando

mogwai sites create --server-name=SERVER-NAME --owner=OWNER [<flags>]

Opciones

  • --owner : Usuario en el sistema FASTPANEL que será el propietario del sitio.
  • --server-name=SERVER-NAME : Nombre de dominio del sitio.
  • -a, --alias=ALIAS : Alias del sitio, como subdominios www. Se pueden especificar varios alias.
  • --ip=IP : Dirección IP del servidor donde se ejecutará el sitio. Se pueden especificar varias direcciones IP.
  • -h, --handler=HANDLER : Manejador de backend. Puede ser:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Versión de PHP o Node.js (p. ej. 8.2, 8.3, 20.15.1).
  • --create-user : Crear un usuario para el sitio.

Comando de ejemplo

mogwai sites create --server-name=example.com --owner=user --create-user --alias=www.example.com --ip=127.0.0.1 --handler=fcgi --handler_version=7.3

Eliminación de un sitio

Comando

mogwai sites delete --id=ID

El ID del sitio se puede obtener del comando mogwai sites list.

Comando de ejemplo

mogwai sites delete --id=987

Este comando eliminará el sitio con ID 987

Modificación de la configuración del sitio

Comando

mogwai sites update --id=ID [<flags>]

El ID del sitio se puede obtener del comando mogwai sites list.

Opciones

  • -i, --id=ID : ID del sitio.
  • -a, --add-alias=ADD-ALIAS : Añadir un alias; se pueden especificar varios alias.
  • --del-alias=DEL-ALIAS : Eliminar un alias; se pueden especificar varios alias.
  • --add-ip=ADD-IP : Añadir una dirección IP desde la configuración del sitio; se pueden especificar varias direcciones IP.
  • --del-ip=DEL-IP : Eliminar una dirección IP de la configuración del sitio; se pueden especificar varias direcciones IP.
  • -h, --handler=HANDLER : Manejador de backend. Puede ser:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Versión de PHP o Node.js (p. ej. 8.2, 8.3, 20.15.1).
  • --gzip : Habilitar la compresión.
  • --no-gzip : Deshabilitar la compresión.
  • --gzip-comp-level=LEVEL : Establecer el nivel de compresión, 1-9.
  • --expires=EXPIRES : Establecer el tiempo de almacenamiento en caché para contenido estático.
  • --worker-count=WORKER-COUNT : Establecer el número de workers para PHP-FPM

También puede actualizar la configuración de varios sitios en un servidor usando el comando

mogwai sites batch-update
  • Para cambiar la configuración de todos los sitios, use el indicador -a.
  • Para cambiar la configuración de los sitios seleccionados, especifique varios indicadores --id con sus IDs.

Comando de ejemplo

mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6

Este comando añadirá un alias www1.example.com, cambiará el manejador a cgi y la versión de PHP a 5.6 para el sitio con ID 3

Comando de ejemplo

mogwai sites batch-update -h cgi --handler_version=5.6 --id 3 --id 2

Este comando cambiará el manejador de PHP para los sitios con ID 2 y 3

Transferencia de usuarios entre FASTPANEL

En esta página

Introducción

Este artículo describe el proceso de transferencia de cuentas de usuario y sus datos asociados (sitios web, bases de datos, correo electrónico, etc.) de un servidor FASTPANEL a otro utilizando la utilidad de migración integrada.

Términos clave

  • Servidor de origen - El servidor desde el que se transfieren los datos.
  • Servidor de destino - El servidor al que se transfieren los datos.

Notas importantes

  • De forma predeterminada, la migración funciona correctamente solo para sitios con una configuración estándar de FASTPANEL.

  • Los sitios con cambios de configuración manual solo se pueden transferir si se utiliza el indicador -m para la asignación de direcciones IP.

  • Si no hay disponible una contraseña cifrada para un propietario de base de datos, la base de datos no se transferirá.

  • Si un sitio web no se transfiere, sus bases de datos asociadas tampoco se transferirán.

  • Solo se pueden transferir bases de datos locales.

Proceso de migración

Conexión

El servidor de destino se conecta al servidor de origen mediante SSH. Durante la primera conexión, el servidor de destino instala una clave SSH en el servidor de origen (ya sea proporcionada previamente o generada a partir de una contraseña).

Pasos de la migración

  • Instalación de módulos
  • Recopilación de información sobre objetos transferibles
  • Creación de usuarios
  • Transferencia de certificados SSL
  • Creación de sitios web, cuentas FTP, dominios de correo electrónico y cuentas de correo electrónico
  • Creación de bases de datos y usuarios de bases de datos
  • Transferencia de archivos de sitios web y buzones de correo electrónico
  • Transferencia de tareas cron

La transferencia de archivos se ejecuta mediante rsync. Las bases de datos se transfieren creando un volcado a través de un túnel SSH.

Comando para iniciar la migración

El comando se ejecuta en el servidor de destino como un usuario con privilegios de root:

/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]

Indicadores de línea de comandos

Conexión SSH

  • --remote_host="SOURCE_IP" - Dirección IP del servidor de origen.
  • --remote_port="SSH_PORT" - Puerto SSH.
  • --remote_username="SSH_USER" - Usuario (debe ser root).
  • --remote_password="USER_PASSWORD" - Contraseña para el usuario SSH especificado.
  • --ssh_key_path="PATH_TO_KEY" - Ruta a la clave SSH privada en el servidor de destino para conectarse al servidor de origen. Si se utiliza una clave, la contraseña (--remote_password) no es necesaria.

Direcciones IP

Debe utilizar solo uno de los siguientes indicadores para gestionar las direcciones IP de los sitios durante la transferencia. El indicador -m tiene prioridad.

  • -i "IP_ADDRESS_ON_DESTINATION" - Asigna la dirección IP especificada a todos los sitios transferidos en el servidor de destino. Para especificar varias IP (p. ej., si había varias en el origen), repita el indicador para cada IP de origen que deba transferirse.

  • -m "SOURCE_IP,DESTINATION_IP" - Método recomendado. Establece una asignación directa: todos los sitios que usan SOURCE_IP en el servidor de origen usarán DESTINATION_IP en el servidor de destino. Este indicador se puede especificar varias veces para diferentes pares de IP. Obligatorio para transferir sitios con ediciones manuales de configuración, ya que permite sustituir correctamente las direcciones IP en las directivas listen.

Configuración adicional

  • --users="USER_LIST" - Transfiere solo los usuarios especificados (separados por comas). Si no se especifica, se transfieren todos los usuarios.
  • --disable_disk_quota - Desactiva la transferencia de cuotas de disco de usuario.
  • --with_user_data - Incluye la copia de todo el contenido de los directorios home de los usuarios (excepto el subdirectorio logs/). Úselo con precaución, ya que esto puede aumentar significativamente el tiempo de transferencia y la cantidad de datos transferidos.
  • --only_data - Transfiere solo datos (archivos de sitios web, archivos de correo, volcados de bases de datos). Útil si la migración inicial de la estructura (usuarios, sitios, BD, etc.) fue correcta, pero se produjeron errores durante la etapa de copia de archivos o volcados. Permite volver a ejecutar solo la parte de copia de datos.
  • --transfer_timeout - Establece el tiempo de espera de la operación (el valor predeterminado es 60 minutos).

Comando de ejemplo

Transfiera todos los usuarios del servidor 11.22.33.44 al servidor actual. En el servidor antiguo, los sitios usaban las IP 11.22.33.44 y 11.22.33.55; en el servidor nuevo, deben usar 99.88.77.66 y 99.88.77.67 respectivamente. Conexión mediante SSH con contraseña.

/usr/local/fastpanel2/fastpanel transfer run \
--remote_host=11.22.33.44 \
--remote_username=root \
--remote_password=YourSourceRootPassword \
-m 11.22.33.44,99.88.77.66 \
-m 11.22.33.55,99.88.77.67

Posibles problemas y tipos de errores

Un error en el registro de migración no siempre indica un problema crítico, pero puede señalar la razón por la que un objeto específico no fue transferido.

  • Conflictos: Ocurren cuando es imposible transferir un objeto debido a la configuración actual del servidor de destino (por ejemplo, ya existe un usuario o sitio con el mismo nombre) o si la configuración del sitio en el servidor de origen es desconocida para el panel (por ejemplo, debido a amplias ediciones manuales).

  • Contraseña guardada faltante: Como se mencionó anteriormente, los usuarios de bases de datos MySQL sin una contraseña guardada en FASTPANEL en el servidor de origen no se pueden transferir.

  • Configuración manual y direcciones IP: Si un sitio en el servidor de origen tiene ediciones manuales en la configuración del servidor web y no se utiliza el indicador -m durante la migración para asignar su dirección IP, dicho sitio no se transferirá porque el panel no sabe qué IP especificar en la configuración del servidor de destino.

Usuarios

En esta página

Creación de un nuevo usuario

Comando

mogwai users create --username=USERNAME --password=PASSWORD [--role="USER"]

Opciones

  • -u, --username=USERNAME : Especifique el nombre de usuario del nuevo usuario.
  • -p, --password=PASSWORD : Especifique la contraseña del nuevo usuario.
  • -r, --role="USER" : Especifique el rol del nuevo usuario. Los roles compatibles son RESELLER y USER. El rol predeterminado es USER.

Información de uso

Para crear un nuevo usuario con el nombre de usuario testuser, la contraseña My$ecretPassword123 y el rol RESELLER, use el siguiente comando:

mogwai users create --username=testuser --password=My$ecretPassword123 --role="RESELLER"

Notas adicionales

  • Los nombres de usuario deben ser únicos y no pueden contener espacios ni puntos.
  • Las contraseñas deben tener al menos 8 caracteres. Recomendamos usar al menos una letra mayúscula, una letra minúscula, un número y un carácter especial.