Solution communautaire

Installer OpenCloud sur ZimaOS avec Docker Compose

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

OpenCloud peut fonctionner sur ZimaOS, car il propose des méthodes officielles de déploiement avec Docker et Docker Compose. Pour un test local rapide, utilisez le déploiement à conteneur unique ; pour synchroniser les fichiers d’une famille avec HTTPS, utilisez la pile Compose officielle avec Traefik intégré ou l’architecture avec proxy externe.

L’utilisateur a rencontré des difficultés pendant deux semaines avec des instructions générées par l’IA. La solution consiste à cesser d’improviser la pile et à suivre le modèle de déploiement actuel d’OpenCloud, notamment ses chemins persistants de configuration et de données, la configuration initiale de l’administrateur, l’URL et les exigences liées au proxy et au TLS.

Commencer par une instance de test locale

Le guide Docker d’OpenCloud actuel décrit un conteneur simple sur le port 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

Utiliser le test local uniquement pour la validation

L’exemple en amont utilise des paramètres non sécurisés et locaux pour les tests rapides. Ne le considérez pas comme un déploiement de cloud familial de production exposé à Internet.

Utiliser Docker Compose pour la production

Le guide Docker Compose d’OpenCloud actuel prend en charge deux architectures officielles : Traefik intégré ou proxy inverse externe.

Surveiller les ports 80 et 443 sur ZimaOS

La pile avec Traefik intégré utilise normalement les ports HTTP/HTTPS standard. Si ZimaOS ou un autre proxy inverse les utilise déjà, choisissez la méthode avec proxy externe ou une adresse IP LAN/une machine virtuelle distincte plutôt que de déplacer hâtivement le point de gestion de ZimaOS.

Conserver la configuration et les données utilisateur

Conservez /etc/opencloud et /var/lib/opencloud sur un stockage ZimaOS durable. Une image de conteneur peut être recréée ; l’identité et les données utilisateur, non.

Utiliser une image ou une branche stable pour les données familiales

L’exemple de démarrage rapide utilise une image évolutive. Pour un déploiement durable, suivez les recommandations de production d’OpenCloud et épinglez une version ou une branche stable appropriée après validation, plutôt que de mettre à jour sans discernement.

Sauvegarder avant toute mise à niveau

Protégez la configuration et les données OpenCloud, puis testez la connexion, le partage, les clients de synchronisation et la restauration après les mises à niveau.

OpenCloud ou Nextcloud

Si vous avez principalement besoin d’une synchronisation légère de fichiers pour plusieurs utilisateurs, OpenCloud peut être un bon choix. Si vous avez besoin d’un écosystème plus vaste avec calendrier, contacts, bureautique, extensions et intégrations éprouvées, Nextcloud reste peut-être l’option la plus riche en fonctionnalités.

Le guide Docker personnalisé fournit les informations nécessaires pour la partie ZimaOS du processus.

Choisir l’URL publique ou privée avant la configuration de production

OpenCloud génère les liens et les redirections d’authentification en fonction de l’URL configurée. Décidez du nom d’hôte final et du chemin HTTPS avant d’inviter les membres de votre famille, afin de ne pas devoir migrer les clients depuis une URL temporaire de type localhost par la suite.

Vérifier la synchronisation des fichiers avec un utilisateur non administrateur

Créez un compte familial standard, téléversez un dossier de test depuis un client, synchronisez-le avec un deuxième appareil, puis supprimez et restaurez un fichier de test. Cela vérifie le véritable processus de synchronisation entre plusieurs utilisateurs, et pas seulement la connexion à l’interface web d’administration.

Sauvegarder l’identité et la configuration avec les fichiers

Les fichiers utilisateur ne constituent pas à eux seuls l’intégralité du service. Conservez la configuration et les données d’identité OpenCloud afin de pouvoir récupérer les comptes, les partages et les autorisations en même temps que les fichiers stockés.

FAQ

OpenCloud peut-il fonctionner sur ZimaOS ?

Oui. ZimaOS prend en charge Docker et Compose, et OpenCloud documente officiellement ces deux méthodes de déploiement de conteneurs.

Quel port utilise le test OpenCloud simple ?

L’exemple Docker local officiel utilise le port 9200.

Dois-je utiliser l’image évolutive en production ?

Utilisez-la uniquement pour les tests, sauf si les recommandations actuelles d’OpenCloud pour la production correspondent explicitement à votre stratégie de mise à jour.

Ai-je besoin de Traefik ?

Non. OpenCloud prend en charge Traefik intégré ou un déploiement derrière un proxy inverse externe.