Montar um compartilhamento SMB/CIFS no ownCloud sem um ponto de montagem Linux.

Para acessar um compartilhamento Windows ou Samba no ownCloud Server, habilite o aplicativo Suporte a Armazenamento Externo e adicione uma montagem de armazenamento SMB/CIFS na página de administração do ownCloud. Use o endereço do servidor, o nome do compartilhamento e credenciais SMB válidas; geralmente, não é necessário montar o compartilhamento com o Linux mount.cifsprimeiro.

Este método expõe os arquivos de rede existentes na interface do ownCloud Files, preservando as permissões impostas pelo servidor SMB. As instruções abaixo se aplicam à interface clássica de armazenamento externo do ownCloud Server, documentada para as versões 10.16 e 11.0, e não ao ownCloud Infinite Scale.

1. Verifique os pré-requisitos do compartilhamento SMB e do ownCloud.

Você precisa de acesso de administrador ao ownCloud, um servidor SMB acessível, um compartilhamento ao qual você tenha autorização de acesso e uma conta SMB com as permissões de leitura e gravação necessárias. Mantenha a porta TCP 445 acessível entre o ownCloud e o servidor de arquivos, preferencialmente por meio de uma rede privada confiável ou VPN, em vez de expor o SMB à internet pública.

Para um exemplo concreto, suponha que o servidor SMB seja files.internal.example, o compartilhamento seja Projectse a conta de serviço seja ACME\oc-share. A pasta a ser exibida no ownCloud será Team Projects. Esses são valores fictícios; substitua-os pelos detalhes reais do seu servidor.

Em uma instalação Linux convencional, o cliente Samba e a extensão PHP SMB apropriada podem ser necessários. Por exemplo, em um host baseado em Debian, instale o cliente de teste de linha de comando:

sudo apt update
sudo apt install smbclient

Verifique qual versão do PHP e método de instalação o ownCloud utiliza antes de instalar uma extensão. As instruções de instalação do ownCloud para o Ubuntu Server 10.16 descrevem php7.4-smbclienta configuração para PHP 7.4; utilize esse pacote somente se ele corresponder ao seu ambiente PHP e repositório suportados. Após habilitar a extensão, reinicie o serviço PHP ou o servidor web que executa o ownCloud e verifique o carregamento dos módulos com o comando ` php -m | grep -i smbclientphp -m`. O comando verifica o PHP da linha de comando; o processo web pode ter uma configuração separada.

Para a imagem Docker oficial do ownCloud Server 11.0, a documentação do SMB afirma que as dependências de tempo de execução do SMB estão incluídas, embora a imagem não inclua o smbclientcomando para testes manuais. Não assuma que os mesmos comandos de pacote do host se aplicam a todas as imagens de contêiner.

2. Teste o acesso a partir do servidor ownCloud.

Antes de alterar as configurações do ownCloud, teste a resolução de nomes, a autenticação e o próprio compartilhamento a partir do host do ownCloud ou de seu ambiente de rede. Em um host com smbclient, execute:

smbclient -L //files.internal.example -U 'ACME/oc-share'
smbclient //files.internal.example/Projects -U 'ACME/oc-share' -c 'ls'

Digite a senha da conta SMB quando solicitado, em vez de inseri-la na linha de comando. O primeiro comando lista os compartilhamentos disponíveis; o segundo verifica o acesso ao compartilhamento específico. A listagem não comprova a permissão de gravação. Se o comando falhar, confirme o nome ou IP do servidor, a grafia do compartilhamento, as credenciais, o domínio, as regras do firewall e as permissões efetivas no servidor Windows ou Samba antes de prosseguir. O guia do ownCloud SMB/CIFS também recomenda realizar testes smbclientantes da configuração.

3. Ativar suporte para armazenamento externo

1. Faça login no ownCloud com uma conta de administrador.
2. Abra as Configurações → Aplicativos e verifique se o suporte para armazenamento externo está ativado.
3. Acesse Configurações → Administrador → Armazenamento (os rótulos de navegação podem variar ligeiramente entre as interfaces).
4. Ative o armazenamento externo se a página apresentar essa caixa de seleção e use Adicionar armazenamento para selecionar SMB/CIFS .

Você não precisa habilitar a opção " Permitir que os usuários montem armazenamento externo" apenas para criar um compartilhamento gerenciado pelo administrador. Essa configuração separada permite que os usuários criem seus próprios compartilhamentos, incluindo potencialmente conexões com serviços de rede que o administrador não exporia de outra forma. Consulte o manual de Configuração de Armazenamento Externo do ownCloud .

