ONLYOFFICEモバイルアプリのセルフホスト型サーバーへの接続タイムアウトを修正する

ONLYOFFICE Documentsでセルフホスト型サーバーのアドレスを入力し、「次へ」をタップすると、アプリが接続タイムアウトを報告するまで読み込みを続けます。同じアカウントがデスクトップブラウザでは正常に動作する場合があるため、アプリのバグのように見えるかもしれません。実際には、タイムアウトは通常、スマートフォンが入力したサービスURLに正確にアクセスできない、URLが間違ったONLYOFFICEコンポーネントを指している、またはネットワーク層がリクエストをブロックしていることを意味します。

まず、サーバーが実際に何を提供しているかを把握することから始めましょう。Documentsモバイルアプリは、DocSpaceやWorkspaceなどのONLYOFFICEポータル、またはNextcloud、ownCloud、その他のWebDAVサービスなどのサポートされているサードパーティ製クラウドに接続します。ONLYOFFICE Docs（ドキュメントサーバーとも呼ばれます）は、ストレージプラットフォームと連携する編集サービスであり、ユーザーポータルやWebDAVファイルアカウントとは必ずしも同じものではありません。ONLYOFFICEのAndroid Documents概要とiOS Documents概要では、サポートされているアカウントの種類について説明しています。

1. モバイルアプリが使用する住所を確認してください。

ドキュメントサーバーのURLをすべての接続フィールドに貼り付けないでください。ファイルがセルフホスト型のDocSpaceまたはWorkspaceポータルに保存されている場合は、そのポータルの公開アドレスを使用し、ポータルアカウントでサインインしてください。ファイルがNextcloudまたはownCloudにある場合は、アプリでそのサービスを選択し、ストレージサーバーのWebDAVアドレスとアカウント認証情報を入力してください。汎用WebDAVサービスの場合は、アプリで利用可能な「その他のWebDAV」オプションを選択してください。

NextcloudとownCloudの場合、URLにはドメイン以外のパスが含まれることがあります。古いチュートリアルからパスを推測するのではなく、クラウドアカウントの設定に表示されているWebDAVアドレスをコピーしてください。ONLYOFFICEのモバイル接続ガイドにはNextcloudの例が記載されており、プロトコルを含む完全なURLを貼り付けるようユーザーに指示しています。アプリのAndroid版の説明にも、WebDAVストレージへの接続URL、ログイン名、パスワードを入力するよう記載されています。最新の接続手順については、公式のNextcloud統合ガイドまたはownCloud統合ガイドを参照してください。

• ポータルアカウントには、エディターサービスのアドレスではなく、ポータルURLを使用してください。
• Nextcloud、ownCloud、またはその他のWebDAVアカウントの完全なWebDAV URLを使用してください。
• サーバーで設定されているとおりに含めてくださいhttps://。http://
• /webdavやなどの未検証の接尾辞を追加しないでください/remote.php/dav。サーバーに表示されている WebDAV URL をコピーしてください。

2. アプリ外で同じアドレスをテストする

スマートフォンで、モバイルブラウザにアドレスを開いてください。ポータルURLの場合は、サインインページが表示されるか、ポータルにリダイレクトされます。WebDAVエンドポイントの場合は、通常のWebサイトではなく、サインインプロンプト、認証応答、またはエラーメッセージが表示される場合があります。重要なのは、ブラウザが迅速に応答し、ホストが見つからない、またはアクセスできないといったエラーメッセージを表示しないことです。

Wi-Fi接続時とモバイルデータ通信時でそれぞれ1回ずつテストを繰り返してください。どちらか一方のネットワークでのみ動作する場合は、アプリ自体に問題がある可能性は低いでしょう。問題が発生しているネットワーク上のルーター、VPN、DNSフィルタリング、モバイルキャリアの制限、またはファイアウォールポリシーを確認してください。両方のネットワークで動作しない場合は、ホスト名がパブリックに解決されること、およびリバースプロキシまたはファイアウォールがサービスのHTTPSトラフィックを目的のバックエンドに転送していることを確認してください。

