如何從 Linux 系統中徹底卸載 ONLYOFFICE 文件伺服器

ONLYOFFICE 文件伺服器卸載失敗可能會導致服務文件、配置、資料目錄、Docker 磁碟區或套件管理器依賴套件殘留。安全徹底的卸載方法是：首先確定其安裝方式，然後讓 ONLYOFFICE 關閉所有活動會話，移除匹配的軟體包或容器，最後檢查持久性資料和共享服務，然後再刪除其他任何內容。

如果伺服器上仍包含您可能需要的文件、快取檔案、憑證或自訂配置，請先進行備份。卸載文件伺服器可能會中斷 Nextcloud、ownCloud 或其他連接到該伺服器的應用程式。此外，「移除 ONLYOFFICE」並不意味著「移除 PostgreSQL、Nginx、RabbitMQ、Redis 或共享字體」：這些服務可能用於其他軟體。

卸載前，請確定安裝類型

請先檢查軟體包資料庫和Snap：

dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
snap list | grep -i onlyoffice

這些命令是唯讀的；如果某個軟體包管理器傳回空結果，並不能證明該軟體不存在，因為它可能已透過其他方式安裝。對於 Docker，請列出容器和映像：

docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Names}}'
docker image ls | grep -i onlyoffice

如果 Linux 主機運行的是 Docker Compose，請先找到 Compose 專案及其磁碟區宣告。如果 ONLYOFFICE Docs 是透過 Helm 在 Kubernetes 上安裝的，請使用 Helm Chart 的卸載說明，而不是 Linux 軟體包命令。

如何解除安裝 DEB 或 RPM 安裝套件？

1. 儲存工作並乾淨俐落地斷開使用者連接

對於 ONLYOFFICE Linux 卸載指南中涵蓋的軟體包安裝，請在卸載軟體包之前執行其關機準備腳本：

sudo documentserver-prepare4shutdown.sh

該腳本會關閉所有活動會話，並確保文件已儲存。 ONLYOFFICE 表示此過程可能需要長達五分鐘。請在維護視窗期間安排此步驟，並事先通知已連線的使用者。如果找不到該指令，請確認已安裝的軟體包，並查閱相應版本的官方卸載頁面，而不是使用不相關的腳本。

2. 在 Ubuntu 或 Debian 系統上卸載該軟體包

社群版的官方軟體包名稱是onlyoffice-documentserver：

sudo apt purge onlyoffice-documentserver

軟體包名稱因版本而異。官方開發者版卸載指南使用[此處應填寫卸載指南名稱] onlyoffice-documentserver-de。請核對[此處應填寫卸載指南名稱]顯示的準確名稱dpkg -l，並按照相應的供應商說明進行操作；切勿憑猜測卸載名稱相似的軟體包。

APT 清除操作會移除軟體包二進位檔案和軟體包配置，但 ONLYOFFICE 指出，軟體包安裝的依賴項仍然保留。請在確認前仔細檢查 APT 的建議。避免apt autoremove自動運行：請先閱讀軟體包列表，並保留其他服務正在使用的軟體包。

3. 在 CentOS 或相容系統上移除 RPM 軟體包

社群版卸載頁面提供了適用於 CentOS 的以下指令：

sudo yum remove onlyoffice-documentserver

在使用 DNF 的系統中，請使用 RPM 報告的軟體包名稱，並在確認之前檢查建議的事務：

sudo dnf remove onlyoffice-documentserver

版本和軟體來源的差異可能會導致軟體包名稱不同。 ONLYOFFICE 的官方說明特別針對 CentOSyum指令進行了詳細說明；在移除企業版或開發者版之前，請先驗證適用於您發行版的等效軟體包名稱。

剩餘的文件和依賴項應該如何處理？

如果軟體包移除程式報告目錄不為空，ONLYOFFICE 會將某些目錄列為/etc/onlyoffice可/var/www/onlyoffice手動刪除的目錄。首先檢查這些目錄，並複製任何您想要保留的設定、憑證或檔案。然後，只有當伺服器即將停用且這些目錄不包含任何其他應用程式的資料時，才刪除這些確切的路徑：

sudo rm -rv /etc/onlyoffice /var/www/onlyoffice

