Conecta un bucket compatible con S3 al almacenamiento externo de Nextcloud.

Para mostrar un bucket compatible con S3 en Nextcloud, active la aplicación de soporte para almacenamiento externo incluida, agregue un punto de montaje de Amazon S3 en la configuración de administración e ingrese el bucket del proveedor, la clave de acceso, la clave secreta y los detalles del punto final. Para un proveedor que no sea de Amazon, el nombre de host y la configuración del estilo de ruta suelen ser los campos que requieren mayor atención. Confirme que el punto de montaje esté en verde y luego realice una prueba con un archivo temporal antes de otorgar acceso completo.

Qué preparar

Este procedimiento crea un montaje externo: Nextcloud se conecta a un bucket existente y lo presenta como una carpeta en Archivos. No migra archivos al bucket, no lo convierte en el almacenamiento principal de Nextcloud ni reemplaza el directorio de datos de Nextcloud.

• Acceso de administrador: El montaje a nivel de sistema se configura en los ajustes de administración de Nextcloud.
• Nombre del bucket y credenciales: Obtenga una clave de acceso S3 y una clave de acceso secreta del proveedor de almacenamiento. Se recomienda una clave dedicada con solo los permisos necesarios para este bucket y sus operaciones previstas.
• Detalles de conexión: Obtenga el nombre de host genérico del punto final de S3 y, si el proveedor lo requiere, la región y el formato de ruta. No pegue una URL específica del bucket donde se solicita el nombre de host.
• Red y TLS: El servidor Nextcloud debe poder acceder al punto final. Utilice HTTPS a menos que el proveedor tenga una razón específica y documentada para configurar otra opción.

El manual de administración de Nextcloud 35 documenta el backend de Amazon S3 para Amazon S3 y servicios compatibles. Los proveedores difieren en el comportamiento de su API de S3, el formato del punto final, la región de firma y los permisos necesarios, por lo que se recomienda consultar la página de configuración del proveedor para obtener estos valores. Si no está seguro de cómo se mostrarán los objetos existentes, comience con un bucket nuevo o vacío, o con un prefijo de prueba claramente aislado.

Habilitar la compatibilidad con almacenamiento externo

1. Inicia sesión como administrador de Nextcloud y abre Aplicaciones .
2. Busca la aplicación de soporte para almacenamiento externo incluida y actívala si está desactivada. La aplicación viene incluida con Nextcloud, pero está desactivada por defecto.
3. Abre el menú de tu perfil, elige Configuración y selecciona Almacenamiento externo en Administración.

Si el backend no aparece en el menú desplegable de almacenamiento, compruebe que la aplicación esté habilitada y que su cuenta tenga privilegios de administrador. Las etiquetas del menú pueden variar ligeramente entre versiones; utilice la versión correspondiente del Manual de administración de Nextcloud si su instalación no es la versión 35.

Agregue y configure el montaje S3.

1. En la nueva fila de almacenamiento, asigne al montaje un nombre de carpeta simple , como Archive. Este es el nombre que los usuarios ven en Nextcloud; no es un nombre de bucket ni una ruta. No incluya barras diagonales.
2. Seleccione Amazon S3 en el menú desplegable de almacenamiento y Clave de acceso como método de autenticación.
3. Introduzca el nombre del bucket, el ID de la clave de acceso y la clave de acceso secreta exactamente como se le proporcionaron. Evite añadir espacios al copiar y pegar. Trate la clave secreta como una contraseña; no la incluya en un ticket público, en el historial de la consola ni en una captura de pantalla de un artículo.
4. Para el almacenamiento alojado en Amazon, ingrese la región del bucket. Para un servicio que no sea de Amazon, ingrese su nombre de host S3 genérico (el host del punto final, sin el prefijo del bucket). Complete una región si el proveedor requiere específicamente una región de firma; siga su documentación cuando utilice un valor como auto.
5. Mantén seleccionada la opción Habilitar SSL para HTTPS. Deja el puerto en su valor predeterminado a menos que el proveedor especifique un puerto diferente.
6. Pruebe primero el estilo de solicitud de host virtual predeterminado. Habilite el estilo de ruta cuando el proveedor requiera solicitudes con formato https://endpoint.example/bucketen lugar de https://bucket.endpoint.example. La guía S3 del proveedor es la fuente de información fidedigna para esta configuración.
7. Desactive la autenticación heredada (v2) a menos que el proveedor la requiera explícitamente. Nextcloud documenta la v4 como la predeterminada e indica que la v2 rara vez es necesaria.
8. En Disponible para , seleccione únicamente los usuarios o grupos que deberían ver este punto de montaje. Un punto de montaje creado en la configuración de administración está disponible de forma generalizada por defecto, así que restrinja su acceso antes de exponer datos privados o compartidos.

