Questa situazione è iniziata come un frustrante problema di autorizzazioni e alla fine si è trasformata in una soluzione ripetibile. Syncthing riusciva a comunicare con il peer Windows e poteva sincronizzare nella posizione AppData predefinita, ma il tentativo di utilizzare un percorso NAS montato come /media/raid/NAS/Music prodotti autorizzazione negata e percorso della cartella mancante errori.
Nell'agosto 2025, un utente della community ha pubblicato l'approccio che ha funzionato per lui: reinstallare Syncthing con Installazione personalizzata, utilizzare il PUID/PGID dell'utente ZimaOS reale, scegliere una radice di sincronizzazione appropriata e lasciare che Syncthing crei la propria cartella di destinazione. Due utenti successivi hanno confermato esplicitamente che ha funzionato. L'attuale guida ufficiale di IceWhale per Syncthing documenta ora essenzialmente la stessa configurazione.
L'installazione originale di Syncthing poteva scrivere solo nel percorso AppData predefinito
L'utente di origine poteva compilare:
/DATA/AppData/syncthing/config/Syncma non riusciva a utilizzare il percorso musicale desiderato sul disco rigido, anche se File, Jellyfin e Navidrome potevano accedervi. Questa è una forte indicazione di una mancata corrispondenza tra identità e autorizzazioni del container, piuttosto che di un disco guasto.
È stato suggerito di eseguire Syncthing come root, ma non è la soluzione attuale preferita
Una prima risposta della community suggeriva PUID/GUID 0. Eseguire un servizio di sincronizzazione dei file come root può aggirare molti problemi di autorizzazione, ma offre al container anche capacità di scrittura/eliminazione molto più ampie del necessario.
Le indicazioni attuali di IceWhale raccomandano esplicitamente di utilizzare invece gli ID dell'utente reale.
Utilizza l'installazione personalizzata
Trova il PUID e il PGID effettivi dell'utente ZimaOS
Le indicazioni ufficiali attuali utilizzano:
id -u username
id -g usernameSostituisci nome utente con l'account ZimaOS che dovrebbe essere proprietario e gestire i file sincronizzati, quindi copia gli ID numerici restituiti nelle variabili d'ambiente di Syncthing.
Non utilizzare la radice di un disco montato come cartella di Syncthing
La documentazione attuale di IceWhale indica che la radice di un disco montato o cartelle di sistema come Gallery/Media/Documents non dovrebbero essere utilizzate direttamente come percorso della cartella di Syncthing, poiché ciò normalmente richiede privilegi a livello di root.
Crea o utilizza invece una sottocartella dedicata appropriata.
Lascia che Syncthing crei la cartella di destinazione
La soluzione della community raccomandava specificamente agli utenti di non creare in anticipo la destinazione tramite il browser File di ZimaOS. La documentazione ufficiale attuale ripete ora la stessa procedura consigliata: definire la destinazione in Syncthing e lasciare che sia Syncthing a crearla.
Questa soluzione della community è ora riportata nella documentazione ufficiale di ZimaOS
Usa la configurazione attuale di Syncthing in ZimaOS.
Perché la guida avverte che gli ID errati potrebbero richiedere una reinstallazione
Se la prima installazione crea la configurazione e le cartelle con l'identità errata, cambiare semplicemente un valore in seguito può lasciare la proprietà precedente. Per questo le indicazioni attuali chiedono agli utenti di verificare attentamente PUID/PGID prima dell'installazione.
Esegui il backup della configurazione di Syncthing, se contiene relazioni importanti tra dispositivi e cartelle, prima di eliminare AppData per una reinstallazione pulita.
Prova prima con una piccola cartella usa e getta
Prima di collegare Syncthing a una grande struttura di musica o documenti, sincronizza una piccola cartella di prova, verifica il comportamento bidirezionale se abilitato, conferma la proprietà sul NAS, quindi aggiungi le cartelle di produzione.
La correzione funziona perché tutti i livelli delle autorizzazioni finalmente corrispondono
Affinché Syncthing possa creare correttamente i file, devono allinearsi quattro elementi: la cartella dell'host ZimaOS deve esistere ed essere scrivibile dall'utente/gruppo previsto, Docker deve mappare tale cartella nel container, Syncthing deve essere eseguito con il PUID/PGID corrispondente e il percorso della cartella configurato in Syncthing deve puntare al mount all'interno del container. Un disallineamento in uno qualsiasi di questi livelli può manifestarsi con lo stesso messaggio «autorizzazione negata».
Perché le radici dei dischi montati non sono una destinazione di sincronizzazione predefinita adatta
La radice di un disco montato contiene spesso directory gestite dal sistema, metadati delle condivisioni o autorizzazioni pensate per più servizi. Concedere a un motore di sincronizzazione un ampio accesso in scrittura aumenta il raggio d'azione di eliminazioni accidentali o configurazioni errate. Una sottocartella dedicata rende molto più facile ragionare sulla proprietà e sulle policy di backup.
Convalida la semantica delle eliminazioni di Syncthing prima di abilitare la sincronizzazione bidirezionale
Syncthing propaga le modifiche in base alla modalità della cartella, comprese le eliminazioni nelle configurazioni di invio/ricezione. Prima di collegarlo a una grande libreria musicale o di documenti, testa il comportamento di creazione/rinomina/eliminazione con file usa e getta e valuta il versioning di Syncthing se è importante poter recuperare file eliminati accidentalmente in remoto.
FAQ su Syncthing in ZimaOS
Gli utenti successivi hanno confermato che l'approccio con PUID/PGID ha funzionato?
Sì. Almeno due partecipanti successivi alla discussione hanno dichiarato esplicitamente che il metodo indicato ha risolto il loro problema.
Syncthing deve essere eseguito come root per accedere ai dischi?
Le indicazioni attuali di IceWhale raccomandano invece di usare il PUID/PGID dell'utente reale di ZimaOS e una sottocartella adatta.
Devo creare prima la cartella di destinazione in File di ZimaOS?
La documentazione attuale di IceWhale indica di lasciare che sia Syncthing a creare autonomamente la cartella di destinazione.
