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タイプを登録し、最後に実際のドキュメントの開閉と保存の両方をテストします。

コメントを残す

Microsoft Wordで画像を移動する方法

Wordで画像をドラッグする方法、テキストの折り返しを選択する方法、段落内に画像を保持する方法、ページ上に画像を固定する方法、そして画像が移動しない場合のトラブルシューティング方法を学びましょう。

Excelにチェックボックスを挿入する方法：2つの簡単な方法

Excelのセル内ツールを使ってチェックボックスを挿入する方法、数式を使ってチェックされた項目の数を数える方法、古いデスクトップ版でリンクされたフォームコントロールを追加する方法を学びましょう。

Excelで文字を自動入力する方法：AからZ、そしてその先へ

Excelでフィルハンドル関数、SEQUENCE関数、または再利用可能なカスタムリストを使用して、AからZまでのアルファベット、小文字、またはZを超えるラベルを生成します。

Excelで取り消し線を引く方法：ショートカットと手順

Windows、Mac、Web版Excelで取り消し線を引く方法、セルの一部に書式を設定する方法、値を削除せずに行を削除する方法を学びましょう。

Microsoft Accessとは？そのデータベースツールはどのように機能するのか？

Microsoft Accessは、関連レコードの保存、クエリの作成、データ入力フォームの作成、レポートの生成を行うためのWindowsデータベースアプリケーションです。その仕組みと最適な活用シーンについて解説します。

Word 2010でグリッド線の高さと幅を変更する

Word 2010でグリッド線の高さと幅を調整する方法、表示される線の頻度を変更する方法、および下地となる水平方向と垂直方向の描画グリッドの間隔を設定する方法を学びましょう。

Office Outlook 2010 のインポートとエクスポート: PST ファイルを使用してデータを移動する

Outlook 2010にPSTファイルをインポートする方法、またはメール、連絡先、カレンダー、タスクをエクスポートする方法を学びましょう。正しいメニューに従い、フォルダの欠落や重複を避けてください。

Nucleus Kernelを使用してOutlook PSTファイルのパスワードを復元する

Kernelが提供する最新の手順では、忘れてしまったOutlook PSTファイルのパスワードを復元する方法を解説します。正しいファイルの特定方法、バックアップの作成方法、ツールの制限事項の確認方法などが含まれています。

PowerPointスライドにライブWebページを挿入する方法

LiveWebアドインを使用すると、WebサイトをPowerPointスライドに配置し、サイズや更新動作を設定し、プレゼンテーション前に互換性を確認できます。

Access 2010データベースをフォームで開く方法

Access 2010データベースアプリケーションを、データ入力フォームに直接開くように設定し、オブジェクトリストを非表示にし、メニューを制限し、共有前に設定を確認します。