プライベートアドレス（例：）でのみアクセス可能なサーバーは、192.168.x.xVPNなどの安全なリモートアクセス設定で接続されていない限り、電話機がローカルネットワークから離れると通常は利用できません。アプリのテストのためだけに内部サービスをパブリックインターネットに公開しないでください。組織が承認したリモートアクセス方法を使用してください。

3. URL、リダイレクト、リバースプロキシを確認する

アプリ内のアドレスとブラウザで正しく動作するアドレスを、文字ごとに比較してください。サブディレクトリの欠落、古いホスト名、ポート番号の誤り、別のサービスからコピーされた末尾のパス、または端末が解決できない内部ホスト名へのリダイレクトがないか確認してください。サーバーがリバースプロキシの背後にある場合は、公開URLが正しいアプリケーションにルーティングされ、転送されたスキームとホスト情報がユーザーがアクセスするHTTPSアドレスと一致している必要があります。

ポータルまたはWebDAVサービスがサブパスで公開されている場合は、プロキシが必要なパスを保持し、リクエストをそのアプリケーションに転送していることを確認してください。リバースプロキシのウェルカムページを表示するルートURLは、Webサーバーが応答したことを証明するだけであり、アプリのポータルまたはWebDAVエンドポイントが正しくルーティングされていることを証明するものではありません。可能であれば、ドメインのホームページだけでなく、モバイルアプリにコピーした正確なURLをテストしてください。

アプリがタイムアウトを報告しているにもかかわらず、ブラウザがすぐにログインページに到達する場合は、新しい接続試行時にプロキシアクセスとエラーログを確認してください。502 または 504 応答は、アップストリームまたはプロキシのタイムアウトを示しています。404 は通常、パスまたはルーティングの不一致を示唆しています。401 または 403 は、エンドポイントが応答したが認証またはアクセスが拒否されたことを示します。これらのステータスコードは調査範囲を絞り込むのに役立ちますが、その意味は ONLYOFFICE の前にあるプロキシとクラウドソフトウェアによって異なる場合があります。

4. HTTPSと証明書チェーンを検証する

モバイルOSはサーバー証明書を検証します。有効期限切れの証明書、異なるホスト名に対して発行された証明書、中間証明書が欠落している証明書、またはデバイスが信頼していない認証局によって署名された証明書は、安全な接続を妨げる可能性があります。スマートフォンで正確なHTTPSアドレスを開き、ブラウザの証明書に関する警告を確認してください。また、デバイスの日付と時刻が正しいかどうかも確認してください。時計が正しくないと、有効な証明書が期限切れまたは未有効と表示されることがあります。

公開ホスト名用に発行された証明書を使用し、公開プロキシまたはサーバーに証明書チェーン全体をインストールしてください。ONLYOFFICEのドキュメントでは、ドキュメントサーバーのHTTPS構成について説明しています。証明書はクライアントが使用するURLと一致している必要があります。恒久的な解決策として証明書検証を無効にすることは避けてください。ONLYOFFICEは統合ドキュメントでこのオプションを安全でないと説明しており、証明書チェックを回避した後にのみ機能する接続であっても、正しい証明書構成が必要です。

5. アプリのサインインの問題とエディターの接続の問題を区別する

ユーザーがポータルに正常にサインインできたとしても、ドキュメントを開く際に問題が発生する場合があります。これらは別々の接続です。アプリはまずストレージまたはポータルにアクセスする必要があります。ファイルを開く際には、ドキュメントサーバーへの接続も必要となる場合があります。したがって、モバイルでのサインインが正常に機能したとしても、エディターサービスがストレージサーバーにアクセスできる、あるいはストレージサーバーがエディターにアクセスできるという証明にはなりません。

タイムアウトがファイルを開く後にのみ発生する場合は、管理者にサーバー側から統合テストを実施するよう依頼してください。ONLYOFFICEのNextcloudおよびownCloudガイドでは、制限付きネットワークの背後にあるインストールでは、ストレージサーバーからONLYOFFICE Docsへのリクエスト、およびONLYOFFICE Docsからストレージサービスへのリクエスト用に内部アドレスを設定する必要がある場合があると説明しています。サーバー間のトラフィックが依然として失敗している場合でも、公開アドレスはスマートフォンのブラウザで機能する可能性があります。

