Obsidian LiveSync CouchDB misslyckas på CasaOS: Vad ska konfigureras

Viktig slutsats: kalla inte avbildningen trasig enbart utifrån installationsfelet. Självhostad LiveSync kräver fungerande CouchDB-autentiseringsuppgifter, skrivbar beständig lagring, initiering, CORS och en nåbar slutpunkt. En appmall med ett klick kan fortfarande kräva dessa värden.

Ange de obligatoriska CouchDB-variablerna

Aktuella LiveSync CouchDB-variabler från uppströmsprojektet kräver administratörsuppgifter och ett databasnamn:

COUCHDB_USER=admin
COUCHDB_PASSWORD=strong-random-password
COUCHDB_DATABASE=obsidiannotes

Läs containerloggarna innan du gör slumpmässiga ändringar

docker ps -a | grep -i couch
docker logs --tail 200 <container-name>

Leta efter saknade variabler, behörighetsfel, fel vid montering av konfigurationen, initieringsfel eller portkonflikter.

Beständig lagring måste vara skrivbar

Uppströmsprojektets CouchDB-lagringskonfiguration anger att data- och konfigurationskataloger kan ägas av UID 5984. Felaktigt ägarskap kan stoppa containern.

Verifiera CouchDB innan Obsidian

curl -u admin:YOUR_PASSWORD http://SERVER_IP:5984/_up

Uppströmsprojektets CouchDB-hälsokontroll förväntar sig en frisk status innan plugin-konfigurationen görs.

Initiera LiveSync-databasen

En körande CouchDB-process utgör inte hela konfigurationen. Kör den aktuella initieringsvägen från uppströmsprojektet så att nödvändiga databas- och konfigurationsvärden finns innan du ansluter Obsidian-pluginet.

Fjärrsynkronisering kräver en säker HTTPS-väg

Uppströmsprojektet tillhandahåller nu profiler för Caddy, Tailscale och Cloudflare. Använd endast vanlig HTTP för lokal testning; fjärrsynkronisering och synkronisering från mobila enheter bör använda en HTTPS-väg som stöds.

BigBear listar för närvarande ett Obsidian LiveSync-paket baserat på CouchDB. Jämför den genererade compose-konfigurationen med uppströmsprojektets variabler i stället för att anta att någon av sidorna är korrekt.

ZimaOS appkatalog innehåller Obsidian-relaterade arbetslaster, och CasaOS Docker-konfiguration hjälper till att förklara inställningar på mallnivå jämfört med inställningar under körning.

ZimaBoard 2 räcker för denna lätta databasanvändning; lagringens hållbarhet är viktigare än rå beräkningskraft.

Jämför mallen med den aktuella Compose-konfigurationen från uppströmsprojektet

Den aktuella Compose-konfigurationen från uppströmsprojektet startar CouchDB med obligatoriska variabler för användarnamn och lösenord, beständiga data och en särskild LiveSync-konfigurationsfil. Om en community-mall skiljer sig åt bör du identifiera skillnaden innan du kallar containeravbildningen felaktig. Avbildningen, Compose-mallen och applikationskonfigurationen är tre separata lager.

Tvinga inte fram användaren för CouchDB-containern utan vidare

Den aktuella Compose-konfigurationen från uppströmsprojektet varnar uttryckligen för att ange en fast användare: värde eftersom CouchDB:s startskript börjar med tillräckliga behörigheter för att skriva sin konfiguration och sedan växlar till CouchDB:s UID. En mall som åsidosätter detta beteende kan skapa behörighetsfel under uppstarten.

Kontrollera CORS efter att hälsoslutpunkten fungerar

En frisk /_up Svaret visar att CouchDB körs, men inte att Obsidian-klienter kan använda den. Testa svarshuvudena med en Obsidian-origin och bekräfta att LiveSync-konfigurationen tillåter de förväntade ursprungen för datorer och mobiler.

Håll databasen borta från det öppna internet

CouchDB-porten 5984 är en databasslutpunkt, inte en sida för fildelning till användare. För fjärrsynkronisering bör du föredra de HTTPS-mönster som stöds av uppströmsprojektet – Caddy, Tailscale eller Cloudflare – framför att direkt vidarebefordra routern till 5984.

Använd denna felsökningsordning

1. Containern fortsätter att köras.
2. /_up returnerar frisk med inloggningsuppgifter.
3. Beständiga data finns kvar efter omstart.
4. Initieringen slutförs.
5. CORS är korrekt konfigurerat.
6. HTTPS-slutpunkten fungerar på distans.
7. Obsidian-pluginets URI, användarnamn, lösenord och databas måste överensstämma med servervärdena.

Att hoppa direkt till plugininställningarna innan steg 1–5 gör felsökningen mycket svårare.

Vanliga frågor

Är BigBear-avbildningen definitivt felaktig?

Den ursprungliga diskussionen bevisade inte det. Jämför först dess Compose-konfiguration med aktuella krav från uppströmsprojektet.

Varför kan CouchDB köras medan Obsidian misslyckas?

Databasinitiering, CORS, inloggningsuppgifter, databasnamn och slutpunkts-URL måste fortfarande stämma överens.