# 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.

> 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.

João Rizzon · 2026-11-06 · Painéis

---

## 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-joao` enviou `/public_html/wp-config.php` naquele 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.php` pode 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](https://docs.cpanel.net/whm/account-functions/raw-ftp-log-download/). É 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:

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

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

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

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

```bash
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:

> **** No dia 12 de março, às 14h32 no horário do servidor, o usuário de FTP `deploy-joao` substituiu o arquivo `/public_html/wp-config.php`. É o momento em que o site passou a exibir tela em branco.

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

> **** O registro identifica o usuário de FTP utilizado, não a pessoa fisicamente conectada. Também não cobre alterações feitas pelo Gerenciador de Arquivos do painel, por SSH ou por plugins dentro do WordPress.

Conserto e prevenção:

> **** O arquivo foi restaurado a partir do backup das 03h e o site voltou às 15h10. A partir de agora, cada pessoa com acesso usa um usuário de FTP próprio, e a conta principal fica reservada à administraçã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 `stat` do 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.

