如何在 Ubuntu 24.04 LTS 上設定 ONLYOFFICE 工作區

ONLYOFFICE Workspace 將線上文件編輯與更廣泛的協作入口網站結合。在 Ubuntu 24.04 LTS 上，最方便的伺服器設定是使用官方的 ONLYOFFICE Workspace Community 安裝腳本並配合 Docker。 Docker 將 Workspace 元件運行在隔離的容器中，這使得部署比手動建置的堆疊更容易重現和更新。

本指南使用社群版，並首先為首次使用 Workspace 的管理員提供一個實用建議：安裝 Workspace 時不包含選購的 ONLYOFFICE 郵件伺服器。這樣可以避免首次部署時對 DNS 和郵件投遞的要求。如有需要，您可以稍後從控制面板新增郵件伺服器。

截至 2026 年 10 月，Docker 正式支援 Ubuntu 24.04 LTS (Noble)。 ONLYOFFICE 目前的 Workspace Community 文件列出了至少需要一台配備 4 核心 CPU、8 GB 記憶體、40 GB 可用磁碟空間和 6 GB 交換空間的 amd64 Linux 主機。廠商建議使用更高的 CPU 和記憶體以獲得更流暢的部署體驗。在生產伺服器上部署之前，請務必查閱ONLYOFFICE Workspace Community 的最新 Docker 安裝指南和Docker 的 Ubuntu 安裝文件。

開始之前你需要準備什麼

您需要一台 Ubuntu 24.04 LTS 伺服器或虛擬機，一個具有相應權限的帳戶sudo，能夠存取互聯網下載軟體包和容器鏡像，以及足夠的可用資源來運行 Workspace 服務。如果您希望其他電腦可以存取該門戶，伺服器還需要一個穩定的區域網路位址或公網 IP 位址。

amd64指的是英特爾和 AMD 處理器常用的 64 位元 x86 伺服器架構。請勿假定 Docker 對其他架構的支援就表示 ONLYOFFICE Workspace 也支援該架構；目前 Workspace 的要求明確指出僅支援 amd64 Linux。

步驟 1：確認 Ubuntu 主機有足夠的資源

開啟終端或透過 SSH 連接到伺服器。運行：

uname -m
free -h
df -h

uname -m報告處理器架構。在相容的 x86-64 主機上，通常會看到x86_64。free -h顯示 RAM 和交換空間，而df -h顯示可用磁碟空間（以人類可讀的單位表示）。

避免在記憶體或儲存空間不足的伺服器上繼續操作。安裝可能完成，但之後在編輯或索引工作負載下會失敗，這種情況比先解決容量不足的問題更難診斷。

步驟 2：從 Docker 官方 Ubuntu 軟體倉庫安裝 Docker Engine。

Docker Engine 是建立和執行 Workspace 部署所用容器的服務。 Docker 目前的 Ubuntu 安裝指南支援 Ubuntu 24.04 LTS，並建議在常規伺服器上使用 Docker 自帶的 APT 軟體倉庫進行安裝。

首先安裝基本的儲存庫工具：

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings

新增 Docker 目前的簽署金鑰和程式碼倉庫：

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg   -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

然後安裝 Docker Engine 和 Compose 外掛程式：

sudo apt install -y docker-ce docker-ce-cli containerd.io   docker-buildx-plugin docker-compose-plugin

確認服務正在運作：

sudo systemctl status docker --no-pager

步驟 3：在引入 ONLYOFFICE 之前驗證 Docker

這個簡單的檢查可以將 Docker 問題與 Workspace 問題區分開來。運行：

sudo docker run --rm hello-world

Docker 會下載一個小型測試映像，啟動一個容器，列印確認訊息，然後退出。如果此步驟失敗，請先修復 Docker，而不是繼續執行 Workspace 腳本。

初學者常犯的錯誤是將權限錯誤誤認為dockerONLYOFFICE 錯誤。本指南特意使用 `docker-compose up` 指令sudo docker，因此您無需將帳戶新增至 Docker 使用者群組。 Docker 警告說，加入該使用者群組實際上會授予 root 權限，因此不要為了簡化命令而隨意添加使用者。

步驟 4：下載 ONLYOFFICE Workspace 官方安裝程序

ONLYOFFICE 在其下載網域上發布了安裝腳本。請直接下載：

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

在運行任何下載的管理腳本之前，最好先對其進行檢查：

less workspace-install.sh

按下q即可離開less。這並不能證明腳本是安全的，但它可以讓您有機會在授予腳本 root 權限之前驗證其來源並注意是否有意外命令。

步驟 5：先安裝 Workspace，不安裝郵件伺服器。

首次部署時，請執行官方腳本，同時跳過 ONLYOFFICE Mail：

sudo bash workspace-install.sh -ims false

此-ims false參數表示「不安裝郵件伺服器元件」。這樣，初始設定將重點放在工作區入口網站、文件編輯器和管理元件上。 ONLYOFFICE 文件中的郵件元件可以稍後從控制面板安裝。

如果您已經擁有配置正確的郵件服務網域，並且特別需要完整安裝，ONLYOFFICE 文件中提供了此表單：

sudo bash workspace-install.sh -md "mx1.example.com"

請將此處替換mx1.example.com為您真實的郵件服務主機名稱。主機名稱必須能夠解析到伺服器，且郵件網域需要正確的 DNS 記錄。切勿為了讓安裝程式繼續運作而使用虛構的主機名稱。錯誤的 DNS 設定是導致原本成功的 Workspace 部署變成郵件投遞問題的最簡單方法之一。

步驟 6：檢查容器是否實際運作

腳本運行完畢後，檢查正在執行的容器：

sudo docker ps

