FASTPANELWIKI

Funcionalidades do Extended

Estatísticas de e-mail

Nesta página
informação

O FASTPANEL Extended está ativo por predefinição para todos os utilizadores. Não é necessário ativar uma licença.

O FASTPANEL® inclui um recurso de Estatísticas de e-mail que permite monitorar facilmente a atividade de e-mails de saída de um domínio inteiro ou de caixas de correio individuais. Você pode ver rapidamente quantas mensagens foram enviadas, entregues ou rejeitadas, além de visualizar códigos de erro SMTP detalhados com recomendações que explicam por que determinados e-mails foram rejeitados.

Configurar a coleta automática de estatísticas

  1. Para ativar a coleta automática de estatísticas de e-mail, navegue até "Configurações" → "E-mail" → "Estatísticas" e ative a opção "Ativar coleta de estatísticas".

Se preferir não coletar dados automaticamente, desative esta opção. Em seguida, você precisará clicar manualmente no botão "Atualizar" na visualização de estatísticas (consulte a próxima seção) para atualizar os dados.

  1. Você pode definir com que frequência as estatísticas são atualizadas automaticamente — de cada 1 hora até cada 24 horas.

  2. Para salvar suas configurações, não se esqueça de clicar no botão "Salvar".

Visualização de estatísticas

Para ver as estatísticas, navegue até "Gerenciamento" → "E-mail" e clique no ícone de gráfico ao lado do domínio que deseja analisar.

A visualização de estatísticas é dividida em três seções principais, descritas em detalhes abaixo.

Gráfico de estatísticas

Exibe o número total de mensagens enviadas, entregues e rejeitadas no período selecionado. O gráfico ajuda você a identificar tendências e problemas de entrega rapidamente.

Você pode personalizar os dados exibidos ao:

  1. Selecionar um domínio de e-mail.

  2. Selecionar estatísticas para o domínio inteiro ou para uma caixa de correio específica.

  3. Escolher o intervalo de tempo do relatório — das últimas 24 horas até o último mês.

  4. Clicar no botão "Atualizar" para atualizar manualmente as estatísticas e obter os dados mais recentes.

Principais motivos de rejeição

Lista as causas mais frequentes de falhas na entrega de mensagens, juntamente com seus respectivos códigos de erro SMTP. Isso permite que você compreenda e resolva problemas recorrentes.

Eventos de erro de saída

Fornece informações detalhadas sobre cada mensagem rejeitada ou não entregue, com ações recomendadas para resolver os problemas.

Para cada registro, os seguintes detalhes são exibidos:

  • Data/Hora — o horário exato em que ocorreu a tentativa de entrega

  • Queue ID — o identificador exclusivo da mensagem na fila de e-mail

  • From / From domain / To — endereços do remetente e do destinatário, bem como o domínio de origem

  • SMTP code — o código de resposta retornado pelo servidor de e-mail do destinatário (por exemplo, 550-5.7.26)

  • Advice — uma breve explicação do problema e uma ação recomendada (por exemplo, “Mensagem rejeitada pelo Gmail: autenticação SPF/DKIM ausente ou com falha”)

  • Detail — o texto completo da resposta SMTP, que pode incluir um link para documentação externa do servidor do destinatário (por exemplo, páginas de suporte do Gmail)

  • Unknown code — indica se a resposta SMTP não pôde ser classificada

  • Bytes — tamanho da mensagem de e-mail

  • Retry count — número de tentativas de entrega feitas antes de a mensagem ser rejeitada permanentemente

  • Last try — registro de data e hora da tentativa final de entrega

  • Spam score — resultado da avaliação de spam, se aplicável

Esses dados fornecem uma visão abrangente dos problemas de entrega de saída, ajudando você a diagnosticar problemas de autenticação, reputação ou configuração.

Estatísticas de uso do disco

informação

O FASTPANEL Extended está ativo por predefinição para todos os utilizadores. Não é necessário ativar uma licença.

O FASTPANEL® inclui um recurso de Estatísticas de Uso do Disco que permite ver rapidamente quais arquivos e diretórios consomem espaço nos diretórios de usuário dos seus sites.

Para usar este recurso, abra "Management" → "File Manager" e clique no ícone redondo no canto superior direito

