blog
Painéis

Quem subiu (ou apagou) arquivo no site: lendo o log de FTP

O log bruto de FTP diz a hora, o usuário e o caminho do arquivo. Veja como baixar, filtrar e transformar isso num laudo de três parágrafos que o cliente entende.

JR · · 10 min de leitura · 2 tabelas · 5 blocos de código

Resposta curta: baixe o log bruto de FTP da conta (no WHM, pela interface Raw FTP Log Download) e leia a linha do intervalo do incidente: ela traz data, hora, IP, usuário de FTP autenticado e caminho completo do arquivo enviado ou baixado.

Neste artigo
  1. O que o log bruto de FTP prova, e o que ele não prova
  2. Onde baixar o log bruto de FTP no WHM
  3. Os 14 campos da linha de transferência, um a um
  4. Como cruzar o horário do log com o minuto em que o site quebrou
  5. Como preparar os sites para que o log identifique alguém
  6. Como escrever o laudo para o cliente em três parágrafos
  7. O log veio vazio: três hipóteses, nesta ordem
  8. Checklist de entrada, incidente e offboarding

O que o log bruto de FTP prova, e o que ele não prova

Quando um site de cliente quebra depois de um deploy, ou aparece um arquivo que ninguém assume, a discussão costuma virar troca de acusação. O log bruto de FTP corta isso porque registra transferência por transferência: data e hora, usuário de FTP autenticado, caminho completo do arquivo e o sentido da operação.

O que ele prova:

O que ele não prova, e isso precisa estar claro antes de você mandar qualquer coisa para o cliente:

Esse recorte é o que separa um laudo defensável de um chute. Quando a resposta for "não há registro de FTP nesse intervalo", diga exatamente isso, e não "ninguém mexeu".

Onde baixar o log bruto de FTP no WHM

No WHM, a interface Raw FTP Log Download (em Account Functions) entrega o log bruto de FTP de uma conta para download, conforme a documentação oficial do cPanel. É o caminho de menor atrito: você escolhe a conta, a interface lista os logs disponíveis e você baixa o arquivo.

Se você tem acesso só ao cPanel da conta, e não ao WHM, peça o arquivo ao provedor citando o nome da interface. Isso encurta a conversa: o atendimento sabe exatamente o que buscar.

Por que o log precisa ser baixado no mesmo dia do incidente

Log de FTP é arquivo rotacionado. A cada ciclo de rotação, o arquivo corrente é fechado, comprimido e, depois de um número de ciclos, descartado. O detalhe operacional que custa caro para a agência é esse: o prazo para pegar a prova é curto e não depende de você. A política de retenção é do servidor.

Regra prática que vale adotar no seu processo interno: no mesmo dia em que o cliente relata "o site quebrou" ou "apareceu um arquivo estranho", baixe o log antes de investigar qualquer outra coisa. Investigar leva horas. Rotação não espera.

Guarde o arquivo cru, sem editar, numa pasta por cliente e por incidente. Exemplo de organização:

clientes/
  padaria-do-bairro/
    incidentes/
      2026-03-12-site-em-branco/
        ftp-raw.log        # arquivo original, não tocar
        recorte.txt        # só as linhas do intervalo
        laudo.md           # o que você vai mandar ao cliente

Os 14 campos da linha de transferência, um a um

O layout da linha não é universal: ele depende do daemon de FTP em uso e deve ser conferido na documentação dele (o exemplo abaixo segue o formato de log de transferência no estilo xferlog, usado por servidores como Pure-FTPd e ProFTPD). A documentação do cPanel citada acima cobre o download do arquivo, não o formato da linha. Abaixo, uma linha fictícia, criada como exemplo didático, não extraída de servidor real. Na contagem de campos que uso na tabela, a data inteira conta como campo 1, e os campos 2 a 5 são duração, IP, tamanho em bytes e caminho:

Thu Mar 12 14:32:07 2026 1 203.0.113.44 2918 /home/padaria/public_html/wp-config.php b _ i r deploy-joao ftp 0 * c

Os campos que costumam resolver a investigação:

Campo no exemplo O que é Por que importa
Thu Mar 12 14:32:07 2026 data e hora da conclusão da transferência é o que você cruza com o minuto da quebra
1 duração da transferência em segundos arquivo grande com duração zero é suspeito
203.0.113.44 IP de origem separa escritório, home office e desconhecido
2918 tamanho em bytes compara com o tamanho do arquivo legítimo
/home/.../wp-config.php caminho completo diz exatamente qual arquivo mudou
b (campo 6) tipo de transferência: b binário, a ASCII distingue envio binário de texto
_ (campo 7) flag de ação especial: C comprimido, U descomprimido, T empacotado, _ nenhuma normalmente vem _
i (campo 8) sentido: i entrada (upload), o saída (download) i é alguém subindo, o é alguém baixando
r (campo 9) modo de acesso: r usuário autenticado, a anônimo, g convidado confirma que houve login com credencial
deploy-joao (campo 10) usuário de FTP autenticado o nome que vai no laudo
ftp e 0 (campos 11 e 12) serviço usado e método de autenticação raramente mudam a conclusão
* (campo 13) ID retornado pela autenticação, * quando não há costuma vir vazio
c (campo 14, o último) c transferência completa, i incompleta aqui o i significa incompleta, não upload: repare que é o último campo, enquanto o sentido está no campo 8

Dois detalhes que mudam a leitura:

Como cruzar o horário do log com o minuto em que o site quebrou

