Como configurar permissões de arquivos e pastas corretamente via SSH (chmod/chown)

Permissões de Arquivos e Pastas via SSH: o Guia da Sensei para você nunca mais errar um chmod

Oi! Eu sou a Sensei da GeHost 🥋 e hoje vamos falar de um assunto que assusta muita gente, mas que na verdade é bem simples quando você entende a lógica por trás: permissões de arquivos e pastas. Se o seu site está dando erro 500, uma página em branco, ou algum script não consegue gravar um arquivo, é bem provável que o problema seja permissão errada. Vamos resolver isso juntos, com calma.

Por que permissões existem?

Todo arquivo e toda pasta no seu servidor têm três tipos de "poder de ação": ler (r), escrever (w) e executar (x). E esses poderes são definidos para três grupos diferentes: o dono do arquivo, o grupo dele, e "os outros" (todo mundo mais). É exatamente essa combinação que o comando chmod ajusta.

💡 Dica da Sensei: pense assim — r = ler, w = escrever/alterar, x = executar/entrar na pasta. Cada permissão vale 4, 2 e 1 respectivamente, e a soma delas forma aquele número que você vê por aí, tipo 755 ou 644.

Os valores que você realmente precisa saber

• 755 — padrão para pastas (dono pode tudo; grupo e outros só leem e entram).
• 644 — padrão para arquivos (dono lê e escreve; grupo e outros só leem).
• 750 / 640 — versões mais restritas, quando você quer travar o acesso do "grupo" também.

⚠️ Nunca use 777. Esse valor libera leitura, escrita e execução para absolutamente qualquer pessoa que acesse o servidor — é uma porta escancarada para invasões. Se algum tutorial da internet mandar usar 777 "pra resolver logo", desconfie: quase sempre existe uma permissão mais segura que resolve o mesmo problema.

Passo 1: conectando via SSH

1. Abra seu terminal (Mac/Linux) ou um cliente como o PuTTY/Windows Terminal (Windows).
2. Use o comando de conexão com o usuário e o endereço do seu SSH — essas informações ficam disponíveis no seu painel.gehost.com.br ou no e-mail de boas-vindas que enviamos na entrega da hospedagem:
   ssh seu_usuario@seu_dominio.com.br
3. Digite sua senha quando solicitado (ela não aparece na tela enquanto você digita — é normal, siga em frente e aperte Enter).

🔑 Não sabe seu usuário SSH ou se ele está ativo? Consulte o painel do cliente ou fale com o nosso suporte — cada plano tem suas particularidades de acesso.

Passo 2: navegando até a pasta certa

Depois de conectado, vá até a pasta do seu site (geralmente dentro de public_html):

1. cd public_html — entra na pasta principal do site.
2. ls -la — lista todos os arquivos e pastas, já mostrando as permissões atuais (aquela sequência de letras tipo drwxr-xr-x no começo de cada linha).

Passo 3: ajustando com chmod

1. Para corrigir uma pasta específica:
   chmod 755 nome_da_pasta
2. Para corrigir um arquivo específico:
   chmod 644 nome_do_arquivo.php
3. Para corrigir todas as pastas de uma vez, recursivamente:
   find . -type d -exec chmod 755 {} \;
4. Para corrigir todos os arquivos de uma vez, recursivamente:
   find . -type f -exec chmod 644 {} \;

📌 Dica da Sensei: rode o comando de pastas e o de arquivos separadamente (como acima), nunca um chmod -R 755 genérico em tudo — isso deixaria seus arquivos executáveis igual a pastas, o que também é uma falha de segurança.

Passo 4: e o chown, quando usar?

O chown muda o dono de um arquivo ou pasta — diferente do chmod, que muda o que cada um pode fazer. Na grande maioria dos casos em hospedagem compartilhada, você não vai precisar mexer em dono, porque tudo já pertence ao seu próprio usuário. Se em algum momento um arquivo aparecer com dono diferente (por exemplo, depois de restaurar um backup enviado por outra pessoa), o comando é:

1. chown seu_usuario:seu_usuario nome_do_arquivo

🙋 Ficou em dúvida se deve mexer no dono? Melhor chamar o suporte antes — trocar o dono errado pode tirar o acesso de scripts do próprio sistema à sua pasta.

Prefere sem terminal? Use o Gerenciador de Arquivos

Se comando de terminal ainda não é sua praia, dá pra ajustar permissões visualmente, com cliques, direto pelo cPanel:

1. No cPanel, abra o Gerenciador de Arquivos (File Manager).
2. Clique com o botão direito sobre o arquivo ou pasta desejada.
3. Seleccione "Alterar Permissões" (Change Permissions).
4. Marque as caixinhas correspondentes ou digite direto o número (755, 644 etc.) e confirme.

Erros comuns que a permissão errada causa

• Erro 500 (Internal Server Error): quase sempre é pasta ou arquivo com permissão maior do que deveria (ex: 777) ou dono incorreto.
• "Failed to write" ou upload que não salva: geralmente a pasta de destino está com permissão menor do que 755, sem direito de escrita nem pro próprio dono.
• Script/plugin não consegue criar arquivos automaticamente (como cache de CMS): confira se a pasta específica exigida pelo sistema está em 755 — evite liberar mais do que isso "pra testar".

🌸 Palavra final da Sensei: permissão é como uma chave de casa — você quer dar a chave certa pra pessoa certa, nunca uma cópia pra rua inteira. Na dúvida entre "mais restrito" ou "mais aberto", vá sempre pelo mais restrito primeiro e vá abrindo só o necessário. E se travar em algum passo, nosso suporte está aqui pra te ajudar sem julgamento nenhum — todo mundo já apanhou de um chmod um dia. 💛