Na tela seguinte, você verá estatísticas detalhadas de uso do disco, incluindo Directories, Top large files e Extension statistics.

  1. Clique no ícone de pasta no canto superior direito para retornar ao gerenciador de arquivos.
  2. Clique no ícone de atualização (setas circulares) no canto superior direito para recarregar os dados.
  3. Clique no nome de usuário no canto superior esquerdo para alternar entre os diretórios pessoais de diferentes usuários; as estatísticas serão atualizadas de acordo.

Node.js

Nesta página
informação

O FASTPANEL Extended está ativo por predefinição para todos os utilizadores. Não é necessário ativar uma licença.

Introdução

Node.js é uma plataforma de servidor que executa aplicativos escritos em JavaScript.

Primeiro, você precisa instalar o Node.js:

  • Vá para "Configurações" -> "Aplicativos"
  • Clique no botão "Instalar" da versão necessária do Node.js

Crie um site:

  • Selecione um modelo para um site Node.js
  • Especifique o domínio e os parâmetros relacionados. Na etapa de configuração, você pode alterar o BD, o usuário FTP e o Backend
  • Envie os arquivos do aplicativo para o diretório do site
  • Para instalar as dependências, execute npm20.15.1 install no Terminal (é necessário instalar o aplicativo ttyd para FASTPANEL®)
  • Reinicie o Node.js acessando o painel do site e, em seguida, abrindo a seção "Serviços".

Framework Express

Usando o framework Express como exemplo, vamos criar um servidor web simples:

  • Conecte-se ao servidor via SSH como o usuário proprietário do site (você pode usar o aplicativo ttyd para FASTPANEL®)
  • Crie um arquivo app.js no diretório do site e preencha-o com o seguinte código:
const express = require('express');
const app = express();
const PORT = process.env.SERVICE_PORT;

app.get('/', (req, res) => {
  res.send('Hello! This is my first server on Node.js + Express 🚀');
});

app.listen(PORT, () => {
  console.log(`Server is running at http://localhost:${PORT}`);
});
  • No diretório do site, execute o comando para instalar o express
npm20.15.1 install express
  • Vá para o painel do site e depois para a seção Serviços
  • Reinicie o serviço
  • Verifique o site

Docusaurus

Usando o aplicativo web Docusaurus como exemplo, vamos configurar as definições:

  • Conecte-se ao servidor via SSH como o usuário proprietário do site (você pode usar o aplicativo ttyd para FASTPANEL®)
  • No diretório do site, execute a instalação do Docusaurus
npx20.15.1 create-docusaurus -j ./docs
  • Quando for solicitado a selecionar um modelo, responda classic (recommended)

  • Após a instalação, substitua uma linha no arquivo docs/package.json

"start": "docusaurus start",
# replace with 
"start": "docusaurus start --port $SERVICE_PORT",

$SERVICE_PORT é uma variável do sistema definida no FASTPANEL®

  • No painel de controle, vá para "configurações do site" -> "Backend"

  • Selecione o manipulador Standalone ou PM2.

  • Escolha a versão desejada do Node.js.

  • Especifique a pasta de trabalho docs

  • No campo Comando de inicialização, insira: npm run start

  • Salve. Aguarde a compilação do aplicativo (as informações aparecerão nos logs). Verifique o site

Next.js

Usando o Next.js com Node.js 20.19 como exemplo, vamos criar um servidor web simples:

  • Conecte-se ao servidor via SSH como o usuário proprietário do site (você também pode usar o aplicativo ttyd no FASTPANEL®).
  • No diretório do site, execute o comando de inicialização do projeto:
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom
  • Adicione um bloco scripts ao arquivo package.json:
"scripts": {
  "dev": "next dev -p $SERVICE_PORT",
  "build": "next build",
  "start": "next start -p $SERVICE_PORT"
}
  • Crie um diretório pages e, dentro dele, adicione um arquivo chamado index.js:
mkdir pages
cat <<EOF > pages/index.js
export async function getServerSideProps() {
  return {
    props: {
      nodeVersion: process.version,
      port: process.env.SERVICE_PORT || 3000,
    },
  };
}