Los campos obligatorios se guardan al completarlos. Un indicador de estado verde significa que Nextcloud puede conectarse; un indicador amarillo o rojo significa que no se pudo validar el montaje. Si el estado de error persiste, haga clic en el icono de estado o recargue la página de administración para volver a comprobarlo. Nextcloud indica que un montaje con errores puede aparecer como no disponible durante diez minutos.

Elija el comportamiento de montaje deliberadamente

Abre el menú de opciones de la fila para revisar la configuración del montaje. La opción de compartir está desactivada por defecto; actívala solo si los usuarios deben compartir archivos desde este punto de montaje. También puedes configurar el montaje como de solo lectura para los datos de referencia, habilitar las vistas previas cuando sea necesario y elegir la frecuencia con la que Nextcloud comprueba si hay cambios externos. Estas opciones afectan al comportamiento del montaje dentro de Nextcloud; no modifican la política de bucket del proveedor de almacenamiento.

No asuma que agregar un montaje hace que los cambios directos en la consola del proveedor aparezcan inmediatamente en Nextcloud. Nextcloud mantiene una caché de archivos. Cuando se crean, modifican o eliminan archivos fuera de Nextcloud, la lista en caché puede permanecer desactualizada hasta que un escaneo la actualice. Para S3 y otros backends sin notificaciones push del proveedor, Nextcloud documenta los escaneos periódicos con occ files_external:scan <mount_id>. Encuentre el ID con occ files_external:list; ejecute OCC desde el directorio de instalación de Nextcloud como el usuario del servidor web, adaptando el usuario y el envoltorio de comandos a su instalación.

Solucionar problemas de conexión

• Estado rojo o amarillo: Vuelva a comprobar la ortografía exacta del bucket, el par de claves, el nombre de host del punto final, la región/región de firma y el acceso a la red del servidor. Confirme el DNS y el acceso HTTPS saliente desde el host de Nextcloud.
• Error de firma o autorización: Asegúrese de que la clave esté activa y tenga permiso para listar el bucket y realizar las operaciones que los usuarios necesitan. Verifique que la región coincida con las instrucciones de firma del proveedor. Una credencial que puede cargar archivos pero no listar ni inspeccionar el bucket aún podría fallar la prueba de conexión de Nextcloud.
• Punto final o depósito no encontrado: Verifique que el nombre de host contenga el punto final genérico, no una URL con el depósito ya incluido. Pregunte al proveedor si requiere solicitudes con formato de ruta, active esa opción y vuelva a comprobarlo.
• La conexión funciona, pero faltan objetos existentes: compruebe que la clave pueda listar el bucket y que los nombres de los objetos utilicen rutas compatibles. Nextcloud advierte que las claves S3 que contienen delimitadores repetidos, como Photos//cat.png, y su contenido se ignoran.
• Faltan archivos modificados directamente por el proveedor: active un escaneo de almacenamiento externo para el punto de montaje. Mantenga los cambios de nombre y movimientos rutinarios dentro de Nextcloud siempre que sea posible; un nuevo escaneo puede interpretar un cambio de nombre remoto como una eliminación más un archivo nuevo, lo que puede provocar la pérdida de recursos compartidos, etiquetas, comentarios o historial de actividad de Nextcloud vinculados a la entrada anterior.

Verifique que el soporte esté bien sujeto.

Espere a que el estado del montaje cambie a verde. Abra Archivos como un usuario dentro del ámbito permitido, abra la carpeta del montaje, cargue un archivo de prueba pequeño con un nombre único, descárguelo y elimínelo a través de Nextcloud. Si es posible, verifique que el objeto esperado aparezca en la vista del bucket del proveedor. Luego, realice una prueba con un segundo usuario solo si el acceso de grupo forma parte del plan. Finalmente, confirme que un usuario fuera del ámbito seleccionado no pueda ver el montaje. Elimine el objeto de prueba y conserve las credenciales de mínimo privilegio.

Para obtener descripciones de campos específicas de la versión, consulte la configuración de Nextcloud 35 en Amazon S3 y la guía de administración de Nextcloud 35 para almacenamiento externo .