ownCloud Webを開くと空白ページが表示される場合の確認事項

ownCloud Web を起動した際に白いページが表示される場合は、まずプライベートウィンドウで同じ URL にアクセスし、現在サポートされているブラウザで試してみてください。それでもアクセスできない場合は、ブラウザの開発者ツールを開き、コンソールパネルとネットワークパネルを確認してください。失敗したリクエストに基づいて、ブラウザのサイトデータをクリアするか、不足している Web アセットを修復するか、Infinite Scale およびリバースプロキシサービスを検査するかを判断してください。この確認を行う前に、サーバーデータの削除やインスタンスの再インストールは避けてください。

ownCloud WebはInfinite Scaleに同梱されているWebインターフェースですが、管理者はコンパイル済みのアセットをカスタムビルドに置き換えることができます。そのため、空白ページが表示される原因としては、ブラウザ、JavaScriptアセットの欠落または不一致、あるいはインターフェースの読み込みを妨げるサーバー/プロキシの応答などが考えられます。以下の手順では、これらのケースを分けて説明します。インターフェースパネルはあくまで例ですので、実際のブラウザおよびデプロイメントの出力と比較してください。

1. 問題がローカルなものか、サーバー全体に及ぶものかを調べます。

他のユーザーに同じ公開URLを開いてもらい、自分もプライベートウィンドウで試してみてください。例えば、ある従業員には空白ページが表示されるのに、別の従業員にはファイルが表示される場合は、ブラウザ固有の原因から調査を開始してください。全員が同じページが表示される場合は、ネットワークとサーバーのチェックに直接進んでください。

  1. ownCloud Webがサポートするデスクトップブラウザを使用してください。現在の要件ページには、サポートされているデスクトップオペレーティングシステム上で、最新のChrome、Firefox、Edge、およびSafari 16以降が記載されています。
  2. インスタンスをプライベートウィンドウで開きます。インターフェースが読み込まれたら、通常のプロファイルで拡張機能を1つずつ無効にし、ownCloudホスト名のみのサイトデータをクリアします。サイトデータをクリアするとログアウトされますが、サーバーに保存されているファイルは削除されません。
  3. 開発者ツールを開いた状態で、ブラウザのキャッシュを無効にして空白ページを更新してください。複数の対応ブラウザおよび複数のユーザーで同じエラーが発生する場合は、サーバー側またはデプロイメントの問題である可能性が高いです。

例のクラウドホスト名で完全に空白の白いページが表示されているブラウザウィンドウの例

症状の例:ブラウザはクラウドホストに到達したが、ページコンテンツ領域が空白のままになる。

2. 失敗したリクエストを使用して修正方法を選択する

開発者ツールを開きます(通常、Windows/LinuxではF12キーまたはCtrl+Shift+Iキー、macOSではOption+Command+Iキー)。コンソールを選択してJavaScriptエラーを表示し、ネットワークを選択してページを再読み込みし、失敗したリクエストを探します。ステータスコードとリクエストタイプは、白い画面だけが表示されるよりも役立ちます。

  • JavaScriptまたはCSSのリクエストで404エラーが返された場合:ブラウザが要求したアセットが指定されたURLに見つかりませんでした。この問題が特定のブラウザプロファイルでのみ発生する場合は、そのサイトのキャッシュファイルをクリアして再読み込みしてください。同じアセットがすべてのユーザーでエラーとなる場合は、アセットのパス、リバースプロキシのルーティング、およびカスタムWebサイトの構築内容を確認してください。
  • リクエストが502、503、または接続エラーを返す場合:プロキシがアップストリームサービスから使用可能な応答を取得できなかったか、サービスが利用できませんでした。ブラウザの設定を変更する前に、デプロイメントの状態とログを確認してください。
  • コンソールにブロックされたリクエスト、証明書エラー、または混合コンテンツの警告が表示された場合は、ブラウザで使用されている公開ホスト名とHTTPSスキームをURLおよびプロキシ設定と比較してください。ドメイン、TLS終端、またはプロキシルールを最近変更した場合は、まずその変更をテストしてください。
  • ページは200レスポンスでアセットを読み込みますが、JavaScriptが依然として失敗します。最初のコンソールエラーとownCloud Web/Infinite Scaleのバージョンを記録してください。構文エラーまたは実行時エラーは、互換性のないカスタムビルドまたは拡張機能を示している可能性があります。200レスポンスだけからそれを推測しないでください。

JavaScriptアセットに対する404レスポンスの例を示すブラウザ開発者ツールコンソールの例

診断例:JavaScriptアセットに対する404エラーは、アセットのURLと配信パスを確認するための手がかりであり、特定の原因を証明するものではありません。

3. Web資産とサービスの健全性を確認する

失敗したリクエストがアセットに関するものである場合、まずインスタンスがバンドルされているownCloud Webファイルを使用しているか、カスタムコンパイルされたファイルを使用しているかを確認してください。ownCloud 8.2管理者ガイドによるWEB_ASSET_PATHと、カスタムコンパイルされたWebクライアントアセットを指しています。この設定を行う場合は、実行中のデプロイメント内にパスが存在し、完全なビルドが含まれており、Webインターフェースを提供するプロセスから読み取り可能であることを確認してください。カスタムアセットを使用していない場合は、この変数を暫定的な解決策として追加しないでください。

Docker Compose でデプロイする場合は、Compose ファイルを含むディレクトリから以下のコマンドを実行してください。

docker compose ps
docker compose logs --tail=100 ocis