export default function Home({ nodeVersion, port }) {
  return (
    <div style={{
      fontFamily: 'sans-serif',
      textAlign: 'center',
      marginTop: '20vh'
    }}>
      <h1>✅ It works!</h1>
      <p>Next.js app running on Node.js {nodeVersion}</p>
      <p>Port: {port}</p>
    </div>
  );
}
EOF
  • Execute a compilação do projeto.
yarn20.19.4 build
  • No painel de controle, vá para "configurações do site" -> "Backend"
  • Selecione o manipulador Standalone ou PM2.
  • Escolha a versão desejada do Node.js.
  • No campo Comando de inicialização, insira: yarn run start.
  • Salve. Aguarde a compilação do aplicativo (as informações aparecerão nos logs). Verifique o site

Informações adicionais

No modo Standalone, um processo Node.js é iniciado para executar seus scripts.

No modo PM2, o gerenciador de processos PM2 é usado para gerenciar processos Node.js, logs e carga do sistema.
Esse modo também permite especificar o número de workers — isto é, o número de processos Node.js que tratam as solicitações recebidas pelo servidor.
Além disso, esse modo fornece a opção Enable file watch — o PM2 reinicia automaticamente seu aplicativo quando um arquivo é modificado no diretório atual ou em seus subdiretórios. Observe que esse modo introduz carga adicional no sistema e não é recomendado para ambientes de produção.

Da mesma forma, você pode configurar o aplicativo se ele exigir YARN em vez de NPM

Você pode instalar as dependências do seu projeto listadas em package.json usando YARN ou NPM diretamente do FASTPANEL®. Para fazer isso, abra o cartão do site e vá para a seção Serviços:

Logs

Um aplicativo Node.js pode gerar logs. No FASTPANEL®, eles estão localizados no painel do site, na seção Logs, na aba "Log do Backend"

Comandos do console

Após instalar o Node.js no FASTPANEL®, os usuários podem trabalhar com seus projetos usando comandos de console como:

  • pm2
  • yarn20.15.1
  • npx20.15.1
  • npm20.15.1
  • node20.15.1

Exemplo:

$ npm20.15.1 list
node-socket-port-server@1.0.0 /var/www/node_user/data/www/node.site
└── express@4.21.2
$ pm2 ls
┌────┬─────────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐
│ id │ name        │ namespace   │ version │ mode    │ pid      │ uptime │ ↺    │ status    │ cpu      │ mem      │ user     │ watching │
├────┼─────────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤
│ 0  │ amazing_site│ default     │ 1.0.0   │ cluster │ 9355     │ 2m     │ 0    │ online    │ 0%       │ 62.4mb   │ user     │ disabled │
│ 1  │ amazing_site│ default     │ 1.0.0   │ cluster │ 9362     │ 2m     │ 0    │ online    │ 0%       │ 62.5mb   │ user     │ disabled │
└────┴─────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘

Cada nome de comando inclui o número da versão do Node.js que foi instalada. Neste exemplo, a versão disponível é o Node.js 20.15.1.

FASTPANEL Extended

Notificações do servidor

Nesta página
informação

O FASTPANEL Extended está ativo por predefinição para todos os utilizadores. Não é necessário ativar uma licença.

O FASTPANEL® permite monitorar métricas principais do servidor: carga de CPU, Load Average 5, uso de disco e consumo de RAM. Quando uma métrica excede seu limite, alertas são enviados automaticamente para Telegram ou Slack. A configuração está localizada em "Configurações" → "Notificações".

Este artigo explica como configurar canais de entrega e configurar parâmetros de notificação, incluindo limites e gatilhos.

Configuração do canal

Telegram

  1. Crie um novo bot usando o bot oficial do Telegram @BotFather. Siga o link e clique no botão "Start"
  1. Digite /newbot e pressione Enter.
  2. Digite o nome desejado para o seu bot e pressione Enter.
  3. Digite o nome de usuário desejado para o seu bot. Ele deve terminar com bot, depois pressione Enter.
  4. Você receberá uma mensagem começando com:
    Done! Congratulations on your new bot.
  5. Clique na linha azul após Use this token to access the HTTP API: (desfocada na captura de tela) para copiar o token da API do seu bot para a área de transferência. Mantenha o token seguro, pois qualquer pessoa com ele pode controlar seu bot
