Conecte um bucket compatível com S3 ao armazenamento externo do Nextcloud.

Para exibir um bucket compatível com S3 no Nextcloud, habilite o aplicativo de suporte a armazenamento externo incluído, adicione uma montagem do Amazon S3 nas configurações de administração e insira o bucket, a chave de acesso, a chave secreta e os detalhes do endpoint do provedor. Para provedores que não sejam da Amazon, o nome do host e o formato do caminho geralmente são os campos que exigem mais atenção. Confirme se a montagem está verde e, em seguida, teste com um arquivo descartável antes de conceder acesso mais amplo.

O que preparar

Este procedimento cria uma montagem externa: o Nextcloud se conecta a um bucket existente e o apresenta como uma pasta em Arquivos. Ele não migra arquivos para o bucket, não define o bucket como o armazenamento primário do Nextcloud nem substitui o diretório de dados do Nextcloud.

• Acesso de administrador: A montagem em todo o sistema é configurada nas configurações de administração do Nextcloud.
• Nome e credenciais do bucket: Obtenha um ID de chave de acesso S3 e uma chave de acesso secreta do provedor de armazenamento. Dê preferência a uma chave dedicada com apenas as permissões necessárias para este bucket e suas operações pretendidas.
• Detalhes da conexão: Obtenha o nome de host genérico do endpoint S3 e, se o provedor exigir, a região e o formato do caminho. Não cole um URL específico do bucket onde o nome de host é solicitado.
• Rede e TLS: O servidor Nextcloud deve conseguir alcançar o endpoint. Use HTTPS, a menos que o provedor tenha um motivo específico e documentado para outra configuração.

O Manual de Administração do Nextcloud 35 documenta o backend do Amazon S3 para o Amazon S3 e serviços compatíveis. Os provedores diferem em seu comportamento da API do S3, formato do endpoint, região de assinatura e permissões necessárias; portanto, consulte a página de configuração do seu provedor para obter esses valores. Comece com um bucket novo ou vazio, ou com um prefixo de teste claramente isolado, caso não tenha certeza de como os objetos existentes serão exibidos.

Habilitar suporte para armazenamento externo

1. Faça login como administrador do Nextcloud e abra Aplicativos .
2. Localize o aplicativo de suporte a armazenamento externo incluído e ative-o, caso esteja desativado. O aplicativo está incluído no Nextcloud, mas vem desativado por padrão.
3. Abra o menu do seu perfil, escolha Configurações e selecione Armazenamento externo em Administração.

Se o backend não aparecer no menu suspenso de armazenamento, verifique se o aplicativo está ativado e se sua conta possui privilégios de administrador. Os rótulos do menu podem variar ligeiramente entre as versões; use a versão correspondente do Manual de Administração do Nextcloud se sua instalação não for a versão 35.

Adicione e configure o suporte S3.

1. Na nova linha de armazenamento, dê ao ponto de montagem um nome de pasta simples , como Archive. Este é o nome que os usuários veem no Nextcloud; não é um nome de bucket nem um caminho. Não inclua barras.
2. Selecione Amazon S3 no menu suspenso de armazenamento em segundo plano e Chave de acesso como método de autenticação.
3. Insira o nome do bucket, o ID da chave de acesso e a chave de acesso secreta exatamente como foram fornecidos. Evite espaços adicionados durante o processo de copiar e colar. Trate a chave secreta como uma senha; não a inclua em um ticket público, histórico do shell ou captura de tela de artigo.
4. Para armazenamento hospedado na Amazon, insira a região do bucket. Para um serviço que não seja da Amazon, insira o nome de host genérico do S3 (o host do endpoint, sem o prefixo do bucket). Preencha a região se o provedor exigir especificamente uma região de assinatura; siga a documentação do provedor quando ele usar um valor como `<região>` auto.
5. Mantenha a opção "Ativar SSL" selecionada para HTTPS. Deixe a porta no padrão, a menos que o provedor especifique uma porta diferente.
6. Experimente primeiro o estilo de solicitação de host virtual padrão. Habilite o Estilo de Caminho quando o provedor exigir solicitações no formato ` <path> https://endpoint.example/bucket` em vez de `<path>` https://bucket.endpoint.example. O guia do S3 do provedor é a fonte de referência para essa configuração.
7. Desative a autenticação Legacy (v2), a menos que o provedor a exija explicitamente. O Nextcloud documenta a v4 como padrão e afirma que a v2 raramente é necessária.
8. Em "Disponível para" , selecione apenas os usuários ou grupos que devem ver este ponto de montagem. Um ponto de montagem criado nas configurações de administrador fica amplamente disponível por padrão; portanto, restrinja seu acesso antes de expor dados privados ou compartilhados.

