> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usuários FTP

> Cria acessos de FTP a mais na sua conta, cada um preso a uma pasta. É o jeito de dar a um desenvolvedor ou a um parceiro acesso a uma parte dos seus arquivos sem passar a senha do…

O FTP é o jeito de enviar e baixar arquivos do servidor por um programa no seu
computador, como o FileZilla.

**Caminho no painel:** menu da esquerda > **RECURSOS** > **Usuários FTP**

## Você já tem um acesso FTP: o da própria conta

A tela lembra: *"Dica: Você pode simplesmente usar sua conta FTP principal, usando
as mesmas credenciais de acesso que você usa para entrar neste painel de controle."*

**Medido:** um programa de FTP entrou com o nome de usuário e a senha do painel, sem
nenhum usuário FTP criado. Esse acesso abre a pasta da conta inteira, com o site, os
arquivos e os registros. O nome de usuário é o **Nome de usuário do sistema**, que
aparece no [Painel de Controle](/keyhelp/painel-de-controle).

Crie usuários FTP quando outra pessoa precisar de acesso, e só a uma pasta.

## Conectar um programa de FTP

Os dados de cada usuário ficam no **Mostrar** da lista, na janela **Dados de
conexão**:

![Janela Dados de conexão: Servidor, Porta 21, Protocolo FTP sobre TLS (FTPS), Criptografia Modo explícito e Nome de usuário](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp/imagens/ftp-dados-conexao.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=26f1613a94d74ea1651d34666db487bc)

| Dado | Valor |
| - | - |
| **Servidor** | o endereço do servidor |
| **Porta** | 21 |
| **Protocolo** | FTP sobre TLS (FTPS) |
| **Criptografia** | modo explícito |
| **Nome de usuário** | o do usuário FTP, ou o da sua conta para o acesso principal |

**O servidor exige a conexão criptografada.** No FileZilla, escreva no campo do
servidor `ftpes://` seguido do endereço: o `ftpes` pede o FTP com criptografia no
modo explícito. Medido assim, a conexão entrou. Um programa configurado em FTP sem
criptografia é recusado antes de mandar a senha.

## A lista

![Lista de Usuários FTP com um usuário: o status, o nome com a descrição embaixo, o diretório inicial, o Mostrar dos dados de conexão e os ícones de editar e excluir](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp/imagens/ftp-lista.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=ce678946a40085a89f22c5ec41278b1b)

Acima da lista, **Usuários de FTP** mostra quantos existem e o limite da sua conta,
como *1 / Ilimitado*. Quem define o limite é a empresa que administra o servidor.

| Coluna | O que é |
| - | - |
| **S** | o estado. O quadrado verde quer dizer *"Tudo certo"*, com o mouse em cima. Logo depois de criar, aparece uma chave inglesa azul até o painel terminar de preparar o usuário, em menos de um minuto |
| **NOME DE USUÁRIO** | o nome, com a **Descrição** embaixo |
| **DIRETÓRIO INICIAL** | a pasta do usuário. É link: abre essa pasta no [Gerenciador de Arquivos](/keyhelp/gerenciador-de-arquivos) |
| **DADOS DE CONEXÃO** | o **Mostrar**, com a janela da seção acima |
| **AÇÕES** | o lápis edita, a lixeira exclui |

A busca de **Opções de visualização** procura em **Todos os campos**, ou só em
**Nome de usuário**, **Diretório inicial** ou **Descrição**.

## Criar um usuário FTP

![Formulário Adicionar usuário FTP: Nome de usuário preenchido automaticamente, Descrição, Diretório inicial com Navegar, Senha, Confirme a senha e Sugestão de senha com Gerar](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp/imagens/ftp-adicionar.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=aec01d974509c162b7ffe252630a5e4a)

1. Clique em **Adicionar usuário FTP**.
2. Em **Descrição**, escreva para que é o acesso, como o nome de quem vai usar.
3. Em **Diretório inicial**, escreva a pasta, ou escolha em **Navegar...**. Vem preenchido com `/www/`, a pasta do site.
4. Em **Senha** e **Confirme a senha**, digite a senha, ou clique em **Gerar** e copie a sugestão.
5. Clique em **Salvar**.

A tela responde *"O usuário FTP `<nome>` foi criado com sucesso."*

**O nome de usuário é escolhido pelo painel neste servidor.** O campo vem cinza, com
*"Esta informação é preenchida automaticamente."* Medido: o primeiro usuário da
conta recebeu o nome da conta seguido de `_ftp1`. Quem decide se o cliente escolhe o
nome é a configuração do servidor: ver
[Servidor de FTP (área do administrador)](/keyhelp-admin/servidor-de-ftp).

