Collabora OnlineをownCloud Infinite Scaleと統合する方法

Collabora OnlineとownCloud Infinite Scale（oCIS）の統合は、ownCloud Classicで使用される設定とは異なり、WOPI統合です。WOPI（Web Application Open Platform Interface）とは、オンラインオフィススイートがストレージプラットフォームからファイルを要求し、ブラウザで編集して、その結果を書き戻すことを可能にするプロトコルです。

この違いが重要なのは、現在のInfinite Scaleのデプロイメントでは、組み込みのコラボレーションサービスがoCISとCollabora間のブリッジとして使用されているためです。古いownCloud Classic CollaboraアプリをインストールしてサーバーURLを指定する必要はありません。オフィスアプリケーションは、コラボレーションサービスとアプリレジストリサービスを通じて登録されます。ownCloud WOPIの公式ドキュメントでは、Collaboraがサポートされているオフィスアプリケーションとして記載されており、コラボレーションサービスのドキュメントでは、サービスとその必要な設定について説明されています。

2026年10月現在、ownCloudの公式GitHubリリースには、2026年8月10日にリリースされたInfinite Scale 8.2.0が含まれています。プロジェクトのデプロイメント例は独自に進化する可能性があるため、ローリングイメージが適切であると想定するのではなく、テスト済みの本番環境タグを使用してください。公式のoCISフルデプロイメント例では、26.04.3.1.1環境ファイルにCollabora CODEタグを使用することを推奨しています。バージョンを固定する前に、公式のInfinite Scaleリリースと公式デプロイメント例の環境ファイルを確認してください。

まず、３つの終点について理解しましょう。

本番環境への統合は通常、3つの論理的なエンドポイントを含みます。

終点	目的	例
無限スケール	ユーザー向けownCloud WebおよびストレージAPI	`https://cloud.example.com`
Collabora Online	ブラウザエディタとWOPIクライアント	`https://office.example.com`
WOPI/コラボレーションサービス	CollaboraがoCISファイルを読み書きするためのブリッジ	トポロジーに応じて、内部サービスURLまたは外部ルーティングされたWOPIホスト名

検証済み: COLLABORATION_APP_ADDR Collabora の URL であり、COLLABORATION_WOPI_SRCオフィスアプリケーションで使用される WOPI ソースを識別します。環境依存: Collabora とコラボレーションサービスが信頼できるコンテナネットワークを共有している場合、WOPI ソースは別のパブリックホスト名である必要はありません。現在の公式 Compose の例では、http://collaboration:9300内部的にを使用しています。分離デプロイメントでは、ルーティングされた HTTPS WOPI ホスト名が必要になる場合があります。

役立つ手順：設定値をコピーする前に、トポロジーを決定してください。すべてのコンポーネントが公式のComposeスタックで実行されている場合は、その例から始めてください。Collaboraが別のホストまたはKubernetesクラスタで実行されている場合は、各側が実際に解決してアクセスできるDNS名を文書化してください。

ステージ1：DNS、HTTPS、およびCollabora Discoveryの検証

oCIS の設定を変更する前に、ownCloud と Collabora の名前が正しく解決され、Collabora が検出エンドポイントを公開していることを確認してください。Collabora は WOPI 機能をを通じて公開します/hosting/discovery。基本的なチェックは次のとおりです。

dig +short cloud.example.com
dig +short office.example.com

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

検出エンドポイントからXMLを受信する必要があります。TLSがリバースプロキシで終了する場合は、office.example.comoCISホストまたはコンテナネットワークの観点から、提示された証明書が有効であることを確認してください。

ターミナルでownCloudとCollaboraのホスト名のDNSをチェックし、Collaboraホスティング検出エンドポイントを要求します。

/hosting/discoveryキャプション： Infinite Scale内でWOPI登録をデバッグする前に、名前解決とCollaboraエンドポイントを確認してください。

よくある誤解：ブラウザでCollaboraのランディングページが表示されたからといって、WOPI連携が正常に機能しているとは限りません。これは、Webエンドポイントにアクセス可能であることを示すだけです。コラボレーションサービスがCollaboraにアクセスでき、CollaboraもWOPIソースにアクセスできる必要があります。

