Como montar um dispositivo de armazenamento compatível com S3 como armazenamento externo no Nextcloud

Para montar um bucket compatível com S3 no Nextcloud, habilite o aplicativo integrado de suporte a armazenamento externo, adicione uma entrada de armazenamento do Amazon S3 nas configurações de armazenamento externo do administrador e forneça as credenciais do bucket, além dos detalhes do endpoint do provedor. O Nextcloud usa o backend do Amazon S3 para serviços compatíveis; você não precisa instalar um aplicativo separado para cada provedor de S3. O nome do host, a região e o formato do caminho exatos dependem do provedor de armazenamento de objetos.

Este guia segue a documentação atual de administração do Nextcloud para os backends S3 e de armazenamento externo, verificada em 6 de outubro de 2026. Os rótulos podem variar ligeiramente entre versões de servidor e temas. Um ponto de montagem pode estar acessível, mas ainda assim se comportar de maneira diferente de uma pasta local do Nextcloud, especialmente quando arquivos são alterados diretamente no bucket.

O que você deve verificar antes de adicionar o balde?

Confirme esses detalhes com seu provedor S3 antes de abrir as configurações do Nextcloud:

• O nome do bucket e as credenciais para uma chave de acesso.
• O nome de host genérico do endpoint S3 do provedor, como s3.example.net. Use o próprio endpoint, não uma URL específica do bucket que já contenha o nome do bucket.
• A região ou região de assinatura, caso o provedor exija uma.
• Se as solicitações devem usar o estilo virtual-hospedado ( https://bucket.endpoint/) ou o estilo de caminho ( https://endpoint/bucket).
• A porta HTTPS, normalmente 443, e se o seu servidor consegue alcançar esse ponto de extremidade através do firewall e do DNS.

Crie uma chave de acesso dedicada para este ponto de montagem e limite suas permissões ao bucket e às ações necessárias. Não cole segredos em um ticket, captura de tela ou histórico do shell. A configuração do S3 no Nextcloud exige um ID de chave de acesso e uma chave de acesso secreta; ela não valida automaticamente todas as políticas de permissão específicas do provedor.

Isso é o mesmo que definir o S3 como armazenamento primário do Nextcloud?

Não. Um ponto de montagem de armazenamento externo expõe um bucket existente como uma pasta dentro do Nextcloud. Isso é útil quando você deseja navegar ou gerenciar arquivos em um bucket, mantendo-o acessível a outras ferramentas do S3. O armazenamento de objetos primário é uma arquitetura diferente, que abrange todo o servidor, com premissas operacionais distintas. Se precisar escolher entre eles, consulte a documentação do Nextcloud sobre armazenamento de objetos primário antes de alterar o design de dados de um ambiente de produção.

Como adiciono o suporte compatível com S3 na interface web?

1. Ative o suporte para armazenamento externo.

Inicie sessão como administrador do Nextcloud, abra a secção "Aplicações" e ative a aplicação de suporte para armazenamento externo incluída . Esta aplicação está incluída no Nextcloud, mas pode estar desativada por predefinição. Se já estiver ativada, continue para as definições de armazenamento.

2. Abra a página de armazenamento externo do administrador.

Abra o menu do seu perfil, selecione Configurações e, em seguida, encontre Armazenamento externo na seção Administração. Esta página é para montagens configuradas pelo administrador. Um armazenamento que um usuário individual configura em suas configurações pessoais está disponível apenas para esse usuário; uma montagem administrativa pode estar disponível para usuários e grupos selecionados.

3. Crie uma montagem e escolha o backend S3.

Na nova linha, insira um nome de pasta simples , por exemplo Archive. Este será o nome da pasta visível no Nextcloud e deve ser um nome, não um caminho; não inclua barras. No seletor de tipo de armazenamento, escolha Amazon S3 . Em Autenticação, escolha Chave de acesso .

4. Insira o bucket e as credenciais.

Insira o nome exato do bucket, o ID da chave de acesso e a chave de acesso secreta fornecida pelo seu provedor. Trate a chave secreta como uma senha. A documentação do Nextcloud observa que os nomes de bucket para este backend devem atender aos requisitos de nomenclatura do AWS S3, mesmo quando o serviço estiver hospedado em outro local; sublinhados não são aceitos. Se o nome do bucket do provedor incluir um sublinhado, verifique se o provedor oferece um nome de bucket compatível antes de solucionar problemas com as credenciais.

5. Defina o endpoint, a região e o estilo da solicitação.

Para o S3 hospedado pela Amazon, especifique a região correta. Para um serviço que não seja da Amazon, defina o nome de host genérico do provedor. Use os valores de endpoint e região publicados pelo provedor; não existe um valor de região universal para todos os produtos compatíveis com o S3.

O guia atual do Nextcloud para S3 especifica que se deve usar o nome de host genérico do endpoint para armazenamento que não seja da Amazon. Ele também descreve o endereçamento em formato de caminho como dependente do provedor. Não alterne o formato de caminho por tentativa e erro se você puder obter o modo de endereçamento esperado na documentação do S3 do seu provedor.

6. Restrinja quem pode usar o suporte.

Use a opção "Disponível para" para atribuir somente os usuários ou grupos do Nextcloud desejados. Uma montagem configurada pelo administrador pode, de outra forma, estar disponível para todos. Verifique também as opções da montagem após salvar: o modo somente leitura e os controles de compartilhamento podem ser apropriados para arquivos ou buckets compartilhados. O comportamento de compartilhamento pode afetar quem pode expor arquivos pelo Nextcloud, portanto, configure-o cuidadosamente.

7. Confirme se o Nextcloud consegue se conectar.

Quando os campos obrigatórios são válidos, a linha de armazenamento é salva automaticamente. Um indicador de status verde significa que o Nextcloud pode usar o armazenamento configurado; vermelho ou amarelo indica que a conexão ou a configuração precisa de atenção. A página de administração pode marcar temporariamente um armazenamento com falha como indisponível por dez minutos. Clique no ícone de status ou recarregue a página para acionar outra verificação após corrigir um valor.

8. Teste com um arquivo inofensivo

Abra o arquivo como um usuário que tenha acesso ao ponto de montagem. Confirme se a pasta aparece, crie ou carregue um pequeno arquivo de teste, baixe-o novamente e exclua-o se o bucket for projetado para ser gravável. Se o ponto de montagem for projetado para ser somente leitura, teste se os usuários podem ler os arquivos e verifique se as gravações estão bloqueadas. Um indicador verde por si só não confirma que todas as permissões de usuário ou o comportamento de leitura/gravação pretendido estejam corretos.

Como posso verificar a montagem a partir da linha de comando?

Para instalações onde você administra o servidor, o Nextcloud também fornece occcomandos para armazenamento externo. Execute os comandos a partir do diretório de instalação do Nextcloud e use a conta de servidor web apropriada para o seu sistema. Em muitas instalações Linux, é `sudo` www-data, mas instalações de pacotes e contêineres podem ser diferentes.

sudo -E -u www-data php occ files_external:list
sudo -E -u www-data php occ files_external:verify <mount_id>

Substitua <mount_id>pelo ID exibido pelo comando de listagem. Uma verificação bem-sucedida confirma que o Nextcloud pode estabelecer a conexão configurada naquele momento. Para o Nextcloud AIO ou outra implantação em contêiner, use o método documentado dessa implantação para executar o comando occdentro do contêiner do aplicativo, em vez de copiar o comando do host sem alterações.

Por que a montagem pode falhar mesmo quando os valores parecem corretos?

Quando um serviço usa um certificado autoassinado, o servidor precisa confiar nesse certificado; desativar a verificação de certificados não é uma alternativa segura. O manual atual do Nextcloud também alerta que delimitadores repetidos, como `\`, Photos//cat.pngnão são suportados e que os prefixos afetados podem ser ignorados.

O que acontece quando os arquivos são alterados diretamente no bucket?

O Nextcloud mantém um cache de arquivos interno para armazenamento externo. Se outra ferramenta adicionar, editar ou excluir objetos diretamente no S3, o Nextcloud pode não detectar a alteração imediatamente. O guia atual de Armazenamento Externo recomenda novas verificações periódicas para tipos de armazenamento sem notificações push. Você pode encontrar o ID de montagem com files_external:listo comando:

sudo -E -u www-data php occ files_external:scan <mount_id>

Agende uma verificação de acordo com a atualização necessária e a carga que seu servidor suporta. Uma verificação não é o mesmo que notificações instantâneas de alterações. O Nextcloud também documenta um risco relacionado a metadados: uma nova verificação pode interpretar uma renomeação externa como um objeto antigo excluído mais um novo objeto, removendo compartilhamentos, tags, comentários e histórico de atividades associados à entrada antiga no Nextcloud. Por esse motivo, realize renomeações pelo Nextcloud quando a preservação desses metadados for importante.

Como saber se a configuração está completa?

• O ponto de montagem S3 exibe um status verde na página de armazenamento externo do administrador.
• Usuários do grupo pretendido podem ver a montagem, enquanto usuários não atribuídos não podem.
• Um teste de upload, download e exclusão funciona conforme o esperado — ou as gravações são bloqueadas para uma montagem somente leitura.
• O servidor consegue detectar alterações feitas fora do Nextcloud após o intervalo de verificação configurado.
• As credenciais são armazenadas apenas na configuração do Nextcloud e na conta do provedor, e o acesso é limitado ao bucket necessário.

Para detalhes específicos da versão, consulte o guia oficial de armazenamento externo S3 do Nextcloud , o guia de administração de armazenamento externo e a referência oficial do comando occ . Os provedores variam em termos de endpoint, região, permissões e requisitos de endereçamento, portanto, a documentação de configuração do S3 deles continua sendo a fonte oficial para esses valores.