FASTPANELWIKI

CLI

Bancos de dados

Nesta página

Obtendo uma lista de servidores de banco de dados

Comando

mogwai databases servers list

Exemplo de saída

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

O servidor IDs é usado em outros comandos.

Obtendo uma lista de bancos de dados

Comando

mogwai databases list

Exemplo de saída

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

Sincronizando a lista de bancos de dados

Se você adicionou ou removeu bancos de dados recentemente, e eles ainda não apareceram no FASTPANEL, você pode forçar a sincronização das listas

Comando

mogwai databases sync

Criando um novo banco de dados

Comando

mogwai databases create [flags]

Opções

  • -n, --name=NAME : Nome do banco de dados.
  • -o, --owner="fastuser" :  Usuário do FASTPANEL ao qual o banco de dados será adicionado.
  • -s, --site=SITE : Site no FASTPANEL ao qual o banco de dados será adicionado.
  • -c, --charset="utf8mb4" : Codificação do banco de dados.
  • -u, --username=USERNAME : Nome de usuário do banco de dados.
  • -p, --password=PASSWORD : Senha do usuário do banco de dados.

Exemplo de comando

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

Este comando criará um banco de dados chamado db1 no servidor de banco de dados padrão (--server=1) e o "vincula" ao site example.com.

E-mail

Nesta página

Obtendo uma lista de domínios de e-mail

Comando

mogwai emails domains list

Exemplo de saída

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

Os domínios IDs são usados em outros comandos.

Adicionando um domínio de e-mail

Comando

mogwai emails domains create

Opções

  • --domain=DOMAIN : Nome do domínio de e-mail.
  • -o, --owner="fastuser" : O usuário FASTPANEL ao qual o domínio de e-mail será adicionado.

Exemplo de criação de um domínio de e-mail example1.com sob o usuário fastuser

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

Obtendo uma lista de caixas de correio

Comando

mogwai emails boxes list

Opções

  • --domain=DOMAIN : Nome do domínio de e-mail

Exemplo de comando

mogwai emails boxes list --domain example.com

Exemplo de saída

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

O ID da saída do comando é usado em outros comandos.

Criando uma caixa de correio

Comando

mogwai emails boxes create

Opções

  • --domain=DOMAIN : Nome do domínio de e-mail.
  • -l, --login=LOGIN : O nome da caixa de correio, sem o domínio.
  • -p, --password=PASSWORD : A senha da caixa de correio.

Exemplo de comando

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

Este comando criará uma caixa de correio chamada user@example.com com a senha MySecretPassword123.

Excluindo uma caixa de correio

Comando

mogwai emails boxes delete

Opções

  • -b, --box=BOX : O ID da caixa de correio..

Exemplo de comando

mogwai emails boxes delete -b 1

Este comando excluirá a caixa de correio com o ID 1.

Importando caixas de correio e e-mails

Comando

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

Opções

  • -i, --import_config=IMPORT_CONFIG : Caminho para o arquivo de lista de importação
  • --force : Somente para o modo import - limpar caixas de correio existentes.

Para importar e-mail, você precisa preparar uma lista de caixas de correio no servidor no formato:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Opções

  • IMAP_HOST : Endereço do servidor de e-mail IMAP.
  • SOURCE_ADDR : Caixa de correio no servidor de origem.
  • SOURCE_PASSWORD : Senha para a conexão IMAP com a caixa de correio no servidor de origem. Alguns serviços, como o Google, exigem a criação de uma senha de aplicativo para acesso IMAP https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Caixa de correio no servidor FASTPANEL para a qual as mensagens são transferidas.

Exemplo de conteúdo do arquivo

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

Dois modos estão disponíveis:

Modo de importação

mogwai emails boxes import

Neste modo, todas as mensagens são copiadas integralmente, as caixas de correio no servidor FASTPANEL não devem estar criadas ou devem estar vazias - quando o comando é executado, o FASTPANEL cria as caixas de correio necessárias. Se já existirem caixas de correio com conteúdo, será exibido um erro. Você pode usar a flag --force - então a caixa de correio será limpa.

Exemplo de execução do comando com uma lista de caixas de correio armazenada no arquivo /root/import.txt e usando a chave --force

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

Modo de sincronização

mogwai emails boxes sync

Neste modo, o Painel de Controle baixa mensagens do servidor de origem sem excluir nada. Ele deve ser usado se novas mensagens tiverem aparecido na caixa de correio original após a primeira importação, e elas também precisarem ser transferidas.

Exemplo de comando

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

Descrição

Nesta página

