Instalación y Configuración de Syn

Instalación de software — Paso a paso

Instalaremos Syncthing a través del repositorio APT oficial, que es el método recomendado para Debian/Ubuntu, ya que garantiza actualizaciones sencillas e integración con el sistema. Se supone que para 2026 este método seguirá siendo relevante y preferido.

1. Importación de la clave GPG de Syncthing

Para que el sistema confíe en los paquetes del repositorio de Syncthing, es necesario importar su clave GPG.

# Obtener la clave GPG de Syncthing
sudo curl -L -o /usr/share/keyrings/syncthing-archive-keyring.gpg https://syncthing.net/release-key.gpg

2. Adición del repositorio de Syncthing

Ahora añadiremos el repositorio oficial de Syncthing a la lista de fuentes de paquetes de su sistema. Usaremos la rama estable.

# Añadir el repositorio de Syncthing para la versión estable
echo "deb [signed-by=/usr/share/keyrings/syncthing-archive-keyring.gpg] https://apt.syncthing.net/ syncthing stable" | sudo tee /etc/apt/sources.list.d/syncthing.list

3. Actualización de la lista de paquetes e instalación de Syncthing

Después de añadir el nuevo repositorio, es necesario actualizar la lista de paquetes y luego instalar Syncthing.

# Actualizar la lista de paquetes
sudo apt update

# Instalar Syncthing
sudo apt install syncthing -y

Después de la instalación, Syncthing estará disponible en el sistema. La versión actual para 2026 será probablemente Syncthing 1.27.x o superior.

4. Verificación de la versión instalada

Asegúrese de que Syncthing esté instalado correctamente y verifique su versión:

# Verificar la versión de Syncthing
syncthing --version

La salida debería mostrar algo como syncthing v1.27.x "Fermium Flea" (go1.22.x linux-amd64) [email protected] 2026-XX-YY HH:MM:SS UTC.

5. Configuración de Syncthing como servicio del sistema (systemd)

Syncthing debe ejecutarse como un servicio del sistema para iniciarse automáticamente al arrancar el servidor y funcionar en segundo plano. Lo configuraremos para que se ejecute bajo el usuario creado anteriormente (youruser).

# Habilitar e iniciar el servicio Syncthing para su usuario
sudo systemctl enable [email protected]
sudo systemctl start [email protected]

Verificar el estado del servicio:

# Verificar el estado del servicio Syncthing
sudo systemctl status [email protected]

Debería ver el estado active (running).

Por defecto, Syncthing crea su configuración y datos en el directorio de inicio del usuario, por ejemplo, /home/youruser/.config/syncthing y /home/youruser/Sync.

Copias de seguridad y mantenimiento

Las copias de seguridad regulares y el mantenimiento oportuno son clave para garantizar la fiabilidad y seguridad de su sistema Syncthing.

1. Qué respaldar

Para Syncthing, dos tipos de datos son críticamente importantes:

• Configuración de Syncthing: Son los archivos ubicados en el directorio /home/youruser/.config/syncthing/. Incluyen config.xml (con el ID del dispositivo, la configuración de la interfaz de usuario web, la lista de dispositivos y carpetas), así como los archivos de la base de datos de índices.
• Datos sincronizados: Son los archivos y carpetas que usted sincroniza (por ejemplo, /home/youruser/Sync/MyProject). Este es su activo más valioso.

2. Script simple de copia de seguridad automática

Para la copia de seguridad de la configuración de Syncthing, se puede utilizar un script simple. Para los datos sincronizados, se recomienda utilizar soluciones más avanzadas como BorgBackup o Restic, que proporcionan deduplicación y cifrado.

Ejemplo de script para la copia de seguridad de la configuración (rsync)

Cree un directorio para las copias de seguridad, por ejemplo, /home/youruser/backups.

mkdir -p /home/youruser/backups/syncthing_config

Cree un script de copia de seguridad, por ejemplo, /home/youruser/backup_syncthing_config.sh:

nano /home/youruser/backup_syncthing_config.sh

Contenido del script:

#!/bin/bash

# Directorio de configuración de Syncthing
SYNCTHING_CONFIG_DIR="/home/youruser/.config/syncthing"
# Directorio para guardar copias de seguridad
BACKUP_DIR="/home/youruser/backups/syncthing_config"
# Nombre del archivo de copia de seguridad
BACKUP_FILENAME="syncthing_config_$(date +%Y%m%d_%H%M%S).tar.gz"

