Casos en los que Syncthing es adecuado:

• Sincronizar archivos entre Windows, macOS, Linux, Android y NAS;
• Querer un VPS como nodo de retransmisión y réplica siempre en línea;
• No querer entregar los archivos a un disco en la nube de terceros;
• Necesitar conexiones directas rápidas en la LAN y cambiar automáticamente a conexión directa o Relay en internet;
• Querer controlar por carpeta el envío, la recepción, la retención de versiones y las reglas de ignorado;
• Poder mantener tú mismo el VPS, los permisos, el cortafuegos y las copias de seguridad independientes.

Casos en los que no es adecuado:

• Necesitar que varias personas editen en línea el mismo documento de Office;
• Necesitar enlaces para compartir en el navegador, vistas previas en línea y permisos complejos;
• Tratar el directorio de sincronización como única copia de seguridad, sin instantáneas ni copias sin conexión;
• Necesitar auditoría empresarial estricta, aprobación de archivos y prevención de fuga de datos;
• Tener muchos archivos pequeños que cambian con frecuencia sin evaluar el coste de disco, base de datos y escaneo.

Si necesitas más acceso web y uso compartido al estilo de un disco en la nube, consulta el tutorial de OpenList en un VPS. Si gestionas principalmente contratos, facturas y escaneos, consulta el tutorial de archivado de documentos con OCR de Paperless-ngx.

Syncthing es ideal para "estos dispositivos son todos míos y quiero que los archivos se mantengan coherentes automáticamente". No tiene un sistema de cuentas central; cada dispositivo confía en otro mediante el Device ID, y las transferencias de archivos usan cifrado TLS.

Una arquitectura típica es la siguiente:

手机 ───────────────┐
                    │
笔记本 ── 直连/Relay ├── VPS Syncthing 常在线节点
                    │
家中 NAS ───────────┘

El VPS aporta tres ventajas principales:

1. Cuando otros dispositivos no están en línea al mismo tiempo, el VPS guarda la copia más reciente;
2. Cuando la red doméstica no tiene entrada pública, es más fácil que los dispositivos se conecten al VPS;
3. Puedes mantener directorios de versiones y copias de seguridad adicionales en el VPS.

Pero si el móvil y el portátil están en la misma LAN, Syncthing normalmente intentará una conexión directa en la LAN y no necesitará pasar por el VPS. No lo interpretes como un disco en la nube tradicional en el que todo el tráfico debe pasar por el VPS.

Este artículo se basa en la versión estable verificada en agosto de 2026:

Syncthing v2.1.3
Docker image: syncthing/syncthing:2.1.3

Puertos habituales:

Syncthing también puede usar Relays públicos. Aunque el 22000 no esté abierto al público, los dispositivos pueden conectarse a través de un Relay, pero la velocidad y la latencia suelen ser peores que con una conexión directa.

Syncthing en sí es ligero; los recursos se consumen principalmente en el escaneo de archivos, el cálculo de hashes, la indexación de la base de datos y la retención de versiones:

La capacidad del disco debe cubrir al menos:

当前同步数据
+ 文件版本目录
+ 临时下载文件
+ Syncthing 索引数据库
+ 独立备份预留

Si el directorio de origen tiene 100 GB y activas la retención de versiones a largo plazo, un VPS de 80 GB sin duda no será suficiente. El historial de versiones debe tener un periodo de retención y un número máximo; no puede crecer sin límite.

Comprueba Docker y Compose:

docker version
docker compose version

Si no tienes Docker, consulta primero la guía práctica de despliegue con Docker.

Crea los directorios de configuración, datos de sincronización y versiones:

sudo mkdir -p /opt/syncthing/config
sudo mkdir -p /opt/syncthing/data
sudo mkdir -p /opt/syncthing/versions
sudo chown -R 1000:1000 /opt/syncthing
sudo chmod 750 /opt/syncthing
cd /opt/syncthing

El contenedor oficial usa UID 1000 y GID 1000 por defecto. Comprueba primero los permisos de los directorios de destino en el host, para evitar que el contenedor arranque pero no pueda escribir los archivos sincronizados.

Crea /opt/syncthing/compose.yaml:

