CLI
Bases de datos
En esta página
Obtener una lista de servidores de bases de datos
Comando
mogwai databases servers listSalida de ejemplo
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueEl servidor IDs se utiliza en otros comandos.
Obtener una lista de bases de datos
Comando
mogwai databases listSalida 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 UTCSincronizar 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 syncCrear 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 dbpassword1Este 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 listEjemplo 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:00El dominio IDs se utiliza en otros comandos.
Añadir un dominio de correo electrónico
Comando
mogwai emails domains createOpciones
--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 fastuserObtener una lista de buzones de correo
Comando
mogwai emails boxes listOpciones
--domain=DOMAIN: Nombre del dominio de correo
Comando de ejemplo
mogwai emails boxes list --domain example.comEjemplo 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:00El ID de la salida del comando se utiliza en otros comandos.
Crear un buzón de correo
Comando
mogwai emails boxes createOpciones
--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=MySecretPassword123Este 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 deleteOpciones
-b,--box=BOX: El ID del buzón de correo..
Comando de ejemplo
mogwai emails boxes delete -b 1Este 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 modoimport: 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_ADDROpciones
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=enDEST_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.comHay dos modos disponibles:
Modo de importación
mogwai emails boxes importEn 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 --forceModo de sincronización
mogwai emails boxes syncEn 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.txtDescripció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 --helpPara obtener más información sobre un comando específico, use:
mogwai command --helpPara ver una lista de comandos con descripciones, use:
mogwai --help-longSitios web
En esta página
Listado de sitios en un servidor
Comando
mogwai sites listEjemplo 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.comNota: 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.
- PHP:
--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.3Eliminación de un sitio
Comando
mogwai sites delete --id=IDEl ID del sitio se puede obtener del comando mogwai sites list.
Comando de ejemplo
mogwai sites delete --id=987Este 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.
- PHP:
--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
--idcon susIDs.
Comando de ejemplo
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Este 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 2Este 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
-mpara 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 subdirectoriologs/). Ú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.67Posibles 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
-mdurante 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.
FASTPANEL