File Sync on KnightLi Blog

Cómo gestionar varios dispositivos y carpetas en Syncthing: topología, nombres y versionado

Sun, 31 May 2026 12:23:55 +0800

Índice de la serie Syncthing

Cómo usar Syncthing: notas prácticas desde el emparejamiento de dispositivos hasta la sincronización de archivos
Desplegar Syncthing con Docker: Compose, puertos y errores comunes con volúmenes
Cómo configurar varios dispositivos en Syncthing: red P2P, topología en estrella e introducers
Cómo usar Syncthing en Android: configuración de Syncthing-Fork y copia de fotos
Cómo gestionar varios dispositivos y carpetas en Syncthing: topología, nombres y versionado
Cómo sincronizar fotos de iPhone a un ordenador o NAS con Syncthing

Cuando Syncthing empieza a tener muchos dispositivos y muchas carpetas, puede volverse caótico si no lo planificas con antelación. Un caso típico es tener un móvil, una tableta, un portátil, un PC de escritorio y un NAS sincronizando a la vez, mientras las carpetas contienen fotos, documentos de trabajo, proyectos de código, copias de chats y ebooks. Cada dispositivo puede modificar archivos, cada carpeta puede compartirse y al final resulta difícil saber de dónde viene un archivo y hacia dónde se sincronizará.

Para usar Syncthing de forma estable, lo importante no es instalar más clientes, sino crear un modelo de gestión:

Usar una topología en estrella.
Normalizar IDs y rutas de carpetas.
Usar introducers para las relaciones entre dispositivos.
Separar copias de seguridad y sincronización bidireccional según la dirección de los datos.
Activar versionado en el nodo central.
Filtrar archivos temporales con ignore patterns.

Topología: evita la malla completa y prioriza la estrella

Syncthing usa una arquitectura P2P, pero eso no significa que todos los dispositivos deban emparejarse entre sí.

Si 5 dispositivos están conectados en malla completa, hay que mantener 10 relaciones entre dispositivos. Al añadir una carpeta nueva, también tendrás que aceptarla, configurar rutas y confirmar el uso compartido en varios equipos. Cuantos más dispositivos haya, mayor será el coste de gestión.

La opción más recomendable suele ser una topología en estrella.

Elige un dispositivo que esté siempre encendido, tenga espacio y una red estable como nodo central:

NAS
Synology
router con sistema propio
mini PC
ordenador encendido 24/7

Los demás dispositivos se emparejan solo con el nodo central:

Phone ----\
Tablet ----\
Laptop ---- NAS
Desktop ---/

El móvil no añade directamente el portátil, y el portátil no añade directamente el escritorio. Si el móvil necesita sincronizar fotos con el ordenador, primero las sincroniza con el NAS y luego el NAS las sincroniza con el ordenador.

Esta estructura tiene varias ventajas:

Los dispositivos nuevos solo necesitan emparejarse con el NAS.
Las relaciones entre carpetas se gestionan de forma centralizada en el NAS.
El NAS puede aplicar una política de versiones coherente.
Si un dispositivo periférico está apagado, el NAS sigue funcionando como punto intermedio.

La desventaja es que el NAS se vuelve más importante. Debe funcionar de forma estable y tener su propia copia de seguridad.

El Folder ID importa más que la etiqueta

En Syncthing, el identificador real de una carpeta sincronizada es el Folder ID, no la etiqueta visible en la interfaz.

La etiqueta es solo un nombre de presentación y puede variar entre dispositivos. El Folder ID es lo que determina si las carpetas en distintos dispositivos pertenecen al mismo grupo de sincronización.

Por eso, al crear una carpeta en el primer dispositivo, conviene definir manualmente un ID claro.

Por ejemplo:

notes-main
work-docs
backup-pixel-photos
backup-iphone-photos
media-ebooks
code-projects

Evita IDs aleatorios generados automáticamente o nombres poco mantenibles como test, sync y new-folder.

Una regla sencilla de nombres es suficiente:

Sincronización bidireccional: notes-main, work-docs
Copias del móvil: backup-pixel-photos, backup-iphone-photos
Distribución de archivos: media-ebooks, media-music
Directorios de código: code-projects

Más adelante, cuando otros dispositivos reciban una carpeta compartida, el Folder ID te dirá de inmediato para qué sirve.

Ordena las rutas del nodo central

En el NAS o en el ordenador central, crea un directorio raíz dedicado para Syncthing.

Por ejemplo:

/volume1/Syncthing/
├── Phone_Backup/
│   ├── iPhone15_DCIM/
│   └── Pixel7_DCIM/
├── Work/
│   ├── Office_Docs/
│   └── Coding_Projects/
├── Notes/
│   └── Main_Notes/
└── Media/
    └── eBooks/

No repartas las carpetas sincronizadas por todo el sistema. Puede parecer cómodo a corto plazo, pero a largo plazo será difícil de mantener.

Reglas recomendadas:

Colocar todas las carpetas gestionadas por Syncthing bajo una misma raíz.
Separar copias de móviles, documentos de trabajo y archivos multimedia.
Hacer que los nombres de carpeta reflejen el propósito, no un estado temporal del dispositivo.
No usar directorios del sistema ni cachés de descargas como carpetas de sincronización de largo plazo.

Si Syncthing se ejecuta en Docker, también debes distinguir entre rutas del host y rutas dentro del contenedor.

Por ejemplo, la ruta del host:

`1`	`/volume1/Syncthing/Phone_Backup/iPhone15_DCIM`

puede estar montada dentro del contenedor como:

`1`	`/var/syncthing/Phone_Backup/iPhone15_DCIM`

La ruta que escribes en la Web UI es la ruta dentro del contenedor, no la ruta del host.

Introducers: reducir el trabajo de emparejar muchos dispositivos

La función Introducer de Syncthing encaja muy bien con una topología en estrella.

La idea es marcar el NAS como introducer. Después, un dispositivo nuevo solo necesita emparejarse con el NAS. El NAS puede presentar dispositivos conocidos y relaciones de carpetas al nuevo equipo, reduciendo el trabajo repetido de escanear códigos y añadir dispositivos manualmente.

Es útil cuando:

hay varios ordenadores y móviles en casa;
el NAS es el nodo central permanente;
añades dispositivos con frecuencia;
quieres reducir operaciones de emparejamiento.

Pero no conviene usarlo sin control.

Recomendaciones:

Solo marca como introducer el NAS o el servidor principal.
No marques móviles, tabletas u ordenadores temporales como introducers.
Después de añadir un dispositivo nuevo, revisa qué dispositivos y carpetas se añadieron automáticamente.
No metas dispositivos no confiables dentro del ámbito gestionado por el introducer.

Los introducers mejoran la eficiencia, pero también amplían el alcance de las relaciones automáticas. Funcionan mejor en una red con un nodo central claro, no en un entorno desordenado de dispositivos temporales.

Separa copias de seguridad y sincronización bidireccional

En la gestión de muchas carpetas, una regla clave es: no uses Send & Receive para todo.

Cada carpeta puede tener una dirección de datos distinta.

Copia de fotos del móvil

En el móvil:

`1`	`Send Only`

En el NAS:

`1`	`Receive Only`

Así el móvil envía fotos y el NAS las recibe y conserva. Limpiar espacio en el móvil u ordenar carpetas en el NAS tendrá menos riesgo de afectar al otro lado.

Documentos y notas en varios dispositivos

En el ordenador:

`1`	`Send & Receive`

En el NAS:

`1`	`Send & Receive`

Que el móvil participe en esta sincronización bidireccional depende de si realmente editas esos archivos en el móvil. Si solo los consultas, considera Receive Only.

Distribución de archivos

En el NAS:

`1`	`Send Only`

En otros dispositivos:

`1`	`Receive Only`

Es adecuado para ebooks, instaladores y material de referencia distribuido desde una carpeta central.

Directorios de copia de seguridad

Dispositivo principal:

`1`	`Send Only`

Equipo de copia:

`1`	`Receive Only`

Luego combínalo con versionado o snapshots en el equipo de copia.

Activa el versionado de archivos en el NAS

Los mayores riesgos en una sincronización con muchos dispositivos son los borrados accidentales y las sobrescrituras accidentales.

Por ejemplo:

Un ordenador borra documentos de trabajo por error.
Una herramienta de limpieza del móvil elimina el directorio del álbum.
Dos dispositivos editan la misma nota al mismo tiempo.
Una regla de sincronización mal configurada sincroniza una carpeta vacía encima de otra.

Por eso, conviene activar el versionado de archivos en el nodo central.

En la Web UI de Syncthing del NAS:

Abre la configuración de la carpeta correspondiente.
Entra en la sección de versionado de archivos.
Elige una estrategia adecuada.

Una opción habitual es Staggered File Versioning. Conserva versiones históricas por intervalos de tiempo, dejando versiones más espaciadas cuanto más antiguas son.

También puedes usar estrategias más simples:

Trash Can File Versioning: similar a una papelera.
Simple File Versioning: conserva un número fijo de versiones.
Staggered File Versioning: conserva versiones por etapas de tiempo.