O FASTPANEL fornece uma interface de linha de comando (CLI) implementada por meio do utilitário mogwai (/usr/local/bin/mogwai). O utilitário só funcionará quando executado como root.

Ajuda

Para ver uma lista de comandos disponíveis, use:

mogwai --help

Para saber mais sobre um comando específico, use:

mogwai command --help

Para ver uma lista de comandos com descrições, use:

mogwai --help-long

Sites

Nesta página

Listando sites em um servidor

Comando

mogwai sites list

Exemplo de saída

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: Os sites IDs desta lista são usados em outros comandos.

Criando um novo site

Comando

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

Opções

  • --owner : Usuário no sistema FASTPANEL que será o proprietário do site.
  • --server-name=SERVER-NAME : Nome de domínio do site.
  • -a, --alias=ALIAS : Aliases para o site, como subdomínios www. Vários aliases podem ser especificados.
  • --ip=IP : Endereço IP do servidor onde o site será executado. Vários endereços IP podem ser especificados.
  • -h, --handler=HANDLER : Handler de backend. Pode ser:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Versão do PHP ou Node.js (por exemplo, 8.2, 8.3, 20.15.1).
  • --create-user : Criar um usuário para o site.

Exemplo de comando

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

Excluindo um site

Comando

mogwai sites delete --id=ID

O site ID pode ser obtido com o comando mogwai sites list.

Exemplo de comando

mogwai sites delete --id=987

Este comando excluirá o site com ID 987

Modificando configurações do site

Comando

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

O site ID pode ser obtido com o comando mogwai sites list.

Opções

  • -i, --id=ID : ID do site.
  • -a, --add-alias=ADD-ALIAS : Adicionar um alias, vários aliases podem ser especificados.
  • --del-alias=DEL-ALIAS : Excluir um alias, vários aliases podem ser especificados.
  • --add-ip=ADD-IP : Adicionar um endereço IP das configurações do site, vários endereços IP podem ser especificados.
  • --del-ip=DEL-IP : Excluir um endereço IP das configurações do site, vários endereços IP podem ser especificados.
  • -h, --handler=HANDLER : Handler de backend. Pode ser:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : Versão do PHP ou Node.js (por exemplo, 8.2, 8.3, 20.15.1).
  • --gzip : Ativar compressão.
  • --no-gzip : Desativar compressão.
  • --gzip-comp-level=LEVEL : Definir o nível de compressão, 1-9.
  • --expires=EXPIRES : Definir o tempo de cache para conteúdo estático.
  • --worker-count=WORKER-COUNT : Definir o número de workers para PHP-FPM

Você também pode atualizar as configurações de vários sites em um servidor usando o comando

mogwai sites batch-update
  • Para alterar as configurações de todos os sites, use a flag -a.
  • Para alterar as configurações dos sites selecionados, especifique várias flags --id com seus IDs.

Exemplo de comando

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

Este comando adicionará um alias www1.example.com, alterará o handler para cgi e a versão do PHP para 5.6 para o site com ID 3

Exemplo de comando

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

Este comando alterará o handler do PHP para os sites com ID 2 e 3

Transferência de usuários entre FASTPANEL

Nesta página

Introdução

Este artigo descreve o processo de transferência de contas de usuário e seus dados associados (sites, bancos de dados, e-mail etc.) de um servidor FASTPANEL para outro usando o utilitário de migração integrado.

Termos-chave

  • Servidor de origem - O servidor do qual os dados estão sendo transferidos.
  • Servidor de destino - O servidor para o qual os dados estão sendo transferidos.

Observações importantes

  • Por padrão, a migração funciona corretamente apenas para sites com uma configuração padrão do FASTPANEL.

  • Sites com alterações de configuração manual só podem ser transferidos se a flag -m for usada para mapeamento de endereços IP.

  • Se uma senha criptografada para um proprietário de banco de dados não estiver disponível, o banco de dados não será transferido.

  • Se um site não for transferido, seus bancos de dados associados também não serão transferidos.

  • Apenas bancos de dados locais podem ser transferidos.

Processo de migração

Conexão

O servidor de destino se conecta ao servidor de origem via SSH. Durante a primeira conexão, o servidor de destino instala uma chave SSH no servidor de origem (pré-fornecida ou gerada a partir de uma senha).

Etapas da migração

  • Instalação de módulo
  • Coleta de informações sobre objetos transferíveis
  • Criação de usuários
  • Transferência de certificados SSL
  • Criação de sites, contas FTP, domínios de e-mail e contas de e-mail
  • Criação de bancos de dados e usuários de banco de dados
  • Transferência de arquivos de sites e caixas de correio
  • Transferência de tarefas cron