管理者の方は、両方のサービスが互いの設定済みホスト名を正しく解決していること、ファイアウォールルールで必要なトラフィックが許可されていること、およびJWTが有効になっている場合にコネクタがドキュメントサーバー用に設定されたものと同じJWTシークレットを使用していることを確認してください。推測でシークレットを変更したり、JWTを無効にしたりしないでください。まずは、クラウドプラットフォームの公式統合ガイドを使用して設定値を比較してください。

6. 認証情報とアプリの状態を再確認する

接続性と証明書を確認した後、同じポータルまたはストレージアカウントのWebインターフェースでユーザー名とパスワードを確認してください。WebDAVエンドポイントでは、サーバーの認証ポリシーに応じて、アカウントの実際の認証情報またはアプリパスワードが必要になる場合があります。多要素認証が有効になっている場合は、そのサーバーの指示に従ってください。通常のWebログインパスワードがすべてのWebDAV実装で受け入れられるとは限りません。

ONLYOFFICE Documentsを公式アプリストアからアップデートし、アプリを閉じてから再度開き、アカウントの追加をもう一度試してください。アカウントが以前に誤ったアドレスで保存されていた場合は、保存済みの接続を削除し、検証済みのURLで新しい接続を作成してください。この操作ではサーバー上のファイルは削除されません。モバイルアプリでクラウドアカウントの接続を解除すると、ローカル接続エントリが削除されるだけで、リモートストレージの内容は削除されません。アプリを再インストールしたり、データを消去したりする前に、同期されていないローカルドキュメントがすべて保存またはバックアップされていることを確認してください。

7. より単純な原因が除外された後にのみサーバーをチェックする

複数のデバイスやネットワークから正確な公開 URL にアクセスしようとしてタイムアウトが発生する場合は、サーバーまたはそのネットワーク パスに問題がある可能性が高いです。ポータル、ストレージ サービス、リバース プロキシ、およびドキュメント サーバーが実行されていることを確認してください。Docker インストールの場合、管理者は次のようなコマンドを使用してコンテナの状態と最近のログを調べることができます。

docker compose ps
docker compose logs --tail=100 <service-name>

デプロイメントの Compose ファイルに記載されている実際のサービス名を使用してください。サービス名はインストール環境によって異なります。繰り返しの再起動、DNS 障害、アップストリーム接続エラー、リソース枯渇、証明書更新の問題がないか確認してください。ログを取得する前にすべてのコンポーネントを再起動することは避けてください。再起動によって障害の有用な証拠が失われる可能性があるためです。

ドキュメントサーバーに関しては、公式ヘルプセンターに、/info/管理者がサービスが有効でアクセス可能な状態であることを確認するために使用できるページが記載されています。これはドキュメントサーバーの診断ツールであり、モバイルアプリに入力したポータルまたはWebDAVアドレスのテストの代わりとなるものではありません。ドキュメントサーバー情報ページについては、ONLYOFFICEの手順を参照してください。

スマートフォンから修正内容を確認してください。

以下の手順でチェックを実行してください。まず、スマートフォンのブラウザでポータルまたはWebDAVのURLを正確に開きます。次に、Wi-Fiとモバイルデータ通信の両方で同じ手順を繰り返します。その後、ONLYOFFICE Documentsに一致するサービスタイプのアカウントを追加し、サインインします。フォルダを参照し、小さなテスト文書を開きます。閲覧はできるが編集ができない場合は、サーバー側のONLYOFFICE Docs統合について調査してください。ブラウザとアプリの両方でタイムアウトが発生する場合は、パスワードを繰り返し変更するのではなく、DNS、ファイアウォール、プロキシ、およびサーバーのチェックを続行してください。

正常に動作すれば、作業予定のネットワーク上で安定したサインインとフォルダ一覧表示が可能になります。重要なドキュメントをセットアップする前に、重要度の低いファイルを開いて保存するテストを行ってください。問題が解決しない場合は、管理者に正確なURLタイプ（ポータル、WebDAV、またはドキュメントサーバー）、スマートフォンのオペレーティングシステム、使用しているネットワーク、タイムスタンプ、およびHTTPステータスまたはプロキシログエントリをお知らせください。サポートリクエストにパスワード、アクセストークン、またはドキュメントの内容を含めないでください。