Si no sabes cuál elegir, en un NAS doméstico puedes empezar con Trash Can o Staggered.

El versionado no sustituye a una copia de seguridad completa, pero es una red de seguridad muy útil en sincronización multi-dispositivo.

Filtra archivos temporales con Ignore Patterns

Al sincronizar proyectos de código, documentos o copias de chats entre muchos dispositivos, los archivos temporales y cachés pueden crear problemas.

Problemas frecuentes:

consumen mucho ancho de banda;
generan conflictos sin valor;
distintos sistemas crean distintos archivos de caché;
al borrar un directorio, los archivos ignorados pueden bloquear la eliminación.

Puedes añadir reglas en los Ignore Patterns de la carpeta.

Archivos temporales comunes:

1
2
3

(?d).DS_Store
(?d)Thumbs.db
(?d)*~

Proyectos Node / Python / Java:

(?d)node_modules/
(?d)__pycache__/
(?d).pytest_cache/
(?d)target/

Si el proyecto de código ya está gestionado por Git, normalmente no conviene sincronizar el directorio .git con Syncthing. Puedes ignorarlo:

`1`	`(?d).git/`

(?d) significa que, si se va a eliminar todo el directorio, Syncthing puede eliminar también esos archivos ignorados generados localmente, evitando que cachés residuales bloqueen el borrado.

No hagas las reglas de ignorado demasiado complejas desde el principio. Empieza por cachés y archivos temporales evidentes, y ajusta poco a poco según los conflictos reales.

Ejemplos de nombres para varias carpetas

Puedes definir un esquema fijo de nombres.

Fotos del móvil:

1
2
3

Folder ID: backup-pixel-photos
Label: Pixel Photos
NAS Path: /volume1/Syncthing/Phone_Backup/Pixel7_DCIM

Fotos de iPhone:

1
2
3

Folder ID: backup-iphone-photos
Label: iPhone Photos
NAS Path: /volume1/Syncthing/Phone_Backup/iPhone15_DCIM

Biblioteca principal de notas:

1
2
3

Folder ID: notes-main
Label: Main Notes
NAS Path: /volume1/Syncthing/Notes/Main_Notes

Documentos de trabajo:

1
2
3

Folder ID: work-docs
Label: Work Docs
NAS Path: /volume1/Syncthing/Work/Office_Docs

Ebooks:

1
2
3

Folder ID: media-ebooks
Label: eBooks
NAS Path: /volume1/Syncthing/Media/eBooks

Mientras los IDs, las etiquetas y las rutas sigan una regla, la gestión seguirá siendo controlable aunque aumenten los dispositivos.

Diseño general recomendado

Si ya tienes Syncthing en Docker ejecutándose en el NAS, puedes diseñarlo así:

Usar el NAS como nodo central.
Marcar el NAS como introducer.
Emparejar todos los dispositivos solo con el NAS.
Colocar todos los directorios de sincronización bajo /volume1/Syncthing/.
Usar Send Only en el móvil y Receive Only en el NAS para carpetas de fotos.
Usar Send & Receive para documentos de trabajo y notas.
Usar NAS Send Only y otros dispositivos Receive Only para carpetas de distribución.
Activar versionado en las carpetas importantes del NAS.
Configurar ignore patterns para código y cachés.
Hacer snapshots o copias externas del propio NAS.

Cuando esta estructura ya está creada, añadir nuevos dispositivos o carpetas consiste en encajarlos en las reglas existentes. No necesitas replantear las relaciones de sincronización cada vez.

Resumen

Syncthing ofrece mucha libertad, pero cuanto mayor es la libertad, más necesarias son las reglas.

En escenarios con muchos dispositivos y muchas carpetas, no conviene usar una malla completa. Un enfoque más estable es dejar que un NAS o un ordenador siempre encendido sea el nodo central, normalizar Folder ID, rutas y versionado, y usar tipos de carpeta para separar copias de seguridad, sincronización bidireccional y distribución de archivos.

Así conservas la capacidad P2P de Syncthing, pero concentras la gestión diaria en un dispositivo central. Aunque aumenten los dispositivos y las carpetas, la sincronización no se convertirá en un lío.

Cómo sincronizar fotos del iPhone con un PC o NAS usando Syncthing

Sun, 31 May 2026 12:21:54 +0800

Serie Syncthing

Usar Syncthing para sincronizar fotos en un iPhone es bastante distinto a hacerlo en Android.

La razón es sencilla: iOS es más cerrado, y el proyecto oficial de Syncthing no ofrece un cliente iOS propio. Para usar el protocolo Syncthing en un iPhone, normalmente necesitas un cliente compatible de terceros.

Hay dos opciones habituales:

Mobius Sync: una opción bastante popular, con una experiencia cercana a una app nativa. Algunas funciones pueden requerir desbloqueo de pago, así que revisa la descripción actual en App Store.
FSync: un cliente Syncthing para iOS gratuito y de código abierto.

Si el objetivo es sincronizar la fototeca del iPhone con un PC o NAS, Mobius Sync suele ser la opción más común. Los pasos siguientes lo usan como ejemplo.

Primero entiende las limitaciones de iOS

En Android, Syncthing-Fork puede ejecutarse durante mucho tiempo mediante servicio en segundo plano, condiciones de ejecución y exclusiones de optimización de batería. iOS no permite que las herramientas de sincronización de terceros permanezcan en segundo plano sin límites.

Esto significa:

No esperes que sincronice 24/7 como un NAS.
Cuando la app pasa a segundo plano, la ventana de sincronización puede ser corta.
Para lotes grandes de fotos, lo mejor es abrir la app manualmente y dejarla terminar.
iCloud Optimized Storage puede afectar la lectura de los archivos originales.

Por eso, en iPhone conviene tratar Syncthing como un flujo de “abrir la app periódicamente para sincronizar fotos”, no como una sincronización en segundo plano completamente invisible y en tiempo real.

Paso 1: instala el cliente y concede permisos

Después de instalar Mobius Sync desde App Store, presta atención a varios permisos la primera vez que lo abras.

Notificaciones

Es recomendable permitir notificaciones. Sirven para ver el estado de sincronización, el estado de conexión y mensajes de error.

Acceso a la red local

Este permiso es muy importante.

iOS pregunta por separado si una app puede acceder a la red local. Si lo deniegas, el iPhone quizá no pueda descubrir tu PC, NAS u otros nodos Syncthing dentro de la LAN.

Si lo rechazaste por error, puedes volver a activarlo desde Ajustes de iOS.

Acceso a Fotos

Si quieres sincronizar fotos, debes permitir el acceso a la fototeca.

La opción recomendada es:

`1`	`Full Access to Photos`

Si solo concedes acceso limitado a algunas fotos, Mobius Sync quizá solo pueda ver esas fotos seleccionadas, y las fotos nuevas podrían no sincronizarse más adelante.

Paso 2: empareja el iPhone con el PC o NAS

El emparejamiento de Syncthing sigue basándose en intercambiar IDs de dispositivo.

En el iPhone:

Abre Mobius Sync.
Entra en Settings.
Abre Device ID.
Mantén visible la pantalla con el código QR.

En el PC o NAS:

Abre la Web UI de Syncthing.
Haz clic en Add Remote Device.
Escanea el código QR del iPhone, o introduce el ID manualmente.
Ponle un nombre al dispositivo, por ejemplo My-iPhone.
Guarda.

Vuelve al iPhone, espera la solicitud de conexión y toca Accept.

En este punto, el iPhone y el PC/NAS ya confían entre sí, pero la fototeca todavía no está compartida.

Paso 3: crea una carpeta de sincronización de fotos en el iPhone

iOS no permite elegir directamente una ruta como /DCIM/Camera del mismo modo que Android. Mobius Sync incluye soporte especial para la fototeca del sistema, así que debes elegir el tipo de carpeta adecuado.

En Mobius Sync:

Cambia a Folders.
Toca + en la esquina superior derecha.
Crea una carpeta nueva.

Campos importantes:

Folder Type: elige Camera Roll.
Folder Label: usa un nombre fácil de reconocer, por ejemplo iPhone_Photos.
Folder ID: puedes dejar el valor generado automáticamente, o usar un ID estable en inglés.
Folder Path: deja el valor predeterminado para que el cliente se vincule con la fototeca de iOS.

Luego, en la sección Sharing, marca el PC o NAS que acabas de emparejar.

Paso 4: configura el iPhone como Send Only

La sincronización de fotos suele ser “el teléfono envía al NAS”, no un flujo de edición bidireccional.

Por eso, en el iPhone configura el tipo de carpeta como:

`1`	`Send Only`

Así el iPhone se encarga de enviar fotos, sin aceptar cambios en sentido inverso desde el PC o NAS.

Esta opción reduce el riesgo de operaciones accidentales. Por ejemplo, si organizas la carpeta de copia en el ordenador, normalmente no quieres que esos cambios afecten a la fototeca del iPhone.

Aun así, recuerda que Syncthing es una herramienta de sincronización, no un sistema completo de copias de seguridad. Para proteger fotos a largo plazo, también conviene usar snapshots en el NAS, versionado de archivos o una copia independiente.