services:
  syncthing:
    image: docker.io/syncthing/syncthing:2.1.3
    container_name: syncthing
    hostname: vps-syncthing
    network_mode: host
    restart: unless-stopped
    environment:
      PUID: "1000"
      PGID: "1000"
      UMASK: "0022"
      STGUIADDRESS: ""
    volumes:
      - ./config:/var/syncthing/config
      - ./data:/var/syncthing/data
      - ./versions:/var/syncthing/versions
    healthcheck:
      test:
        - CMD-SHELL
        - curl -fkLsS -m 2 127.0.0.1:8384/rest/noauth/health | grep -q OK
      interval: 1m
      timeout: 10s
      retries: 3

La documentación oficial de Docker recomienda host network, porque la red bridge predeterminada hace que Syncthing solo vea la dirección del contenedor, lo que afecta al descubrimiento en la LAN y a la decisión de conexión directa. Con host network, Syncthing controla sus propias direcciones de escucha y puertos, por lo que la configuración del cortafuegos debe ser más cuidadosa.

Deja STGUIADDRESS vacío para que Syncthing use la dirección de la GUI del archivo de configuración. La configuración inicial suele escuchar en 127.0.0.1:8384, lo que evita exponer la interfaz de administración directamente a internet.

Comprueba la configuración:

cd /opt/syncthing
docker compose config --quiet

Inícialo:

docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=150 syncthing

Comprueba el estado de salud de la GUI:

curl -fsS http://127.0.0.1:8384/rest/noauth/health

Cuando esté correcto verás OK. Si se rechaza la conexión, revisa los registros del contenedor y la dirección de escucha:

sudo ss -lntup | grep -E ':(8384|22000)\b'
docker compose logs --tail=250 syncthing

Crea un túnel en tu propio ordenador:

ssh -L 8384:127.0.0.1:8384 your_user@your_vps_ip

Abre en el navegador:

http://127.0.0.1:8384

Tras iniciar sesión por primera vez, haz tres cosas de inmediato:

• Configura un nombre de usuario de la GUI y una contraseña fuerte e independiente;
• Confirma que la dirección de escucha de la GUI sigue siendo 127.0.0.1:8384;
• Asigna nombres claros a los dispositivos, por ejemplo vps-sync, home-nas, work-laptop.

El Device ID identifica el certificado del dispositivo, no es la contraseña de la GUI. Compártelo solo con los dispositivos que necesiten emparejarse; la API Key de la GUI y la contraseña de administrador deben mantenerse en secreto.

Si quieres que los dispositivos se conecten directamente al VPS, abre 22000 TCP y UDP:

sudo ufw allow 22000/tcp
sudo ufw allow 22000/udp
sudo ufw status numbered

Normalmente no abras 21027/UDP en un VPS público. Se usa principalmente para el descubrimiento por difusión en la LAN; la sincronización a través de internet depende del descubrimiento global, direcciones estáticas o Relay.

Confirma que 8384 no está expuesto públicamente:

sudo ufw status
sudo ss -lntp | grep ':8384'

Mientras la GUI escuche en 127.0.0.1, aunque el cortafuegos permita 8384 por error, el exterior normalmente no podrá conectarse. Pero una configuración segura debe restringir tanto la dirección de escucha como el cortafuegos; no dependas de una sola capa.

Si todos los dispositivos ya se han unido a WireGuard, puedes no abrir el 22000 público y permitir solo la subred de la VPN:

sudo ufw allow from 10.66.66.0/24 to any port 22000 proto tcp
sudo ufw allow from 10.66.66.0/24 to any port 22000 proto udp

En la dirección del dispositivo remoto del cliente, introduce:

tcp://10.66.66.1:22000
quic://10.66.66.1:22000

Después puedes desactivar el descubrimiento global y Relay para reducir la exposición de metadatos externos. Para desplegar WireGuard, consulta el tutorial de WireGuard VPN en un VPS.

Nota: tras desactivar el descubrimiento y Relay, una configuración de direcciones incorrecta no tendrá ruta de respaldo automática. Confirma el enrutamiento de la VPN y la accesibilidad del puerto 22000 antes de desactivar los mecanismos de conexión automática.

Busca el Device ID de este dispositivo en la GUI del VPS y, en otro dispositivo, elige Add Remote Device. Introduce el Device ID del VPS y configura el nombre y la dirección del dispositivo.

Proceso de emparejamiento recomendado:

