CLI
Bancos de dados
Nesta página
Obtendo uma lista de servidores de banco de dados
Comando
mogwai databases servers listExemplo de saída
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueO servidor IDs é usado em outros comandos.
Obtendo uma lista de bancos de dados
Comando
mogwai databases listExemplo 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 UTCSincronizando 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 syncCriando 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 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 dbpassword1Este 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.
Nesta página
Obtendo uma lista de domínios de e-mail
Comando
mogwai emails domains listExemplo 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:00O domínio IDs é usado em outros comandos.
Adicionando um domínio de e-mail
Comando
mogwai emails domains createOpçõ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 no usuário fastuser
mogwai emails domains create --domain=example1.com -o fastuserObtendo uma lista de caixas de correio
Comando
mogwai emails boxes listOpções
--domain=DOMAIN: Nome do domínio de e-mail
Exemplo de comando
mogwai emails boxes list --domain example.comExemplo 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:00O ID da saída do comando é usado em outros comandos.
Criando uma caixa de correio
Comando
mogwai emails boxes createOpçõ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=MySecretPassword123Este comando criará uma caixa de correio chamada user@example.com com a senha MySecretPassword123.
Excluindo uma caixa de correio
Comando
mogwai emails boxes deleteOpções
-b,--box=BOX: O ID da caixa de correio..
Exemplo de comando
mogwai emails boxes delete -b 1Este 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 da lista de importação--force: Somente para o modoimport- limpar as caixas de correio existentes.
Para importar e-mails, você precisa preparar uma lista de caixas de correio no servidor no formato:
IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDROpçõ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=enDEST_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.comDois modos estão disponíveis:
Modo de importação
mogwai emails boxes importNeste 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, um erro será exibido. 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 --forceModo de sincronização
mogwai emails boxes syncNeste 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.txtDescriçã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 --helpPara saber mais sobre um comando específico, use:
mogwai command --helpPara ver uma lista de comandos com descrições, use:
mogwai --help-longSites
Nesta página
Listando sites em um servidor
Comando
mogwai sites listExemplo 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.comNota: O site IDs desta lista é usado 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 do 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.
- PHP:
--handler_version=HANDLER_VERSION: Versão do PHP ou Node.js (por exemplo8.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.3Excluindo um site
Comando
mogwai sites delete --id=IDO site ID pode ser obtido com o comando mogwai sites list.
Exemplo de comando
mogwai sites delete --id=987Este comando excluirá o site com ID 987
Modificando as 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.
- PHP:
--handler_version=HANDLER_VERSION: Versão do PHP ou Node.js (por exemplo8.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
--idcom seusIDs.
Exemplo de comando
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Este 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 2Este comando alterará o handler do PHP para os sites com ID 2 e 3
Transferindo usuários entre servidores 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
-mfor usada para o 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.
-
Somente 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 do 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 eletrônico
- Transferência de tarefas cron
A transferência de arquivos é executada usando rsync. Os bancos de dados são transferidos por meio da criação de um dump através 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 do usuário SSH especificado.--ssh_key_path="PATH_TO_KEY" - Caminho para a chave SSH privada no servidor de destino para se conectar 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 houver vários no servidor de origem), repita a flag para cada IP de origem que precise 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 nas 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- Desativa 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óriologs/). 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 da estrutura inicial (usuários, sites, bancos de dados etc.) foi bem-sucedida, mas ocorreram erros durante a etapa de cópia dos arquivos ou dumps. 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.67Possí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 na configuração do servidor web e a flag
-mnã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"Observações adicionais
- Os nomes de usuário devem ser exclusivos 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.
FASTPANEL