有効な対策：関連サービスと同じネットワーク名前空間から接続テストを実行します。例えば、Dockerを使用している場合は、コラボレーションコンテナ内から実行します。

ステージ2：無限スケールコラボレーションサービスの設定

コラボレーションサービスは、一般的なocis server監視モードの設定では自動的に起動されません。ownCloudのドキュメントには、管理者が異なるオフィス製品用に複数のコラボレーションサービスインスタンスを実行する可能性があるため、明示的に起動する必要があると記載されています。

Collaboraの重要な設定項目は以下のとおりです。

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=http://collaboration:9300
OCIS_URL=https://cloud.example.com

上記のWOPIソースコードは、現在の公式Composeサンプルで使用されているトポロジーと完全に一致しています。Collaboraとコラボレーションサービスは同じDockerネットワークを共有しています。Collaboraサーバーが外部にある場合は、内部URLをCollaboraがアクセスできるアドレスに置き換えてください。

このサービスは、Infinite Scaleのゲートウェイおよびアプリプロバイダのインフラストラクチャにも依存しています。コンテナ分割デプロイメントの場合、ownCloudのドキュメントでは、生成されたシークレットがサービス間で必要となるため、oCIS構成をコラボレーションコンテナと共有する必要があると明記されています。最新の公式Collabora Compose定義を参照してください。

Collabora、オフィス住所、WOPIソース、HTTPリスナー情報から始まるInfinite Scaleコラボレーションサービスのターミナルビュー

キャプション：コラボレーションサービスプロセスは、意図したCollaboraアドレスとWOPIソースから開始する必要があります。実際のサービスログを使用して、デプロイメント内の値を確認してください。

役立つアドバイス：collabora.ymlデプロイメントを手動で構築した場合は、古いcs3org/wopiserverチュートリアルから設定をコピーするのではなく、公式の環境と比較してください。

ステージ3：WOPIホストとブラウザ埋め込みのためのCollaboraの設定

CollaboraはWOPIホストを信頼し、ownCloud Webページ内でレンダリングを行う権限が必要です。公式のoCIS Composeサンプルでは、リバースプロキシでTLSを終端し、net.frame_ancestorsoCISドメインに設定するCollaboraオプションを渡します。また、Collaboraを起動する前にWOPI証明キーを生成します。

公式の例では、関連する Collabora 側の値には以下が含まれます。

DONT_GEN_SSL_CERT=YES

extra_params:
  --o:ssl.enable=...
  --o:ssl.ssl_verification=...
  --o:ssl.termination=true
  --o:welcome.enable=false
  --o:net.frame_ancestors=cloud.example.com

SSLフラグの具体的な設定は、TLSの終端場所によって異なります。インターネットに接続する場合は、証明書検証を有効にしたHTTPS接続が推奨されます。この例のINSECURE=trueオプションは、自己署名証明書を使用するローカル環境で使用できますが、ownCloudの導入ガイドでは、パブリックサーバーの場合はこのオプションを削除するか、falseに設定するよう管理者に明示的に指示しています。

ブラウザビューには、アクセス可能なCollabora Onlineサービスエンドポイントが表示されています。

キャプション：アクセス可能なCollaboraエンドポイントが前提条件の一つです。本番環境では、他のコンポーネントから信頼されている証明書を使用してHTTPS経由でエンドポイントを公開する必要があります。

有効な対処法：ドキュメントの読み込み時にiframeが空白になったり、CSPエラーが発生した場合は、ブラウザの開発者ツールとリバースプロキシのヘッダーを確認してください。ページを読み込むためだけに、証明書の検証やコンテンツセキュリティの制限を広範囲に無効にしないでください。

ステージ4：登記所ファイルの種類とテスト編集

Infinite Scaleのアプリレジストリサービスは、各MIMEタイプを開くことができるアプリケーションを決定します。その設定では、MIMEタイプ、拡張子、アイコン、デフォルトアプリケーション、およびユーザーがそのタイプの新しいファイルを作成できるかどうかを定義できます。これらのフィールドについては、公式のアプリレジストリドキュメントで説明されています。

重要な点は、レジストリで使用されるアプリ名が、実際に登録したコラボレーションプロバイダーと一致している必要があるということです。現在の公式Collabora展開例では、製品名CollaboraOnlineとしてとCOLLABORATION_APP_NAMEを使用していますCollabora。展開バージョンを確認せずに、古い例からコピーした名前を混在させないでください。