1. En el dispositivo A, añade el dispositivo B;
2. En el dispositivo B, acepta el dispositivo pendiente;
3. Ambas partes verifican el Device ID mostrado;
4. No compartas todavía directorios importantes; comparte solo una carpeta de prueba;
5. Tras confirmar el tipo de conexión, la subida/descarga y el comportamiento de borrado, migra los datos.

Que un dispositivo muestre Connected no significa que la carpeta ya esté compartida. La confianza del dispositivo y el uso compartido de carpetas son dos capas de configuración distintas; debes seleccionar los dispositivos permitidos en la configuración de la carpeta.

Añade una carpeta en el VPS:

Folder Label: Personal Sync
Folder ID: personal-sync
Folder Path: /var/syncthing/data/personal
Folder Type: Send & Receive

El directorio correspondiente en el host es:

/opt/syncthing/data/personal

Créalo y corrige los permisos:

sudo mkdir -p /opt/syncthing/data/personal
sudo chown -R 1000:1000 /opt/syncthing/data/personal

El Folder ID debe ser idéntico entre los dispositivos que comparten la carpeta, pero la Folder Path puede ser distinta en cada dispositivo. Por ejemplo, Windows usa D:\Sync\Personal y el VPS usa /var/syncthing/data/personal.

El versionado de Syncthing protege principalmente frente a "eliminaciones y sobrescrituras sincronizadas desde otros dispositivos". Tipos habituales:

• Trash Can: mueve los archivos antiguos al directorio de versiones;
• Simple File Versioning: añade marcas de tiempo a las versiones antiguas y conserva un número fijo;
• Staggered File Versioning: conserva densamente las versiones recientes y de forma progresivamente más dispersa las antiguas;
• External File Versioning: llama a un script personalizado para gestionar las versiones.

En entornos domésticos y personales, puedes empezar con Staggered File Versioning y establecer el directorio de versiones en:

/var/syncthing/versions/personal

Ruta correspondiente en el host:

/opt/syncthing/versions/personal

Limitación importante: el versionado normalmente gestiona los cambios procedentes de dispositivos remotos. Si sobrescribes un archivo directamente en el mismo dispositivo localmente, no necesariamente se genera una versión de Syncthing. Los datos realmente importantes siguen necesitando instantáneas, restic o copias de seguridad en almacenamiento de objetos.

Crea .stignore en la raíz de la carpeta de sincronización para ignorar cachés, artefactos de compilación y archivos temporales:

(?d).DS_Store
Thumbs.db
~*
*.tmp
node_modules
.git
.cache

Verifica primero las reglas en un directorio de prueba. Ignorar archivos de base de datos, configuraciones de aplicaciones o directorios ocultos puede hacer que falten datos críticos durante la recuperación.

.stignore es una regla local del dispositivo; no supongas que se propagará automáticamente a todos los dispositivos como esperas. Cuando uses varios dispositivos, revisa las reglas de ignorado y los resultados de escaneo en cada uno.

Cuando dos dispositivos sin conexión modifican el mismo archivo a la vez, al reconectarse puede generarse un archivo similar a:

report.sync-conflict-20260808-103000-DEVICE.txt

Pasos de gestión:

1. Pausa la carpeta correspondiente;
2. Compara el archivo original y el archivo de conflicto;
3. Combina manualmente o conserva la versión correcta;
4. Elimina la copia de conflicto que no necesites;
5. Reanuda la sincronización y observa si vuelven a aparecer conflictos.

Syncthing no entiende la estructura interna de Word, Excel o las bases de datos y no puede combinar automáticamente archivos complejos. Los archivos con escritura continua como SQLite, discos de máquinas virtuales y bases de datos de correo no son adecuados para sincronización directa en tiempo real; usa la exportación propia de la aplicación o una copia de seguridad consistente.

Windows, macOS y Linux pueden usar los clientes de su plataforma correspondiente. En Android, las opciones habituales incluyen clientes mantenidos por la comunidad; iOS está limitado por la ejecución en segundo plano y el sistema de archivos, y el comportamiento de los clientes de terceros difiere de la versión de escritorio.

En móviles, ten en cuenta:

• Las políticas de ahorro de energía del sistema pueden pausar la sincronización en segundo plano;
• La sincronización por red móvil consume muchos datos;
• Los permisos del directorio de fotos pueden estar restringidos por el sistema;
• El cliente puede no seguir escaneando después de salir;
• Limita el alcance de la carpeta antes de la primera sincronización.