4. Configure a montagem SMB/CIFS

Na nova linha de armazenamento, forneça as informações de conexão. O exemplo a seguir mantém o nome do compartilhamento SMB separado do nome da pasta que os usuários veem no ownCloud.

Insira oc-shareo nome de usuário ACMEno campo Domínio. Não insira o nome de usuário //files.internal.example/Projectsno campo Host e não confunda o nome do compartilhamento com uma subpasta opcional. Para uma subpasta remota, o ownCloud permite $userselecionar um diretório existente que corresponda ao nome de usuário atual do ownCloud; ele não cria esse diretório.

Para uma conta de serviço comum, o uso de nome de usuário e senha é simples, mas o acesso a ela depende das permissões SMB da conta. Se os usuários se autenticarem via SMB com suas próprias credenciais do ownCloud, a opção "Credenciais de login, salvar na sessão" pode ser mais adequada. No entanto, o ownCloud documenta limitações importantes relacionadas às credenciais de sessão: varreduras em segundo plano e compartilhamento direto do armazenamento montado não funcionam da mesma forma que com credenciais armazenadas. Escolha com base nos requisitos reais de autenticação e varredura, e não apenas na conveniência. Consulte Mecanismos de Autenticação de Armazenamento Externo .

Restrinja o acesso aos usuários ou grupos do ownCloud pretendidos; caso contrário, um ponto de montagem criado pelo administrador estará disponível para todos os usuários por padrão. Se a equipe precisar apenas navegar pelos arquivos, ative a opção "Somente leitura" do ponto de montagem e também imponha acesso somente leitura no servidor SMB. Deixe o compartilhamento do ponto de montagem desativado, a menos que sua política de acesso exija isso.

5. Resolva o problema de um ponto de montagem indisponível antes de usá-lo.

Após o preenchimento dos campos obrigatórios, o ownCloud salva automaticamente a linha de armazenamento. O indicador de status verde significa que a conexão está pronta; um indicador vermelho ou amarelo requer investigação adicional. O ownCloud pode marcar um armazenamento externo com falha como indisponível por dez minutos, portanto, clique no indicador de status ou recarregue a página de administração após resolver o problema.

• Falha na autenticação: verifique novamente a senha SMB, o domínio, o formato do nome de usuário, o estado de bloqueio da conta e as permissões de compartilhamento. Compare com o smbclientteste usando a mesma conta.
• Tempo limite da conexão excedido: verifique o DNS, o roteamento, o acesso do firewall à porta TCP 445 e se o serviço SMB está em execução. Teste a partir da mesma rede de contêineres se o ownCloud estiver em contêineres.
• O backend SMB/CIFS está ausente: confirme se o aplicativo de suporte a armazenamento externo está ativado e se a extensão SMB necessária está carregada no ambiente de execução PHP que serve o ownCloud, quando aplicável.
• Algumas pastas estão ausentes: verifique as permissões da subpasta remota e do sistema de arquivos SMB. Uma atribuição de grupo do ownCloud não pode conceder acesso negado pelo servidor remoto.
• Arquivos alterados externamente não aparecem: revise a frequência de verificação do sistema de arquivos, as tarefas em segundo plano e o mecanismo de varredura do ponto de montagem. Credenciais SMB somente de sessão impedem varreduras em segundo plano; evite o agendamento occ files:scancomo uma suposta solução para essa limitação.

Uma montagem CIFS em nível de kernel exposta ao ownCloud como armazenamento local geralmente não é a alternativa correta. O ownCloud alerta que, se essa montagem do sistema de arquivos desaparecer, ele poderá ver um diretório local vazio e propagar eventos de exclusão. Use o backend SMB/CIFS direto; consulte o aviso oficial sobre armazenamento local .

6. Verifique o compartilhamento em Arquivos.

Inicie sessão como um utilizador autorizado em Disponível para . Abra o ficheiro Arquivos e localize Projetos de Equipa . Navegue até um diretório existente e abra um pequeno ficheiro de teste. Se a conta SMB e a montagem ownCloud permitirem escrita, carregue um ficheiro de teste inofensivo e verifique se este aparece no servidor SMB; elimine-o após a verificação. Para montagens só de leitura, confirme se a modificação está bloqueada.

Por fim, verifique se a linha de armazenamento permanece verde após a atualização da página e se outro usuário fora do grupo permitido não consegue visualizar a montagem. Essas verificações garantem que o ownCloud consiga acessar o compartilhamento SMB correto, que a conta remota tenha o acesso pretendido e que a montagem esteja exposta apenas ao público-alvo pretendido.