コミュニティソリューション

Docker ComposeでZimaOSにOpenCloudをインストールする

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

OpenCloudは、DockerとDocker Composeによる公式のデプロイ方法が用意されているため、ZimaOS上で実行できます。 簡単なローカルテストには単一コンテナ方式を使用し、HTTPS対応の家族向けファイル同期には、Traefikを統合した公式Composeスタックまたは外部プロキシ構成を使用してください。

原文のユーザーは、AIが生成した手順に2週間悩まされていました。解決策は、独自にスタックを構成するのをやめ、OpenCloud独自の最新のデプロイモデルに従うことです。特に、永続的な設定・データパス、初期管理者設定、URL、プロキシとTLSの要件に注意してください。

ローカルテストインスタンスを開始する

現在のOpenCloud Dockerガイドでは、ポート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

ローカルテストは検証専用にする

上流の例では、簡単なテスト用に安全性の低いローカル設定を使用しています。これを、インターネットに公開する本番の家族向けクラウド環境として扱わないでください。

本番環境ではDocker Composeを使用する

現在のOpenCloud Docker Composeガイドでは、統合Traefikまたは外部リバースプロキシという2つの公式構成に対応しています。

ZimaOSでポート80と443を確認する

統合Traefikスタックは通常、標準のHTTP/HTTPSポートを使用します。ZimaOSや別のリバースプロキシがすでにこれらのポートを使用している場合は、ZimaOSの管理エンドポイントを不用意に移動するのではなく、外部プロキシ構成または別のLAN IP/VMを使用してください。

設定とユーザーデータの両方を永続化する

/etc/opencloud/var/lib/opencloudは、耐久性のあるZimaOSストレージ上に保持してください。コンテナイメージは再作成できますが、ID情報とユーザーデータは再作成できません。

家族のデータには安定したイメージやブランチを使用する

クイックスタートの例ではrollingイメージを使用しています。長期運用する場合は、検証後にOpenCloudの本番向けガイダンスに従い、適切な安定版リリースまたはブランチを固定してください。無計画に更新しないでください。

アップグレード前にバックアップする

OpenCloudの設定とデータの両方を保護し、アップグレード後にログイン、共有、同期クライアント、復元をテストしてください。

OpenCloudとNextcloud

主に軽量なマルチユーザーファイル同期が必要な場合、OpenCloudは適した選択肢です。カレンダー、連絡先、オフィス機能、プラグイン、成熟した連携機能を含む、より大規模なエコシステムが必要な場合は、Nextcloudのほうが機能豊富な選択肢となる可能性があります。

カスタムDockerガイドでは、ワークフローにおけるZimaOS側の手順を説明しています。

本番設定の前に公開URLまたはプライベートURLを選択する

OpenCloudは、設定されたURLに基づいてリンクと認証リダイレクトを生成します。家族を招待する前に最終的なホスト名とHTTPSパスを決めてください。後から一時的なlocalhost形式のURLからクライアントを移行する必要がなくなります。

管理者以外のユーザーでファイル同期を確認する

通常の家族用アカウントを作成し、1台のクライアントからテストフォルダーをアップロードして2台目のデバイスに同期し、その後テストファイルを削除して復元してください。これにより、管理者のWebログインだけでなく、実際のマルチユーザー同期ワークフローを確認できます。

ファイルとともにID情報と設定もバックアップする

ユーザーファイルだけではサービス全体を保存したことにはなりません。アカウント、共有、権限を保存ファイルとともに復元できるよう、OpenCloudの設定とID情報も保持してください。

よくある質問

OpenCloudはZimaOS上で実行できますか?

はい。ZimaOSはDocker/Composeに対応しており、OpenCloudも両方のコンテナデプロイ方法を公式に案内しています。

シンプルなOpenCloudテストで使用するポートは何ですか?

公式のローカルDocker例では、ポート9200を使用します。

本番環境でrollingイメージを使用すべきですか?

テスト用途に限定してください。ただし、OpenCloudの最新の本番向けガイダンスが、現在の更新戦略に明確に適合する場合を除きます。

Traefikは必要ですか?

いいえ。OpenCloudは、統合Traefikまたは外部リバースプロキシの背後でのデプロイに対応しています。