Collabora Online CODEをDockerとNextcloudでインストールする方法

具体例： Nextcloud ファイルが にホストされている小規模チームを想像してくださいhttps://cloud.example.com。チームの管理者は、 に別の Collabora Online Development Edition (CODE) サーバーを構築したいと考えていますhttps://office.example.com。これは手順を説明するための架空の設定であり、実際のインストールのレポートではありません。上記のホスト名は、ご自身が管理するドメイン名に置き換えてください。

CODEはNextcloudとは別のサービスとして動作します。DockerがCollaboraサービスを起動し、TLSリバースプロキシがそれを公開し、Nextcloud Office統合機能が両者を接続します。ブラウザは公開されているオフィスURLにアクセスできる必要があり、サーバーは関連するNextcloudおよびCollaboraのエンドポイントにアクセスできる必要があります。現在のNextcloud Officeインストールマニュアルでは、Dockerをデプロイメントオプションの1つとして説明しており、専用サーバーには通常リバースプロキシが必要であることを指摘しています。

始める前に

この例では、Linux ホストで Docker が実行可能であり、Nextcloud が既に HTTPS で動作し、両方のホスト名の DNS レコードが正しいサーバーを指していると仮定します。 の有効な TLS 証明書を取得しますoffice.example.com。 Collabora サービスの Docker ポートを直接パブリック インターネットに公開するのではなく、そのホスト名を介して Collabora サービスを公開するように計画します。

• CODEホストがを解決して接続できることを確認してくださいcloud.example.com。
• https://office.example.comブラウザがHTTPSでアクセスできることを確認してください。
• リバースプロキシをDockerホスト上で実行するか、別の場所で実行するかを選択します。同じホスト上のプロキシはループバックで公開されたコンテナポートを使用できます。別のコンテナ内のプロキシは、到達可能な共有Dockerネットワークまたは別のプライベートルートが必要です。
• 本番環境で使用する前に、互換性とプロキシ要件について、最新のCODEおよびNextcloudのドキュメントを確認してください。CODEは開発版です。ベンダーによる安定性やサポートが必要なチームは、サポート対象のCollabora Online製品を検討してください。

以下のコマンドは、公式イメージ名と単一のNextcloudオリジンを使用します。これらの例ではリリースタグは固定されていないため、管理者は本番環境の変更管理戦略としてcollabora/code扱うのではなく、バージョン管理と更新ポリシーを決定する必要があります。latest

1. オフィスホスト名をサーバーに向けます。

office.example.comCollaboraを提供するホストまたはロードバランサーを指すDNS AレコードまたはAAAAレコードを作成します。リバースプロキシを設定して、その名前で有効な証明書を使用してHTTPSを終端し、CollaboraアプリケーションパスとWebSocketトラフィックをCODEコンテナに転送します。Collaboraの公式リバースプロキシドキュメントには、プロキシ固有の例が記載されています。実際のプロキシソフトウェアと現在のCODEリリースに合わせて、該当セクションを参照してください。

汎用プロキシのスニペットをそのままコピーしないでください。プロキシは、WebSocket のアップグレードをサポートし、必要なホストと転送プロトコル情報を保持し、 、 、 などの Collabora ルートを渡す必要があります/browser。/hosting/discovery具体/cool的な指示は、Apache、NGINX、Traefik、その他のゲートウェイによって異なります。プロキシが Docker ホスト上で実行されている場合、 への転送は127.0.0.1:9980一般的なプライベートターゲットです。別のコンテナである場合、そのループバック アドレスは CODE ホストではなく、プロキシ コンテナ自体を指します。

2. CODE Dockerコンテナを起動する

Dockerホスト上で、コンテナをプルして起動します。この例では、ポートはループバックにバインドされているため、すべてのホストネットワークインターフェイスに直接公開されることはありません。

docker pull collabora/code

docker run -d --name collabora   -p 127.0.0.1:9980:9980   -e 'aliasgroup1=https://cloud.example.com:443'   --restart always   --cap-add MKNOD   collabora/code