No empieces sincronizando todo el almacenamiento del móvil o el directorio personal del usuario. Empieza con una carpeta de prueba y verifica la carga, el Wi-Fi, el segundo plano y el comportamiento ante conflictos.

Syncthing propaga fielmente los cambios, incluidos los malos:

• Borrado accidental de archivos;
• Cifrado masivo por ransomware;
• Aplicaciones que escriben datos corruptos;
• Scripts defectuosos que renombran o vacían directorios;
• Usuarios que sobrescriben la versión incorrecta en todos los dispositivos.

Prepara al menos una copia de seguridad independiente:

Syncthing 实时同步
+ VPS/存储快照
+ restic 或 rclone 异地备份
+ 定期恢复演练

Consulta el tutorial de simulacro de copia de seguridad y restauración en un VPS.

Detén el contenedor antes de hacer copia de seguridad de la configuración de Syncthing:

cd /opt/syncthing
docker compose stop
sudo tar -czf syncthing-config-$(date +%F).tar.gz config compose.yaml
docker compose start
chmod 600 syncthing-config-*.tar.gz

Los datos de sincronización deben gestionarse con una herramienta de copia de seguridad independiente; no los empaquetes solo en el mismo disco del VPS.

Antes de actualizar, registra la imagen actual y haz copia de seguridad de la configuración:

cd /opt/syncthing
docker inspect syncthing --format '{{.Config.Image}}'
sudo tar -czf syncthing-before-upgrade-$(date +%F).tar.gz config compose.yaml

Tras cambiar la etiqueta de la imagen, ejecuta:

docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 syncthing

Tras actualizar, comprueba:

• El inicio de sesión en la GUI y la lista de dispositivos;
• El tipo de conexión directa, QUIC o Relay;
• El estado de escaneo y sincronización de las carpetas;
• Si el directorio de versiones sigue siendo escribible;
• Las reglas de ignorado y las contraseñas de carpeta;
• Si pasa la comprobación de salud.

Syncthing 2.x puede actualizar la base de datos interna. No vuelvas sin más a una versión mayor anterior sin una copia de seguridad de la configuración; lee primero las Release Notes y, si es necesario, prueba en un nodo réplica.

• La GUI 8384 escucha solo en local o en la red privada WireGuard;
• La GUI tiene nombre de usuario y contraseña fuerte configurados, y la API Key no es pública;
• Solo se abre al público el 22000 TCP/UDP realmente necesario;
• Un VPS público normalmente no abre 21027/UDP;
• El descubrimiento global y Relay pueden desactivarse cuando no se necesiten;
• Los Device ID solo se intercambian con dispositivos que necesiten emparejarse;
• Se activa el versionado en carpetas importantes, pero el directorio de versiones no se trata como única copia de seguridad;
• No se sincronizan bases de datos, discos de máquinas virtuales ni archivos de aplicaciones con escritura continua;
• Se revisan periódicamente los archivos de conflicto, los elementos fallidos y el espacio en disco;
• La configuración, los datos y las copias de seguridad usan rutas de recuperación distintas;
• Se fija la versión y se hace copia de seguridad de la configuración antes de actualizar;
• Las contraseñas de carpetas Receive Encrypted se guardan en dispositivos de confianza y en un gestor de contraseñas.

Para uso personal, puedes empezar con un VPS de 1 núcleo y 1 GB, Syncthing v2.1.3, una carpeta de prueba y gestión mediante túnel SSH. Confirma primero que el emparejamiento de dispositivos, la creación, modificación y eliminación de archivos, los conflictos y la recuperación de versiones se comportan como esperas, y luego amplía gradualmente el alcance de la sincronización.

Una arquitectura estable de Syncthing no es "todos los dispositivos sincronizan bidireccionalmente todo el disco", sino dividir las carpetas por uso, elegir el modo correcto para cada nodo, restringir la GUI y los puertos de sincronización, y mantener una copia de seguridad realmente recuperable fuera del sistema de sincronización.

• Documentación oficial de Syncthing
• Syncthing v2.1.3 Release
• Documentación oficial de Docker de Syncthing
• Documentación de versionado de archivos de Syncthing