Paso 5: recibe las fotos en el PC o NAS

Después de guardar en el iPhone, la Web UI de Syncthing en el PC o NAS mostrará un aviso:

`1`	`Device My-iPhone wants to share folder iPhone_Photos`

Haz clic en añadir.

Configura la ruta de almacenamiento.

En Windows puede ser algo como:

`1`	`D:\Backups\iPhone_Photos`

En Linux o NAS puede ser algo como:

`1`	`/volume1/photos/iphone`

Si Syncthing se ejecuta dentro de Docker, debes escribir la ruta dentro del contenedor. Por ejemplo, si el montaje del host es:

`1`	`- /volume1/photos:/var/syncthing/photos`

En la Web UI deberías usar:

`1`	`/var/syncthing/photos/iphone`

En el receptor, usa Receive Only

En el PC o NAS también es recomendable configurar esta carpeta como:

`1`	`Receive Only`

Así el receptor solo acepta fotos enviadas desde el iPhone, sin sincronizar cambios locales de vuelta al iPhone.

Es una segunda capa de protección:

Lado iPhone: Send Only
Lado NAS: Receive Only

Ambos lados quedan configurados con lógica de copia unidireccional, que encaja mejor con un archivo de fotos.

La realidad de la sincronización en segundo plano en iOS

iOS es muy estricto con la ejecución en segundo plano. Aunque todo esté bien configurado, no esperes que Mobius Sync se quede funcionando silenciosamente en segundo plano todo el tiempo.

Comportamiento habitual:

Mientras la app está abierta, la velocidad de sincronización es normal.
Al pasar a segundo plano, puede seguir sincronizando durante un rato.
Después, el sistema puede pausarla o limitarla.
Cambios de ubicación, planificación del sistema o ventanas breves de segundo plano pueden despertarla de nuevo.

El flujo práctico más fiable es sencillo:

Después de tomar muchas fotos, abre Mobius Sync manualmente.
Mantén el teléfono con la pantalla encendida, o evita bloquearlo demasiado rápido.
Espera a que termine de sincronizar las fotos nuevas.
Luego cierra la app o bloquea la pantalla.

Si acostumbras hacer una copia de la fototeca cada pocos días, este método es bastante fiable.

Evita problemas con iCloud Optimized Storage

Si el iPhone tiene activado:

`1`	`Optimize iPhone Storage`

iOS puede conservar solo miniaturas en local y dejar los originales en iCloud. Cuando un cliente de sincronización de terceros intenta leer las fotos, puede no obtener los originales completos, lo que causa fallos, elementos omitidos o esperas mientras el sistema descarga los archivos.

La opción más adecuada para copia por sincronización es:

`1`	`Download and Keep Originals`

La ruta suele ser:

`1`	`Settings -> Apple ID -> iCloud -> Photos`

Si el iPhone no tiene suficiente espacio y necesitas usar almacenamiento optimizado, quizá debas abrir primero esas fotos en la app Fotos del sistema para que el iPhone descargue los originales desde iCloud, y después iniciar Mobius Sync.

Consejos para la primera sincronización grande

La primera vez que sincronices la fototeca del iPhone, puede haber miles o incluso decenas de miles de fotos. No conviene intentar terminar todo de una sola vez.

Puedes hacerlo así:

Sincroniza primero unas pocas fotos de prueba.
Confirma que la ruta del NAS es correcta.
Confirma que los tipos de carpeta son Send Only / Receive Only.
Confirma que el receptor no afectará al iPhone en sentido inverso.
Luego inicia la sincronización completa.

Durante la primera sincronización, es mejor:

Mantener el iPhone conectado a la corriente.
Mantener una Wi-Fi estable.
Dejar Mobius Sync abierto en primer plano.
Mantener el NAS o PC en línea.

Si la fototeca es grande, la sincronización puede tardar bastante. Es normal.

Configuración recomendada

Una configuración estable para sincronizar fotos del iPhone sería:

Instalar Mobius Sync en el iPhone.
Permitir notificaciones, red local y acceso completo a Fotos.
Intercambiar IDs de dispositivo entre el iPhone y el NAS.
Crear una carpeta Camera Roll en el iPhone.
Definir la etiqueta de carpeta como iPhone_Photos.
Configurar la carpeta del iPhone como Send Only.
Definir la ruta receptora del NAS como /volume1/photos/iphone.
Configurar la carpeta del NAS como Receive Only.
Activar versionado de archivos o snapshots en el NAS.
Abrir Mobius Sync manualmente cada pocos días para completar la sincronización.

Si dependes mucho de una copia automática de fotos en segundo plano, iOS será más incómodo que Android. Sus restricciones hacen difícil que las herramientas de sincronización de terceros funcionen como un servicio siempre activo e invisible.

Resumen

Un iPhone puede integrarse en el ecosistema Syncthing mediante Mobius Sync o FSync, y sincronizar fotos con un PC o NAS.

La diferencia clave en iOS está en las limitaciones de segundo plano y los permisos de la fototeca. Durante la configuración, permite acceso a la red local y acceso completo a Fotos. Diseña los tipos de carpeta como copia unidireccional: iPhone Send Only, NAS Receive Only. Si iCloud Optimized Storage está activado, comprueba también si los originales están realmente disponibles localmente.

Para archivar fotos, el flujo más estable es abrir el cliente periódicamente para sincronizar, y dejar que el NAS se encargue del versionado, los snapshots y la copia a largo plazo.

Usar Syncthing en Android: configuración de Syncthing-Fork y copia de fotos

Sun, 31 May 2026 12:17:19 +0800

Índice de la serie Syncthing

En Android, Syncthing se usa sobre todo de dos maneras: sincronizar documentos entre el teléfono y un ordenador, o hacer una copia automática de las fotos del móvil hacia un PC o NAS.

La idea general no es complicada, pero Android añade dos problemas prácticos: la gestión agresiva de procesos en segundo plano y las restricciones de almacenamiento de las versiones recientes del sistema. Por eso, en Android normalmente recomiendo usar Syncthing-Fork.

Qué cliente usar en Android

Las dos opciones más habituales son:

Syncthing oficial: mantiene la experiencia más cercana al proyecto original. Es limpio y directo, pero en algunos teléfonos puede sufrir cortes cuando Android mata procesos en segundo plano.
Syncthing-Fork: una versión mantenida por la comunidad, más adaptada al uso móvil. Añade condiciones de ejecución como “solo con Wi-Fi”, “solo al cargar” o “solo con SSID concretos”, y suele ser más cómoda para sincronización diaria.

Si lo que quieres es respaldar fotos, notas o documentos desde el teléfono hacia un NAS, Syncthing-Fork suele ser la opción más práctica.

Preparación inicial

Instala Syncthing-Fork desde Google Play, F-Droid o GitHub Releases. Después de abrirlo por primera vez, presta atención a dos permisos:

Acceso a todos los archivos

Syncthing necesita leer y escribir en las carpetas que vas a sincronizar. Si no concedes este permiso, la aplicación puede abrir, pero fallará al acceder a fotos, documentos o carpetas creadas por otras apps.
Exclusión de optimización de batería

Muchos teléfonos Android cierran apps en segundo plano de forma agresiva. Si Syncthing-Fork queda dentro de la optimización de batería, es normal que la sincronización se detenga cuando apagas la pantalla. Añádelo a la lista blanca de batería siempre que el sistema lo pida.

También es buena idea crear una carpeta dedicada para datos sincronizados, por ejemplo:

1
2
3

/storage/emulated/0/SyncData
/storage/emulated/0/SyncData/Notes
/storage/emulated/0/SyncData/Photos

En Android 11 y versiones posteriores, esta clase de carpeta propia en el almacenamiento interno suele dar menos problemas que intentar sincronizar directorios del sistema o rutas protegidas.

Si vas a sincronizar las fotos de la cámara, la ruta más habitual es:

`1`	`/storage/emulated/0/DCIM/Camera`

Emparejar el teléfono con un PC o NAS

Syncthing no usa cuentas centrales. Antes de compartir carpetas, los dos dispositivos deben emparejarse.

En el teléfono:

Abre Syncthing-Fork.
Abre el menú lateral.
Entra en la pantalla para mostrar el ID del dispositivo.
Deja visible el código QR o el identificador largo.

En el PC o NAS:

Abre la interfaz web de Syncthing.
Pulsa Añadir dispositivo remoto.
Escanea el QR del teléfono o pega su ID.
Dale un nombre claro, por ejemplo Pixel-Phone o Android-Photos.
Guarda los cambios.

Vuelve al teléfono. En unos segundos debería aparecer una solicitud de conexión desde el PC o NAS. Acéptala. A partir de ese momento los dos dispositivos ya se conocen.

Recibir una carpeta compartida en Android

Si el PC o NAS comparte una carpeta hacia el teléfono, Syncthing-Fork mostrará una carpeta pendiente.

`1`	`El dispositivo NAS quiere compartir la carpeta Notes`

