Collaboraの「これは恥ずかしい」エラーを解決する

まず、ブラウザ、Nextcloud、Collabora がすべて同じ HTTP または HTTPS スキームで正しいサーバー URL にアクセスできることを確認してください。Nextcloud では、Collabora のエンドポイントをテストします/hosting/capabilities。/hosting/discoveryこれらのエンドポイントが応答してもドキュメントが失敗する場合は、リバースプロキシの WebSocket ルートと WOPI の許可リストを確認してください。

「これは恥ずかしい」というメッセージは、一般的なドキュメントを開く際の失敗を示すものであり、それ自体が診断結果を示すものではありません。原因としては、アクセスできないURL、TLSまたはDNSの不一致、WebSocketのアップグレードを破棄するプロキシ、あるいはCollaboraまたはNextcloudが信頼していないWOPIホストなどが考えられます。以下のチェックでは、Nextcloudとhttps://cloud.example.comCollaboraをそれぞれ使用した典型的な例を示していますhttps://office.example.com。両方のホスト名を実際のホスト名に置き換えてください。

1. Collaboraのエンドポイントは読み込まれますか？

ユーザーと同じネットワーク上のブラウザから、Collaboraのホスト名を変更して、以下のURLを開いてください。

• https://office.example.com/hosting/capabilities
• https://office.example.com/hosting/discovery

ブラウザの証明書警告、404ページ、またはリバースプロキシエラーではなく、Collaboraエンドポイントデータが返されるはずです。検出エンドポイントは通常XMLを返します。Nextcloudホストまたはそのアプリケーションコンテナからテストすることもできます。

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

ブラウザからのエラーは、パブリックDNSまたはLAN DNS、ファイアウォール、証明書、またはプロキシルーティングに問題があることを示しています。ブラウザでの成功とNextcloudからのコマンドラインでの失敗は、サーバー側の経路が異なることを意味します。ユーザーのブラウザとNextcloudサーバーはそれぞれ、Collaboraへの独自の有効なパスを必要とします。Nextcloudの最新の管理マニュアルでは、両方の場所から両方のエンドポイントをテストし、CollaboraがHTTP(S)経由でNextcloudにアクセスできることを確認することを推奨しています。

2. 2つのサービスはホスト名とプロトコルについて一致していますか？

Nextcloudで、[設定] → [管理] → [オフィス]を開き、[Collabora Onlineサーバー]フィールドに公開されている、またはアクセス可能なCollaboraのURLが含まれていることを確認します。https://サービスがHTTPS用に構成されている場合は、このURLを使用してください。Nextcloudのドキュメントによると、構成済みのURLはCollaboraのインストールと同じプロトコルを使用する必要があり、HTTPSを推奨しています。

次に、戻りパスを確認します。Collaboraホストまたはコンテナから、Nextcloudのステータスエンドポイントにリクエストを送信します。

curl -fsS https://cloud.example.com/status.php

応答は、ラップトップだけでなく、Collabora からもアクセスできる必要があります。サーバーのいずれかが Docker 内にある場合は、該当するコンテナまたはネットワーク名前空間からテストしてください。ホスト上で解決されるホスト名が、コンテナ内では解決されない場合があります。組み込みの CODE サーバーの場合、Nextcloud はユーザーがブラウザで使用するのと同じホスト名を使用して自身にアクセスできる必要があります。分割 DNS またはローカル名前解決によってそれが妨げられる場合は、localhostリモート サービスに対してホスト名を入力するのではなく、DNS またはホスト マッピングを修正してください。

3. リバースプロキシはWebSocketトラフィックを通過させますか？

検出URLが読み込まれるものの、エディタフレームが空白のまま、回転し続ける、または切断される場合は、Collaboraの前面にあるプロキシを確認してください。編集には永続的なWebSocket接続が使用されます。プロキシはCollaboraの現在の/cool/…/wsエンドポイントをCollaboraサービスにルーティングし、HTTP/1.1アップグレードヘッダーを渡す必要があります。ご使用のプロキシソフトウェアとバージョンに対応する最新のCollaboraプロキシの例を確認してください。古い設定をそのまま貼り付けないでください。

古いインストール環境では、 などのパスが引き続き使用されている場合があります。Collabora の移行ガイドでは、から、 からへの/lool変更について説明しています。古いルートにプロキシが残っていると、ベースドメインが開いていても 404 エラーが返されることがあります。プロキシ ファイルを編集した後は、そのサーバーのテスト コマンドで構文を検証し、ファイルを再読み込みしてから、検出 URL を再テストし、ドキュメントを開いてください。loolcoolloleafletbrowser

失敗した試行と同じタイムスタンプのアクセスログとエラーログを確認してください。404エラーは/browserパス/coolルーティングの問題を示唆します。WebSocketアップグレードの失敗は、アップグレード処理の不足またはタイムアウトを示唆します。502エラーは通常、プロキシがCollaboraのアップストリームに到達できないことを意味します。これらは手がかりであり、決定的な診断ではないため、Collabora自身のログと比較してください。

4. WOPIホストは許可されていますか？

WOPI（Web Application Open Platform Interface）は、NextcloudとCollaboraがドキュメントアクセス要求を交換するために使用するプロトコルです。Collaboraのログに「許容可能なWOPIホストが見つかりません」または「許可されていないWOPIホスト」と表示される場合は、Collaboraが自身のホスト名ではなく、Nextcloudのホスト名を信頼するように設定されていることを確認してください。Dockerイメージを使用して、コンテナの起動構成とログを調べます。

docker ps
 docker logs --tail=100 CONTAINER_NAME

Collaboraコンテナの実際の名前に置き換えてくださいCONTAINER_NAME。ネイティブパッケージのインストールの場合は、サービスログを確認してくださいsudo journalctl -u coolwsd --since "15 minutes ago"。インストール方法に応じてWOPIホスト構成の手順に従ってください。広範囲のワイルドカード許可ルールは避けてください。

Nextcloud Officeには、WOPI許可リストも別途用意されています。このリストでは、Nextcloudからファイルを要求できるCollaboraサーバーのIPアドレスを制限します。Nextcloudが実際にCollaboraに対して認識する送信元IPアドレスを追加してください。このIPアドレスは、Dockerネットワークやリバースプロキシが関係する場合に異なる場合があります。0.0.0.0エラーを非表示にするためだけにこの制限を追加したり無効にしたりしないでください。Nextcloudは、WOPIリクエストを想定されるCollaboraサーバーのアドレスに限定することを推奨しています。

修正を確認してください

ユーザーのブラウザと Nextcloud サーバーの両方から再テストしてください。検出エンドポイントと機能エンドポイントが応答し、Nextcloud が設定済みの Collabora URL に到達し、Collabora が Nextcloud のステータス エンドポイントに到達するはずです。次に、小さなテスト ドキュメントを開いてください。それでも失敗する場合は、タイムスタンプ、影響を受けたドキュメント アクション、プロキシ ログの HTTP または WebSocket ステータス、および対応する Nextcloud と Collabora のログ エントリを記録してください。この証拠は、ネットワーク パスの障害と WOPI 認証の問題を区別するのに役立ちます。

公式資料

• Nextcloud Officeのトラブルシューティングチェックと接続エラー
• Nextcloud OfficeのURLとWOPIの設定
• Collaboraエンドポイントパスの変更に関するNextcloudのガイダンス
• Collabora Onlineのリバースプロキシ設定