echo "Iniciando la copia de seguridad de la configuración de Syncthing..."

# Detener el servicio Syncthing para una copia de seguridad consistente
sudo systemctl stop [email protected]

# Crear archivo de configuración
tar -czf "$BACKUP_DIR/$BACKUP_FILENAME" -C "$(dirname "$SYNCTHING_CONFIG_DIR")" "$(basename "$SYNCTHING_CONFIG_DIR")"

# Eliminar copias de seguridad antiguas (por ejemplo, más de 7 días)
find "$BACKUP_DIR" -type f -name "syncthing_config_.tar.gz" -mtime +7 -delete

# Iniciar el servicio Syncthing
sudo systemctl start [email protected]

echo "Copia de seguridad de la configuración de Syncthing completada: $BACKUP_DIR/$BACKUP_FILENAME"

chmod +x /home/youruser/backup_syncthing_config.sh

crontab -e

0 3    /home/youruser/backup_syncthing_config.sh >> /home/youruser/backups/syncthing_config/backup.log 2>&1

Para la copia de seguridad de los datos en sí, utilice BorgBackup o Restic en un almacenamiento separado (ver más abajo).

3. Dónde almacenar las copias de seguridad

Es extremadamente importante almacenar las copias de seguridad en un recurso separado del servidor principal. Opciones:

• Almacenamiento de objetos externo compatible con S3: Muchos proveedores ofrecen almacenamiento compatible con S3 (AWS S3, DigitalOcean Spaces, Backblaze B2). Es una solución fiable y escalable. Herramientas como Restic o BorgBackup pueden trabajar directamente con S3.
• VPS o NAS separado: Si tiene otro VPS o un NAS doméstico, puede configurar la sincronización de copias de seguridad allí a través de SSH (utilizando rsync o sftp).

Ejemplo de uso de Restic para la copia de seguridad de datos en un almacenamiento compatible con S3:

Instale Restic:

sudo apt install restic -y

Configure las variables de entorno para S3 (¡no las guarde en el script!):

# En el archivo ~/.bashrc o /etc/environment
export RESTIC_REPOSITORY="s3:https://s3.REGION.PROVIDER.com/bucket-name"
export AWS_ACCESS_KEY_ID="SU_CLAVE"
export AWS_SECRET_ACCESS_KEY="SU_SECRETO"
export RESTIC_PASSWORD="CONTRASEÑA_COMPLEJA_PARA_CIFRADO_DE_COPIA_DE_SEGURIDAD"

Inicialice el repositorio de Restic:

restic init

Cree un script para la copia de seguridad de datos (por ejemplo, /home/youruser/backup_data.sh):

#!/bin/bash

# Cargar variables de entorno si no están definidas
if [ -f "/home/youruser/.bashrc" ]; then
  source "/home/youruser/.bashrc"
fi

# Ruta a la carpeta de datos de Syncthing
DATA_DIR="/home/youruser/Sync"

echo "Iniciando la copia de seguridad de datos de Syncthing..."

# Crear copia de seguridad
restic backup "$DATA_DIR" --tag syncthing-data

# Limpiar instantáneas antiguas (por ejemplo, mantener 7 diarias, 4 semanales, 12 mensuales)
restic forget --prune --keep-daily 7 --keep-weekly 4 --keep-monthly 12

echo "Copia de seguridad de datos de Syncthing completada."

Agréguelo a Cron, al igual que el script de configuración.

4. Actualizaciones

Mantener el sistema y el software actualizados es crucial para la seguridad y estabilidad.

• Actualización del SO y paquetes: Ejecute regularmente los comandos de actualización. Para Syncthing, instalado a través de APT, esto también lo actualizará a la última versión estable.

  
  sudo apt update && sudo apt upgrade -y
  sudo apt autoremove -y
  

• Actualización de Caddy: Caddy también se actualiza a través de APT.
• Estrategia de actualizaciones:
  • Actualizaciones continuas: Para sistemas no críticos, simplemente puede ejecutar apt upgrade regularmente (por ejemplo, una vez a la semana a través de cron).
  • Ventana de mantenimiento: Para sistemas más importantes, se recomienda planificar una "ventana de mantenimiento" donde pueda realizar actualizaciones manualmente, probar el sistema y revertir los cambios en caso de problemas.

Siempre lea los registros de cambios antes de las actualizaciones importantes para estar al tanto de posibles cambios o problemas.

Solución de problemas + Preguntas frecuentes

