Para acceder a un recurso compartido de Windows o Samba en ownCloud Server, habilite la aplicación de soporte para almacenamiento externo y agregue un punto de montaje de almacenamiento SMB/CIFS desde la página de administración de ownCloud. Utilice la dirección del servidor del recurso compartido, el nombre del recurso compartido y credenciales SMB válidas; por lo general, no es necesario montar el recurso compartido con Linux mount.cifspreviamente.
Este método expone los archivos de red existentes dentro de la interfaz de archivos de ownCloud, conservando los permisos impuestos por el servidor SMB. Las instrucciones que se describen a continuación se aplican a la interfaz clásica de almacenamiento externo de ownCloud Server, documentada para las versiones 10.16 y 11.0, no a ownCloud Infinite Scale.
1. Compruebe los requisitos previos del recurso compartido SMB y ownCloud.
Necesitas acceso de administrador a ownCloud, un servidor SMB accesible, una carpeta compartida a la que tengas autorización para acceder y una cuenta SMB con los permisos de lectura o escritura necesarios. Mantén el puerto TCP 445 accesible entre ownCloud y el servidor de archivos, preferiblemente a través de una red privada segura o una VPN, en lugar de exponer SMB a internet.
Por ejemplo, supongamos que el servidor SMB es files.internal.example, el recurso compartido es Projectsy la cuenta de servicio es ACME\oc-share. La carpeta que se mostrará en ownCloud será Team Projects. Estos son valores ficticios; sustitúyalos por los datos reales de su servidor.
En una instalación convencional de Linux, puede ser necesario el cliente Samba y la extensión de cliente SMB de PHP correspondiente. Por ejemplo, en un host basado en Debian, instale el cliente de prueba de línea de comandos:
sudo apt update
sudo apt install smbclient
Antes de instalar una extensión, compruebe la versión de PHP y el método de instalación que utiliza ownCloud. Las instrucciones de instalación de ownCloud Server 10.16 Ubuntu describen php7.4-smbclientla configuración para PHP 7.4; utilice ese paquete solo si coincide con su entorno y repositorio PHP compatibles. Tras habilitar la extensión, reinicie el servicio PHP o el servidor web que ejecuta ownCloud y compruebe la carga del módulo con php -m | grep -i smbclient. El comando comprueba PHP de línea de comandos; el proceso web puede tener una configuración independiente.
En la imagen oficial de Docker de ownCloud Server 11.0, la documentación de SMB indica que se incluyen las dependencias de SMB en tiempo de ejecución, aunque la imagen no incluye el smbclientcomando para realizar pruebas manuales. No asuma que los mismos comandos de host-package se aplican en todas las imágenes de contenedor.
2. Prueba el acceso desde el servidor ownCloud.
Antes de cambiar la configuración de ownCloud, pruebe la resolución de nombres, la autenticación y el propio recurso compartido desde el host de ownCloud o su entorno de red. En un host con smbclient, ejecute:
smbclient -L //files.internal.example -U 'ACME/oc-share'
smbclient //files.internal.example/Projects -U 'ACME/oc-share' -c 'ls'
Introduzca la contraseña de la cuenta SMB cuando se le solicite, en lugar de escribirla en la línea de comandos. El primer comando muestra los recursos compartidos disponibles; el segundo verifica el acceso al recurso compartido específico. La lista no garantiza el permiso de escritura. Si el comando falla, confirme el nombre del servidor o la IP, la ortografía del recurso compartido, las credenciales, el dominio, las reglas del firewall y los permisos efectivos en el servidor Windows o Samba antes de continuar. La guía de ownCloud SMB/CIFS también recomienda realizar pruebas smbclientantes de la configuración.
3. Habilitar la compatibilidad con almacenamiento externo.
- Inicia sesión en ownCloud con una cuenta de administrador.
- Abre Ajustes → Aplicaciones y asegúrate de que la compatibilidad con almacenamiento externo esté activada.
- Ve a Configuración → Administración → Almacenamiento (las etiquetas de navegación pueden variar ligeramente entre las distintas interfaces).
- Habilite el almacenamiento externo si la página muestra esa casilla de verificación y use Agregar almacenamiento para seleccionar SMB / CIFS .
No es necesario habilitar la opción " Permitir a los usuarios montar almacenamiento externo" solo para crear un recurso compartido administrado por el administrador. Esta configuración independiente permite a los usuarios crear sus propios puntos de montaje, incluyendo potencialmente conexiones a servicios de red que el administrador no expondría de otro modo. Consulte el manual de configuración de almacenamiento externo de ownCloud .
4. Configurar el montaje SMB/CIFS
En la nueva fila de almacenamiento, proporcione la información de conexión. El siguiente ejemplo mantiene el nombre del recurso compartido SMB separado del nombre de la carpeta que los usuarios ven en ownCloud.
| Campo ownCloud | Valor de ejemplo | Propósito |
| Nombre de la carpeta | Proyectos de equipo | Nombre que se muestra en la interfaz de Archivos |
| Almacenamiento externo | SMB / CIFS | Utiliza directamente el backend SMB. |
| Host | files.internal.example | Nombre de host o dirección IP del servidor SMB |
| Compartir | Proyectos | Nombre del recurso compartido remoto, sin ruta UNC completa |
| Subcarpeta remota | Equipo (opcional) | Limita el montaje a una carpeta existente en el recurso compartido. |
| Dominio | ACME (si es necesario) | Dominio o grupo de trabajo asociado a la cuenta |
| Autenticación | Nombre de usuario y contraseña | Credenciales explícitas para compartir esta información |
| Disponible para | Grupo ownCloud seleccionado | Restringe la visibilidad de la montura. |
Introduzca oc-shareel nombre de usuario ACMEen el campo Dominio. No lo introduzca //files.internal.example/Projectsen el campo Host y evite confundir el nombre del recurso compartido con una subcarpeta opcional. Para una subcarpeta remota, ownCloud permite $userseleccionar un directorio existente que coincida con el nombre de usuario actual de ownCloud; no crea dicho directorio.
Para una cuenta de servicio común, el nombre de usuario y la contraseña son sencillos, pero su acceso se rige por los permisos SMB de dicha cuenta. Si los usuarios se autentican en SMB con sus propias credenciales de ownCloud, las credenciales de inicio de sesión guardadas en la sesión pueden ser más adecuadas. Sin embargo, ownCloud documenta limitaciones importantes con las credenciales de sesión: los análisis en segundo plano y el uso compartido directo del almacenamiento montado no funcionan como con las credenciales almacenadas. Elija en función de los requisitos reales de autenticación y análisis, no solo por comodidad. Consulte Mecanismos de autenticación de almacenamiento externo .
Restringir el acceso a los usuarios o grupos de ownCloud previstos; de lo contrario, un montaje creado por un administrador estará disponible para todos los usuarios de forma predeterminada. Si el personal solo necesita explorar archivos, active la opción de solo lectura del montaje y aplique también el acceso de solo lectura en el servidor SMB. Deje la opción de compartir desde el montaje desactivada a menos que su política de acceso lo requiera.
5. Resuelva un punto de montaje no disponible antes de usarlo.
Una vez introducidos los campos obligatorios, ownCloud guarda automáticamente la fila de almacenamiento. El indicador de estado verde significa que la conexión está lista; un indicador rojo o amarillo requiere una investigación más a fondo. ownCloud puede marcar un almacenamiento externo con fallos como no disponible durante diez minutos, así que haga clic en su indicador de estado o recargue la página de administración después de solucionar el problema.
- Error de autenticación: vuelva a comprobar la contraseña SMB, el dominio, el formato del nombre de usuario, el estado de bloqueo de la cuenta y los permisos de uso compartido. Compare con la
smbclientprueba realizada con la misma cuenta.
- Tiempo de espera de conexión agotado: compruebe el DNS, el enrutamiento, el acceso del firewall al puerto TCP 445 y si el servicio SMB está en ejecución. Pruebe desde la misma red de contenedores si ownCloud está en contenedores.
- Falta el backend SMB/CIFS: confirme que la aplicación de soporte para almacenamiento externo esté habilitada y que la extensión SMB necesaria esté cargada en el entorno de ejecución de PHP que da servicio a ownCloud, cuando corresponda.
- Faltan algunas carpetas: verifique los permisos de la subcarpeta remota y del sistema de archivos SMB. Una asignación de grupo de ownCloud no puede otorgar acceso que el servidor remoto deniega.
- Los archivos modificados externamente no aparecen: revise la frecuencia de comprobación del sistema de archivos del punto de montaje, las tareas en segundo plano y el mecanismo de escaneo. Las credenciales SMB de solo sesión impiden los escaneos en segundo plano; evite programarlos
occ files:scancomo supuesta solución a esta limitación.
Un montaje CIFS a nivel de kernel expuesto a ownCloud como almacenamiento local suele ser una solución de respaldo incorrecta. ownCloud advierte que si dicho montaje del sistema de archivos desaparece, podría detectar un directorio local vacío y propagar eventos de eliminación. En su lugar, utilice el backend SMB/CIFS directo; consulte la advertencia oficial sobre el almacenamiento local .
6. Verificar el recurso compartido en Archivos
Inicia sesión como un usuario autorizado en Disponible para . Abre Archivos y localiza Proyectos de equipo . Explora un directorio existente y abre un archivo de prueba pequeño. Si tanto la cuenta SMB como el montaje de ownCloud permiten la escritura, sube un archivo de prueba inofensivo y verifica que aparezca en el servidor SMB; elimínalo después de la verificación. Para montajes de solo lectura, confirma que la modificación esté bloqueada.
Por último, compruebe que la fila de almacenamiento permanezca en verde tras recargar la página y que ningún otro usuario ajeno al grupo autorizado pueda ver el punto de montaje. Estas comprobaciones garantizan que ownCloud pueda acceder al recurso compartido SMB correcto, que la cuenta remota tenga el acceso previsto y que el punto de montaje solo sea visible para el público al que está destinado.