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.

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
- O que o log bruto de FTP prova, e o que ele não prova
- Onde baixar o log bruto de FTP no WHM
- Os 14 campos da linha de transferência, um a um
- Como cruzar o horário do log com o minuto em que o site quebrou
- Como preparar os sites para que o log identifique alguém
- Como escrever o laudo para o cliente em três parágrafos
- O log veio vazio: três hipóteses, nesta ordem
- 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:
- que o usuário
deploy-joaoenviou/public_html/wp-config.phpnaquele minuto; - que uma transferência existiu, com tamanho em bytes e IP de origem;
- que, no intervalo em que o site quebrou, houve ou não houve atividade de FTP.
O que ele não prova, e isso precisa estar claro antes de você mandar qualquer coisa para o cliente:
- quem estava fisicamente atrás daquele usuário. O log autentica credencial, não pessoa. Se três pessoas usam a mesma conta, o log aponta para as três.
- alteração feita pelo Gerenciador de Arquivos do painel, por SSH/SFTP, por plugin de editor de tema do WordPress, por atualização automática ou por qualquer script PHP. Nada disso passa pelo serviço de FTP e nada disso aparece nesse log.
- intenção. Sobrescrever
wp-config.phppode ser deploy legítimo com arquivo errado dentro.
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:
- Fuso horário. O log usa o horário do servidor, que pode não ser o do cliente. Antes de afirmar "às 14h32", confirme o fuso do servidor e converta. Errar uma hora destrói a credibilidade do laudo inteiro.
- Exclusão não é transferência. O log de transferência registra envio e download. Apagar arquivo é um comando de FTP, não uma transferência, e pode não aparecer nesse arquivo. Se o cliente diz "sumiu arquivo", o log pode ser silencioso mesmo com o apagamento tendo acontecido por FTP. Diga isso em vez de concluir que não houve apagamento.
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:
- 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.
- 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
statdo arquivo e o fuso do servidor. - 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
- [ ] Criar um usuário de FTP por pessoa, com nomenclatura
papel-pessoa. - [ ] Criar usuário separado para cada automação.
- [ ] Restringir o diretório de cada usuário ao que ele precisa.
- [ ] Guardar a conta principal do cPanel para administração, com senha que a equipe não usa no dia a dia.
- [ ] Registrar em planilha: usuário, pessoa responsável, data de criação.
- [ ] Confirmar e anotar o fuso horário do servidor.
No incidente, nesta ordem
- [ ] Baixar o log bruto de FTP da conta antes de qualquer outra coisa, pela interface Raw FTP Log Download do WHM ou solicitando ao provedor.
- [ ] Salvar o arquivo original sem edição, numa pasta do incidente.
- [ ] Definir a janela pelo primeiro sinal objetivo, com 30 minutos de folga de cada lado.
- [ ] Filtrar por data e hora, depois por usuário, depois pelo caminho do arquivo.
- [ ] Verificar sentido da transferência, tamanho e se ela foi completa.
- [ ] Comparar o arquivo atual com o backup antes de concluir.
- [ ] Se não houver linha no intervalo, checar log do painel e log de acesso web antes de dizer qualquer coisa ao cliente.
- [ ] Escrever o laudo em três parágrafos: fato, limite, conserto.
Na saída de alguém da equipe
- [ ] Remover o usuário de FTP em todos os sites onde ele existe.
- [ ] Anotar a data de remoção na planilha.
- [ ] Trocar a senha da conta principal se ela tiver sido compartilhada em algum momento.
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
- Documentação oficial (cpanel) — Raw FTP Log Download. Consultado em 2026-09-24.