Communityoplossing

UrBackup Server uitvoeren op ZimaOS: juiste paden, machtigingen, netwerkconfiguratie en back-upopslag

An August 2025 source thread where UrBackup initially failed because of a China-only Docker mirror, invalid ZimaOS bind paths, permissions, port/launcher confusion, and container recreation issues. The original poster eventually reported a working Docker/Compose setup.

De UrBackup-installatie uit de bron mislukte om verschillende onafhankelijke redenen voordat deze werkte: het ophalen van de image werd omgeleid via een mirror die alleen in continentaal China beschikbaar was, de eerste bindpaden bestonden niet op de ZimaOS-host, de rechten voor de back-upmap waren onjuist en de URL/poorten van de app-launcher waren verwarrend.

De blijvende les is om UrBackup te behandelen als een normale stateful Docker-toepassing: gebruik echte hostopslagpaden, bewaar zowel back-upgegevens als de UrBackup-database/-status, controleer de rechten van de runtimegebruiker en bevestig de WebUI- en netwerklisteners voordat je erop vertrouwt voor clientback-ups.

ZimaOS Docker-CLI-importdialoog met de oorspronkelijke opdracht voor urbackup-server
De eerste poging gebruikte algemene hostpaden en liep tegen image- en mountproblemen aan voordat de gebruiker de configuratie opnieuw opbouwde.

De eerste image-pull werd herschreven naar een onbruikbare mirror

De daemon gaf een melding dat het ophalen was geweigerd voor docker.1panel.live/uroni/urbackup-server. De officiële downloadpagina van UrBackup vermeldt nog steeds uroni/urbackup-server als de officiële Docker-image.

Zie de huidige officiële Docker-image van UrBackup.

Bindkoppelingen moeten naar echte ZimaOS-hostmappen verwijzen

De werkende samenvatting gebruikte echte opslag op paden zoals /media/Safe-Storage/UrBackup/backups en /media/Safe-Storage/UrBackup/data, gekoppeld aan /backups en /var/urbackup. Controleer je werkelijke hostpad in plaats van de naam van de opslag uit de bron letterlijk over te nemen.

‘Permission denied’ betekent dat de containergebruiker niet kan schrijven

De bron stuitte op Geen toestemming om toegang te krijgen tot "/backups/urbackup_tmp_files". De oplossing gebruikte een specifieke UID/GID en bijbehorend eigenaarschap op de host. Leg 1000:100 als universele identiteit; controleer de huidige runtimegebruiker.

Bewaar zowel back-ups als de UrBackup-status

De repository bevat back-upgegevens van clients en /var/urbackup bevat de serverdatabase en -status. Een bruikbaar herstelplan moet beide waar nodig bewaren.

De bron gebruikte hostnetwerken

De onderhouden uroni/urbackup-server image documenteert hostnetwerken momenteel als een ondersteund Docker-patroon en stelt de normale UrBackup-servicepoorten beschikbaar. Hostnetwerken vereenvoudigt detectie, maar verwijdert netwerkisolatie van Docker.

De WebUI heeft de juiste poort nodig

De bron corrigeerde de ZimaOS-launcher naar poort 55414. De launcher is alleen een handige URL; de werkelijke servicestatus moet worden gecontroleerd aan de hand van logs en luisterende poorten.

ZimaOS UrBackup-appinstellingen voor image, WebUI, netwerk en poortconfiguratie
De bron laat zien hoe de instellingen voor de image, WebUI en netwerk elk afzonderlijk verkeerd kunnen zijn, zelfs wanneer de container bestaat.

Geef de voorkeur aan een reproduceerbare Compose-definitie

De huidige workflows voor ZimaOS App Store 2.0 en aangepaste apps ondersteunen standaard Docker Compose. Houd de image, persistente paden, tijdzone, herstartbeleid en netwerkconfiguratie bij elkaar in één Compose-definitie.

Gebruik het huidige ZimaOS Compose-model.

Een actief dashboard is niet de laatste test

Registreer één client, voltooi een kleine back-up, start de container of host opnieuw op en voer vervolgens een bestandsherstel uit. Hiermee controleer je netwerkverbinding, machtigingen, persistentie van de database en back-upopslag gezamenlijk.

Plaats de back-uprepository op gegevensopslag, niet op de systeemschijf

UrBackup kan honderden gigabytes of meer in beslag nemen. Het opslagpad voor de repository moet verwijzen naar een echte ZimaOS-opslaglocatie met bekende capaciteit en bekende gezondheid, niet naar de kleine schijf met het besturingssysteem.

Controleer voordat je clients toevoegt het hostpad in ZimaOS en houd de vrije ruimte in de gaten tijdens de eerste volledige back-up.

De bestanden onder

De UrBackup-database maakt deel uit van het herstelsysteem /backups zijn slechts de ene helft van een bruikbare server. De status en database van UrBackup onder /var/urbackup houdt clients, back-upmetadata, bewaarbeleid en serverconfiguratie bij.

Documenteer en beveilig beide persistente koppelingen, zodat het opnieuw aanmaken van een container niet leidt tot een hoop back-upbestanden zonder de verwachte serverstatus.

Gebruik schrijfrechten volgens het principe van minimale bevoegdheden

De aanpassing van de UID/GID die specifiek voor de bron was, heeft één implementatie hersteld, maar recursieve eigendomswijzigingen in een volledige opslagpool zijn riskant. Maak een speciale UrBackup-map aan en geef de containeridentiteit toegang tot die map, in plaats van brede schrijfrechten voor niet-gerelateerde NAS-gegevens.

Hostnetwerken stelt UrBackup-services rechtstreeks op ZimaOS bloot

Wanneer hostnetwerken wordt gebruikt, zijn de UrBackup-listeners host-listeners. Als ZFW of een andere firewall de NAS beschermt, sta dan alleen de poorten en clientnetwerken toe die nodig zijn voor back-ups en detectie. Publiceer UrBackup-servicepoorten niet rechtstreeks op het openbare internet.

Test een herstelactie voordat je de back-upserver als voltooid beschouwt

Voltooi één back-up van een client, start ZimaOS opnieuw op of maak de container opnieuw aan, controleer of de clientgeschiedenis behouden blijft en herstel vervolgens meerdere bestanden naar een afzonderlijke locatie. Hiermee valideer je de beschikbaarheid van de image, machtigingen, persistente status, netwerkverbinding en daadwerkelijke herstelbaarheid—niet alleen het groene dashboard.

Veelgestelde vragen over UrBackup op ZimaOS

Is het de gebruiker uit de bron uiteindelijk gelukt om UrBackup werkend te krijgen?

Ja.

Moet elk ZimaOS-systeem PUID 1000 en PGID 100 gebruiken?

Nee. Dat waren bron-specifieke waarden.

Is hostnetwerken verplicht?

Niet universeel. Het is een gedocumenteerde afbeeldingsoptie die de bron met succes gebruikte, maar deze vermindert de netwerkisolatie.