在 Ubuntu 24.04 上部署 ONLYOFFICE Workspace Community

對於簡單的 Ubuntu 24.04 部署，請使用 ONLYOFFICE 官方 Workspace Community 安裝程式並配合 Docker 使用。除非您擁有網域並計劃執行電子郵件服務，否則請忽略郵件元件。開始之前，請檢查伺服器資源和可用連接埠：ONLYOFFICE 建議此資源密集型配置至少需要 8 GB 記憶體、40 GB 可用磁碟空間和 4 核心 CPU。

是否應該使用社區安裝程式？

ONLYOFFICE Workspace 將文件編輯與協作工具結合。社群版是免費版本。其官方 Linux 安裝程式可以安裝文件、社群伺服器、控制面板和聊天工具；郵件伺服器可以單獨添加。此程序使用供應商基於 Docker 的腳本，運行在 amd64 Ubuntu 伺服器上。 ONLYOFFICE 目前的系統需求描述的是相容的 64 位元 Linux 發行版，而沒有明確提及 Ubuntu 24.04，因此請在實際部署前確認相容性並查閱供應商的最新文件。

請勿將此配置用於低於公佈最低配置要求的小型虛擬機器。 ONLYOFFICE 列出的最低配置要求為 4 個 CPU 核心、8 GB 記憶體和 40 GB 可用磁碟空間，建議配置為 6 個核心和 12 GB 記憶體。安裝程式會自動建立一個 6 GB 的交換檔案。請預留額外的磁碟空間用於上傳檔案、日誌、備份和未來擴充；40 GB 是列出的最低配置要求，並非針對繁忙團隊的容量建議。

首先該準備什麼？

一台全新或已妥善準備的 64 位元 Ubuntu 24.04 伺服器，並具有管理員權限。
伺服器上已安裝 Docker。安裝程式會檢查 Docker 是否存在，並可進行安裝或更新。
至少需要 4 個 CPU 核心、8 GB 記憶體和 40 GB 可用空間，以及安裝程式管理的交換空間。
透過網路下載安裝程式和容器鏡像。
您計劃安裝的元件需要佔用哪些未使用的連接埠？供應商提供的連接埠清單應指導防火牆規則的設定。

如果其他 Web 伺服器或應用程式已佔用所需端口，請在安裝前停止並規劃端口或反向代理方案。切勿盲目終止現有服務。對於公共伺服器，請在邀請使用者或將入口網站暴露於網際網路之前準備好網域名稱和 HTTPS 方案。

如何在不安裝郵件系統的情況下安裝 Workspace？

1. 下載官方安裝程序

透過 SSH 連接到 Ubuntu 伺服器，然後從 ONLYOFFICE 官方提供的下載位址下載腳本：

curl -O https://download.onlyoffice.com/install/workspace-install.sh

在執行特權安裝程式之前，請確認檔案已到達並檢查其開頭幾行：

ls -lh workspace-install.sh
less workspace-install.sh

按下此鍵q即可退出檢視器。此腳本及其參數均來自供應商的安裝指南；請在稍後重複此步驟之前，先查閱該指南以確認所有變更。

2. 執行社區版安裝程序

以管理員權限執行安裝程序，並選擇文件中說明的跳過郵件選項：

sudo bash workspace-install.sh -ims false

此-ims false參數指示安裝程式不要安裝 ONLYOFFICE Mail。腳本使用 Docker 安裝和設定 Workspace 元件，並可能在必要時安裝或更新 Docker。請按照腳本顯示的任何提示操作。安裝運行時請保持 SSH 會話打開，並避免中斷軟體包或容器的設定。

如果您確實需要使用郵件功能，請不要簡單地移除相關參數並認為郵件會自動生效。供應商提供的郵件功能說明要求您為電腦設定一個有效的域名，包括對應的 DNS 記錄。郵件功能也會增加一些您可能不需要用於文件協作的服務和網路連接埠。

如何開啟新的工作區？

安裝程式完成後，在可以存取伺服器的電腦上開啟瀏覽器，並輸入伺服器的區域網路 IP 位址，例如 `/etc/hosts/local/bin` http://192.168.1.20。請將此範例替換為實際地址。 ONLYOFFICE 特別建議在檢查安裝時使用電腦的網路 IP 位址，而不是 `/etc/hosts/local/bin` 或 `/etc/hosts/local/bin` localhost。127.0.0.1完成安裝程式首次運行螢幕的提示，並建立管理員帳戶；除非您所用版本的官方說明明確提供了預設密碼，否則請勿使用預設密碼。

對於遠端或面向網際網路的部署，請在正常使用前設定 DNS 名稱和 HTTPS。安裝程式的本機 IP 檢查僅確認服務在網路上回應，它本身並不會建立安全的公共存取。請依照您選擇的安裝類型的官方 HTTPS 流程進行操作，並僅允許所選工作區模組所需的連接埠。

如果安裝失敗怎麼辦？

所需端口已被佔用：請確定哪個服務佔用了該端口，並決定是重新配置該服務還是更改部署計劃。 ONLYOFFICE 建議驗證所需連接埠是否閒置；不要終止任何不熟悉的進程。
安裝程式無法下載映像：請確認 DNS、出站網路連線和 Docker 狀態。如果主機有意不連接互聯網，則供應商文件中提供了配置 Docker 以使用可存取的本機 DNS 解析器的方法。
瀏覽器無法存取入口網站：請檢查伺服器的區域網路位址、主機防火牆設定以及安裝是否已完成。在排查外部存取問題之前，請先從同一網路上的電腦進行測試。
伺服器運作緩慢或記憶體不足：請將其資源與供應商的最低和建議配置進行比較。可能需要增加記憶體或 CPU；重啟伺服器無法彌補主機配置不足的問題。