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

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で実行できます。手軽なローカルテストには単一コンテナの手順を、本番環境で家族とファイルを同期するには、統合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とユーザーデータは復元できません。

家族データには安定したイメージ/ブランチを使う

クイックスタートの例ではローリングイメージを使用しています。長期運用する場合は、無条件に更新するのではなく、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を使用しています。

本番環境でローリングイメージを使用すべきですか?

OpenCloudの最新の本番環境向けガイダンスが更新戦略に明確に適合する場合を除き、テスト専用として使用してください。

Traefikは必要ですか?

いいえ。OpenCloudは、統合されたTraefikを使用する方法と、外部のリバースプロキシの背後に配置する方法のどちらにも対応しています。