このaliasgroup1値は、このCODEサービスを使用することが想定されるNextcloudオリジンを認証します。スキームとホスト名は、ユーザーがNextcloudにアクセスするために使用するURLと一致させてください。公開されているNextcloudサービスがデフォルト以外のポートを使用している場合は、そのポートを含めてください。複数のNextcloudインスタンスがこのサービスを使用する場合は、任意のホストを広く許可するのではなく、現在のCODEイメージのドキュメントに従って、追加の許可ホストグループを設定してください。

このコマンドは、リバースプロキシが同じマシン上にあり、ループバックポートに転送することを前提としています。Docker Compose、コンテナ化されたプロキシ、またはリモートプロキシを使用している場合は、ネットワークとポートの公開設定を慎重に調整してください。プロキシ接続を機能させるためだけにポート9980を公開することは避け、プライベートDockerネットワーク、ファイアウォールルール、またはその他の制限されたパスを使用してください。CODE Dockerイメージの現在のオプションについては、CollaboraのCODE Dockerガイドを参照してください。

3. リバースプロキシを設定し、コードを確認します。

プロキシの設定が完了したら、ソフトウェアに応じた方法でプロキシを再読み込みし、変更を適用する前に設定を確認してください。その後、ドメインにアクセスできるマシンからパブリック検出エンドポイントにリクエストを送信してください。

curl -fsS https://office.example.com/hosting/discovery | head

正常な応答には、プロキシエラーページではなく、XML検出情報が含まれているはずです。このチェックは、公開URLがCollaboraエンドポイントに到達していることを確認するものであり、Nextcloud認証、WebSocket、またはドキュメント編集が機能していることを証明するものではありません。エンドポイントが失敗した場合は、コンテナも検査してください。

docker ps --filter name=collabora
docker logs --tail=100 collabora

想定される設定では、パブリック URL への接続が拒否された場合、まず DNS、TLS、ファイアウォール、またはプロキシ ルーティングに問題があると考えられます。502 レスポンスは通常、プロキシがコンテナに設定されているアップストリームに到達できないことを意味します。検出は成功したが、後でエディタの読み込み中にエラーが発生した場合は、WebSocket の転送設定と、プロキシがアップグレードまたはアップストリームのエラーを報告していないかを確認してください。

4. NextcloudをCollaboraに接続する

Nextcloudで、アプリエリアを開き、お使いのバージョンで提供されているオフィス統合をインストールまたは有効化します。アプリのラベルは、リリースとインストールされているアプリカタログによって「Nextcloud Office」または「Collabora Online」となる場合があります。次に、Officeの管理設定を開き、以下を入力します。

https://office.example.com

設定を保存し、接続状態を確認してください。NextcloudのOffice設定ドキュメントでは、このフィールドはCollaboraサーバーのURLとポート番号として示されており、HTTPSの使用が推奨されています。ブラウザからアクセスできる公開Collabora URLを使用してください。スプリットDNS、NAT、またはセグメント化されたネットワーク環境では、Nextcloudは当該サービスへの内部ルートも必要とする場合があります。サーバーから公開DNSが機能すると想定するのではなく、インストールされているアプリバージョンの高度な接続オプションを参照してください。

この例では、Nextcloud はcloud.example.comを許可された WOPI ホストと認識し、ユーザーのブラウザは からエディタを開きますoffice.example.com。Nextcloud の管理ページで WOPI リクエストの許可リストが提供されている場合は、ネットワーク内の正しいアドレスを確認した後、想定される Collabora サーバーのアドレスに制限してください。Nextcloud は WOPI リクエストを想定される Collabora ホストに限定することを推奨しています。特定のネットワーク上の理由がない限り、広範囲の範囲を追加しないでください。

5. サンプル文書でテストする

通常のNextcloudユーザーとしてサインインし、小さなテキスト文書を作成するか、使い捨てのテストファイルを開き、ブラウザエディタを選択します。エディタのツールバーが読み込まれることを確認し、無害な変更を加え、保存インジケーターが表示されるまで待ち、ファイルを閉じて再度開き、変更が保持されていることを確認します。インストールが同時編集をサポートしている場合は、同じテストファイルを別のユーザーセッションで開き、プレゼンスや編集内容が期待どおりに更新されることを確認します。