O método é sempre o mesmo e funciona para qualquer site. Primeiro você fixa o intervalo, depois filtra o log.

Fixe a janela pelo primeiro sinal objetivo, não pelo relato

Monte a janela pelo primeiro sinal objetivo, não pelo relato. Serve: horário do e-mail de monitoramento, timestamp do erro no error_log da conta, data de modificação do arquivo suspeito (stat arquivo.php ou a coluna de data no Gerenciador de Arquivos), primeiro comentário do cliente no WhatsApp. Pegue 30 minutos antes e 30 depois.

Recorte o log com três grep e nada além disso

Com o arquivo baixado na sua máquina, filtre pela data e pela hora. O comando mais direto:

grep "Mar 12" ftp-raw.log | grep " 14:" > recorte.txt

Se você quer ver tudo de um único usuário no dia:

grep "Mar 12" ftp-raw.log | grep "deploy-joao"

E para achar todo mundo que tocou num arquivo específico, independente da data:

grep "wp-config.php" ftp-raw.log

São três grep porque é o que basta. Resista à tentação de escrever um pipeline de awk elegante: você vai ler o resultado com os olhos de qualquer jeito, e um filtro simples que você entende é melhor que um sofisticado que você copiou.

Separe upload de download e veja se a transferência foi completa

No recorte, separe o que é upload do que é download. Upload no minuto da quebra é a pista forte. Download em massa num horário estranho é outra história, e geralmente pior: pode ser exfiltração.

Compare o arquivo com o backup antes de escrever o laudo

O log diz que o arquivo foi substituído. Ele não diz o que entrou. Se você tem backup, compare as duas versões antes de escrever o laudo. Muita vez o upload do log é inocente e a quebra veio de outro lugar.

Como preparar os sites para que o log identifique alguém

Log de FTP só vale como prova se o usuário identificar alguém. Com todo mundo usando a conta principal do cPanel, toda linha aponta para o mesmo nome e a investigação morre na origem. A preparação é trabalho de dez minutos por site e paga sozinha no primeiro incidente.

Prática O que muda no log Custo para a agência
Um usuário de FTP por pessoa o nome na linha identifica alguém criar conta por pessoa em cada site
Usuário separado por automação (CI, backup, plugin) separa robô de humano no mesmo arquivo uma conta extra por integração
Nunca usar a conta principal para deploy a linha com o usuário principal vira alerta mudar o hábito da equipe
Diretório restrito por usuário upload fora do escopo nem acontece definir o caminho na criação
Remover usuário na saída de freelancer fecha a janela de acesso item no checklist de offboarding
Baixar o log no dia do incidente a prova existe quando você precisa um download

Padronize o nome do usuário para que o log seja legível sem consulta. Um esquema que funciona bem em carteira grande: papel-pessoa, como deploy-joao, design-marina, ci-github, bkp-rclone. Ao abrir o log seis meses depois, você entende a linha sem abrir planilha.

E registre em algum lugar quem é o dono de cada usuário, com data de criação e data de remoção. Essa planilha é o que transforma "o usuário deploy-joao" em "o João, da equipe de desenvolvimento, com acesso criado em 3 de fevereiro".

Como escrever o laudo para o cliente em três parágrafos

O cliente não quer linha de log. Ele quer saber o que aconteceu, se está resolvido e se vai acontecer de novo. Mande três parágrafos curtos.

Fato, com o que o log mostra:

Limite, dito por você antes de alguém perguntar:

Conserto e prevenção:

Três parágrafos. Sem adjetivo, sem acusação, sem log colado. Se o cliente pedir a evidência, aí sim você anexa o recorte das linhas do intervalo.

O log veio vazio: três hipóteses, nesta ordem

Acontece com frequência e não significa que o arquivo apareceu sozinho. Três hipóteses para percorrer nesta ordem:

  1. A alteração não passou por FTP. Gerenciador de Arquivos, SSH/SFTP, editor de arquivos do WordPress, atualização de plugin ou tema, script PHP executado por requisição web. Nenhum desses deixa rastro no log de transferência de FTP. Para o Gerenciador de Arquivos e para ações do painel, o caminho é o log de acessos ao painel. Para script PHP, o log de acesso do servidor web no horário é o lugar: procure o POST que bate com o minuto.
  2. A janela está errada. Data de modificação do arquivo e horário percebido pelo cliente podem estar a horas de distância, especialmente com cache ou CDN na frente. Reabra a janela usando o stat do arquivo e o fuso do servidor.
  3. O log já rodou. Se o incidente é de semanas atrás, pode não existir mais arquivo para aquele período. Nesse caso, registre a limitação no laudo em vez de preencher com suposição.

Uma observação que vale contra o nosso próprio interesse comercial: antes de propor migração, plano maior ou serviço de limpeza de malware, confira o log. Muitas vezes ele mostra que não houve FTP nenhum e a causa era atualização automática de plugin ou permissão de arquivo. Conferir o log leva minutos e às vezes encerra o assunto.

Checklist de entrada, incidente e offboarding

Coloque isso no seu processo de onboarding de cliente e no runbook de incidente. É o mesmo texto para todos os sites da carteira.

Na entrada do cliente

No incidente, nesta ordem

Na saída de alguém da equipe

O item que mais gente pula é o segundo da lista de incidente. Trabalhar sobre o arquivo original intacto é o que permite, semanas depois, responder a uma contestação do cliente sem precisar refazer nada.

Referências

  1. Documentação oficial (cpanel) — Raw FTP Log Download. Consultado em 2026-09-24.
Leia também