Esta sección recopila respuestas a preguntas frecuentes y soluciones a problemas típicos que pueden surgir al trabajar con Syncthing en un VPS.

La interfaz web de Syncthing no está disponible

Problema: No puede abrir la interfaz web de Syncthing en https://sync.example.com o http://SU_DIRECCIÓN_IP_VPS:8384.

Qué verificar:

• Servicio Syncthing: Asegúrese de que el servicio [email protected] esté activo.

  
  sudo systemctl status [email protected]
  

• Servicio Caddy (si se usa): Verifique el estado de caddy.service.

  
  sudo systemctl status caddy
  

• Cortafuegos (UFW): Asegúrese de que los puertos 80 y 443 (para Caddy) o 8384 (para acceso directo a Syncthing) estén abiertos.

  
  sudo ufw status verbose
  

• Configuración de Syncthing: Verifique el archivo /home/youruser/.config/syncthing/config.xml. Asegúrese de que en la sección <gui> la dirección de escucha esté configurada en 0.0.0.0:8384 o 127.0.0.1:8384 (si se usa un proxy).
• Registros de Syncthing: Verifique los registros en busca de errores.

  
  journalctl -u [email protected] -f
  

Cómo solucionarlo: Reinicie los servicios correspondientes si no están en ejecución. Corrija las reglas del cortafuegos. Edite config.xml y reinicie Syncthing.

Los dispositivos no se conectan o tardan mucho en hacerlo

Problema: Su dispositivo Syncthing en el VPS no puede conectarse con otros dispositivos, o la conexión es muy lenta.

Qué verificar:

• Cortafuegos (UFW): Asegúrese de que el puerto 22000 (TCP y UDP) esté abierto en el VPS.

  
  sudo ufw status verbose
  

• ID de dispositivos: Verifique que los ID de los dispositivos se hayan introducido correctamente en todos los nodos. Son sensibles a mayúsculas y minúsculas.
• Descubrimiento global: Asegúrese de que el descubrimiento global esté habilitado en todos los dispositivos (o que esté utilizando direcciones IP estáticas/DNS). En la interfaz web: Acciones (Actions) -> Configuración (Settings) -> pestaña General (General) -> Descubrimiento global (Global Discovery).
• Conexión de red: Verifique que todos los dispositivos tengan acceso a Internet y puedan "verse" entre sí.

Cómo solucionarlo: Abra los puertos necesarios en el cortafuegos. Vuelva a verificar los ID de los dispositivos. Asegúrese de que no haya bloqueos en la ruta (por ejemplo, en el router). Si el descubrimiento global está deshabilitado, intente agregar las direcciones IP de los dispositivos manualmente en la configuración de los dispositivos remotos.

Baja velocidad de sincronización

Problema: Los archivos se sincronizan muy lentamente, a pesar de una buena conexión de red.

Qué verificar:

• Ancho de banda de la red: Asegúrese de que el VPS y otros dispositivos tengan suficiente ancho de banda. Verifique el tráfico en la interfaz web de Syncthing.
• CPU y RAM: Syncthing utiliza activamente la CPU para el hashing y el cifrado, y la RAM para los índices. Verifique la carga de la CPU y el uso de la RAM en el VPS (htop).
• E/S de disco: Los discos lentos (especialmente los HDD en VPS débiles) pueden ralentizar considerablemente la sincronización, sobre todo al trabajar con una gran cantidad de archivos pequeños.
• Configuración de versiones: Si el versionado complejo está habilitado, esto puede aumentar la carga en el disco y la CPU.
• Cantidad de archivos: La sincronización de millones de archivos pequeños siempre será más lenta que la sincronización de unos pocos archivos grandes.

Cómo solucionarlo: Considere actualizar el VPS a uno más potente (más CPU, RAM, NVMe SSD). Optimice la configuración de versiones. Utilice patrones de ignorado para excluir archivos innecesarios. Verifique la configuración de red en todos los nodos.

¿Qué configuración mínima de VPS es adecuada?

Respuesta: Para ejecutar Syncthing y sincronizar un volumen moderado de datos (hasta 100-200 GB) con 2-3 dispositivos, un VPS mínimo debería tener 1-2 vCPU, 1-2 GB de RAM, 50-100 GB de disco SSD y un canal de red de al menos 100 Mbps. Es importante que el disco sea SSD, ya que Syncthing trabaja intensamente con E/S para la indexación de archivos. Si planea sincronizar una gran cantidad de archivos pequeños o volúmenes de datos muy grandes, se recomienda aumentar la RAM y el espacio en disco.