起動後、ownCloud Webにログインし、サポートされているオフィス文書を開きます。正常に動作した場合の流れは以下のようになります。

ownCloud Webは、文書のMIMEタイプに基づいて、登録事務所のアプリケーションを選択します。
コラボレーションサービスは、WOPIのローンチ情報を作成します。
Collaboraはブラウザに読み込まれ、WOPIを介してファイルを要求します。
編集内容は、同じ統合プロセスを通じてInfinite Scaleに書き戻されます。

ownCloud Infinite Scaleから開いたDOCXファイルを表示するブラウザベースのCollaboraドキュメントエディタ

キャプション：最終テストは、ownCloud Webから実際のオフィス文書を開き、Collaboraで編集し、閉じて、保存したバージョンがInfinite Scaleで再び表示されることを確認することです。

有効な手順：使い捨てのテスト文書に小さな変更を加え、エディタを閉じ、ファイルを再度開き、変更が反映されていることを確認します。エディタを読み込むだけのページでは、完全な書き込みパスのテストにはなりません。

カスタムトポロジーが必要ない場合は、公式のComposeサンプルを使用してください。

従来のDockerデプロイメントの場合、リスクが最も低いのはownCloudが提供しているocis_fullサンプルです。このサンプルには、コラボレーションサービスであるCollaboraとTraefikを含むInfinite Scaleが含まれています。公式ガイドによると、このデプロイメントにはoCISとCollabora用のドメインが必要であり、スタックの一部としてWOPIコンポーネントがドキュメント化されています。詳細については、公式の完全なデプロイメントガイドを参照してください。

一般的な本番環境向け環境ファイルには、概念的には次のような値が含まれます。

OCIS_DOCKER_IMAGE=owncloud/ocis
OCIS_DOCKER_TAG=<tested-production-version>
OCIS_DOMAIN=cloud.example.com

COLLABORA=:collabora.yml
COLLABORA_DOCKER_TAG=<tested-collabora-version>
COLLABORA_DOMAIN=office.example.com

INSECURE=false

次に、スタックを次のように開始します。

docker compose pull
docker compose up -d
docker compose ps

検証済み：現在の公式リバースプロキシの例では、コラボレーション/Collaboraで必要とされるため、HTTPSエントリポイントでエンコードされたスラッシュ、疑問符、パーセント記号が有効になっています。環境依存： Traefikの代わりにNginx、HAProxy、イングレスコントローラー、またはクラウドロードバランサーを使用する場合は、そのプラットフォームで必要なURL処理、WebSocket/プロキシ動作、証明書、タイムアウトを再現する必要があります。

有効な対策： Traefikのラベルを他のプロキシにそのまま翻訳しないでください。Traefikのラベルはルーティング要件を理解するために使用し、その後、プロキシのドキュメントに記載されている構文を使用してそれらの要件を実装してください。

トラブルシューティングリファレンス

症状	可能性の高い地域	次の項目を確認してください
DOCX/ODT 用のオフィスオプションはありません	アプリレジストリ／プロバイダー登録	コラボレーションサービスが登録されていること、およびMIMEタイプが正しいアプリ名を指していることを確認してください。
Collaboraページは動作するが、ドキュメントが開かない	WOPIの到達可能性	Collaboraが`COLLABORATION_WOPI_SRC`コラボレーションログにアクセスして検査できることを確認してください。
空白のフレームまたはブラウザのCSPエラー	フレーム/CSP構成	`frame_ancestors`oCIS CSPと、ブラウザが実際に使用しているオリジンを確認してください。
TLSまたは証明書エラー	リバースプロキシ／トラストチェーン	本番環境では有効な証明書を使用し、ワークステーションだけでなくサービスコンテナからもHTTPSをテストしてください。
エディタは開くが、保存に失敗する	WOPI書き込みパス/共有シークレット	コラボレーションおよびCollaboraのログを検査し、必要な場所に共有oCIS構成がマウントされていることを確認します。
1つのファイルが複数のオフィススイートで予期せず開く	複数のオフィスとの連携	公式環境ファイルでは現在、同一ファイル内のアプリの連動機能が利用できないため、重複するオフィスアプリを有効にしないよう警告しています。

