Linux版ONLYOFFICE Docsのトラブルシューティング
サポートに連絡する前に：診断情報の収集
以下で取り上げていない問題が発生した場合は、ONLYOFFICEサポートに連絡する前に次の情報を収集してください：
- ログディレクトリ：
/var/log/onlyoffice/documentserver/ - パッケージバージョン：
dpkg -l | grep onlyoffice（Debian/Ubuntu）またはrpm -qa | grep onlyoffice（CentOS） - OSバージョン：
cat /etc/os-release
コンパイルの問題
Q： コードをクローンしましたが、空のフォルダーしかなく、ソースコードがありません。
A： リポジトリにはサブモジュールが含まれています。次のコマンドを実行してリポジトリをクローンすることをお勧めします：
git clone --recursive https://github.com/ONLYOFFICE/DocumentServer.git
次のコマンドを使用してリポジトリをクローンした場合：
git clone https://github.com/ONLYOFFICE/DocumentServer.git
次の方法でサブモジュールを更新できます：
-
DocumentServerディレクトリに移動します：cd DocumentServer -
次のコマンドを実行します：
git submodule update --init --recursive
使用上の問題
Q： ONLYOFFICE Docsを停止したときにデータが失われました。データの損失を防ぐにはどうすればよいですか？
A： 動作上の特性により、ONLYOFFICE Docsは、ドキュメントを編集したすべてのユーザーがそのドキュメントを閉じた後にのみドキュメントを保存します。データの損失を防ぐため、アプリケーションの更新やサーバーの再起動などでONLYOFFICE Docsを停止する必要がある場合は、ONLYOFFICE Docsのユーザーを強制的に切断する必要があります。そのためには、ONLYOFFICE Docsがインストールされているサーバーで次のスクリプトを実行します：
sudo documentserver-prepare4shutdown.sh
スクリプトはすべてのユーザーが切断されるまで待機するため、実行に時間がかかる場合があります（最大5分）。
Q： カスタムインターフェーステーマを追加したり、エディターの言語ファイルを更新（一部の翻訳を修正）したりしましたが、サーバーには正しい値ではなく以前の値が表示されたままです。すべてのユーザーのキャッシュを同時にリセットするにはどうすればよいですか？
A： 次の手順に従ってキャッシュをリセットしてください：
/etc/nginx/includes/ds-docservice.confファイルと /etc/nginx/includes/ds-spellchecker.confファイルを見つけます。そこにはビルドの日付と時刻の値があるはずです。これらの値を別の値に変更し（どの値でも構いませんが、すべての箇所で同じである必要があります）、NGINXを再起動します：
sudo service nginx reload
これで、サーバーのすべてのユーザーのキャッシュがリセットされます。
Q： ONLYOFFICE Docsのサービスが起動しません。どうすればよいですか？
A： サービスの状態を確認し、エラー出力を確認してください：
sudo systemctl status ds-docservice
sudo systemctl status ds-converter
いずれかのサービスが停止している場合は、再起動してみてください：
sudo systemctl restart ds-docservice
よくある原因：
- メモリ不足（少なくとも4 GBのRAMを推奨します）。
- ポート80が別のアプリケーションですでに使用されている。
sudo ss -tlnp | grep :80で競合しているプロセスを特定して停止するか、別のポートを使用するようにONLYOFFICE Docsを再設定してください。 - より具体的なエラーメッセージについてはログを確認してください：
/var/log/onlyoffice/documentserver/
Q： ONLYOFFICE Docsを自分のプラットフォームと統合した後、JWT認証が失敗します。どうすれば解決できますか？
A： ONLYOFFICE Docsで設定したJWTシークレットが、プラットフォームのコネクター設定で設定したシークレットと完全に一致していることを確認してください。また、JWTヘッダー名が一致していることも確認してください（デフォルトは「Authorization」です）。現在のシークレットを確認するには、設定ファイルを直接読み取ります：
cat /etc/onlyoffice/documentserver/local.json
services.CoAuthoring.secret.session.stringの値を確認してください。よくある間違い：
- シークレット値の先頭または末尾にスペースがある。
- カスタムシークレットを設定せずに、デフォルトのランダムなシークレットを使用している。
Q： ドキュメントの変換に失敗します（例：DOC、XLS、PPTファイルを開くとエラーが表示される）。どうすればよいですか？
A： コンバーターのログでエラーを確認してください：
cat /var/log/onlyoffice/documentserver/converter/out.log
よくある原因として、ディスク容量の不足やフォントの欠落があります。
Q： ONLYOFFICE Docsが大量のメモリを使用しています。これは正常ですか？
A： メモリ使用量は、開いているドキュメントの数と同時ユーザー数に応じて増加します。アクティブユーザーが数十人のサーバーでは、2～4 GBのRAM使用量は正常です。メモリ使用量が予想外に多い場合は、/var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/に停止したドキュメントや忘れられたドキュメントがないか確認してください。
Enterprise EditionおよびDeveloper Editionの問題
Q：「License expired」（ライセンスの有効期限切れ）という警告が表示されます。どうすればよいですか？
A： license.licファイルの有効期限が切れています。ライセンスを更新するには、sales@onlyoffice.comまでご連絡ください。新しいファイルを受け取ったら、データディレクトリ内の古いlicense.licファイルを置き換え、ONLYOFFICE Docsを再起動してください。
Q： 管理パネルにアクセスできません。どうすればよいですか？
A： 管理パネルをまだ設定していない場合は、管理パネルの設定ガイドに従ってください。管理者パスワードを忘れた場合は、runtime.jsonからpasswordHashエントリを削除して再起動してください。新しいブートストラップコードが生成されます。