nota

O token da API é armazenado em @BotFather. Se você o esquecer, envie o comando /mybots, selecione seu bot e clique no botão "API Token".

  1. Abra o FASTPANEL® e navegue até "Configurações" → "Notificações".
  2. Clique no botão "Criar canal"
  1. Preencha os seguintes campos:
  • Name — Digite um nome para o canal para distingui-lo visualmente
  • Channel — Escolha "Telegram"
  • Bot token — Cole o token do bot copiado na etapa 6
  • Problem period — Defina o intervalo de tempo (em minutos) após o qual uma notificação será enviada se o problema persistir. O valor mínimo é 1 minuto
  • Notification repeat interval — Defina o intervalo entre notificações consecutivas para o mesmo problema
  • Notify about solved problems — Ative esta opção para receber uma notificação quando o problema for resolvido
  • Add basic triggers — Ative esta opção para criar automaticamente gatilhos para todas as unidades, RAM e CPU
  1. Clique no botão "Save".
  2. Na próxima tela, clique no botão "Invite" para convidar seu bot para o chat ou chat em grupo
  1. Um link será aberto em uma nova aba. Confirme o redirecionamento para o aplicativo Telegram Desktop
  1. Clique no botão "Start" para ativar seu bot
  1. Para verificar se a configuração está correta, volte para a aba do FASTPANEL® e clique no botão de avião de papel
  1. Se tudo estiver configurado corretamente, uma notificação de teste será enviada para o chat com seu bot
  1. Para ajustar as configurações do canal depois, clique no ícone de lápis ao lado do canal
  1. Abaixo está um exemplo de uma notificação gerada quando um gatilho é ativado

Slack

  1. Faça login na sua conta e crie um aplicativo Slack pela página de aplicativos.
  2. Selecione "Do zero".
  3. Digite um App Name, escolha o workspace onde o aplicativo será criado e clique em “Create app”.
  4. Na seção “Features”, abra “Incoming Webhooks” e ative o recurso
  1. Na parte inferior da mesma página, clique em “Add New Webhook”
  1. Na próxima tela, selecione o canal para o qual as notificações serão enviadas. Recomenda-se criar um canal dedicado para alertas. Em seguida, clique em “Allow”.
  2. Você será redirecionado de volta para a página de webhooks. Role para baixo e clique em “Copy” para copiar a URL do webhook
  1. Abra o FASTPANEL® e navegue até "Configurações" → "Notificações".
  2. Clique no botão "Criar canal"
  1. Preencha os seguintes campos:
  • Name — Digite um nome para o canal para distingui-lo visualmente
  • Channel — Escolha "Slack"
  • Webhook url — Cole a URL do webhook copiada na etapa 7
  • Problem period — Defina o intervalo de tempo (em minutos) após o qual uma notificação será enviada se o problema persistir. O valor mínimo é 1 minuto
  • Notification repeat interval — Defina o intervalo entre notificações consecutivas para o mesmo problema
  • Notify about solved problems — Ative esta opção para receber uma notificação quando o problema for resolvido
  • Add basic triggers — Ative esta opção para criar automaticamente gatilhos para todas as unidades, RAM e CPU
  1. Clique no botão "Save".
  2. Para verificar se a configuração está correta, clique no botão de avião de papel
  1. Se tudo estiver configurado corretamente, uma notificação de teste será enviada para o canal selecionado na etapa 6
  1. Para ajustar as configurações do canal depois, clique no ícone de lápis ao lado do canal
  1. Abaixo está um exemplo de uma notificação gerada quando um gatilho é ativado

Configuração de gatilhos

Para configurar os gatilhos, clique no ícone de engrenagem na linha do canal que você deseja editar

Na seção aberta, você pode:

  1. Desativar gatilhos desnecessários usando o alternador à esquerda.
  2. Criar um novo gatilho de um dos seguintes tipos: CPU, Disk (para cada disco individualmente), Load Average 5 (carga média do sistema nos últimos 5 minutos), RAM.
  3. Editar gatilhos existentes

Os limites para CPU, Disk e RAM são definidos em porcentagens. O limite para Load Average 5 é definido em valores inteiros.

nota