如果您的容器名稱與您在網路上看到的範例不同，請不要擔心。名稱和內部元件可能會在不同版本之間變更。有用的訊號是：預期的 ONLYOFFICE 容器已存在，並且其狀態為“正在運行”，而不是反覆重新啟動或退出。

如果容器不斷重啟，請檢查其真實名稱，docker ps -a然後運行：

sudo docker logs --tail 100 CONTAINER_NAME

請將其替換CONTAINER_NAME為 Docker 顯示的名稱。這比從教程中複製舊的容器名稱更安全。

步驟 7：使用伺服器的真實網路位址開啟入口網站

使用以下命令查找伺服器位址：

hostname -I

使用可以存取伺服器的瀏覽器，開啟：

http://SERVER_IP

ONLYOFFICE 的 Docker 指南特別建議在驗證入口網站時使用機器的網路 IP 位址，而不是其他localhost位址127.0.0.1。安裝後首次啟動可能需要幾分鐘時間，因此短暫的延遲並不一定意味著部署失敗。

步驟 8：完成管理員設定

首次運行頁面會提示您建立入口網站管理員帳戶。請設定強密碼、輸入有效的電子郵件地址、選擇正確的語言和時區，並接受授權條款。 ONLYOFFICE 指出，預設密碼長度為 8 到 120 個字元；您可以稍後加強安全設定。

完成初始精靈後，請確認您可以開啟「文件」模組並建立測試文件。成功登入即可證明入口網站可以存取；開啟並編輯文件還可以檢查文件編輯元件是否已正確連接。

邀請用戶之前，請確保安裝安全。

如果伺服器將在臨時實驗室以外的環境中使用，請將純 HTTP 升級到 HTTPS。 ONLYOFFICE 控制面板可以產生並套用 Let's Encrypt 證書，也可以接受現有的憑證和私鑰。對於內建的 Let's Encrypt 工作流程，在憑證授權期間必須保證 80 連接埠可存取。請參閱ONLYOFFICE 官方 HTTPS 配置指南。

此外，也要檢查您實際需要哪些網路連接埠。 ONLYOFFICE 發布了一份Workspace Community 連接埠參考表。不要僅僅因為資料庫連接埠或內部服務連接埠出現在該表中就將其暴露給 Internet。

Ubuntu 內建了主機防火牆 UFW，但需要注意一個與 Docker 相關的特殊問題：Docker 文件警告稱，已發布的容器連接埠可能會繞過 UFW 規則。這意味著「我在 UFW 中封鎖了它」並不足以證明 Docker 發布的連接埠無法存取。請仔細查看 Docker 的防火牆行為，對於面向網際網路的伺服器，應使用設計合理的主機或上游防火牆策略，而不是僅依靠 UFW 來控制所有容器連接埠。 Ubuntu 本身的防火牆參考文件可在Ubuntu Server 防火牆文件中找到。

常見問題及首先應檢查的內容

安裝程式提示所需連接埠已被佔用。

在停止隨機服務之前，請檢查監聽器：

sudo ss -ltnp | grep -E ':(80|443)\b'

如果 Apache、Nginx、其他容器或管理面板已經佔用了該端口，請決定哪個服務應該繼續使用該端口。切勿盲目地關閉生產環境中的 Web 伺服器。

安裝後入口網站無法載入。

首先檢查 Docker：

sudo systemctl is-active docker
sudo docker ps -a

如果 Docker 處於非活動狀態，請啟動它並查看其日誌。如果 Workspace 容器已啟動但頁面不可用，請確認您使用的是正確的伺服器 IP 位址，並且路由、雲端安全性群組和上游防火牆允許所需的 Web 流量。

安裝過程中伺服器記憶體不足。

請重新檢查free -h。基於工作區腳本的指南至少需要 6 GB 的交換空間，並將 8 GB 記憶體列為最低配置要求。當多個鏡像同時初始化時，容量非常小的虛擬機器可能會變得不穩定。遷移到更大的虛擬機器通常比嘗試針對記憶體不足調整每個服務要好得多。

稍後您只需要 ONLYOFFICE Mail。

您無需重新安裝 Workspace。 ONLYOFFICE 文件介紹如何從控制面板的「更新」頁面新增郵件伺服器。在此之前，請準備好實際的服務主機名稱及其 DNS 記錄。請參閱ONLYOFFICE 的指南，以了解如何將郵件新增至現有的 Workspace 安裝。

您喜歡使用 Docker Compose 而不是安裝腳本

如果您希望對部署定義擁有更多控制權，這是一種有效的替代方案。 ONLYOFFICE 目前的 Compose 指南要求 Ubuntu 22.04 及更高版本使用 Docker Compose 2.16.0 或更高版本，並指示管理員cgroup在 Workspace YAML 檔案中啟用相關行。 Ubuntu 24.04 也屬於「22.04 及更高版本」的範疇。請遵循ONLYOFFICE 官方 Docker Compose 指南，而不是從其他無關教學課程複製舊的 Compose 檔案。

如何確定設定真正完成

成功的部署應該具備幾個獨立的健康指標：Docker 處於活動狀態；工作區容器持續運作；入口網站可以透過伺服器的真實網路位址從另一台機器開啟；管理員可以登入；測試文件可以在瀏覽器編輯器中開啟。如果您打算將服務公開，HTTPS 也應該能夠正常運作，並且需要使用瀏覽器信任的憑證。

對於首次部署 Ubuntu 24.04 來說，在完成這些檢查後就停止操作，比立即添加郵件、自訂反向代理、第三方儲存和身份驗證整合要好得多。每次新增一個功能，進行驗證，並記錄 DNS、防火牆和容器的變更。這樣可以使後續的故障排除更加可預測。