LinuxからONLYOFFICE Document Serverを完全に削除する
ドキュメントサーバーがLinuxパッケージを使用しているかDockerを使用しているかを特定し、そのコンポーネントのみを削除し、共有サービスを誤って削除することなく残りのデータを確認します。
LinuxからONLYOFFICE Document Serverを完全に削除する
ONLYOFFICE Document Serverを完全に削除するには、まずDEB/RPMパッケージとしてインストールされたのか、Dockerコンテナとしてインストールされたのかを確認してください。アクティブな編集セッションを停止し、該当するパッケージまたはコンテナのみを削除してから、残りのデータ、ボリューム、イメージを個別に確認してください。アプリケーションを削除しても、すべての依存関係や永続ファイルが自動的に削除されるわけではありません。
削除コマンドを実行する前に、以下のチェックリストを確認してください。ONLYOFFICEの公式削除手順書には、このプロセスでドキュメントサーバーのデータが削除されると警告されています。サービスを復元する必要がある場合は、作業を進める前に、構成、データベース、ログ、およびマウントされたデータを保存してください。
1. 設備を特定し、稼働中の作業を保護する
ホストにはパッケージと Docker コンテナが同時に存在する可能性があるため、両方のインストールタイプを確認してください。Debian または Ubuntu では、パッケージ リストを で検査しますdpkg -l | grep onlyoffice-documentserver。Community パッケージの名前は ですonlyoffice-documentserver。Developer 版と Enterprise 版ではパッケージ名が異なります。purge コマンドをコピーする前に、インストールされているパッケージ名を確認してください。Docker ホストでは、 を使用してsudo docker ps -a停止中のコンテナと実行中のコンテナを確認し、Document Server イメージまたは認識できるコンテナ名を探してください。
シャットダウン前に、開いているドキュメントを保存して閉じるようにユーザーに伝えてください。ONLYOFFICE のドキュメントによると、アクティブなセッションが処理されている間、準備スクリプトの実行には最大 5 分かかる場合があります。パッケージをインストールするには、以下を実行してください。
documentserver-prepare4shutdown.shDockerの場合は、指定されたコンテナ内で同じスクリプトを実行してください。
sudo docker exec <container_name> documentserver-prepare4shutdown.shプレースホルダーを実際のコンテナ名またはIDに置き換えてください。スクリプトが利用できない場合は、開いている編集内容が保存されていると想定しないでください。サーバーを停止する前に、ユーザーがドキュメントを閉じてバックアップを作成するまで待ってください。
2. ネイティブLinuxパッケージを削除する
UbuntuまたはDebianの場合、ONLYOFFICEのガイドに記載されているCommunity Editionの削除コマンドは次のとおりです。
sudo apt purge onlyoffice-documentserverCentOS 上の Community Edition では、ONLYOFFICE ドキュメントは以下のとおりです。
sudo yum remove onlyoffice-documentserverエディションごとにパッケージ名が異なります。公式の開発者版ガイドでは を使用しonlyoffice-documentserver-de、エンタープライズ版ガイドでは を使用しますonlyoffice-documentserver-ee。インストールされているパッケージ一覧に表示されているパッケージ名を使用してください。すべてのバージョンを無条件に実行しないでください。特に、現在使用しているデータベースやその他のサービスを削除するよう提案された場合は、パッケージマネージャーの確認概要をよく読んでから承認してください。
ONLYOFFICEによると、パッケージを削除するとサーバーのバイナリと設定は削除されますが、依存関係はインストールされたままになります。パッケージマネージャーがONLYOFFICEディレクトリが空ではないと報告する場合は、まずそれらのディレクトリを確認してください。削除ガイドには/etc/onlyoffice、/var/www/onlyoffice手動で削除できるディレクトリとして、以下のものが挙げられています。
sudo rm -rvf /etc/onlyoffice /var/www/onlyofficeこのコマンドは元に戻せません。必要なカスタム設定、ログ、証明書、またはデータがこれらのパスに含まれていないことを確認してから実行してください。より限定的なクリーンアップを行うには、親ディレクトリではなく、検証済みのドキュメントサーバーのサブディレクトリのみを削除してください。
3. Dockerデプロイメントを削除する
まずsudo docker ps -a、特定の ONLYOFFICE コンテナを特定します。ホスト上のすべてのコンテナまたはイメージを削除するコマンドは使用しないでください。コンテナの名前が の場合はonlyoffice-ds、次のコマンドでそのコンテナを停止して削除します。
sudo docker stop onlyoffice-ds
sudo docker rm onlyoffice-ds実際のコンテナ名またはIDに置き換えてください。Composeデプロイメントの場合は、docker compose psまずComposeファイルを確認してください。ONLYOFFICEサービスは実際のサービス名で停止および削除できますが、Nextcloud、データベース、またはリバースプロキシも実行しているプロジェクトでは、それらを停止させないようにしてください。
コンテナを削除しても、ホストのバインドマウント ディレクトリや名前付きボリュームは自動的に削除されません。コンテナのマウントを検査するsudo docker inspect <container_name>か、volumesCompose ファイルのエントリを確認してください。必要なものはすべてバックアップしてから、検証済みの ONLYOFFICE データ パスまたは名前付きボリュームのみを削除してください。Docker Compose の はdown -vプロジェクト ボリュームを削除します。Compose プロジェクトと宣言されたすべてのボリュームがこのインストールにのみ属する場合にのみ使用してください。Docker のドキュメントには、外部ボリュームは Compose によって削除されないと記載されています。
コンテナを削除した後、他のコンテナが使用していない場合は、ONLYOFFICEイメージを削除できます。
sudo docker image ls
sudo docker image rm onlyoffice/documentserver特定のイメージタグを使用した場合は、そのリポジトリとタグを正確に使用してください。Dockerは、他のコンテナによって参照されているイメージを保持する可能性があるため、強制削除する前に確認する必要があります。
4. 余分なものを取り除いて確認する
公式の APT リポジトリからインストールし、ホスト上の他の ONLYOFFICE パッケージがそれを必要としていない場合は、リポジトリのエントリと署名キーを削除できます。インストール ガイドでは、/etc/apt/sources.list.d/onlyoffice.listとが識別されます/usr/share/keyrings/onlyoffice.gpg。削除する前に、それらの内容を確認し、ONLYOFFICE 専用であることを確認してください。Debian または Ubuntu では、sudo apt autoremove --purge不要になった依存関係を削除するオプションが提示される場合があります。提案されたパッケージ リストを注意深く確認し、他のサービスで使用されているソフトウェアが含まれている場合はキャンセルしてください。依存関係のクリーンアップはオプションであり、Document Server を停止するために必須ではありません。
パッケージマネージャーとDockerインベントリを使用して結果を確認してください。
dpkg -l | grep onlyoffice-documentserver
sudo docker ps -aインストール済みのパッケージやドキュメントサーバーコンテナに一致するものが残っていないことを確認してください。イメージとデータも削除した場合は、以前に特定した関連するイメージリスト、ボリュームリスト、およびホストパスを確認してください。パッケージクエリが空であることは、Dockerデータが削除されたことの証明とはみなさず、コンテナが見つからないことは、そのイメージとボリュームがなくなったことの証明とはみなさないでください。
上記の手順は、特に明記されているとおり、ONLYOFFICE Docs Community、Developer、およびEnterpriseエディションのインストールを対象としています。パッケージ名はエディションによって異なり、カスタムデプロイメントスクリプトによってパスが異なる場合があります。エディション固有の正確なコマンドについては、ONLYOFFICE Community Linux削除ガイド、Developer Edition削除ガイド、またはEnterprise Edition削除ガイドを参照してください。Dockerについては、ONLYOFFICE Docker削除ガイドおよびDocker Composeダウンリファレンスを参照してください。
ONLYOFFICEの共同編集の遅延を解消するために、ボトルネックを見つけましょう
共同編集の速度低下の原因を、Dockerリソースの負荷、プロキシ接続、またはドキュメントの読み込み状況から特定し、測定結果に合致する解決策を選択してください。
Docker 内の ONLYOFFICE Docs の HTTPS を設定する
TLSの終端場所を選択し、信頼できる証明書と秘密鍵を安全にマウントし、Dockerコンテナ化されたONLYOFFICE DocsサーバーへのHTTPSアクセスを検証します。
PHPアプリをONLYOFFICE Docsに接続して編集内容を保存する
ONLYOFFICEエディタをPHPアプリケーションに組み込み、JWTで設定に署名し、編集したファイルを安全なコールバック経由で保存します。
ONLYOFFICEのスペルチェックは、選択した言語のままにしておいてください。
文書全体または選択したテキストの校正言語を設定し、スペルチェックが有効になっていることを確認し、サーバー辞書が見つからない場合を特定します。
ドキュメントを再度開いたときに変更履歴を記録する
ONLYOFFICEドキュメント内で、すべてのユーザーに対して永続的な変更履歴の記録を有効にし、編集内容が記録されていることを確認し、この設定の制限事項を理解してください。
ONLYOFFICEのNginx 502エラーを解消するために上流を追跡する
Nginx、Dockerネットワーク、またはONLYOFFICE内部サービスのいずれかが502エラーを返しているかどうかを確認し、修正されたアップストリームとヘルスチェックを検証します。
ONLYOFFICEがNextcloudに保存しない場合の保存コールバックのトレース
ONLYOFFICEの保存失敗を診断するには、Nextcloudのコールバックルート、プロキシのリダイレクト、およびストレージログを確認し、編集されたファイルが保持されていることを確認します。
ONLYOFFICEドキュメントサーバーがVPSメモリ不足にならないようにする
ONLYOFFICEのメモリクラッシュの原因を特定し、Dockerの制限を確認し、VPSのRAMサイズを正しく設定し、スワップ領域を安全に追加し、ドキュメントが正しく開いて保存されることを確認します。
ONLYOFFICE PDFエクスポートの失敗の原因を特定する
ブラウザのダウンロードに関する問題とサーバー側の変換エラーを区別し、適切なログまたはアクセスチェックを使用して、PDFエクスポートが正常に機能するようにしてください。