Como regra geral, um valor normal de Load Average 5 é aproximadamente igual ao número de núcleos de CPU no servidor, ou até o dobro desse número.

Personalização da identidade visual

Nesta página

A seção Personalização visual no FASTPANEL® permite personalizar a aparência visual e o estilo do painel de controle. Este menu está localizado em "Configurações" → "Principal" → "Personalização visual".

Esquemas de cores

Navegue até a aba "Esquemas de cores" para alterar o tema de cor principal do painel. Escolha entre uma variedade de paletas de cores predefinidas (por exemplo, azul, laranja, vermelho, verde).

Ajuste o Tema:

  • Claro: Use um tema claro
  • Escuro: Alterne para o modo escuro
  • Como no dispositivo: Adapta-se automaticamente às configurações do dispositivo do usuário

Personalização do logotipo

A aba "Logotipo" permite carregar um logotipo personalizado para diferentes áreas do painel.

Tela de login
Logotipos separados podem ser carregados para os temas Claro e Escuro.
Use o botão Upload para adicionar um novo logotipo ou Reset para reverter ao padrão.

  • Formatos suportados: jpeg, png, svg, webp
  • Resolução máxima: 256x100 pixels
  • Tamanho máximo do arquivo: 5 MB

Logotipo do cabeçalho
Exibido no cabeçalho do painel de controle.

  • Formatos suportados: jpeg, png, svg, webp
  • Resolução máxima: 200x22 pixels
  • Tamanho máximo do arquivo: 5 MB

Personalização do favicon

A aba "Favicon" permite carregar um favicon, exibido nas abas do navegador e nos resultados de pesquisa.
Use o botão Upload para adicionar um favicon ou Reset para reverter ao padrão.

  • Formato suportado: ico
  • Tamanho máximo do arquivo: 1 MB

A aba "Links" fornece campos para personalizar links no menu lateral.

  • Base de conhecimento: URL para acessar a base de conhecimento

Após modificar os links, clique em Save para aplicar as alterações.

Prometheus

Nesta página
informação

O FASTPANEL Extended está ativo por predefinição para todos os utilizadores. Não é necessário ativar uma licença.

Integração do FASTPANEL com o Prometheus para coleta de métricas

O FASTPANEL® agora oferece suporte à integração com o Prometheus para coletar métricas do sistema. Este guia orientará você pelas etapas necessárias para adicionar sua instância do FASTPANEL® ao Prometheus, permitindo coletar e monitorar métricas do sistema em tempo real.

Criar um token

Para permitir que o Prometheus colete métricas, você precisa criar um token especial com acesso limitado:

  1. Conecte-se ao seu servidor FASTPANEL® via SSH.

  2. Execute o seguinte comando para criar um token:

mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only
  • metrics_test_token é um nome personalizado para o token; você pode escolher qualquer nome
  • O token receberá os seguintes escopos:
    • read_only — acesso somente leitura
    • metrics_only — acesso restrito a métricas

Adicionar um job ao Prometheus

Depois que o token for criado, você precisará configurar o Prometheus para começar a coletar métricas da sua instância do FASTPANEL®.

Abra o arquivo de configuração do Prometheus e adicione um novo job:

- job_name: "fastpanel2"
  scheme: https
  static_configs:
    - targets: ["$IP:8888"]
  metrics_path: /api/metrics
  tls_config:
    insecure_skip_verify: true
  bearer_token: I_AM_TOKEN
  scrape_interval: 60s
  • job_name — um nome personalizado para o job
  • targets — o endereço IP e a porta do seu servidor FASTPANEL®. Substitua $IP pelo endereço IP dos seus servidores
  • metrics_path — o endpoint da API de onde buscar as métricas
  • bearer_token — substitua isso pelo token gerado (metrics_test_token)
  • scrape_interval — com que frequência o Prometheus deve coletar as métricas (definido como 60 segundos neste caso)

Configurar o painel de monitoramento

Depois de adicionar com sucesso sua instância do FASTPANEL® ao Prometheus, você poderá configurar seu primeiro painel para visualizar as métricas coletadas.

Para importar o painel, siga este guia.

Agora o Prometheus começará a coletar métricas da sua instância do FASTPANEL®, permitindo monitorar o desempenho do sistema em tempo real.