Como montar um compartilhamento Samba/CIFS no servidor ownCloud
As notas de lançamento atuais do ownCloud Classic listam a versão 11.0.1 como uma versão de segurança e recomendam a atualização. A versão principal 11.0.0 também elevou a versão mínima do PHP para 8.3 e removeu recursos obsoletos; portanto, os administradores que atualizarem da versão 10.x devem verificar primeiro a compatibilidade do PHP e dos aplicativos. O fluxo de trabalho SMB/CIFS em si permanece como uma montagem de armazenamento externo; este guia segue a documentação do SMB do ownCloud Server 10.16, e os rótulos ou dependências do menu podem ser diferentes na versão 11.x.
Para conectar um compartilhamento de arquivos Samba ou Windows, habilite o Suporte a Armazenamento Externo, certifique-se de que o servidor ownCloud consiga acessar o servidor SMB e adicione uma montagem SMB/CIFS nas configurações de armazenamento do administrador. Isso cria uma entrada de armazenamento remoto dentro do ownCloud; o compartilhamento não é montado no sistema de arquivos Linux /etc/fstab. Use essa abordagem quando os usuários precisarem acessar os arquivos pela página Arquivos do ownCloud e as permissões precisarem ser controladas pela montagem do ownCloud e pela conta SMB.
O que você precisa antes de começar
Acesso de administrador ao servidor ownCloud e ao servidor de arquivos SMB.
O nome ou endereço DNS do servidor SMB, o nome do compartilhamento, a subpasta opcional e qualquer domínio ou grupo de trabalho necessário para o login.
Uma conta SMB dedicada com apenas as permissões de leitura ou gravação necessárias aos usuários do ownCloud. A conta também deve ser permitida pelas ACLs de compartilhamento e sistema de arquivos no servidor SMB.
Uma rota de rede e uma política de firewall que permitam ao host ownCloud alcançar o servidor SMB.
A dependência de suporte SMB exigida pelo seu pacote ownCloud. Para uma instalação manual no Linux, o guia do ownCloud correspondente pode exigir o smbclientmódulo PHP; imagens de contêiner e instalações empacotadas podem fornecer dependências diferentes. Consulte o guia para obter as versões exatas do seu ownCloud e PHP em vez de copiar um comando de pacote antigo.
A documentação do ownCloud descreve um teste de acesso pela linha de comando antes de configurar o armazenamento externo. Em uma instalação Linux onde o recurso smbclientestá disponível, teste primeiro a descoberta do servidor e as credenciais. O prompt de senha é interativo, portanto a senha não fica armazenada no histórico do shell.
Se isso falhar, resolva problemas de DNS, roteamento, firewall, sintaxe de domínio ou permissões de compartilhamento antes de solucionar problemas no ownCloud. Um servidor que não consegue acessar o compartilhamento não pode disponibilizá-lo aos usuários.
Ative o suporte para armazenamento externo nos aplicativos antes de adicionar uma montagem SMB/CIFS nas configurações de armazenamento do administrador.
Monte o compartilhamento SMB/CIFS no ownCloud.
1. Ativar suporte para armazenamento externo
Inicie sessão como administrador do ownCloud. Abra Definições > Aplicações , encontre Suporte para armazenamento externo e ative-o, caso ainda não esteja ativo. Em seguida, abra a página de administração de armazenamento, normalmente Definições > Administração > Armazenamento ou o equivalente na sua versão. Se também forem necessárias montagens externas criadas pelo utilizador, ative a configuração separada Permitir que os utilizadores montem armazenamento externo, apenas após rever o acesso à rede que isso concede aos utilizadores.
Para um compartilhamento administrado centralmente, configure-o na página de armazenamento administrativo. Os compartilhamentos administrativos podem estar disponíveis para todos os usuários por padrão, portanto, restrinja o campo " Disponível para " às pessoas ou grupos desejados antes de confiar que o conteúdo do compartilhamento seja privado.
2. Adicione um backend SMB/CIFS
Na tabela de armazenamento externo, selecione SMB/CIFS em Adicionar armazenamento . Insira um nome amigável para a pasta , como Projects. Este nome é o ponto de montagem que os usuários veem no ownCloud. Não é o nome do compartilhamento do servidor SMB.
Escolha SMB/CIFS como o backend de armazenamento externo; isso adiciona uma linha de montagem cujos campos de conexão dependem do método de autenticação.
3. Insira o servidor e o caminho de compartilhamento.
Preencha os campos indicados para o backend SMB. No guia do ownCloud 10.16, estes incluem o URL do servidor, o nome do compartilhamento, a subpasta remota, os usuários ou grupos autorizados a usar o ponto de montagem e, quando necessário, um domínio. Por exemplo, um servidor chamado `<nome_do_servidor>` fileserver.example.com, um compartilhamento chamado `<nome_do_compartilhamento> projects` e uma subpasta chamada `<nome_da_subpasta>` teamexporiam essa subpasta remota no ponto de montagem do ownCloud. Deixe a subpasta remota em sua raiz padrão quando todo o compartilhamento precisar ser montado.
Insira o valor do servidor no formato esperado pelo campo exibido na sua versão. Não cole um URL completo do ownCloud visível para o usuário ou um caminho local, como `/ /mnt/shareusername/`, no campo do servidor SMB. Se o Active Directory exigir um domínio, use o campo de domínio ou o formato de domínio e nome de usuário documentado para o método de autenticação escolhido.
Mapeie o nome da pasta ownCloud para o servidor, compartilhamento e subpasta opcional; o nome da pasta visível é o ponto de montagem que os usuários abrem.
4. Escolha como as credenciais serão fornecidas.
Escolha o método de autenticação que melhor se adapta ao modelo de conta. Uma conta de serviço gerenciada centralmente é útil quando o mesmo compartilhamento precisa funcionar para um grupo de usuários. Insira o nome de usuário e a senha na configuração SMB e adicione um domínio somente se o servidor de arquivos exigir. Armazene a senha no fluxo de configuração protegido do ownCloud e use uma conta dedicada em vez de um login de administrador pessoal.
O método "Credenciais de login, salvar na sessão" utiliza as credenciais de login do ownCloud de cada usuário para o compartilhamento remoto e não as armazena no servidor. O ownCloud documenta importantes limitações: o compartilhamento direto desse ponto de montagem e a verificação de arquivos em segundo plano não funcionam normalmente porque o ownCloud não retém as credenciais de armazenamento. Para acesso compartilhado em equipe ou operações automatizadas em segundo plano, escolha um método de credenciais compatível que armazene as credenciais necessárias com segurança.
Forneça uma conta SMB dedicada e adicione um domínio somente quando a configuração de autenticação do servidor de arquivos exigir.
5. Limitar o acesso e definir as opções de montagem
Use a opção "Disponível para" para escolher os usuários ou grupos do ownCloud que devem ter acesso ao compartilhamento. Evite deixar um compartilhamento administrativo disponível para todos quando ele contiver arquivos restritos. As permissões do próprio servidor SMB ainda se aplicam: um usuário do ownCloud não pode obter mais acesso a arquivos do que o permitido pela conta SMB e pelas ACLs do servidor.
Abra as opções do ponto de montagem para definir o modo Somente Leitura quando os usuários devem navegar ou baixar arquivos sem alterá-los. O compartilhamento externo do ponto de montagem está desativado por padrão nas opções de administração do ownCloud; habilite a opção Habilitar Compartilhamento somente se os usuários precisarem compartilhar arquivos deste ponto de montagem por meio do ownCloud e se o seu modelo de permissões permitir. Selecionar usuários no campo de disponibilidade do ponto de montagem e habilitar o compartilhamento de arquivos são decisões separadas.
Restrinja o acesso administrativo aos usuários ou grupos do ownCloud que devem acessar os arquivos remotos.Defina o ponto de montagem como Somente Leitura quando não houver intenção de editá-lo; decida separadamente se os usuários podem compartilhar arquivos a partir dele.
6. Verifique o estado da montagem
Os campos obrigatórios são marcados na tabela de armazenamento do administrador, e o ownCloud salva a montagem após o fornecimento da configuração necessária. Um ponto verde indica que o armazenamento externo está pronto. Um ícone vermelho ou amarelo significa que o ownCloud não conseguiu se conectar; verifique novamente o nome do host, o compartilhamento, a subpasta, as credenciais, as permissões da conta e a disponibilidade da rede. A documentação informa que um problema de conexão pode deixar a montagem marcada como indisponível por dez minutos. Clique no ícone de status ou recarregue a página do administrador para tentar novamente após corrigir a causa.
Verifique a montagem como administrador e como usuário.
Abra a página Arquivos do ownCloud como um usuário do grupo permitido e confirme se a pasta de montagem aparece. Teste com um arquivo inofensivo: abra ou baixe um arquivo existente e, se a montagem for gravável, crie ou carregue um pequeno arquivo de teste, renomeie-o e remova-o. Confirme se as mesmas alterações aparecem no servidor SMB. Se a montagem for somente leitura, verifique se as leituras funcionam e se as gravações são bloqueadas conforme o esperado.
Para diagnóstico via linha de comando, occas ferramentas do ownCloud podem listar montagens externas e verificar uma montagem pelo seu ID. Execute os comandos como a conta do servidor web e a partir do diretório de instalação do ownCloud; adapte a conta e o caminho para o seu sistema. Primeiro, obtenha o ID da montagem na lista e, em seguida, verifique-o. Não exponha as senhas de montagem na saída de comandos compartilhados.
O número 3é apenas um exemplo. Substitua-o pelo ID retornado pela sua própria files_external:listsaída. Em contêineres, execute occcom o comando de contêiner documentado da implantação, em vez de presumir que o host tenha o mesmo caminho ou usuário da web.
Como usuário autorizado, confirme se o ponto de montagem aparece em Arquivos e teste o acesso usando um arquivo não crítico.Use o ID de montagem da sua própria saída do comando files_external:list ao executar files_external:verify; os caminhos e as contas de serviço variam de acordo com a instalação.
Solução de problemas pelo ponto de falha
O que você vê
O que verificar
SMB / CIFSestá faltando na lista de backend
Confirme se o suporte para armazenamento externo e o backend SMB estão ativados e, em seguida, verifique as dependências do seu pacote ownCloud e do ambiente de execução PHP. Reinicie o PHP ou o serviço web relevante após alterar os módulos PHP.
smbclientNão é possível listar o servidor ou compartilhamento.
Verifique o nome do servidor no host do ownCloud, o firewall e o roteamento, as credenciais, a sintaxe do domínio e as permissões tanto no compartilhamento quanto nos arquivos subjacentes.
A fileira de montagem permanece vermelha ou amarela.
Verifique novamente o URL SMB, o nome do compartilhamento, a subpasta remota, a conta e o caminho de rede. Se o host usar SELinux, consulte as diretrizes oficiais do ownCloud sobre SELinux para acesso de rede de saída antes de alterar a política.
O suporte é verde, mas o usuário não consegue vê-lo.
Verifique a disponibilidade do usuário/grupo selecionado e confirme se a pessoa é realmente membro desse grupo. Montarias de administrador e montarias pessoais têm escopos diferentes.
Os arquivos adicionados diretamente no servidor SMB não aparecem imediatamente.
O ownCloud pode não detectar todas as alterações remotas de uma só vez, principalmente em níveis mais profundos da hierarquia de pastas. Consulte as orientações sobre tarefas em segundo plano para armazenamento externo e as limitações de autenticação para o mecanismo selecionado.
Limitações ao planejamento para
Uma montagem externa SMB/CIFS é uma conexão ativa com outro servidor, não uma cópia dos dados dentro do ownCloud. Se o servidor SMB estiver indisponível, a montagem também poderá ficar indisponível no ownCloud. Alterar ou remover uma montagem externa não remove necessariamente todas as entradas de metadados associadas à configuração antiga; portanto, evite excluir e recriar montagens de produção repetidamente durante os testes.
A escolha da autenticação afeta a automação. Credenciais de sessão não estão disponíveis para processos em segundo plano da mesma forma que credenciais de serviço armazenadas. Além disso, alterações feitas diretamente por meio de outro cliente SMB podem não ser refletidas imediatamente na visualização de arquivos do ownCloud. Se a descoberta confiável em segundo plano, o compartilhamento ou o acesso por usuário forem requisitos, teste esses comportamentos específicos com o backend e a versão do ownCloud selecionados antes da implementação.
Documentação verificada em 6 de outubro de 2026. As dependências de pacotes e os rótulos exatos dos menus variam de acordo com a versão do ownCloud, a distribuição Linux e a imagem do contêiner. Siga o guia de instalação e administração correspondente à versão que você está usando.