A transferência de arquivos é executada usando rsync. Os bancos de dados são transferidos criando um dump por meio de um túnel SSH.

Comando para iniciar a migração

O comando é executado no servidor de destino como um usuário com privilégios de root:

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

Flags de linha de comando

Conexão SSH

  • --remote_host="SOURCE_IP" - Endereço IP do servidor de origem.
  • --remote_port="SSH_PORT" - Porta SSH.
  • --remote_username="SSH_USER" - Usuário (deve ser root).
  • --remote_password="USER_PASSWORD" - Senha para o usuário SSH especificado.
  • --ssh_key_path="PATH_TO_KEY" - Caminho para a chave SSH privada no servidor de destino para conexão ao servidor de origem. Se uma chave for usada, a senha (--remote_password) não será necessária.

Endereços IP

Você deve usar apenas uma das seguintes flags para gerenciar os endereços IP dos sites durante a transferência. A flag -m tem prioridade.

  • -i "IP_ADDRESS_ON_DESTINATION" - Atribui o endereço IP especificado a todos os sites transferidos no servidor de destino. Para especificar vários IPs (por exemplo, se havia vários na origem), repita a flag para cada IP de origem que precisa ser transferido.

  • -m "SOURCE_IP,DESTINATION_IP" - Método recomendado. Estabelece um mapeamento direto: todos os sites que usam SOURCE_IP no servidor de origem usarão DESTINATION_IP no servidor de destino. Esta flag pode ser especificada várias vezes para diferentes pares de IP. Obrigatória para transferir sites com edições manuais de configuração, pois permite a substituição correta de endereços IP em diretivas listen.

Configurações adicionais

  • --users="USER_LIST" - Transfere apenas os usuários especificados (separados por vírgula). Se não for especificado, todos os usuários serão transferidos.
  • --disable_disk_quota - Desabilita a transferência de cotas de disco do usuário.
  • --with_user_data - Inclui a cópia de todo o conteúdo dos diretórios home dos usuários (exceto o subdiretório logs/). Use com cautela, pois isso pode aumentar significativamente o tempo de transferência e a quantidade de dados transferidos.
  • --only_data - Transfere apenas dados (arquivos de sites, arquivos de e-mail, dumps de banco de dados). Útil se a migração inicial da estrutura (usuários, sites, BDs etc.) foi bem-sucedida, mas ocorreram erros durante a etapa de cópia dos arquivos ou do dump. Permite executar novamente apenas a parte de cópia de dados.
  • --transfer_timeout - Define o tempo limite da operação (o padrão é 60 minutos).

Exemplo de comando

Transfira todos os usuários do servidor 11.22.33.44 para o servidor atual. No servidor antigo, os sites usavam os IPs 11.22.33.44 e 11.22.33.55; no novo servidor, eles devem usar 99.88.77.66 e 99.88.77.67, respectivamente. Conexão via SSH com senha.

/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

Possíveis problemas e tipos de erro

Um erro no log de migração nem sempre indica um problema crítico, mas pode apontar o motivo pelo qual um objeto específico não foi transferido.

  • Conflitos: Ocorrem quando a transferência de um objeto é impossível devido à configuração atual do servidor de destino (por exemplo, um usuário ou site com o mesmo nome já existe) ou se a configuração do site no servidor de origem é desconhecida para o painel (por exemplo, devido a extensas edições manuais).

  • Senha salva ausente: Como mencionado anteriormente, usuários de banco de dados MySQL sem uma senha salva no FASTPANEL no servidor de origem não podem ser transferidos.

  • Configurações manuais e endereços IP: Se um site no servidor de origem tiver edições manuais de configuração do servidor web e a flag -m não for usada durante a migração para mapear seu endereço IP, esse site não será transferido porque o painel não sabe qual IP especificar na configuração no servidor de destino.

Usuários

Nesta página

Criando um novo usuário

Comando

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

Opções

  • -u, --username=USERNAME : Especifique o nome de usuário para o novo usuário.
  • -p, --password=PASSWORD : Especifique a senha para o novo usuário.
  • -r, --role="USER" : Especifique a função para o novo usuário. As funções suportadas são RESELLER e USER. A função padrão é USER.

Informações de uso

Para criar um novo usuário com o nome de usuário testuser, a senha My$ecretPassword123 e a função RESELLER, use o seguinte comando:

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

Notas adicionais

  • Os nomes de usuário devem ser únicos e não podem conter espaços ou pontos.
  • As senhas devem ter pelo menos 8 caracteres. Recomendamos usar pelo menos uma letra maiúscula, uma letra minúscula, um número e um caractere especial.