Ir para o conteúdo principal

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

ItemExigência
DirectAdmintestado contra o 1.701
PHP8.1+ em /usr/local/bin/php
Extensões PHPpdo_sqlite, curl, json, zlib e posix
Log de e-mail/var/log/exim/mainlog legível
Acessoroot, 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