Os campos obrigatórios são salvos após o preenchimento. Um indicador de status verde significa que o Nextcloud consegue se conectar; um indicador amarelo ou vermelho significa que não foi possível validar a montagem. Se o erro persistir, clique no ícone de status ou recarregue a página de administração para verificar novamente. O Nextcloud observa que uma montagem com erro pode ficar indisponível por dez minutos.

Escolha o comportamento de montaria deliberadamente.

Abra o menu de opções da linha para revisar as configurações de nível de montagem. O compartilhamento está desativado por padrão; ative-o somente se os usuários precisarem compartilhar arquivos dessa montagem. Você também pode definir a montagem como somente leitura para dados de referência, ativar visualizações prévias quando úteis e escolher com que frequência o Nextcloud verifica alterações externas. Essas opções afetam o comportamento da montagem dentro do Nextcloud; elas não alteram a política de buckets do provedor de armazenamento.

Não assuma que adicionar um ponto de montagem faça com que as alterações diretas no console do provedor apareçam imediatamente no Nextcloud. O Nextcloud mantém um cache de arquivos. Quando arquivos são criados, alterados ou excluídos fora do Nextcloud, a listagem em cache pode permanecer desatualizada até que uma verificação a atualize. Para o S3 e outros backends sem notificações push do provedor, o Nextcloud documenta verificações periódicas com o ID `<ID>` occ files_external:scan <mount_id>. Encontre o ID com ` occ files_external:list<ID>`; execute o OCC a partir do diretório de instalação do Nextcloud como o usuário do servidor web, adaptando o usuário e o wrapper de comando à sua instalação.

Solucione problemas de conexão

• Status vermelho ou amarelo: Verifique novamente a grafia exata do bucket, o par de chaves, o nome do host do endpoint, a região/região de assinatura e o acesso à rede do lado do servidor. Confirme o acesso DNS e HTTPS de saída do host Nextcloud.
• Erro de assinatura ou autorização: Certifique-se de que a chave esteja ativa e tenha permissão para listar o bucket e executar as operações necessárias aos usuários. Verifique se a região corresponde às instruções de assinatura do provedor. Uma credencial que consegue fazer upload, mas não consegue listar ou inspecionar o bucket, ainda pode falhar no teste de conexão do Nextcloud.
• Endpoint ou bucket não encontrado: Verifique se o nome do host contém o endpoint genérico e não uma URL com o bucket já incluído. Consulte o provedor para saber se ele exige solicitações no formato de caminho, ative essa opção e verifique novamente.
• A conexão funciona, mas os objetos existentes estão faltando: verifique se a chave pode listar o bucket e se os nomes dos objetos usam caminhos compatíveis. O Nextcloud avisa que chaves S3 que contêm delimitadores repetidos, como vírgulas Photos//cat.png, e seus conteúdos são ignorados.
• Arquivos alterados diretamente no provedor estão faltando: Execute uma verificação de armazenamento externo para o ponto de montagem. Mantenha renomeações e movimentações rotineiras dentro do Nextcloud sempre que possível; uma nova verificação pode interpretar uma renomeação remota como uma exclusão mais um novo arquivo, o que pode resultar na perda de compartilhamentos, tags, comentários ou histórico de atividades do Nextcloud vinculados à entrada antiga.

Verifique se a montagem está segura.

Aguarde até que o status da montagem fique verde. Abra o app Arquivos como um usuário com permissões adequadas, abra a pasta da montagem, carregue um pequeno arquivo de teste com nome exclusivo, baixe-o e exclua-o pelo Nextcloud. Se possível, verifique se o objeto esperado aparece na visualização do bucket do provedor. Em seguida, teste com um segundo usuário somente se o acesso em grupo fizer parte do plano. Por fim, confirme se um usuário fora do escopo selecionado não consegue visualizar a montagem. Remova o objeto de teste e mantenha as credenciais com privilégios mínimos.

Para obter descrições de campos específicas da versão, consulte o guia de configuração do Nextcloud 35 no Amazon S3 e o guia de administração de armazenamento externo do Nextcloud 35 .