Al aceptarla, el punto más importante es elegir una ruta local estable. Por ejemplo:

`1`	`/storage/emulated/0/SyncData/Notes`

Para documentos, notas o archivos que quieres editar en ambos lados, deja el tipo de carpeta como:

`1`	`Send & Receive`

Eso significa que los cambios hechos en el teléfono se enviarán al PC o NAS, y los cambios hechos en el PC o NAS volverán al teléfono.

Hacer copia de fotos de Android hacia un PC o NAS

La copia de fotos es el uso más típico. En la mayoría de teléfonos, las fotos de cámara están aquí:

`1`	`/storage/emulated/0/DCIM/Camera`

Las capturas de pantalla o imágenes guardadas por apps pueden estar en rutas distintas, por ejemplo:

1
2

/storage/emulated/0/Pictures/Screenshots
/storage/emulated/0/Pictures/WeiXin

Conviene crear una carpeta Syncthing por cada fuente importante, en lugar de mezclar todo sin criterio.

Crear la carpeta de fotos en el teléfono

En Syncthing-Fork:

Entra en la pestaña de carpetas.
Pulsa el botón +.
Crea una carpeta para la cámara.

Usa valores claros:

1
2
3

Folder Label: Pixel_Photos
Folder ID: backup-pixel-photos
Folder Path: /storage/emulated/0/DCIM/Camera

En la sección de compartir, marca tu PC o NAS.

Después cambia el tipo de carpeta del teléfono a:

`1`	`Send Only`

Este ajuste es muy importante para una copia de fotos. El teléfono solo enviará archivos. Si más adelante borras fotos del móvil para liberar espacio, el receptor no debería tratar ese borrado como una eliminación que debe propagarse.

Aceptar la carpeta en el PC o NAS

En la interfaz web del PC o NAS aparecerá una invitación para aceptar la carpeta. Al aceptarla, elige una ruta de destino, por ejemplo en Windows:

`1`	`El dispositivo Pixel-Phone quiere compartir la carpeta Pixel_Photos`

Pulsa añadir y elige una ruta de destino, por ejemplo en Windows:

`1`	`D:\Backups\Phone_Photos`

O en un NAS:

`1`	`/volume1/photos/phone`

En el receptor recomiendo cambiar el tipo de carpeta a:

`1`	`Receive Only`

Así el PC o NAS actúa como destino de respaldo. Si alguien modifica o borra algo accidentalmente en esa carpeta del NAS, Syncthing no intentará propagar ese cambio de vuelta al teléfono.

Si usas Syncthing dentro de Docker, recuerda que en la interfaz web debes escribir la ruta vista desde dentro del contenedor. Por ejemplo, si tu Compose tiene un volumen así:

`1`	`- /volume1/photos:/var/syncthing/photos`

Entonces la ruta que debes usar en Syncthing es:

`1`	`/var/syncthing/photos/phone`

No la ruta del host.

Prueba con pocos archivos primero

Antes de dejarlo funcionando con miles de fotos, haz una prueba pequeña:

Crea una carpeta temporal con dos o tres imágenes.
Sincronízala hacia el NAS.
Comprueba que aparecen en el destino.
Borra una imagen en el teléfono.
Verifica que el comportamiento coincide con lo que esperas.

Esta prueba evita sorpresas desagradables cuando ya hay una fototeca grande implicada.

Ahorrar batería y datos móviles

La ventaja principal de Syncthing-Fork en Android está en las condiciones de ejecución.

En Run Conditions, activa:

Ejecutar solo con Wi-Fi.
Ejecutar solo durante la carga, si quieres máxima autonomía.
Limitar la ejecución a SSID concretos, por ejemplo el Wi-Fi de casa.

`1`	`Ejecutar solo con conexión Wi-Fi`

`1`	`Ejecutar solo durante la carga`

Un flujo cómodo es este: durante el día haces fotos normalmente y Syncthing permanece detenido; por la noche conectas el teléfono al cargador en casa, se conecta al Wi-Fi y Syncthing-Fork sincroniza las fotos nuevas hacia el NAS sin gastar datos móviles ni batería durante el día.

Restricciones de almacenamiento en Android 11+

Android 11 y versiones posteriores introdujeron restricciones más estrictas sobre el acceso a carpetas de otras apps. Por eso no todas las rutas son igual de estables.

Evita, si puedes:

carpetas dentro de Android/data;
carpetas dentro de Android/obb;
directorios controlados por apps que no exponen bien sus archivos;
tarjetas SD con permisos inestables.

1
2

Android/data
Android/obb

Para sincronización normal, suele ser más fiable usar carpetas bajo el almacenamiento interno compartido:

1
2
3

/storage/emulated/0/SyncData
/storage/emulated/0/DCIM/Camera
/storage/emulated/0/Pictures

No recomiendo empezar sincronizando todo el almacenamiento interno:

`1`	`/storage/emulated/0`

Elegir bien el tipo de carpeta

La regla práctica es sencilla:

Escenario	Android	PC / NAS
Fotos del teléfono hacia NAS	`Send Only`	`Receive Only`
Notas editadas en todos los dispositivos	`Send & Receive`	`Send & Receive`
Carpeta que solo quieres consultar en el móvil	`Receive Only`	`Send Only`

1
2
3

Send & Receive
Send Only
Receive Only

No uses siempre el modo por defecto sin pensarlo. En Syncthing, el modo de carpeta define qué pasa cuando se modifica o elimina un archivo.

Sobre los borrados de fotos

Para copias de seguridad, lo habitual es querer esto:

si haces una foto en Android, se copia al NAS;
si borras una foto del teléfono para liberar espacio, la copia del NAS se conserva;
si reorganizas el archivo en el NAS, eso no destruye los originales del teléfono.

Para acercarte a ese comportamiento, combina:

teléfono en Send Only;
NAS en Receive Only;
versionado de archivos activado en el NAS si la carpeta es importante.

También puedes usar una carpeta de entrada y otra de archivo. Por ejemplo:

1
2

/volume1/photos/inbox-phone
/volume1/photos/archive

Syncthing escribe en inbox-phone, y tú organizas manualmente o con scripts hacia archive.

Problemas comunes

Si el teléfono no sincroniza con la pantalla apagada, revisa la optimización de batería. En algunas marcas también hay que permitir inicio automático o ejecución en segundo plano desde el gestor propio del fabricante.

Si el PC o NAS no conecta directamente, comprueba el firewall y los puertos de Syncthing:

1
2

22000/TCP
22000/UDP

Si la carpeta muestra errores de permisos, prueba con una ruta más simple dentro del almacenamiento interno compartido y confirma que Syncthing-Fork tiene permiso de acceso a todos los archivos.

Si aparecen demasiados conflictos, revisa si esa carpeta debería ser realmente bidireccional. Muchas carpetas de respaldo de Android funcionan mejor como Send Only desde el teléfono.

Configuración recomendada

Para un uso doméstico con NAS, una configuración sólida sería:

Syncthing en Docker o paquete nativo dentro del NAS.
Android con Syncthing-Fork.
Fotos del teléfono como Send Only.
Carpeta del NAS como Receive Only.
Ejecución del teléfono solo con Wi-Fi y durante la carga.
Versionado de archivos activado en el NAS para carpetas importantes.

Con esta estructura, Android no necesita estar sincronizando todo el día, el NAS recibe las fotos de forma ordenada y el riesgo de borrar accidentalmente una copia importante baja mucho.

Resumen

En Android, Syncthing funciona mejor cuando aceptas las particularidades del sistema: permisos explícitos, batería agresiva y rutas de almacenamiento más restringidas. Syncthing-Fork suaviza bastante esos problemas y añade justo las opciones que hacen falta para un teléfono.

Para fotos, quédate con esta combinación: teléfono en Send Only, PC o NAS en Receive Only, rutas claras y sincronización limitada a Wi-Fi y carga. Es una configuración simple, pero aguanta muy bien en el uso real.

Cómo configurar Syncthing con varios dispositivos: redes entre pares, topología en estrella e introducers

Sun, 31 May 2026 12:13:57 +0800

Serie Syncthing

Syncthing usa una arquitectura P2P descentralizada. No existe una separación tradicional entre Server y Client. A nivel de protocolo, todos los dispositivos son pares.

En el uso real, sin embargo, puedes organizarlo de dos formas habituales:

Red puramente entre pares: cada dispositivo se empareja directamente con los demás.
Red en estrella: un NAS, servidor u ordenador siempre encendido actúa como nodo central, y los demás dispositivos solo se emparejan con él.

Ambas formas encajan con el diseño de Syncthing. La diferencia está en el coste de gestión y en el flujo de trabajo diario.

Entender primero los pares y el pseudo servidor

Cada dispositivo de Syncthing tiene su propio device ID. Cuando dos dispositivos añaden el ID del otro y comparten la misma carpeta, pueden sincronizarse.

Esto significa que Syncthing no exige que un servidor guarde todos los datos. Lo que solemos llamar “servidor” suele ser simplemente un dispositivo siempre encendido que elegimos como centro operativo.

Por ejemplo:

