Recursos do Extended
- Estatísticas de e-mail
- Estatísticas de uso de 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á habilitado por padrão para todos os usuários. 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 devolvidas, 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 "Habilitar coleta de estatísticas".
Se preferir não coletar dados automaticamente, desative essa opção. Nesse caso, 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 1 hora até 24 horas.
-
Para salvar suas configurações, não se esqueça de clicar no botão "Salvar".
Visualização de estatísticas
Para visualizar 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 devolvidas durante o período selecionado. O gráfico ajuda você a identificar tendências e problemas de entrega rapidamente.
Você pode personalizar os dados exibidos de várias formas:
-
Selecionando um domínio de e-mail.
-
Selecionando estatísticas para o domínio inteiro ou para uma caixa de correio específica.
-
Escolhendo o intervalo de tempo do relatório — das últimas 24 horas até o último mês.
-
Clicando no botão "Atualizar" para atualizar manualmente as estatísticas e recuperar os dados mais recentes.
Principais motivos de devolução
Lista as causas mais frequentes de falhas na entrega de mensagens, juntamente com seus códigos de erro SMTP correspondentes. 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
-
ID da fila — o identificador exclusivo da mensagem na fila de e-mail
-
De / Domínio de origem / Para — endereços do remetente e do destinatário, bem como o domínio de origem
-
Código SMTP — o código de resposta retornado pelo servidor de e-mail do destinatário (por exemplo, 550-5.7.26)
-
Recomendação — 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”)
-
Detalhe — 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)
-
Código desconhecido — indica se a resposta SMTP não pôde ser classificada
-
Bytes — tamanho da mensagem de e-mail
-
Contagem de tentativas — número de tentativas de entrega feitas antes de a mensagem ser rejeitada permanentemente
-
Última tentativa — data e hora da tentativa final de entrega
-
Pontuação de spam — 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 de disco
O FASTPANEL Extended está habilitado por padrão para todos os usuários. Não é necessário ativar uma licença.
O FASTPANEL® inclui um recurso de Estatísticas de Uso de 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 próxima tela, você verá estatísticas detalhadas de uso de disco, incluindo Diretórios, Principais arquivos grandes e Estatísticas de extensões.
- 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 home de diferentes usuários; as estatísticas serão atualizadas adequadamente.
Node.js
Nesta página
O FASTPANEL Extended está habilitado por padrão para todos os usuários. 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 "Settings" -> "Applications"
- Clique no botão "Install" para a 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 depois abrindo a seção "Services".
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, em seguida, para a seção Services
- Reinicie o serviço
- Verifique o site
Docusaurus
Usando o aplicativo web Docusaurus como exemplo, vamos definir as configuraçõ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 que selecione 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 "site settings" -> "Backend"
-
Selecione o manipulador Standalone ou PM2.
-
Escolha a versão desejada do Node.js.
-
Especifique a pasta de trabalho
docs -
No campo Launch command, 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 o 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 "site settings" -> "Backend"
- Selecione o manipulador Standalone ou PM2.
- Escolha a versão desejada do Node.js.
- No campo Launch command, 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 do Node.js, logs e carga do sistema.
Esse modo também permite especificar o número de workers — ou seja, o número de processos Node.js que tratam as solicitações recebidas pelo servidor.
Além disso, esse modo oferece a opção Enable file watch — o PM2 reinicia automaticamente o 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 Services:
Logs
Um aplicativo Node.js pode gerar logs. No FASTPANEL®, eles ficam localizados no painel do site, na seção Logs, na guia "Backend log"
Comandos de 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á habilitado por padrão para todos os usuários. Não é necessário ativar uma licença.
Notificações do servidor
O FASTPANEL Extended está habilitado por padrão para todos os usuários. Não é necessário ativar uma licença.
O FASTPANEL® permite monitorar as principais métricas do servidor: carga da CPU, Load Average 5, uso de disco e consumo de RAM. Quando uma métrica excede seu limite, alertas são enviados automaticamente para o Telegram ou Slack. A configuração está localizada em "Configurações" → "Notificações".
Este artigo explica como configurar canais de entrega e ajustar os 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
bote, em seguida, 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 em segurança, pois qualquer pessoa com ele pode controlar seu bot
O token da API é armazenado no @BotFather. Se você esquecê-lo, 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:
- Nome — Digite um nome para o canal para distingui-lo visualmente
- Canal — Escolha "Telegram"
- Token do bot — Cole o token do bot copiado na etapa 6
- Período do problema — 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
- Intervalo de repetição da notificação — Defina o intervalo entre notificações consecutivas para o mesmo problema
- Notificar sobre problemas resolvidos — Ative esta opção para receber uma notificação quando o problema for resolvido
- Adicionar gatilhos básicos — Ative esta opção para criar automaticamente gatilhos para todas as unidades, RAM e CPU
- Clique no botão "Salvar".
- Na próxima tela, clique no botão "Convidar" 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 posteriormente, clique no ícone de lápis ao lado do canal
- Abaixo está um exemplo de notificação gerada quando um gatilho é ativado
Slack
- Faça login na sua conta e crie um aplicativo do Slack pela página de apps.
- 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. É recomendável 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:
- Nome — Digite um nome para o canal para distingui-lo visualmente
- Canal — Escolha "Slack"
- URL do webhook — Cole a URL do webhook copiada na etapa 7
- Período do problema — 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
- Intervalo de repetição da notificação — Defina o intervalo entre notificações consecutivas para o mesmo problema
- Notificar sobre problemas resolvidos — Ative esta opção para receber uma notificação quando o problema for resolvido
- Adicionar gatilhos básicos — Ative esta opção para criar automaticamente gatilhos para todas as unidades, RAM e CPU
- Clique no botão "Salvar".
- 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 posteriormente, clique no ícone de lápis ao lado do canal
- Abaixo está um exemplo de 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, Disco (para cada disco individualmente), Load Average 5 (carga média do sistema nos últimos 5 minutos), RAM.
- Editar gatilhos existentes
Os limites para CPU, Disco 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 enviar um logotipo personalizado para diferentes áreas do painel.
Tela de login
Logotipos separados podem ser enviados para os temas Claro e Escuro.
Use o botão Upload para adicionar um novo logotipo ou Reset para reverter para o 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 enviar 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 para o padrão.
- Formato suportado: ico
- Tamanho máximo do arquivo: 1 MB
Personalização dos 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á habilitado por padrão para todos os usuários. 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 mostrará as etapas necessárias para adicionar sua instância do FASTPANEL® ao Prometheus, permitindo que você colete e monitore 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 às 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 seu 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 do seu servidor - metrics_path — o endpoint da API de onde as métricas serão obtidas
- bearer_token — substitua isto 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 que você monitore o desempenho do sistema em tempo real.
FASTPANEL