これらのチェックは主要なレイヤーを分離します。検出リクエストはパブリックルーティングをテストし、Nextcloudステータスは構成済みのサーバー接続をテストし、エディタを開くことでブラウザアクセスとWOPI交換をテストし、ファイルを再度開くことで保存パスをテストします。最初のテストには重要なドキュメントを使用しないでください。CODEは開発版であるため、テストが成功したとしても、組織の可用性、リソース容量、バックアップ、およびサポートニーズを評価する代わりにはなりません。

よくある問題とその確認事項

Nextcloudはサーバーにアクセスできないと報告しています。

Office URLにスペルミスがないか、有効な証明書チェーンを使用しているか、HTTPSスキームが一致しているかを確認してください。ブラウザとNextcloudホストの両方から検出URLをテストしてください。サーバーネットワーク内でパブリックDNSの解決結果が異なる場合は、適切な内部ルートを設定するか、コネクタでサポートされている高度なサーバーURL設定を使用してください。

ページは開くが、ドキュメントエディタがフリーズする。

リバースプロキシのアクセスログとエラーログを調べて、WebSocketのアップグレード失敗がないか確認してください。プロキシが現在のCollaboraルートを転送し、WebSocket接続を長時間維持していることを確認してください。ブラウザの開発者ツールを使用すると、WebSocketリクエストが拒否されたか、HTTPにリダイレクトされたか、証明書エラーによってブロックされたかを確認できます。

CollaboraはNextcloudホストを拒否します

スキーム、ホスト名、ポートを含む実際のNextcloudオリジンを、設定済みのエイリアスグループと比較してください。公開URL、内部ホスト名、プロキシ書き換えが一致しない場合、ホスト認証またはWOPIエラーが発生する可能性があります。許可設定には、意図したNextcloudホスト名のみを追加してください。

コードが起動した後、終了するか、異常な状態になる。

docker logs collaboraデプロイしたイメージタグのディスク容量とメモリ容量、コンテナのアクセス許可、および実行時要件を確認してください。環境に関する最新の公式手順で要求されていない限り、無関係な例から特権モードなどのフラグをコピーしないでください。

アップデートと運用上の注意

セキュリティと互換性のためにコンテナイメージは常に最新の状態に保ってください。ただし、業務時間中に未検証の新しいイメージをプルするのではなく、アップグレードをスケジュールしてテストしてください。使用しているバージョンを記録し、関連するリリースノートを読み、ロールバックパスを確保してください。エンドポイントとWebSocketの要件は変化する可能性があるため、CollaboraまたはNextcloudの大幅な変更後はプロキシ構成を確認してください。また、アクティブなエディターの数が増えるにつれて、ホストのメモリ、CPU、ストレージ、およびコンテナログを監視してください。

架空のチームの場合、インストールが限定的な使用準備完了となるのは、検出エンドポイントが応答し、Nextcloudが接続を報告し、サンプルドキュメントがブラウザで開き、保存した編集内容が再度開いた後も保持されている場合のみです。これらのチェックのいずれかが失敗した場合は、ユーザーがサービスを利用できるようにする前に、そのレイヤーのトラブルシューティングを行ってください。

公式資料

• Nextcloud 35 管理マニュアル：オフィスインストール
• Nextcloud管理マニュアル：Dockerインストール例とApacheプロキシルート
• Nextcloud 35 管理マニュアル：オフィス構成と WOPI ガイダンス
• Collabora Online: CODE Dockerイメージ
• Collabora Online: リバースプロキシ設定

ドキュメントは2026年10月6日にレビューされました。Nextcloudの安定版マニュアルは確認時にバージョン35と表示されていましたが、リンク先のDockerのウォークスルーはバージョン28です。そのため、インストール例として使用し、プロキシ構文をCollaboraガイドおよび実際に使用しているバージョンと照らし合わせて確認してください。