Un NAS suele estar encendido, tiene mucho espacio y funciona bien como nodo central.
Los teléfonos y portátiles se desconectan con frecuencia, así que conviene tratarlos como dispositivos de borde.
Un sobremesa puede ser potente, pero quizá no esté encendido 24 horas, así que normalmente es un nodo de sincronización común.

Ese nodo central no es un servidor a nivel de protocolo. Es el dispositivo al que le asignas tareas de gestión y tránsito dentro de tu topología.

Modo 1: red Peer Mesh pura

En el modo puramente entre pares, cada dispositivo se empareja con todos los demás.

Por ejemplo, si tienes cuatro dispositivos:

NAS
Sobremesa
Portátil
Teléfono

Cada dispositivo necesita conectarse con los otros tres. Así, cualquier par de dispositivos en línea puede sincronizarse directamente.

Ventajas:

Las rutas de transferencia son más directas.
Si un dispositivo está desconectado, los demás dispositivos en línea pueden seguir sincronizándose entre sí.
No dependes de un único nodo central.

Desventajas:

Cuantos más dispositivos hay, más complejas son las relaciones de emparejamiento.
Al añadir un nuevo dispositivo, hay que confirmar y configurar varias máquinas existentes.
Las relaciones de carpetas compartidas pueden quedar dispersas.

Cuando tienes pocos dispositivos, el modo puramente entre pares es cómodo. Si solo hay un ordenador y un teléfono, o dos ordenadores sincronizando notas, no hace falta complicarlo.

Pero cuando el número de dispositivos llega a cinco o seis, mantener a mano una malla completa se vuelve cada vez más pesado.

Modo 2: topología en estrella centrada en el NAS

La topología en estrella suele ser mejor para hogares y productividad personal.

Elige un dispositivo que permanezca encendido, tenga espacio suficiente y una conexión estable, por ejemplo:

NAS
Synology
Router ligero
Mini PC
Servidor Linux doméstico

Después, los demás dispositivos se emparejan solo con ese centro:

1
2
3

Teléfono  ----\
Portátil  ---- NAS
Sobremesa ----/

El teléfono no necesita emparejarse directamente con el portátil, y el portátil tampoco necesita emparejarse directamente con el sobremesa. Todos sincronizan indirectamente a través del NAS.

Ventajas:

La gestión es sencilla.
Un nuevo dispositivo solo necesita emparejarse con el NAS.
El NAS puede encargarse del versionado y del búfer de copia de seguridad.
Encaja bien con sincronización 24/7.

Desventajas:

Si el NAS está desconectado, los demás dispositivos quizá no puedan seguir sincronizándose entre sí.
Si todo el tráfico pasa por el NAS, su red y su disco afectan a la experiencia.
Hay que gestionar bien los permisos del nodo central.

Si ya tienes un NAS o un mini servidor siempre encendido, la topología en estrella es la recomendación principal. Mantiene las capacidades P2P de Syncthing y hace que la gestión diaria se parezca más a una sincronización centralizada.

Orden básico para configurar varios dispositivos

Independientemente de la topología, el orden de configuración en Syncthing es:

Emparejar primero los dispositivos.
Compartir después las carpetas.
Confirmar al final la ruta local en el receptor.

No empieces creando carpetas por todas partes. Aclara primero las relaciones entre dispositivos y lo demás será mucho menos caótico.

Paso 1: conectar dispositivos

Supongamos que quieres conectar el dispositivo A y el dispositivo B.

El dispositivo A puede ser un teléfono, y el dispositivo B puede ser un NAS u ordenador.

En el dispositivo A:

Abre la Web UI de Syncthing.
Haz clic en Actions en la esquina superior derecha.
Elige Show ID.
Copia el device ID o muestra el código QR.

En el dispositivo B:

Abre la Web UI de Syncthing.
Haz clic en Add Remote Device.
Introduce el ID del dispositivo A.
Ponle un nombre fácil de reconocer, como My-Phone.
Guarda.

Después vuelve al dispositivo A. Normalmente aparecerá un aviso diciendo que el dispositivo B quiere conectarse. Acéptalo.

En este punto, los dos dispositivos ya tienen una relación entre pares, pero todavía no se sincroniza ninguna carpeta.

Paso 2: crear y compartir una carpeta

En el dispositivo A, haz clic en Add Folder.

Campos habituales:

Etiqueta de carpeta: nombre visible para ti, por ejemplo Notes.
Folder ID: identificador entre dispositivos. Usa un nombre estable en inglés, como notes.
Ruta de carpeta: la ruta real en este dispositivo.

Luego cambia a la pestaña Sharing y marca el dispositivo B que acabas de emparejar.

Tras guardar, el dispositivo A enviará una invitación para compartir esa carpeta al dispositivo B.

Paso 3: aceptar la carpeta compartida

Abre la Web UI del dispositivo B y espera unos segundos. Normalmente verás un aviso como:

`1`	`Device A wants to share a folder`

Haz clic en añadir y elige una ruta local de almacenamiento en el dispositivo B.

Por ejemplo:

`1`	`/volume1/notes`

O, en un despliegue con Docker, una ruta dentro del contenedor:

`1`	`/var/syncthing/notes`

Después de guardar, empieza la sincronización.

Ten en cuenta que las rutas no tienen que ser iguales en todos los dispositivos. Syncthing identifica la relación por Folder ID y no exige que cada dispositivo use la misma ruta local.

Cómo configurar la topología en estrella

Si usas el modelo centrado en NAS, una buena configuración sería:

Desplegar primero Syncthing en el NAS.
Emparejar todos los teléfonos, ordenadores y servidores solo con el NAS.
Crear o aceptar las carpetas principales de sincronización en el NAS.
Cada nuevo dispositivo solo necesita añadir el device ID del NAS.
Compartir cada carpeta entre el NAS y los dispositivos que la necesiten.

Por ejemplo:

NAS
├── notes       -> sobremesa, portátil, teléfono
├── photos      -> teléfono, disco de copia
├── downloads   -> sobremesa, NAS
└── scripts     -> sobremesa, portátil

La estructura queda muy clara. Puedes tratar el NAS como el panel de control de las relaciones de sincronización.

Qué es un introducer

Syncthing tiene una función muy útil llamada Introducer.

Está pensada para escenarios con varios dispositivos.

Supón que configuras el NAS como introducer. Después, cuando un nuevo dispositivo se empareja con el NAS, el NAS puede presentarle los demás dispositivos que conoce. También puede ayudar a propagar relaciones compartidas existentes.

Esto reduce clics repetidos y emparejamientos manuales.

Es útil cuando:

Tienes varios ordenadores y teléfonos en casa.
El NAS actúa como nodo central permanente.
Añades dispositivos con frecuencia.
Quieres reducir el mantenimiento manual de las relaciones entre dispositivos.

Pero hay que tener cuidado. Un introducer amplía el alcance de las relaciones creadas automáticamente. No configures como introducer un dispositivo que no sea de plena confianza, ni lo actives sin entender la topología.

Una regla más segura:

Solo configura el NAS o el servidor principal como introducer.
No conviertas teléfonos o portátiles comunes en introducers.
Después de añadir un nuevo dispositivo, revisa qué dispositivos y carpetas se añadieron automáticamente.

El tipo de carpeta decide la dirección de los datos

El control de permisos de Syncthing se refleja sobre todo en el tipo de carpeta.

Entra en la configuración de la carpeta y ajusta Folder Type.

Hay tres tipos frecuentes:

Send & Receive

Es el modo predeterminado. Ambas partes pueden enviar y recibir cambios.

Sirve para:

Editar notas desde varios dispositivos.
Sincronizar documentos entre varios ordenadores.
Carpetas normales de sincronización bidireccional.

Es el modo más cercano a una sincronización realmente entre pares.

Send Only

Este dispositivo solo envía y no acepta cambios de otros dispositivos.

Sirve para:

Carpetas que son fuente de datos.
Distribuir una carpeta principal a otros dispositivos.
Evitar que cambios remotos afecten a este dispositivo.

Por ejemplo, puedes poner en Send Only una carpeta de instaladores en el NAS para que otros ordenadores solo la reciban.

Receive Only

Este dispositivo solo recibe y no envía cambios locales hacia fuera.

Sirve para:

Máquinas de copia de seguridad.
Espejos de solo lectura.
Evitar que una eliminación local accidental afecte a la carpeta principal.

Por ejemplo, si el NAS recibe fotos de un teléfono y no quieres que borrar fotos en el teléfono borre también la copia del NAS, debes diseñar con cuidado los tipos de carpeta y la política de eliminación.

Diferentes carpetas pueden usar diferentes topologías

La topología de Syncthing no tiene que ser única para todo el sitio. Puedes diseñarla por carpeta.

Por ejemplo:

notes: sobremesa, portátil, teléfono y NAS usan Send & Receive.
photos: el teléfono envía, el NAS recibe y conserva versiones.
downloads: sincronizan el sobremesa y el NAS; el teléfono no participa.
backup: el ordenador principal está en Send Only y el NAS en Receive Only.

