Communityoplossing

Installeer OpenCloud op ZimaOS met Docker Compose

A ZimaOS user wanted a lightweight family file-sync platform but could not get OpenCloud working with AI-generated setup instructions.

OpenCloud kan op ZimaOS draaien, omdat het officiële implementatiemethoden voor Docker en Docker Compose heeft. Gebruik voor een snelle lokale test de workflow met één container; gebruik voor het synchroniseren van gezinsbestanden via HTTPS de officiële Compose-stack met geïntegreerde Traefik of de architectuur met een externe proxy.

De gebruiker in kwestie worstelde twee weken met door AI gegenereerde instructies. De oplossing is om niet langer zelf aan de stack te sleutelen, maar het huidige implementatiemodel van OpenCloud te volgen, met name de permanente paden voor configuratie en gegevens, de eerste beheerdersconfiguratie, de URL en de vereisten voor proxy en TLS.

Begin met een lokale testinstantie

De huidige Docker-handleiding van OpenCloud beschrijft een eenvoudige container op poort 9200.

mkdir -p /DATA/AppData/opencloud/config
mkdir -p /DATA/AppData/opencloud/data

docker pull opencloudeu/opencloud-rolling:latest

docker run --rm -it   -v /DATA/AppData/opencloud/config:/etc/opencloud   -v /DATA/AppData/opencloud/data:/var/lib/opencloud   -e IDM_ADMIN_PASSWORD=CHANGE_ME   opencloudeu/opencloud-rolling:latest init

Gebruik de lokale test alleen ter validatie

Het voorbeeld van de upstream gebruikt onveilige/lokale instellingen voor snelle tests. Beschouw dit niet als een productieomgeving voor een gezinscloud die via internet bereikbaar is.

Gebruik Docker Compose voor productie

De huidige Docker Compose-handleiding van OpenCloud ondersteunt twee officiële architecturen: geïntegreerde Traefik of een externe reverse proxy.

Let op poort 80 en 443 op ZimaOS

De geïntegreerde Traefik-stack gebruikt normaal gesproken de standaardpoorten voor HTTP en HTTPS. Als ZimaOS of een andere reverse proxy deze al gebruikt, kies dan voor de route met een externe proxy of gebruik een afzonderlijk LAN-IP-adres of een virtuele machine, in plaats van het beheereindpunt van ZimaOS zonder meer te verplaatsen.

Maak zowel configuratie als gebruikersgegevens permanent

Bewaar /etc/opencloud en /var/lib/opencloud op permanente opslag van ZimaOS. Een containerimage kan opnieuw worden aangemaakt; identiteits- en gebruikersgegevens niet.

Gebruik een stabiele image of branch voor gezinsgegevens

Het voorbeeld voor een snelle start gebruikt een rolling-image. Volg voor een langdurige implementatie de productieaanbevelingen van OpenCloud en leg na validatie een geschikte stabiele release of branch vast, in plaats van blind te updaten.

Maak een back-up voordat je upgradet

Bescherm zowel de configuratie als de gegevens van OpenCloud en test na upgrades het aanmelden, delen, synchronisatieclients en herstel.

OpenCloud versus Nextcloud

Als je vooral lichte bestandssynchronisatie voor meerdere gebruikers nodig hebt, kan OpenCloud een goede keuze zijn. Als je een groter ecosysteem nodig hebt met agenda's, contacten, kantoorfuncties, plug-ins en volwassen integraties, is Nextcloud mogelijk nog steeds de optie met de meeste functies.

De aangepaste Docker-handleiding beschrijft het ZimaOS-gedeelte van de workflow.

Kies de openbare of privékoppeling vóór de productieconfiguratie

OpenCloud genereert koppelingen en omleidingen voor verificatie op basis van de geconfigureerde URL. Bepaal de uiteindelijke hostnaam en HTTPS-route voordat je gezinsleden uitnodigt, zodat je clients later niet hoeft te migreren vanaf een tijdelijke URL in de stijl van localhost.

Controleer bestandssynchronisatie met een niet-beheerdersaccount

Maak een normaal gezinsaccount aan, upload vanaf één client een testmap, synchroniseer deze naar een tweede apparaat en verwijder en herstel vervolgens een testbestand. Zo bewijs je dat de daadwerkelijke synchronisatieworkflow voor meerdere gebruikers werkt, in plaats van alleen de webaanmelding van de beheerder.

Maak naast bestanden ook een back-up van identiteit en configuratie

Alleen gebruikersbestanden vormen niet de volledige dienst. Bewaar de configuratie- en identiteitsgegevens van OpenCloud, zodat accounts, gedeelde bestanden en rechten samen met de opgeslagen bestanden kunnen worden hersteld.

Veelgestelde vragen

Kan OpenCloud op ZimaOS draaien?

Ja. ZimaOS ondersteunt Docker en Compose, en OpenCloud documenteert officieel beide implementatiemethoden voor containers.

Welke poort gebruikt de eenvoudige OpenCloud-test?

Het officiële lokale Docker-voorbeeld gebruikt poort 9200.

Moet ik de rolling-image voor productie gebruiken?

Gebruik deze alleen voor tests, tenzij de huidige productieaanbevelingen van OpenCloud expliciet aansluiten bij jouw updatebeleid.

Heb ik Traefik nodig?

Nee. OpenCloud ondersteunt zowel geïntegreerde Traefik als implementatie achter een externe reverse proxy.