既知の事項、導入状況によって左右される事項、そして想定すべきでない事項

既知の情報： Infinite ScaleはWOPIを介してCollaboraをサポートしており、組み込みのコラボレーションサービスが現在のブリッジとして機能し、公式の完全展開では動作するリファレンスアーキテクチャが提供されます。

環境によって異なります。WOPIエンドポイントが内部コンテナURLかパブリックホスト名か、TLSがどこで終端されるか、どのプロキシを使用するか、そしてCollaboraがoCISと同じネットワークで実行されているかどうかによって決まります。

ご注意ください。ownCloud Classic の手順は Infinite Scale にも適用されます。Collabora/richdocuments アプリのインストール方法や Classic の管理画面からの設定方法について説明している Classic のドキュメントは、異なる製品アーキテクチャについて述べています。

したがって、最も信頼性の高い統合ワークフローは次のとおりです。まず、公式のInfinite Scale展開モデルから開始し、ネットワークとTLSの到達可能性を検証し、コラボレーションサービスを設定し、CollaboraがWOPIホストを信頼し、到達できることを確認し、関連するMIMEタイプを登録し、最後に実際のドキュメントの開閉と保存の両方をテストします。

コメントを残す

ONLYOFFICE Desktop EditorsをownCloudサーバーに接続する方法

ONLYOFFICE Desktop EditorsをownCloudサーバーに接続する手順を解説。ログイン、クラウド上のファイル編集、接続の管理、設定時によくあるトラブルの確認方法を紹介します。

Collabora OnlineのCPU使用率が高い問題を解決する方法（loolwsd / coolwsdより）

Collabora OnlineのCPU使用率が高い場合、ビジー状態のキットプロセスを特定し、メトリクスとログを確認し、同時実行性とクリーンアップを調整し、修正が安全に行われたことを検証することで、トラブルシューティングを行います。

ONLYOFFICEドキュメントをロゴとカラーでカスタマイズする方法

ONLYOFFICE Docsをヘッダーロゴやインターフェースカラーでカスタマイズする方法を学びましょう。ライセンス制限、テーマJSONの設定、Dockerパス、テスト方法なども解説します。

LibreOffice Calcのダークモードにおけるテキスト表示の問題を修正する

LibreOffice Calc で読みにくいテキストを修正するには、アプリのテーマ、セルのフォントと塗りつぶしの色、スタイル、条件付き書式設定を確認し、印刷出力を検証してください。

LibreOfficeで「ドキュメントは不明なユーザーによってロックされています」エラーを修正する

LibreOfficeの不明ユーザーによるロック警告を安全に解除します。アクティブなセッションを確認し、コピーを保護し、検証済みの古いロックのみを削除して、ドキュメントをテストします。

LibreOffice Writer でアラビア語とヘブライ語の右から左へのテキスト表示を修正する

LibreOffice Writerで、アラビア語またはヘブライ語のテキストが英語と正しく並ばず、位置がずれたり、混ざり合ったりする場合を修正します。複雑なテキストレイアウトを有効にし、段落の方向を設定して、結果を確認してください。

LibreOffice Calc VLOOKUP vs XLOOKUP: A Beginner-Friendly Functions Guide

Learn VLOOKUP and XLOOKUP in LibreOffice Calc, including exact matches, left lookups, not-found results, reverse search, INDEX/MATCH alternatives, and common errors.

Collabora Onlineで「WOPI認証検証失敗」を修正する方法

Collabora OnlineのWOPI認証検証エラーのトラブルシューティングを行うには、検出キー、キーローテーション、プロキシURL、タイムスタンプ、ホスト許可リストを確認してください。

ONLYOFFICE Docsで変更履歴をデフォルトで有効にする方法

ONLYOFFICEドキュメントで全員に対して変更履歴の記録を有効にし、再度開いた後もアクティブな状態を維持する方法、およびグローバルなデフォルト設定の制限事項を理解してください。

Collabora編集セッションのアイドルタイムアウトを設定する方法

Collabora Onlineのビューごとのタイムアウト、フォーカスが外れた状態のタイムアウト、ドキュメントがアイドル状態のタイムアウト、自動保存のタイムアウト、プロキシのタイムアウトを比較し、導入環境に適した設定を選択して確認してください。