Desplegar Syncthing en Synology DSM 7.3: configuración estable con Container Manager

Guía práctica para desplegar Syncthing en Synology DSM 7.3 con Container Manager, cubriendo PUID/PGID, puertos, mapeos de volúmenes y ajustes iniciales de seguridad.

En Synology DSM 7.3, la forma recomendada de desplegar Syncthing es ejecutarlo con Container Manager (Docker). Así las actualizaciones, migraciones y recreaciones quedan más ordenadas, y también es más fácil separar el directorio de configuración de Syncthing de las carpetas compartidas que quieres sincronizar.

Syncthing necesita permisos de lectura y escritura sobre las carpetas compartidas del NAS. El problema más habitual al desplegarlo no suele ser la imagen en sí, sino los permisos del usuario de ejecución y los mapeos de volumen: el contenedor debe arrancar con los valores correctos de PUID y PGID, y la ruta que se escriba en la interfaz web debe ser la ruta dentro del contenedor.

Preparación

Primero inicia sesión en Synology por SSH y consulta el ID del usuario con el que quieres ejecutar Syncthing:

1
id your-admin-username

Anota el uid y el gid de la salida. En muchas instalaciones, uid suele estar alrededor de 1026 y gid suele ser 100. Estos valores se usarán como PUID y PGID.

Después abre File Station, entra en la carpeta compartida docker y crea este directorio:

1
/docker/syncthing

Este directorio guardará los archivos de configuración, la base de datos y el estado de ejecución de Syncthing. Si más adelante recreas el contenedor, la configuración se conservará mientras este directorio siga existiendo.

Descargar la imagen de Syncthing

Abre Container Manager, entra en “Registry” en la barra lateral izquierda y busca:

1
syncthing

Selecciona la imagen oficial syncthing/syncthing, usa la etiqueta latest y descárgala. Cuando termine la descarga, entra en “Image”, selecciona syncthing/syncthing y haz clic en “Run”.

Crear el contenedor

Puedes usar este nombre de contenedor:

1
syncthing

También es recomendable activar el reinicio automático, para que Syncthing vuelva a ejecutarse automáticamente después de reiniciar el NAS.

Configurar variables de entorno

En los ajustes avanzados, añade o modifica estas variables de entorno:

1
2
3
PUID=1026
PGID=100
TZ=Asia/Shanghai

Sustituye PUID y PGID por los valores reales que obtuviste antes con id username. Cuando Syncthing lea y escriba carpetas compartidas, accederá al sistema de archivos de Synology como ese usuario.

Fijar los puertos

Para facilitar el acceso y la resolución de problemas, conviene fijar manualmente los mapeos de puertos:

Puerto del contenedor Puerto local Protocolo Uso
8384 8384 TCP Interfaz web de administración
22000 22000 TCP Transferencia de datos de sincronización
22000 22000 UDP Transferencia de datos con QUIC
21027 21027 UDP Descubrimiento en red local

Si el firewall de Synology está activado, permite también estos puertos. Para uso solo dentro de la red local, al menos asegúrate de que 8384 sea accesible desde tu ordenador.

Configurar mapeos de volumen

Los mapeos de volumen se dividen en dos grupos: el directorio de configuración de Syncthing y las carpetas compartidas de Synology que quieres sincronizar.

El directorio de configuración debe mapearse así:

Ruta del host Synology Ruta montada en el contenedor
/docker/syncthing /var/syncthing

Después añade el directorio de datos que quieres sincronizar. Por ejemplo, si quieres sincronizar /volume1/NasData en Synology, puedes mapearlo así:

Ruta del host Synology Ruta montada en el contenedor
/volume1/NasData /NasData

Esto es importante: cuando más adelante añadas una carpeta en la interfaz web de Syncthing, debes escribir la ruta dentro del contenedor, por ejemplo:

1
/NasData

No escribas la ruta del host Synology /volume1/NasData. Syncthing se ejecuta dentro del contenedor y solo puede ver las rutas que hayas montado en ese contenedor.

Si quieres sincronizar varias carpetas compartidas, añade más mapeos, por ejemplo:

1
2
3
/volume1/Photos  ->  /Photos
/volume1/Backup  ->  /Backup
/volume1/NasData ->  /NasData

Iniciar y acceder a Syncthing

Después de confirmar las variables de entorno, los puertos y los mapeos de volumen, haz clic en “Done” para iniciar el contenedor.

Luego abre esta dirección en el navegador:

1
http://your-Synology-IP:8384

Cuando entres en la interfaz de administración de Syncthing, lo primero es configurar un usuario y una contraseña para la interfaz web. La ruta es:

1
Actions -> Settings -> GUI

No dejes la interfaz de administración de Syncthing expuesta durante mucho tiempo en tu red local sin contraseña.

Añadir una carpeta de sincronización

Haz clic en “Add Folder” y escribe en “Folder Path” la ruta dentro del contenedor que configuraste antes, por ejemplo:

1
/NasData

Si los permisos están bien configurados, Syncthing podrá leer y escribir en esa carpeta compartida. Después añade un dispositivo remoto, selecciona la carpeta que quieres compartir y la sincronización podrá comenzar.

Resumen

Hay tres puntos clave al desplegar Syncthing en Synology DSM 7.3:

  • Ejecutar syncthing/syncthing con Container Manager;
  • Usar los valores correctos de PUID y PGID para resolver los permisos de lectura y escritura de las carpetas compartidas;
  • Usar la ruta dentro del contenedor en la interfaz web de Syncthing, no la ruta del host Synology.

Cuando estas tres partes están bien configuradas, Syncthing funciona de forma estable en Synology y es sencillo añadir más directorios de sincronización más adelante.

记录并分享
Creado con Hugo
Tema Stack diseñado por Jimmy