**A pasta é criada sozinha, se não existir.** A tela avisa *"Se o diretório
especificado não existir, ele será criado automaticamente."* Medido com uma pasta
nova: ela apareceu em menos de um minuto depois de salvar.

### Escolher a pasta pelo Navegar...

![Diretório inicial com a lista de pastas aberta: o caminho barra no campo, o botão Ocultar e as pastas files, logs, tmp e www](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp/imagens/ftp-navegar.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=e07e9122d24e34ed753c199d412e21aa)

**Navegar...** abre a lista de pastas da conta logo abaixo do campo, e o botão vira
**Ocultar**. Clicar numa pasta põe o caminho dela no campo e mostra as pastas de
dentro; o `..` volta um nível. **A lista não sai da sua conta:** na pasta da conta,
o `/`, o `..` fica cinza e não responde.

## O que o usuário FTP pode fazer

A tela resume: *"Cada usuário que você cria pode armazenar e excluir dados e pastas
no diretório atribuído e em seus subdiretórios."* **Medido com o FileZilla:**

* **ele fica preso à pasta inicial.** O programa mostrou a pasta como `/`, vazia, sem caminho para as pastas acima;
* **o que ele envia é da sua conta.** O arquivo enviado ficou com a sua conta como dona: aparece no Gerenciador de Arquivos e ocupa o espaço da conta;
* **o tráfego dele entra no da conta.** O envio apareceu no FTP da [Estatística de tráfego](/keyhelp/estatisticas) da conta.

## Editar

* Na linha do usuário, clique no **lápis**.

Dá para trocar a **Descrição**, o **Diretório inicial** e a **Senha**. Os campos de
senha avisam *"Deixe em branco para manter a senha atual."* **O nome de usuário não
muda.**

## Excluir

![Página Excluir confirmação: o nome, a descrição e o diretório do usuário, com a caixa Excluir diretório home marcada, e a caixa Confirmação](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp/imagens/ftp-excluir.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=01c4b622223ce72984d588d65f4755ba)

1. Na linha do usuário, clique na **lixeira**. Para vários de uma vez, marque as caixas e use **- Ações em massa -** > **Excluir seleção** > **Aplicar**.
2. Na página **Excluir confirmação**, confira o nome e o **Diretório inicial**.
3. Se quiser apagar também a pasta do usuário, marque **Excluir diretório home**, a caixa em destaque. Ela vem desmarcada.
4. Marque **Confirmação** e clique em **Excluir**.

**Medido:**

* a entrada seguinte com aquele usuário foi recusada;
* com **Excluir diretório home** marcada, a pasta saiu junto, com o arquivo que estava nela, em menos de um minuto;
* **quem estava conectado não caiu na hora**: a conexão aberta continuou até o programa fechá-la. A exclusão vale para a próxima entrada.

> [!WARNING]
>
> **Excluir diretório home apaga a pasta inteira, com tudo dentro**
>
> Antes de marcar, confira o **Diretório inicial** na mesma página. A pasta inicial
> vem preenchida com `/www/`, a do site: se for uma pasta que o site ou outras
> pessoas usam, deixe a caixa desmarcada e apague à mão só o que não serve mais.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **O programa de FTP responde "530 Login incorrect"** | a senha está errada, ou o usuário foi excluído: o programa recebe a mesma resposta nos dois casos | conferir se o usuário continua na lista, e trocar a senha pelo lápis se for preciso |
| **O programa recusa antes de pedir a senha** | ele está usando FTP sem criptografia | no FileZilla, escrever `ftpes://` antes do endereço do servidor |
| **Não consigo escolher o nome do usuário** | neste servidor o nome é gerado pelo painel | usar o nome que a lista mostra |
| **O usuário FTP não vê as outras pastas da conta** | ele fica preso ao diretório inicial | trocar o **Diretório inicial** pelo lápis |
| **A pasta nova ainda não apareceu** | o painel cria a pasta em segundo plano | esperar um minuto. Na lista, a chave inglesa vira o quadrado verde |
| **Excluí o usuário e ele continua conectado** | a exclusão barra a próxima entrada, e não a conexão aberta | pedir à empresa que administra o servidor que encerre a sessão |

## Ver também

* [Gerenciador de Arquivos](/keyhelp/gerenciador-de-arquivos), para ver e mexer nas mesmas pastas pelo navegador
* [Painel de Controle](/keyhelp/painel-de-controle), onde aparece o **Nome de usuário do sistema**, o do acesso FTP principal
* [Estatísticas](/keyhelp/estatisticas), com o tráfego de FTP da conta
* [Servidor de FTP (área do administrador)](/keyhelp-admin/servidor-de-ftp), a exigência de criptografia e a política de nomes
* [Sessões Ativas (área do administrador)](/keyhelp-admin/sessoes-ativas), onde o administrador vê e encerra as conexões de FTP


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.