Tecnología · GUÍA PRÁCTICA
¿Syncthing muestra «folder marker missing»? Verifica la ruta antes de recrear .stfolder
El aviso es una parada de seguridad, no una orden de reconstruir una carpeta oculta. Distingue con una revisión de solo lectura entre montaje ausente, ruta movida, limpieza y permisos antes de reanudar.
La ausencia de `.stfolder` interrumpe a propósito la sincronización. Syncthing usa el marcador para decidir si la carpeta configurada está presente y es legible; sin él, una unidad desconectada o un montaje fallido podría parecer una eliminación total.
Por eso, el primer paso seguro no es crear el marcador. Congela los cambios en el extremo afectado, identifica el dispositivo y la ruta exactos y demuestra que el árbol esperado existe antes de escribir.
Esta guía convierte las ramas oficiales en una hoja de trabajo basada en la causa. No recupera bytes ya perdidos ni convierte la sincronización en copia de seguridad.
1. Entiende qué protege la parada
La FAQ oficial indica que el marcador habitual es `.stfolder`. Se comprueba para que un sistema de archivos sin montar, un USB retirado u otro almacenamiento ausente no se interprete como eliminación deliberada. Si falta, la carpeta deja de sincronizar.
Cuando reaparece, las ausencias locales pueden propagarse como borrados. El marcador no es una caché inocua: el aviso exige comprobar el límite de almacenamiento.
2. Congela el estado y localiza el extremo que informa
No quites la carpeta en varios dispositivos, no recrees `.stfolder`, no fuerces un escaneo ni aceptes una nueva compartición. Evita editar el árbol; conserva como referencia cualquier copia completa en otro dispositivo y crea una copia independiente si importa.
Anota en el dispositivo que muestra el error: nombre, etiqueta y Folder ID, ruta configurada y tipo Send & Receive, Send Only o Receive Only. En NAS o contenedores registra tanto la ruta interna como su mapeo en el host.
3. Crea una hoja de pruebas sin escritura
Usa una fila por extremo: dispositivo, Folder ID, ruta, disco o montaje esperado, montaje presente, hijos superiores visibles, archivos testigo, `.stfolder`, usuario del servicio, escritura en el padre, log reciente y rama elegida.
La regla es sencilla: si no puedes demostrar que la ruta apunta al almacenamiento correcto y que el árbol esperado está presente, no recrees el marcador. Un directorio vacío nuevo en el antiguo punto de montaje no es el conjunto original.
4. Rama A: falta la unidad o el montaje padre
Si el disco, USB, recurso de red o sistema padre no está montado, restaura primero ese almacenamiento. Verifica la identidad del volumen o destino, no solo un directorio del mismo nombre, y comprueba varios hijos y archivos esperados.
No crees `.stfolder` en un punto de montaje vacío. Anula la protección y puede convertir el árbol ausente en borrados aparentes. Si el montaje sigue fallando, deja la carpeta detenida y repara el servicio de almacenamiento aparte.
5. Rama B: se movió o renombró la carpeta completa
Si se movieron juntos el conjunto y el marcador, la FAQ ofrece dos rutas: devolverlo a la ubicación configurada o quitar la carpeta de Syncthing solo en el dispositivo afectado y añadirla en la nueva ruta. Antes, verifica otra copia sincronizada y el árbol completo en el destino.
Quitarla de la interfaz no equivale a borrar sus archivos, pero lee la confirmación de tu versión. Reutiliza el Folder ID solo para reconectar la misma carpeta y confirma la ruta local antes de aceptar una oferta remota para evitar un destino predeterminado no auditado.
6. Rama C: están todos los archivos y solo falta el marcador
Algunos limpiadores eliminan el `.stfolder` vacío, sobre todo en móviles. Solo se recrea cuando la ruta es correcta, el almacenamiento está montado y los hijos esperados existen. La FAQ recomienda añadir un archivo ficticio dentro o excluir el marcador de la limpieza.
Detén primero el limpiador. Crea el marcador solo en el extremo cuyo árbol auditado esté completo y observa el siguiente escaneo. Si está vacío o incompleto, detente; no uses el marcador para saltarte la incertidumbre.
7. Rama D: la ruta existe pero el servicio no puede crear el marcador
Mensajes como `Failed to create folder marker`, `permission denied` o una ruta incorrecta apuntan al acceso. Comprueba que la cuenta real de Syncthing atraviesa cada padre y escribe en el destino. En un NAS con contenedor, prueba la ruta interna y el mapeo del host.
El acceso controlado a carpetas de Windows puede bloquearla. Un caso completo se resolvió permitiendo el ejecutable fiable, pero primero confirma la ruta protegida y la identidad del programa. En Linux o NAS corrige propietario, grupo o mapeo del usuario del servicio; no ejecutes todo como administrador sin límites.
8. Si la causa sigue sin estar clara, vuelve a añadir solo en el dispositivo fallido
La ruta oficial de incertidumbre es quitar la carpeta en el dispositivo afectado y añadirla de nuevo en la misma ubicación verificada. Reinicia el estado de base de datos de ese extremo y fusiona sus archivos con los remotos; solo es controlado tras verificar el árbol y respaldar lo importante.
No la quites de todos los dispositivos a la vez. Conserva una copia conocida y el Folder ID. Luego compara cantidad y varios testigos; si la oferta cae en una ruta vacía predeterminada, cancela y corrige la ruta local.
9. Verifica la recuperación sin llamar copia de seguridad a la sincronización
El éxito exige que desaparezca el error, que ruta y Folder ID coincidan con la hoja y que archivos representativos concuerden tras estabilizarse el escaneo. Revisa cambios recientes para detectar borrados inesperados antes de editar normalmente.
La documentación advierte que Syncthing no es una gran aplicación de respaldo porque cambios y borrados se propagan. El versionado reduce parte del riesgo, pero no sustituye una copia independiente. Conserva una antes de cambios peligrosos y registra fecha y acción real de recuperación.
