# Quem apagou ou alterou um arquivo do site: como descobrir

O log de acesso web mostra quem visitou. Autoria de escrita só aparece no log de transferência da conta, e o cPanel entrega esse arquivo para quem sabe onde pedir.

> o log de acesso web não registra escrita. Baixe o log bruto de FTP da conta em WHM > Account Functions > Raw FTP Log Download, cruze o carimbo com o minuto da quebra e feche em três hipóteses: credencial da equipe, credencial vazada ou alteração feita por PHP.

João Rizzon · 2026-09-28 · Painéis

---

## O log de acesso web não registra quem gravou o arquivo

Quando um cliente liga dizendo que o site quebrou de madrugada, ou que apareceu um `index.php` estranho na raiz, o primeiro reflexo é abrir o log de acesso web. Ele mostra requisições: IP, método, URL, código de resposta, user agent. Serve para reconstruir quem visitou e o que foi pedido ao servidor HTTP.

O que ele não mostra é quem gravou byte em disco por outro caminho. Uma sobrescrita feita por cliente FTP, por FileZilla, por deploy automatizado ou por um script de sincronização não passa pelo Apache/LiteSpeed e não gera linha no log de acesso. A evidência de autoria de escrita fica no log de transferência de arquivos da conta, o `xferlog` do servidor de FTP.

É ali que está o par que fecha um incidente: **carimbo de data e hora** mais **usuário FTP** mais **caminho completo do arquivo**. Sem esse arquivo você fica preso no ponto mais caro da triagem, decidindo no escuro entre limpar o site e refazer do backup.

## Raw FTP Log Download fica no WHM, não no cPanel

