Funcionalidades do Extended
- Estatísticas de e-mail
- Estatísticas de uso do disco
- Instalar aplicativo Node.js
- FASTPANEL Extended
- Notificações do servidor
- Personalização visual
- Prometheus
Estatísticas de e-mail
Nesta página
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
- 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.
-
Você pode definir com que frequência as estatísticas são atualizadas automaticamente — de cada 1 hora até cada 24 horas.
-
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:
-
Selecionar um domínio de e-mail.
-
Selecionar estatísticas para o domínio inteiro ou para uma caixa de correio específica.
-
Escolher o intervalo de tempo do relatório — das últimas 24 horas até o último mês.
-
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
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.
- Clique no ícone de pasta no canto superior direito para retornar ao gerenciador de arquivos.
- Clique no ícone de atualização (setas circulares) no canto superior direito para recarregar os dados.
- 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
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 installno 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.jsno 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
pagese, dentro dele, adicione um arquivo chamadoindex.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
O FASTPANEL Extended está ativo por predefinição para todos os utilizadores. Não é necessário ativar uma licença.
Notificações do servidor
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
- Crie um novo bot usando o bot oficial do Telegram @BotFather. Siga o link e clique no botão "Start"
- Digite
/newbote pressione Enter. - Digite o nome desejado para o seu bot e pressione Enter.
- Digite o nome de usuário desejado para o seu bot. Ele deve terminar com
bot, depois pressione Enter. - Você receberá uma mensagem começando com:
Done! Congratulations on your new bot. - 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
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".
- Abra o FASTPANEL® e navegue até "Configurações" → "Notificações".
- Clique no botão "Criar canal"
- 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
- Clique no botão "Save".
- Na próxima tela, clique no botão "Invite" para convidar seu bot para o chat ou chat em grupo
- Um link será aberto em uma nova aba. Confirme o redirecionamento para o aplicativo Telegram Desktop
- Clique no botão "Start" para ativar seu bot
- Para verificar se a configuração está correta, volte para a aba do FASTPANEL® e clique no botão de avião de papel
- Se tudo estiver configurado corretamente, uma notificação de teste será enviada para o chat com seu bot
- Para ajustar as configurações do canal depois, clique no ícone de lápis ao lado do canal
- Abaixo está um exemplo de uma notificação gerada quando um gatilho é ativado
Slack
- Faça login na sua conta e crie um aplicativo Slack pela página de aplicativos.
- Selecione "Do zero".
- Digite um App Name, escolha o workspace onde o aplicativo será criado e clique em “Create app”.
- Na seção “Features”, abra “Incoming Webhooks” e ative o recurso
- Na parte inferior da mesma página, clique em “Add New Webhook”
- 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”.
- Você será redirecionado de volta para a página de webhooks. Role para baixo e clique em “Copy” para copiar a URL do webhook
- Abra o FASTPANEL® e navegue até "Configurações" → "Notificações".
- Clique no botão "Criar canal"
- 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
- Clique no botão "Save".
- Para verificar se a configuração está correta, clique no botão de avião de papel
- Se tudo estiver configurado corretamente, uma notificação de teste será enviada para o canal selecionado na etapa 6
- Para ajustar as configurações do canal depois, clique no ícone de lápis ao lado do canal
- 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:
- Desativar gatilhos desnecessários usando o alternador à esquerda.
- 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.
- 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.
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
Personalização de links
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
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:
-
Conecte-se ao seu servidor FASTPANEL® via SSH.
-
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
$IPpelo 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.
FASTPANEL