Guia: Como instalar o plugin no DirectAdmin
Objetivo
Instalar o plugin de rastreamento de entrega em um servidor DirectAdmin, do download até a primeira tela funcionando.
Escopo e Público
- Aplica-se a: servidores DirectAdmin (testado contra o 1.701).
- Não cobre: cPanel/WHM (guia próprio), nem a configuração da credencial do relay (guia próprio).
- Público-alvo: administrador com acesso root por SSH.
Pré-requisitos
| Item | Exigência |
|---|---|
| DirectAdmin | testado contra o 1.701 |
| PHP | 8.1+ em /usr/local/bin/php |
| Extensões PHP | pdo_sqlite, curl, json, zlib e posix |
| Log de e-mail | /var/log/exim/mainlog legível |
| Acesso | root, por SSH |
Você não precisa da credencial de API do relay para instalar.
Passos (sequência)
Passo 1 — Baixar o plugin
O plugin é distribuído pelo painel do Sender25. Entre na sua conta, abra Plugin no menu lateral do servidor e você verá a versão publicada, as notas dela e um comando pronto, já com o número da versão, o digest e um código de autorização.
Esse código vale 15 minutos e libera aquele arquivo, não o diretório. Se expirar, volte à página e gere outro — não é erro de permissão.
O comando tem esta forma (a versão e o digest você copia da página):
curl -fsS 'https://app.sender25.com/plugin/dl/plugin-panel-VERSAO.tar.gz?t=CODIGO' \
-o /tmp/plugin-panel-VERSAO.tar.gz \
&& echo 'DIGEST /tmp/plugin-panel-VERSAO.tar.gz' | sha256sum -c -
⚠ É -o minúsculo, com o nome do arquivo escrito. Com -O maiúsculo, versões de curl anteriores à 7.83 — as que vêm no AlmaLinux 8 e no CentOS 7, por exemplo — colocam o código de autorização dentro do nome do arquivo. O download funciona, o sha256sum seguinte não encontra nada, e o código fica gravado em disco.
O sha256sum -c tem que responder OK. Se não responder, pare: o arquivo não é o que foi publicado.
Passo 2 — Extrair em um diretório próprio
mkdir -p /opt/plugin-panel-VERSAO
tar -xzf /tmp/plugin-panel-VERSAO.tar.gz -C /opt/plugin-panel-VERSAO
⚠ Um diretório por versão, sempre. Extrair uma versão nova por cima da anterior deixa para trás os arquivos que a nova removeu — e o instalador copia tudo que encontra na origem, inclusive as sobras.
Passo 3 — Ver antes o que ele faria
/opt/plugin-panel-VERSAO/scripts/install-directadmin.sh --dry-run
Imprime cada comando que a execução real faria, sem tocar em nada. As verificações de pré-requisito rodam de verdade aqui, antes de qualquer mudança.
Passo 4 — Instalar
flock -w 420 /tmp/sender25-tracking-directadmin-sync.lock \
/opt/plugin-panel-VERSAO/scripts/install-directadmin.sh
⚠ Repare que o nome da trava é diferente do cPanel (-directadmin- no meio). Usar o nome errado parece funcionar e não protege nada: você toma uma trava que ninguém disputa.
A trava importa em reinstalação ou atualização: o coletor roda de minuto em minuto e o instalador troca os arquivos que ele está usando. Sem ela, um ciclo que caia no meio da troca morre com erro, e o cron reporta rastreamento quebrado por causa de uma instalação que deu certo.
Nenhum serviço do painel é reiniciado, nem antes nem depois. Diferente do cPanel, aqui não há interrupção alguma — o que torna a instalação em servidor com muitas contas bem menos delicada.
Pode aparecer uma execução do coletor terminando logo depois da instalação. É normal por até um minuto.
Passo 5 — Abrir a tela
Entre no DirectAdmin como administrador e abra o plugin no menu de administração. Você deve ver uma lista de mensagens — possivelmente vazia, se o servidor enviou pouco e-mail recentemente, mas nunca um erro.
Confira na aba Configurações se o hostname do relay foi detectado sozinho; se não, informe você mesmo.
Instalando sem expor ao cliente ainda
/opt/plugin-panel-VERSAO/scripts/install-directadmin.sh --admin-only
Instala apenas a tela do administrador. A tela do cliente fica alcançável por qualquer conta no instante em que os arquivos dela existem, sem opt-in — então escalonar mantém a primeira olhada entre você e o servidor.
Há ainda uma segunda escolha, independente dessa:
/opt/plugin-panel-VERSAO/scripts/install-directadmin.sh --customer-menu-tile
Sem essa opção, a tela do cliente existe e funciona, mas não ganha um bloco na grade "Extra Features" do painel dele. A ideia é que você a divulgue pelo menu de E-mail, que é onde o cliente procura. Com a opção, o bloco aparece na grade.
Problemas comuns
O instalador parou num pré-requisito
É o comportamento pretendido. A mensagem diz exatamente qual item falhou — versão do PHP, extensão ausente ou mainlog ilegível.
A tela do cliente não aparece no painel dele
Se você instalou com --admin-only, ela não foi instalada. Se instalou completo mas sem --customer-menu-tile, ela existe e é alcançável — só não tem bloco na grade "Extra Features".
A lista aparece vazia
Normal em servidor com pouco envio recente. Envie uma mensagem de teste por uma conta do servidor e procure por ela um ou dois minutos depois.
Controle de Mudanças
Informações de controle de versão
- Última revisão 02-09-2026
- Próxima revisão 02-03-2027
- Autor Sender25
- Versão 1.0