¿Qué elegir: VPS o dedicado para esta tarea?

Respuesta: Para la mayoría de los usuarios individuales y equipos pequeños, un VPS será más que suficiente. Es económico y proporciona recursos adecuados. Un servidor dedicado debe elegirse si trabaja con volúmenes de datos muy grandes (varios terabytes), maneja millones de archivos que requieren indexación constante, o si su nodo Syncthing atiende a muchos dispositivos activos y requiere el máximo rendimiento de E/S y CPU. En tales casos, un servidor dedicado garantiza recursos estables y no compartidos, lo cual es crítico para cargas de trabajo elevadas.

¿Cómo garantizar la máxima privacidad?

Respuesta: Syncthing utiliza cifrado de extremo a extremo por defecto para todos los datos transmitidos. Para una privacidad máxima: 1) Deshabilite el descubrimiento global (Global Discovery) en la configuración de Syncthing y agregue manualmente las direcciones IP de sus dispositivos. 2) Utilice solo dispositivos de confianza. 3) Asegúrese de que su VPS esté protegido de forma segura (claves SSH, cortafuegos, Fail2Ban). 4) Utilice HTTPS para acceder a la interfaz web (como configuramos con Caddy).

¿Cómo configurar el versionado de archivos?

Respuesta: Syncthing tiene mecanismos de versionado incorporados. En la interfaz web, al editar o agregar una carpeta, vaya a la pestaña "Versionado de archivos" (File Versioning). Puede elegir uno de varios tipos de versionado: "Papelera de reciclaje" (Simple File Versioning), "Escalonado" (Staggered File Versioning) o "Externo" (External File Versioning). El versionado "Escalonado" suele ser un buen compromiso, ya que conserva un número determinado de versiones de un archivo durante diferentes períodos de tiempo, lo que ayuda a restaurar archivos después de una eliminación o modificación accidental.

Syncthing consume muchos recursos

Problema: Syncthing utiliza mucha CPU o RAM.

Qué verificar:

• Cantidad de archivos/carpetas a sincronizar: Cuantos más archivos, más memoria se requiere para su indexación.
• Intensidad de los cambios: Si hay cambios constantes en las carpetas sincronizadas, Syncthing trabajará activamente, haciendo hashing y transfiriendo datos.
• Patrones de ignorado: Asegúrese de excluir archivos innecesarios de la sincronización (por ejemplo, .git/, node_modules/, .DS_Store) utilizando el archivo .stignore.
• Velocidad del disco: Un disco lento puede hacer que Syncthing consuma más CPU esperando E/S.

Cómo solucionarlo: Agregue patrones de ignorado para archivos innecesarios. Divida las carpetas grandes en varias más pequeñas, si es posible. Actualice el VPS a uno más potente. En la configuración de la carpeta, puede limitar la frecuencia de escaneo o establecer un escaneo menos frecuente.

Conclusiones y próximos pasos

¡Felicidades! Ha instalado y configurado Syncthing con éxito en su VPS, creando su propia solución de sincronización de archivos totalmente controlada y segura. Ahora sus datos se mueven directamente entre dispositivos, utilizando cifrado de extremo a extremo, lo que garantiza la privacidad y la independencia de los servicios en la nube de terceros. Ha obtenido una herramienta poderosa para mantener sus archivos actualizados en todas las máquinas necesarias, ya sea para desarrollo, trabajo en equipo o necesidades personales.

¿Hacia dónde ir a continuación?

1. Agregue más dispositivos y carpetas: Ahora que el nodo principal está configurado, puede conectar fácilmente todos sus ordenadores, portátiles, teléfonos inteligentes y otros servidores para expandir su red de sincronización.
2. Optimice la configuración: Explore las configuraciones avanzadas de Syncthing, como los patrones de ignorado (.stignore), el versionado de archivos, las limitaciones de ancho de banda y la programación de escaneo, para adaptar el sistema a sus necesidades únicas.
3. Monitoreo y escalado: Monitoree regularmente el consumo de recursos del VPS (CPU, RAM, E/S de disco) utilizando herramientas como htop o grafana/prometheus para asegurarse de que el sistema funcione de manera óptima. A medida que crezcan los volúmenes de datos o el número de dispositivos, considere escalar su VPS o migrar a un servidor dedicado más potente.