最初のコマンドはサービスが実行中かどうかを表示し、2 番目のコマンドは指定されたサービスの最近のログを表示しますocis。Compose ファイルで別のサービス名を使用している場合、またはフロントエンドを別々に実行している場合は、実際のサービス名に置き換えて、プロキシ/フロントエンドのログも確認してください。手動でインストールまたはオーケストレーションされたデプロイメントの場合は、そのプラットフォームのサービスとログのコマンドを使用してください。ページ読み込みに失敗した時点で、起動エラー、アセットパスのエラー、またはアップストリーム接続エラーを探してください。

サンプル出力なしでdocker compose psコマンドとdocker compose logsコマンドを表示するターミナル画面の例

Composeの2つのチェックの図解です。実際のサービス名とログメッセージは、デプロイメントによって異なります。

4. 公開URLとプロキシルートを確認する

リクエストが古いホスト名、間違ったスキーム、またはプロキシが提供していないパスを指している場合は、パブリック URL の設定とプロキシ ルールを確認してください。ownCloud のドキュメントOCIS_URLには、Infinite Scale へのアクセス方法を定義するために使用される URL が記載されています。リバース プロキシを使用するデプロイメントでは、ブラウザに公開されている HTTPS アドレス、DNS 名、およびルーティング ルールが、設定されているパブリック URL と一致していることを確認してください。プロキシまたはドメインが最近変更された場合は、現在の設定を最後に正常に動作していたバージョンと比較し、一致しない値のみを修正してください。

WEB_ASSET_PATHカスタムアセットが設定されているかどうかのみを確認してください。OCIS_URLブラウザが予期しないホストにリダイレクトされた場合、または誤ったオリジンからアセットを要求された場合は、プロキシ/TLS設定を確認してください。これらの設定はデプロイメントによって異なるため、一般的なサンプル値を本番環境に貼り付けないでください。これらの設定領域については、ownCloud Webの公式カスタムアセットガイド、プロキシサービスドキュメント、およびTLSガイドを参照してください。

デプロイメントチェックのためにWEB_ASSET_PATHとOCIS_URLを強調表示した構成エディタの例

確認すべき設定値の図解。正しい値は、公開URLとカスタムアセットの使用の有無によって異なります。

修正を確認してください

通常のブラウザウィンドウでサイトを再読み込みし、インターフェースが正しくレンダリングされ、コンソールにJavaScriptのエラーが表示されず、必要なJavaScript/CSSリクエストが404または5xxエラーを返さないことを確認してください。別のユーザーに同じ公開アドレスをテストしてもらいます。アセットが正常に読み込まれてもページが空白のままの場合は、最初のコンソールエラー、失敗したリクエストの詳細、Infinite Scaleのバージョン、および関連するサービスログを保存し、管理者またはownCloudサポートに提供してください。ブラウザのキャプチャを共有する前に、Cookie、認証ヘッダー、およびトークンを削除してください。

コメントを残す

適切なバックエンドを使用してownCloudのファイルロックタイムアウトを解消する

データベースロックの競合と期限切れのWebDAVロックを区別し、適切なownCloud 10の修正プログラムを選択して設定します。

ownCloud Webを開くと空白ページが表示される場合の確認事項

ownCloud Webを開くと空白ページが表示される場合の確認事項

ownCloudのWeb画面が空白になる原因を、ブラウザのキャッシュ、Webアセットの欠落、サービスエラー、またはリバースプロキシのURL設定など、特定のチェック項目に絞り込んで特定します。

ownCloud PHPメモリ警告を正しい実行時にクリアする

ownCloudのWeb PHPメモリ制限を設定し、該当するサービスを再起動し、CLI設定やアップロード制限と混同しないように注意しながら、有効な値を確認してください。

ownCloud 10のMySQL接続障害のトラブルシューティング

mySQL、PHP、ソケット設定、またはデータベース権限がownCloud 10の動作を妨げているかどうかを確認し、安全な修正方法を検証してください。

ownCloudの公開リンクに厳格な有効期限を設定する

ownCloudの公開リンクに厳格な有効期限を設定する

ownCloud Classicで公開リンクの有効期限を必須に設定し、最大有効期間を設定し、別途クリーンアップが必要な既存の共有フォルダを確認してください。

keycloakを使用してownCloud Infinite ScaleにTOTP二要素認証ログインを追加する

keycloakを使用してownCloud Infinite ScaleにTOTP二要素認証ログインを追加する

Keycloak経由でTOTPを有効にし、ユーザーを安全に登録し、Infinite ScaleのルートレベルのMFA設定が適用されるタイミングを理解します。

ownCloudの同期を復元するには、クライアントをサーバーに一致させてください。

問題がOC10と7.xの互換性の問題なのか、それともCSyncジャーナルの破損なのかを確認し、同期済みファイルを削除せずに適切な修正を適用してください。

ownCloudをLet's EncryptとNginxを使ってHTTPSで運用する

ownCloudをLet's EncryptとNginxを使ってHTTPSで運用する

HTTP-01またはDNS-01を選択し、ownCloudリバースプロキシを設定して、CertbotがHTTPS証明書を自動的に更新することを確認してください。

ownCloud Infinite ScaleをLDAPに接続してユーザーサインインを行う

展開前に、oCIS LDAPサインインを設定し、ユーザーとグループのルックアップを整合させ、TLSとスキーマの設定を確認してください。

ownCloud 10にS3バケットを外部ストレージとして接続する

ownCloud 10にS3バケットを外部ストレージとして接続する

ownCloud 10にAmazon S3バケットを追加し、互換性のある認証情報とエンドポイントを準備し、マウントとプライマリストレージを混同することなくアクセスを確認します。