O cPanel expõe o log de transferência por uma interface do WHM. Segundo a [documentação oficial do Raw FTP Log Download](https://docs.cpanel.net/whm/account-functions/raw-ftp-log-download/), a interface fica em **WHM > Account Functions > Raw FTP Log Download** e permite baixar o log bruto de FTP de uma conta do servidor.

O detalhe prático para agência: isso é WHM, não cPanel. Se você administra o servidor ou é revendedor com a permissão correspondente, acessa direto. Se o cliente está em hospedagem compartilhada e você só tem o cPanel, o caminho é pedir o arquivo ao provedor informando a conta e a janela de tempo. Em **Metrics > Raw Access**, dentro do cPanel, o que você baixa é o log do servidor web, não o de FTP. São arquivos diferentes e respondem perguntas diferentes.

Dois cuidados de processo:

- **Peça cedo.** Log rotaciona. Quanto mais tempo passa entre o incidente e o pedido, maior a chance de a janela relevante já ter saído do arquivo ativo.
- **Peça a janela, não o dia inteiro.** Informe data e hora aproximadas da quebra. Facilita para quem vai atender e reduz o volume que você precisa ler.

Guarde o arquivo baixado junto com o restante das evidências do caso. Se o incidente virar discussão contratual com o cliente, esse arquivo é o documento que liga a alteração a um usuário FTP nomeado. Alterações feitas por SFTP ou pelo Gerenciador de Arquivos do painel deixam rastro, mas em outros logs, que você precisa pedir separadamente.

## Os 14 campos do xferlog e o que cada um prova

O formato mais comum nos servidores de FTP usados em ambiente cPanel é o `xferlog`, com campos separados por espaço, na ordem abaixo. Confirme no seu servidor antes de bater o martelo, porque daemons diferentes registram alguns campos de forma distinta.

| # | Campo | Para que serve na auditoria |
|---|---|---||
| 1 | current-time | Data e hora da transferência, no fuso do servidor. É o campo que você cruza com o minuto da quebra |
| 2 | transfer-time | Duração da transferência em segundos |
| 3 | remote-host | IP de origem. Identifica escritório, VPN, provedor doméstico ou país inesperado |
| 4 | file-size | Tamanho em bytes do que foi transferido |
| 5 | filename | Caminho completo do arquivo no servidor |
| 6 | transfer-type | `a` para ASCII, `b` para binário |
| 7 | special-action-flag | Compressão ou nenhuma ação |
| 8 | direction | `i` entrada (upload para o servidor), `o` saída (download), `d` exclusão |
| 9 | access-mode | `r` usuário real, `g` guest, `a` anônimo |
| 10 | username | **O nome da conta FTP usada.** O campo mais importante do log |
| 11 | service-name | Normalmente `ftp` |
| 12 | authentication-method | Método de autenticação |
| 13 | authenticated-user-id | ID autenticado, quase sempre `*` |
| 14 | completion-status | `c` completa, `i` incompleta |

Uma linha de exemplo (fictícia, montada para ilustrar a leitura, não extraída de servidor real):

```
Mon Sep 22 03:14:07 2025 2 203.0.113.45 18422 /home/cliente/public_html/wp-content/themes/tema/functions.php b _ i r deploy_agencia ftp 0 * c
```

Leitura em voz alta: às 03:14:07 do dia 22, o IP `203.0.113.45` **enviou** (`i`) 18422 bytes para o caminho `functions.php` do tema, autenticado como usuário real com a conta `deploy_agencia`, e a transferência terminou completa (`c`).

### Sobrescrita aparece como upload, exclusão nem sempre aparece

Sobrescrever um arquivo existente aparece como upload normal, direção `i`, com o caminho de destino idêntico ao arquivo antigo. Não existe um campo dizendo "substituiu". Você conclui isso porque o arquivo já existia e o log mostra um envio para o mesmo caminho.

Exclusão é o ponto fraco. Nem todo daemon registra a operação de delete no `xferlog`. Se o arquivo sumiu e não há linha `d` nem upload para aquele caminho, isso não prova que ninguém apagou por FTP: pode ser que o servidor simplesmente não registre exclusões. Verifique o comportamento do daemon antes de descartar a hipótese.

### Por que awk '{print $10}' devolve o campo errado

O campo 1 é uma data escrita por extenso e ocupa cinco tokens separados por espaço (`Mon`, `Sep`, `22`, `03:14:07`, `2025`). Quem tenta `awk '{print $10}'` esperando o nome de usuário pega outro campo. Para triagem rápida, prefira `grep` pelo caminho ou pelo nome do arquivo e leia a linha inteira:

```
grep "functions.php" xferlog-da-conta.log
grep "Sep 22 03:1" xferlog-da-conta.log
```

## Cruzar o carimbo do log com o minuto em que o site quebrou

O log sozinho é uma lista de transferências legítimas e ilegítimas misturadas. O que separa as duas é o cruzamento temporal.

### Fixe o minuto do incidente no fuso do servidor

Use a fonte mais precisa que existir: alerta do monitoramento, horário do e-mail de erro, primeiro erro no log do PHP, ou o relato do cliente. Anote em fuso do servidor, não no fuso do navegador de quem relatou. Diferença de três horas transforma investigação em ficção.

### Confirme o mtime dos arquivos suspeitos antes de abrir o log

Antes de abrir o log, liste o que mudou no período. Pelo terminal, com acesso SSH:

```
find /home/cliente/public_html -type f -newermt "2025-09-22 03:00" ! -newermt "2025-09-22 04:00" -printf "%T+ %u %p\n" | sort
```

Isso devolve os arquivos modificados dentro da janela, com data, dono e caminho. Para um arquivo específico:

```
stat /home/cliente/public_html/wp-content/themes/tema/functions.php
```

O campo `Modify` indica quando o conteúdo mudou. Ele pode ser forjado por quem tem acesso suficiente, mas na maioria dos incidentes reais ninguém se dá ao trabalho.

### Procure o caminho no log de FTP e interprete os três resultados

Com a lista de arquivos e o minuto em mãos, busque cada caminho no `xferlog`. Três resultados possíveis:

- **Achou linha com o caminho e horário batendo.** Você tem autoria. Anote usuário e IP.
- **Achou linhas do mesmo usuário na janela, mas de outros arquivos.** Sessão suspeita aberta naquele momento. Vale reconstruir tudo que aquela sessão enviou.
- **Não achou nada na janela.** A alteração provavelmente não veio por FTP. Vá para a terceira hipótese.

### Dono igual não distingue FTP de PHP, mas dono diferente é sinal

Em servidor cPanel bem configurado o PHP roda como o usuário da conta, então o dono do arquivo costuma ser o mesmo em gravação por FTP e em gravação por script, e sozinho não distingue as duas origens. Ainda assim, arquivo com dono diferente do restante do diretório é sinal forte de que a gravação veio por outro processo. Compare com `ls -l` a pasta inteira, não só o arquivo suspeito.

## Três hipóteses que fecham o caso e o que fazer em cada uma

| Hipótese | Evidência no log de FTP | Ação imediata |
|---|---|---||
| Credencial da equipe | Linha com usuário conhecido e IP conhecido (escritório, VPN, servidor de deploy) | Falar com a pessoa. Quase sempre é deploy errado, plugin subido por engano ou arquivo salvo direto no servidor |
| Credencial vazada de terceiro | Linha com usuário conhecido mas IP que ninguém reconhece, ou horário incompatível com o expediente | Trocar a senha da conta FTP, revogar contas órfãs, varrer a máquina de quem usa aquela credencial |
| Alteração feita por PHP | Nenhuma linha na janela para aquele caminho | Tratar como execução de código no site: plugin ou tema vulnerável, upload malicioso, backdoor |

A terceira hipótese costuma decepcionar quem esperava um nome, mas a ausência de linha é informação. Se o arquivo mudou às 03:14 e o log de transferência não registra nada naquela janela, a escrita partiu de dentro: um script PHP gravou o arquivo. Isso muda completamente o plano de resposta, porque trocar senha de FTP não resolve nada e a origem está no código da aplicação.

Dois lembretes que evitam conclusão errada:

- **SFTP não escreve no `xferlog`.** Transferência por SFTP passa pelo SSH, não pelo servidor de FTP, e o registro fica nos logs do sistema, normalmente acessíveis só por quem administra o servidor. Se a equipe usa SFTP, peça ao provedor o log correspondente antes de concluir que "não houve transferência".
- **Gerenciador de Arquivos do cPanel também não é FTP.** Edição feita pela interface web do painel não produz linha no log de transferência.

## Checklist de auditoria para reaproveitar em qualquer cliente

Salve este bloco no seu gerenciador de tarefas e reaproveite em qualquer cliente.

- Registrar o minuto do incidente, em fuso do servidor, e a fonte dessa informação.
- Solicitar ou baixar o log bruto de FTP da conta no WHM, informando a janela.
- Rodar o `find -newermt` na janela e salvar a lista de arquivos alterados.
- Rodar `stat` nos dois ou três arquivos mais críticos e anotar `Modify`.
- Buscar cada caminho no log de FTP com `grep`.
- Para cada linha encontrada, anotar horário, IP, usuário e direção.
- Classificar o IP: escritório, casa de alguém da equipe, servidor de deploy, desconhecido.
- Fechar em uma das três hipóteses e escrever uma linha dizendo por quê.
- Se for credencial: trocar senha e listar todas as contas FTP da conta, removendo as que ninguém reconhece.
- Se for PHP: partir para triagem de site invadido, com varredura de plugins, temas e arquivos fora de padrão.
- Restaurar o arquivo específico a partir do backup mais próximo anterior ao carimbo encontrado, e não o site inteiro, quando o escopo estiver delimitado.
- Arquivar log, comandos e conclusões na pasta do cliente.

Restaurar só o arquivo específico depende de ter fixado o minuto do incidente. Saber a hora exata é o que permite escolher a versão certa do backup em vez de jogar o site duas semanas para trás e perder pedidos, cadastros e conteúdo.

## Uma conta FTP por pessoa, senão o campo username não prova nada

O campo `username` é o que transforma log em prova. Se toda a agência, o freelancer que fez o tema, o plugin de deploy e o sobrinho do cliente usam a mesma conta principal, o log vai dizer o óbvio: alguém com a senha subiu o arquivo. Isso não fecha caso nenhum.

Padronize assim nos sites que você administra:

- Uma conta FTP por pessoa física, nomeada (`joao`, `maria`), com diretório inicial restrito ao que aquela pessoa precisa.
- Uma conta separada e exclusiva para automação (`deploy`, `ci`), que nunca é usada por humano.
- Conta principal da hospedagem reservada, sem uso rotineiro, senha guardada no cofre.
- Desativação da conta no mesmo dia em que a pessoa sai do projeto, junto com a saída do Slack e do Git.
- Revisão trimestral da lista de contas FTP de cada cliente, apagando o que ninguém reconhece.

Custa minutos por site e, no dia do incidente, é a diferença entre um relatório com nome e IP e um encolher de ombros. Registre a lista de contas de cada cliente na mesma planilha ou no mesmo gestor onde você guarda acessos, para que a revisão seja um item de rotina e não uma arqueologia.

## Três frases prontas para explicar o achado ao cliente

O cliente final não quer saber de `xferlog`. Ele quer saber se a hospedagem falhou, se foi ataque e quanto vai custar. Três frases prontas, uma por veredito:

**Credencial da equipe:** "Os registros de transferência do servidor mostram que o arquivo foi substituído no dia 22 às 03:14, a partir do acesso FTP usado pela nossa equipe. Foi uma publicação com erro, já revertida a partir do backup da noite anterior. Não houve invasão nem falha da hospedagem."

**Credencial vazada:** "Os registros de transferência do servidor mostram que o arquivo foi substituído no dia 22 às 03:14 usando o login FTP da conta X, a partir de um endereço de internet que não pertence a ninguém da nossa equipe nem da sua. O acesso foi feito com a senha correta, ou seja, essa senha vazou. Já trocamos a senha, removemos os acessos antigos e restauramos o arquivo. O próximo passo é verificar o computador de quem usava essa senha."

**Alteração por PHP:** "Os registros de transferência do servidor não mostram nenhum envio de arquivo no horário da alteração. Isso indica que a modificação partiu de dentro do próprio site, por um plugin ou tema com falha, e não de alguém entrando com senha. A correção é diferente: além de restaurar o arquivo, precisamos identificar e atualizar ou remover o componente vulnerável, senão o problema volta."

A última frase é a mais importante das três, porque justifica ao cliente por que a resposta é mais cara do que "trocar a senha" e por que vale pagar pelo trabalho de limpeza em vez de repetir o incidente em duas semanas.