No metas todas las carpetas en una sola regla. En sincronización multi-dispositivo, lo importante es la dirección de los datos, no el número de dispositivos.

Pensar antes en conflictos y borrados accidentales

El problema más común en la sincronización multi-dispositivo no es que falle la configuración. Es que, después de funcionar, aparecen borrados accidentales o conflictos.

Escenarios de riesgo:

Dos dispositivos editan el mismo archivo al mismo tiempo.
Una app móvil limpia automáticamente una carpeta.
Un dispositivo usa una ruta equivocada, crea una carpeta vacía y la sincroniza.
Se sincronizan juntos cachés, temporales, estado del espacio de trabajo y archivos reales.
El NAS no tiene versionado activado.

Recomendaciones:

Activa el versionado de archivos en el NAS para carpetas importantes.
Usa .stignore para excluir cachés y archivos temporales.
Antes de la primera sincronización de una carpeta nueva, prueba con pocos archivos.
Si la política de borrado no está clara, no pongas todos los dispositivos en Send & Receive.

Configuración recomendada

Si tienes un NAS o servidor siempre encendido, usa directamente topología en estrella:

Usa el NAS como nodo central.
Empareja el NAS con todos los dispositivos.
Los dispositivos comunes se emparejan solo con el NAS.
El NAS puede configurarse como introducer.
Elige Send & Receive, Send Only o Receive Only por carpeta.
Activa versionado de archivos en el NAS para carpetas importantes.
Tras añadir un nuevo dispositivo, comparte primero una carpeta de prueba para confirmar ruta y permisos.

Si solo tienes dos o tres dispositivos, y suelen estar en línea, el modo puramente entre pares también está bien. Es más directo y puede ser más rápido.

Resumen

Syncthing tiene una arquitectura P2P entre pares, pero eso no significa que tengas que convertir todos los dispositivos en una malla compleja.

En configuraciones pequeñas puedes usar el modo puramente entre pares. Cuando hay muchos dispositivos, un NAS o un host siempre encendido, suele ser mejor la topología en estrella. Deja que el NAS actúe como nodo central e introducer, y que los demás dispositivos se conecten solo con él. La gestión se vuelve mucho más sencilla.

Lo importante es decidir qué dispositivos son de confianza, qué carpetas deben sincronizarse, de dónde vienen los datos y quién conserva versiones cuando ocurre un borrado accidental. La topología es solo el método; el flujo de datos es el núcleo de la configuración.

Desplegar Syncthing con Docker: Compose, puertos y mapeo de directorios

Sun, 31 May 2026 12:12:05 +0800

Serie Syncthing

Desplegar Syncthing en Docker encaja muy bien en un NAS, un servidor doméstico o un VPS. Puede actuar como un nodo de sincronización siempre encendido para fotos, documentos, notas Markdown o carpetas de descargas.

Lo importante al desplegar Syncthing con Docker no es solo que el contenedor arranque. Hay tres puntos que conviene resolver desde el principio:

persistir el directorio de configuración;
mapear en el contenedor las carpetas de datos que se quieren sincronizar;
preparar puertos y permisos antes de empezar.

Si estos detalles quedan mal, una actualización del contenedor puede hacerte perder la configuración, la ruta que escribas en el Web UI puede no apuntar a la carpeta real del host, o la sincronización puede fallar con Permission denied.

Planificación de directorios

Primero crea un directorio dedicado en el servidor o NAS, por ejemplo:

1
2

mkdir -p ~/syncthing
cd ~/syncthing

Coloca docker-compose.yml en ese directorio y guarda la configuración de Syncthing en un subdirectorio:

1
2
3

syncthing/
├── docker-compose.yml
└── config/

Los datos reales que se van a sincronizar pueden estar en rutas existentes del host, por ejemplo:

1
2

/volume1/downloads
/volume1/photos

Separa el directorio de configuración de los directorios de datos. config guarda la configuración propia de Syncthing, sus claves y la base de datos de índices. Carpetas como downloads y photos son los datos reales que quieres sincronizar.

Opción 1: Docker Compose

Para uso permanente es mejor Docker Compose, porque las actualizaciones, reinicios y migraciones quedan mucho más claros.

Escribe esto en ~/syncthing/docker-compose.yml:

version: "3"

services:
  syncthing:
    image: syncthing/syncthing:latest
    container_name: syncthing
    hostname: my-nas-syncthing
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    volumes:
      - ./config:/var/syncthing/config
      - /volume1/downloads:/var/syncthing/downloads
      - /volume1/photos:/var/syncthing/photos
    ports:
      - 8384:8384
      - 22000:22000/tcp
      - 22000:22000/udp
      - 21027:21027/udp
    restart: unless-stopped

Arranca el servicio:

`1`	`docker compose up -d`

Comprueba el estado:

1
2

docker compose ps
docker logs -f syncthing

Abre el Web UI:

`1`	`http://ip-del-servidor:8384`

La primera vez que entres, configura antes que nada un usuario y una contraseña para la GUI.

Opción 2: docker run

Para una prueba rápida, también puedes usar directamente docker run:

docker run -d \
  --name syncthing \
  --hostname my-nas-syncthing \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -p 8384:8384 \
  -p 22000:22000/tcp \
  -p 22000:22000/udp \
  -p 21027:21027/udp \
  -v /path/to/config:/var/syncthing/config \
  -v /path/to/data1:/var/syncthing/data1 \
  --restart unless-stopped \
  syncthing/syncthing:latest

Sustituye /path/to/config y /path/to/data1 por rutas reales del host.

Por ejemplo:

1
2

-v /volume1/docker/syncthing/config:/var/syncthing/config
-v /volume1/photos:/var/syncthing/photos

Para uso a largo plazo, conviene convertirlo en un archivo Compose y evitar reconstruir el comando completo cada vez que recrees el contenedor.

Rutas del contenedor y rutas del host

El punto que más confunde al empezar con Docker son las rutas.

Por ejemplo, en Compose puedes tener:

1
2

volumes:
  - /volume1/photos:/var/syncthing/photos

La parte izquierda, /volume1/photos, es la ruta del host. La parte derecha, /var/syncthing/photos, es la ruta dentro del contenedor.

Cuando añadas una carpeta de sincronización en el Web UI de Syncthing, la ruta de carpeta debe ser la ruta dentro del contenedor:

`1`	`/var/syncthing/photos`

Así Syncthing operará realmente sobre esta ruta del host:

`1`	`/volume1/photos`

Si escribes /volume1/photos en el Web UI, esa ruta normalmente no existe dentro del contenedor. Syncthing puede mostrar un error o crear una carpeta nueva dentro del sistema de archivos del contenedor, que no es lo que querías.

La configuración debe ser persistente

Esta línea es crítica:

`1`	`- ./config:/var/syncthing/config`

Syncthing guarda sus archivos de configuración, claves de dispositivo y base de datos de índices en el directorio de configuración. Si no lo montas en el host, al borrar o recrear el contenedor puede cambiar el device ID y dejar sin efecto los emparejamientos existentes.

Usa una ruta estable, por ejemplo:

`1`	`/volume1/docker/syncthing/config`

No pongas la configuración en un directorio temporal, ni la mezcles con los directorios de datos sincronizados.

Puertos y firewall

Los puertos habituales son:

8384/TCP   Administración Web UI
22000/TCP Tráfico de sincronización entre dispositivos
22000/UDP Tráfico de sincronización QUIC
21027/UDP Descubrimiento en red local

Si Syncthing está desplegado en un NAS doméstico, normalmente debes revisar:

si el firewall del NAS permite estos puertos;
si el mapeo de puertos del puente Docker es correcto;
si el router separa la red Wi-Fi de la red cableada;
si el teléfono y el ordenador están en la misma subred.

Si está desplegado en un servidor cloud, revisa también el grupo de seguridad del proveedor. En especial, si 22000/TCP y 22000/UDP no están abiertos, otros dispositivos quizá solo puedan conectar mediante relay, con una velocidad mucho menor.

8384 es el puerto de administración. No lo expongas directamente a Internet. Si necesitas administración remota, usa al menos una contraseña fuerte y, mejor aún, combínalo con proxy inverso, HTTPS, control de acceso o VPN.

Problemas de permisos: PUID y PGID

Si Syncthing arranca y puedes abrir el Web UI, pero una carpeta de sincronización muestra:

`1`	`Permission denied`

normalmente el proceso del contenedor no tiene permisos de lectura y escritura sobre la carpeta del host.

Primero comprueba el UID y GID del usuario actual en el host:

id

La salida puede ser similar a:

`1`	`uid=1000(user) gid=1000(user) groups=1000(user)`

Luego ajusta las variables de entorno en Compose:

1
2
3

environment:
  - PUID=1000
  - PGID=1000

Confirma también que la propia carpeta del host permite leer y escribir a ese usuario:

`1`	`ls -ld /volume1/photos`

Si hace falta, ajusta propietario o permisos:

`1`	`sudo chown -R 1000:1000 /volume1/photos`