請勿將此目標命令替換為通配符，例如rm -rf /var/*/onlyoffice*。檢查剩餘的服務和軟體包狀態：

systemctl list-units --type=service | grep -Ei 'onlyoffice|documentserver'
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice

軟體包管理器可能會保留 Nginx、PostgreSQL、RabbitMQ、Redis 和字體軟體包，因為它們是依賴項或先決條件。只有在確認它們未被其他應用程式使用後才能將其移除。在 Debian 或 Ubuntu 系統上，在考慮移除軟體包之前，請檢查其反向依賴關係；在基於 RPM 的系統上，請檢查依賴這些軟體包的服務和軟體包。如果 ONLYOFFICE 軟體倉庫是專門為此伺服器添加的，您可以在檢查設定檔後單獨移除其倉庫項目和簽署金鑰。請勿移除其他 ONLYOFFICE 產品使用的共享軟體倉庫或金鑰。

同時檢查您的反向代理和防火牆配置。在 Nginx 網站檔案中搜尋 ONLYOFFICE 主機名稱或代理目標，然後僅編輯專用於文件伺服器的伺服器區塊。保留無關的虛擬主機。 TLS 憑證是單獨管理的，其他網站可能仍然需要它們。

如何移除 Docker 安裝？

首先確定具體的 Compose 項目或容器。對於 Compose 安裝，請切換到包含相關 Compose 檔案的目錄並停止專案：

docker compose down

這將移除項目的容器和網絡，但通常會保留命名卷。這在您可能需要重新安裝或需要儲存資料時非常有用。如果您打算永久刪除，請在刪除任何內容之前檢查 Compose 檔案並列出磁碟區：

docker volume ls
docker inspect <container_name> --format '{{json .Mounts}}'

官方 ONLYOFFICE Docker 映像文件中記錄了持久化路徑，包括 `/ etc/docs/docs/` /var/log/onlyoffice、 `/etc/docs /var/www/onlyoffice/Data/` 和 `/ /var/lib/onlyofficeetc/docs/`；PostgreSQL 資料也可以單獨儲存。 Compose 配置可以將這些路徑對應到命名磁碟區或主機目錄。備份所有必要的憑證和資料。僅刪除您已明確識別為專屬於此文件伺服器部署的磁碟區和綁定掛載目錄。

審核通過後，Compose 專案可以使用以下命令刪除其已聲明的命名卷：

docker compose down --volumes

僅當您打算刪除該項目的持久性資料時才使用此方法。請勿docker volume prune以快捷方式運行；它可能會刪除無關的未使用卷。對於使用此方法啟動的容器docker run，請停止並移除該容器，然後單獨檢查其掛載點，並僅移除您選擇丟棄的資料路徑或磁碟區：

docker stop <container_name>
docker rm <container_name>

最後，只有當所有剩餘容器都不再需要 ONLYOFFICE 鏡像時才將其移除。請使用以下方式報告的確切鏡像和標籤docker image ls：

docker image rm onlyoffice/documentserver:<tag>

官方 Docker 倉庫會解釋映像的資料路徑和磁碟區使用情況。運行中的容器實際掛載點可能與預設值不同，因此請相信docker inspectCompose 檔案中的配置，而不是依賴假設。

如何解除安裝 Snap 軟體套件？

如果snap list顯示 ONLYOFFICE Docs snap，則表示官方 snap 儲存庫文件已移除：

sudo snap remove onlyoffice-ds

然後再檢查snap list。移除快照和刪除保留的快照或使用者資料是不同的操作；請檢查已儲存的快照，snap saved並僅移除您打算丟棄的 ONLYOFFICE 快照。請勿隨意刪除共享的快照資料或快照。

卸載後的最終檢查

• 確認您指定的軟體包、Snap 或容器已不再安裝或運作。
• 檢查舊的文檔伺服器 URL 是否不再從受信任的網路或主機本身回應。
• 確認所有已連接的應用程式都已指向已替換的文件伺服器，或者其連接器已停用。
• 檢查 Nginx、防火牆、DNS 和 TLS 設定中 ONLYOFFICE 特有的項目，僅刪除不再使用的項目。
• 檢查磁碟使用情況和軟體包管理器的剩餘相依性清單。如果其他服務需要，請保留共用資料庫、代理程式、訊息代理程式和字型。

如果軟體包移除失敗，請先閱讀完整的錯誤訊息並檢查軟體包狀態，然後再嘗試強制移除。維護腳本損壞或升級中斷可能需要針對特定作業系統和軟體包版本進行修復；未經診斷就強制移除可能會導致軟體包管理器狀態不一致。如果標準移除流程有效，則應優先使用該流程。

官方參考資料

• ONLYOFFICE Docs 社群版：刪除 Linux 安裝
• ONLYOFFICE Docs 開發版：刪除 Linux 安裝
• ONLYOFFICE 文件伺服器 Docker 映像和持久性資料路徑
• ONLYOFFICE Docs Snap 包及卸載說明
• ONLYOFFICE 文件中關於 Kubernetes 的內容：Helm 卸載