En un NAS, no cambies de forma recursiva los permisos de toda una carpeta compartida sin pensarlo, sobre todo si la usan varias personas. Es más seguro preparar una carpeta de sincronización dedicada para Syncthing, o conceder permisos al usuario correspondiente desde la interfaz de permisos del NAS.

Seguridad inicial del Web UI

Después de arrancar el contenedor, visita:

`1`	`http://ip-del-servidor:8384`

En la primera entrada, Syncthing normalmente te pedirá configurar usuario y contraseña para la GUI. No omitas este paso.

Recomendaciones:

configura de inmediato un usuario GUI y una contraseña fuerte;
no expongas 8384 a Internet;
para acceso remoto, prioriza VPN, túnel SSH o un proxy inverso controlado;
si usas proxy inverso, asegúrate de exponer solo el Web UI y no otros puertos innecesarios.

Si alguien controla el panel de administración, podría añadir dispositivos, modificar carpetas compartidas y cambiar relaciones de sincronización. Syncthing cifra la transferencia de datos, pero el punto de administración también necesita protección.

Añadir carpetas de sincronización en el Web UI

Tomemos una carpeta de fotos como ejemplo. En Compose ya está montada así:

`1`	`- /volume1/photos:/var/syncthing/photos`

Al añadir la carpeta en el Web UI:

Folder Label: puedes usar Photos;
Folder ID: usa un ID estable en inglés, por ejemplo photos;
Folder Path: escribe /var/syncthing/photos;
Sharing: elige los dispositivos con los que compartirla;
Folder Type: elige Send & Receive, Send Only o Receive Only según el flujo de datos.

Si este nodo Docker es el nodo central del NAS, algunas configuraciones comunes son:

documentos normales: Send & Receive;
recopilación de fotos del teléfono: Receive Only en el NAS;
carpeta de distribución hacia otros dispositivos: Send Only en el NAS.

La elección depende de la dirección real de los datos. No conviertas todas las carpetas en sincronización bidireccional por inercia.

Actualizar el contenedor

Con Compose, una actualización suele ser:

1
2

docker compose pull
docker compose up -d

Mientras el directorio de configuración y los directorios de datos estén bien montados, actualizar el contenedor no hará que se pierdan el device ID, los emparejamientos ni la configuración de carpetas.

Antes de actualizar, puedes hacer una copia del directorio de configuración:

`1`	`tar -czf syncthing-config-backup.tar.gz ./config`

El directorio de configuración contiene claves privadas del dispositivo. No subas esa copia a ubicaciones públicas sin cuidado.

Problemas frecuentes

El Web UI no abre

Primero comprueba que el contenedor esté ejecutándose:

1
2

docker ps
docker logs syncthing

Después revisa el mapeo de puertos:

`1`	`docker port syncthing`

Si el contenedor está bien pero la página no abre, revisa el firewall del host, el firewall del NAS o el grupo de seguridad del servidor cloud.

La carpeta añadida dice que no existe

Comprueba si la ruta que escribiste en el Web UI es la ruta dentro del contenedor.

Por ejemplo, si la ruta del host es:

`1`	`/volume1/downloads`

y la ruta dentro del contenedor es:

`1`	`/var/syncthing/downloads`

en el Web UI debes escribir la segunda.

Solo conecta por Relay y va muy lento

Revisa primero:

si 22000/TCP está permitido;
si 22000/UDP está permitido;
si el reenvío de puertos del router es correcto;
si el grupo de seguridad cloud permite TCP y UDP;
si el firewall local bloquea los puertos mapeados por Docker.

Relay mejora la conectividad, pero no es adecuado para soportar grandes volúmenes de sincronización de forma permanente.

Los permisos de archivos quedan mal después de sincronizar

Primero confirma que el usuario de ejecución del contenedor sea correcto, y luego revisa los permisos de la carpeta del host. Linux, NAS y carpetas compartidas de Windows usan modelos de permisos distintos. No uses Syncthing como herramienta para reparar permisos.

Para sincronización entre sistemas, intenta sincronizar archivos y directorios normales. Evita carpetas del sistema que dependan de ACL complejas, propietarios o atributos extendidos.

Una forma más estable de usarlo

Si tu objetivo es usar un NAS o servidor como nodo central, puedes diseñarlo así:

Ejecuta Syncthing con Docker en el NAS.
Monta el directorio de configuración en /volume1/docker/syncthing/config.
Monta cada tipo de dato por separado, por ejemplo /volume1/photos y /volume1/notes.
Añade el device ID del NAS desde teléfonos y ordenadores.
Activa el versionado de archivos en carpetas importantes del lado del NAS.
Accede al Web UI solo desde la LAN o mediante VPN.
Haz también una copia de seguridad independiente del NAS. No trates la sincronización como la única copia.

Con este diseño, Syncthing se encarga de la sincronización entre dispositivos, el NAS aporta disponibilidad permanente y una capa de versionado, y la copia de seguridad real queda en snapshots, discos externos o backups fuera del sitio.

Resumen

La clave para desplegar Syncthing con Docker es separar el ciclo de vida del contenedor del ciclo de vida de los datos sincronizados.

El contenedor puede actualizarse, recrearse o migrarse en cualquier momento. Pero el directorio de configuración y los directorios de datos deben permanecer estables en el host. En el Web UI se introducen rutas internas del contenedor; los permisos del host se gestionan con PUID, PGID y permisos de directorio; y los puertos deben abrirse según el entorno de red real.

Cuando estas piezas están claras, Syncthing funciona muy bien como una capa ligera de sincronización entre un NAS, un servidor y dispositivos personales.

Cómo usar Syncthing: notas prácticas desde el emparejamiento de dispositivos hasta la sincronización de archivos

Sun, 31 May 2026 11:59:09 +0800

Índice de la serie Syncthing

Syncthing sirve para sincronizar archivos punto a punto entre varios dispositivos. No es una nube tradicional, ni sube primero todos los datos a un servidor central para descargarlos después. Los dispositivos autorizados intercambian archivos directamente.

Si quieres usarlo para notas Markdown, copias de fotos, archivos de configuración o carpetas de un NAS doméstico, la primera pregunta no es solo si puede sincronizar. Conviene entender antes dispositivos, carpetas, ID de dispositivo, dirección de sincronización, descubrimiento y manejo de conflictos.

Qué problema resuelve Syncthing

El caso central de Syncthing es sencillo: tienes dos o más dispositivos y quieres mantener una carpeta en el mismo estado entre ellos.

Ejemplos típicos:

Sincronizar archivos de trabajo entre un escritorio Windows y un portátil.
Sincronizar fotos o documentos entre un teléfono y un NAS.
Sincronizar scripts, ejemplos de configuración o pequeñas carpetas de referencia entre servidores Linux.
Mantener notas de Obsidian, adjuntos externos de Joplin o carpetas Markdown en varios dispositivos.

Encaja mejor cuando quieres controlar tus propios dispositivos y datos. Si necesitas permisos de equipo, previsualización web, enlaces compartidos o edición colaborativa, una nube o plataforma documental convencional puede ser más adecuada.

Qué ocurre en el primer arranque

La guía oficial de inicio recomienda configurar dos máquinas en paralelo. En Syncthing, cada máquina es un device. La máquina que estás configurando es el local device; la otra máquina que sincronizará contigo es el remote device.

Al arrancar por primera vez, Syncthing crea su configuración, claves criptográficas e ID de dispositivo. También abre por defecto la interfaz web local:

`1`	`http://127.0.0.1:8384/`

Esta Web GUI es la entrada habitual de configuración. Syncthing también puede crear una carpeta predeterminada, normalmente una carpeta Sync bajo el perfil del usuario. Puedes usarla para probar o eliminarla después y añadir tus propias carpetas.

El device ID es la base del emparejamiento

Syncthing empareja dispositivos mediante device IDs.

Cada dispositivo genera su propia clave en el primer arranque. El device ID es una huella legible del certificado de ese dispositivo. Dos dispositivos solo establecen una relación de sincronización después de añadir el ID del otro.

Un flujo típico:

Iniciar Syncthing en ambos dispositivos.
Abrir la Web GUI en ambos lados.
Añadir el device ID de B en A.
Añadir el device ID de A en B.
Elegir qué carpetas compartir.
Guardar y esperar la conexión.

El device ID no se protege como una contraseña, pero tampoco conviene publicar tu topología de sincronización sin necesidad. Lo que sí debe protegerse es la clave privada del dispositivo, el acceso a la Web GUI y las carpetas sincronizadas.

Syncthing no sincroniza toda la máquina

Syncthing sincroniza solo las carpetas que añades explícitamente. No sincroniza todo el dispositivo por defecto.

Cada carpeta tiene su propia ruta, ID, dispositivos compartidos y tipo. Es mejor separar por uso:

notes/: notas Markdown.
photos-inbox/: entrada de fotos del teléfono.
docs/: documentos compartidos entre dispositivos.
scripts/: scripts y ejemplos de configuración.

No empieces sincronizando directorios del sistema, descargas completas o carpetas mezcladas. Cuanto más compleja sea la carpeta, más fácil será que conflictos, reglas de exclusión, permisos y coste de escaneo se vuelvan un problema de mantenimiento.

Tres tipos de carpeta habituales

La documentación oficial explica bien los tipos de carpeta. En la práctica, basta con dominar estos tres.

Send & Receive

Es el modo predeterminado. La carpeta envía cambios locales y recibe cambios remotos.

Sirve para:

Editar notas en varios dispositivos.
Mantener documentos en varias máquinas.
Sincronización bidireccional normal.

Si dos dispositivos modifican el mismo archivo al mismo tiempo, Syncthing crea un archivo de conflicto en lugar de sobrescribir silenciosamente una versión.

Send Only

En este modo, la carpeta local actúa como copia de referencia. Envía cambios a otros dispositivos, pero no aplica los cambios que llegan de ellos.

Sirve para:

Distribuir archivos desde un dispositivo principal a otros.
Hacer que una máquina sea la fuente de verdad.
Evitar que cambios remotos afecten a la carpeta local.

Si aparecen cambios remotos, la carpeta local puede mostrarse como out of sync. La Web GUI puede ofrecer Override Changes, que empuja el estado local al resto del clúster. Úsalo con cuidado.

Receive Only

Es lo contrario de Send Only. La carpeta recibe cambios del clúster, pero sus cambios locales no se envían a otros dispositivos.

Sirve para:

Destinos de copia.
Réplicas de solo lectura.
Dispositivos donde un error local no debe contaminar el conjunto principal.

Si hay cambios locales, la Web GUI puede ofrecer Revert Local Changes para volver al estado del clúster.

Revisar firewall y puertos primero

Syncthing puede usar discovery, NAT y relay, pero cuanto más claro tengas el entorno de red, más estable será la conexión.

Los puertos importantes de la guía oficial de firewall son:

1
2
3

22000/TCP
22000/UDP
21027/UDP

Donde:

22000/TCP se usa para tráfico de sincronización TCP.
22000/UDP se usa para sincronización QUIC.
21027/UDP se usa para descubrimiento local.

Si los dispositivos están en la misma LAN pero no se descubren, revisa primero firewalls locales, aislamiento del router y si Wi-Fi y red cableada están en segmentos distintos.

Entre redes públicas o detrás de NAT, la conexión directa suele ser más rápida que relay cuando puedes hacer port forwarding. Sin port forwarding, relay puede ayudar a conectar, pero el rendimiento suele ser peor.

En Linux, si usas ufw y existe el perfil correspondiente:

1
2

sudo ufw allow syncthing
sudo ufw status verbose

La Web GUI escucha por defecto en 127.0.0.1:8384. Si la cambias a 0.0.0.0:8384, la interfaz de administración queda accesible desde fuera de la máquina. Entonces debes pensar en contraseña, HTTPS, proxy inverso o túnel SSH. Para uso doméstico, un túnel SSH suele ser más seguro.

`.stignore` va en la raíz sincronizada

Si algunos archivos no deben sincronizarse, crea .stignore en la raíz de la carpeta sincronizada.

Detalles importantes:

.stignore debe estar en la raíz de la carpeta sincronizada.
Las reglas son relativas a esa raíz.
.stignore no se sincroniza a otros dispositivos.
El archivo debe usar UTF-8.

Ejemplo simple:

(?d).DS_Store
node_modules
*.tmp
cache/**
!/cache/keep.txt

(?d) permite que Syncthing elimine esos archivos ignorados cuando de otro modo impedirían borrar un directorio. Es útil para archivos generados como .DS_Store.

El signo ! niega una regla y vuelve a incluir un archivo. Las reglas negativas complejas pueden hacer que Syncthing recorra directorios que de otro modo ignoraría, así que conviene empezar con patrones simples.

El versionado no es deshacer local

Syncthing admite versionado de archivos, pero su significado se confunde con facilidad.

La documentación oficial recalca que el versionado guarda la versión local antigua cuando un cambio remoto la reemplaza. Si B modifica un archivo y lo sincroniza hacia A, A puede conservar la versión reemplazada. Pero si A edita un archivo localmente, Syncthing no conserva automáticamente la versión previa de A.

Estrategias comunes:

Trash Can File Versioning: mueve archivos reemplazados o borrados a .stversions.
Simple File Versioning: conserva un número fijo de versiones.
Staggered File Versioning: conserva versiones recientes más densas y versiones antiguas más espaciadas.
External File Versioning: delega el manejo a un script externo.

Para documentos importantes, activa al menos versionado simple o tipo papelera en el destino de copia. No sustituye una copia de seguridad completa, pero reduce daños por borrado o sobrescritura accidental.

Cómo aparecen los conflictos

Syncthing detecta conflictos. Si dos dispositivos cambian el mismo archivo de forma distinta al mismo tiempo, puede crear un archivo como:

`1`	`filename.sync-conflict-date-time-modifiedBy.ext`

Es más seguro que sobrescribir en silencio, pero tendrás que limpiar esos archivos.

Escenarios frecuentes:

Abrir la misma nota Markdown en varios dispositivos a la vez.
Aplicaciones que escriben automáticamente el mismo archivo de estado.
Sincronizar archivos específicos de dispositivo como .obsidian/workspace.json.
Diferencias de mayúsculas y minúsculas entre Windows, macOS y Android.

Para notas, sincroniza primero texto, adjuntos y plantillas. Ten cuidado con estado de espacio de trabajo, cachés y archivos temporales de plugins; ponlos en .stignore si hace falta.

Límites de seguridad

Uno de los objetivos de seguridad de Syncthing es que dispositivos no autorizados no puedan unirse al clúster y que un observador pasivo no pueda leer archivos en tránsito.

La documentación de seguridad explica que el tráfico entre dispositivos está protegido por TLS, y que los pares verifican que la huella del certificado del dispositivo esté en la lista permitida. En la práctica, los dispositivos solo sincronizan cuando ambos lados tienen configurados los device IDs correctos.

Eso no significa que el uso de Syncthing sea invisible:

Global discovery anuncia device IDs y direcciones de escucha.
Local discovery emite en la LAN.
Los relay servers pueden ver device IDs, aunque no descifrar los datos.
Una Web GUI expuesta revela que la máquina ejecuta Syncthing.

Consejos prácticos:

No expongas la Web GUI a internet salvo que la autenticación y el cifrado estén bien configurados.
Añade solo dispositivos de confianza.
Combina carpetas importantes con cifrado de disco o copias separadas.
Puedes desactivar global discovery, relays o auto-upgrade si el entorno lo requiere, aceptando menos comodidad de conexión.

Dispositivos no confiables cifrados

Syncthing también admite dispositivos no confiables cifrados. Permite que un dispositivo no confiable almacene solo datos cifrados.

Un caso típico es usar un servidor en la nube o máquina externa como nodo de sincronización o copia, sin permitirle ver archivos en claro. Los dispositivos confiables cifran con la contraseña de carpeta antes de enviar; otros dispositivos confiables con la misma contraseña pueden sincronizar y descifrar.

La documentación oficial sigue tratando esta función como beta/testing. Es útil para necesidades claras, pero no es el punto de partida más simple.

Recuerda:

Datos, nombres, marcas de tiempo, hashes y estructura de carpetas quedan protegidos.
Folder ID, etiqueta y tamaño aproximado no se ocultan por completo.
La contraseña y el folder ID deben guardarse bien.
En el dispositivo no confiable, el tipo de carpeta debe ser Receive Encrypted.

Para un NAS doméstico, tus propios equipos y teléfonos, normalmente es más fácil usar dispositivos confiables, con inicio de sesión seguro, cifrado de disco y copias.

Consejos de configuración

Si vas a usar Syncthing para notas o documentos a largo plazo:

Crea carpetas separadas por tipo de dato. No uses una carpeta gigante mezclada.
Usa Send & Receive en los equipos principales.
Considera Receive Only con versionado en un NAS o máquina de copia.
En teléfonos, sincroniza solo directorios necesarios.
Usa .stignore para cachés, temporales y estado de workspace.
Asegúrate de que 22000/TCP, 22000/UDP y 21027/UDP funcionen en la LAN.
Mantén la Web GUI local si puedes; usa túneles SSH o VPN para administración remota.
No trates la sincronización como única copia de datos importantes.

Cuándo encaja y cuándo no

Syncthing encaja si:

Quieres que los datos permanezcan principalmente en tus dispositivos.
Puedes entender emparejamiento, carpetas y conflictos.
Tienes NAS, servidor doméstico o varios dispositivos personales.
Quieres sincronizar Markdown, carpetas de entrada de fotos, scripts o documentos ligeros.

No encaja tanto si:

Necesitas edición colaborativa en línea.
Necesitas previsualización web y enlaces compartidos.
Necesitas permisos de equipo detallados.
No quieres tocar red, firewall ni conflictos.

Conviene verlo como una capa fiable de sincronización entre dispositivos, no como una nube completa. Bien usado, conecta NAS, ordenadores y teléfonos en una red de datos controlada por ti. Mal planificado, puede convertirse en una carga por conflictos, borrados accidentales, reglas de exclusión y detalles de red.