使用官方的 Compose 檔案部署 ONLYOFFICE Docs 企業版

對於單主機部署，請使用 ONLYOFFICE 官方的docker-compose.enterprise.ymlDocker-DocumentServer 倉庫中的 Docker 映像，並使用 Docker Compose v2 啟動它。在啟動堆疊之前，請取代範例憑證，為您的整合設定一個穩定的 JWT 金鑰，並掛載用於存放企業授權和持久資料的目錄。容器運作只是第一步：在連接生產平台之前，請確認 Compose 運作狀況並開啟文件歡迎頁面。

企業級 Compose 檔案以什麼開頭？

官方文件定義了文件伺服器企業版服務及其 PostgreSQL、RabbitMQ 和 Redis 依賴項。它發布了編輯器的 HTTP 和 HTTPS 端口，並包含對內部文件資訊端點的健康檢查。這些依賴項使得此 Compose 檔案適用於小型單主機安裝；它本身並不配置平台連接器、公共 DNS 或生產環境 TLS 憑證。

截至 2026 年 10 月 9 日核實，官方文件使用 PostgreSQL 15、RabbitMQ 3 和 Redis 7。儲存庫檔案可能會更改，因此在部署和升級之前，請查看目前的 Enterprise Compose 檔案。

1. 檢查主機並安裝 Docker Compose

ONLYOFFICE 的企業版 Docker 需求包括：amd64 Linux 主機（核心版本 3.10 或更高）、Docker 由其維護者提供支援、至少 4 GB 記憶體、40 GB 可用磁碟空間以及至少 4 GB 交換空間。其參考配置也會根據並發開啟的文件數量和文件類型而變化，因此請將這些資料作為參考，而非容量保證。工作負載較大的生產環境入口網站可能需要更多資源。

按照 Docker 官方指南，針對你的 Linux 發行版安裝 Docker Engine 和 Compose 外掛程式。在克隆倉庫之前，請確認這兩個指令都能正常運作：

docker --version
docker compose version

如果主機已有 Web 伺服器，請確認 80 和 443 連接埠可用，或規劃一個反向代理並設定不同的主機端連接埠對映。 Compose 檔案也會啟動資料庫、佇列和快取服務；這些服務應保留在 Compose 私人網路中，而不是發佈到公用連接埠。

2. 取得官方的 Compose 文件

克隆 ONLYOFFICE 的程式碼庫並進入其目錄：

git clone https://github.com/ONLYOFFICE/Docker-DocumentServer
cd Docker-DocumentServer

請檢查是否docker-compose.enterprise.yml存在。倉庫的 README 文件中提供了企業版的指令：

docker compose -f docker-compose.enterprise.yml up -d

Linux 終端機顯示了 Docker-DocumentServer 複製命令和 docker-compose.enterprise.yml 檔案名 — 儲存庫目錄包含安裝指令使用的 Enterprise Compose 檔案。

3. 設定憑證、JWT 和持久性授權位置

請勿在面向網際網路的主機上直接執行範例 Compose 配置。已發佈的設定檔包含範例資料庫憑證，並註解掉了明確 JWT 值。請將資料庫服務和文件伺服器DB_PWD設定中的 PostgreSQL 密碼替換為相同的強密碼。請確保資料庫、RabbitMQ 和 Redis 連接埠的私有。

若要進行集成，請在文件伺服器服務中設定穩定的 JWT 金鑰，並在平台的 ONLYOFFICE 連接器中設定相同的金鑰。一種簡單的方法是將該值保存在本機.env檔案中，不要提交到 Git，然後使用 Compose 變數替換。將以下項目新增至文件伺服器環境部分，並根據需要調整現有環境格式：

- JWT_ENABLED=true
- JWT_SECRET=${JWT_SECRET}

請輸入一個足夠長且唯一的值作為 `<value> .env` JWT_SECRET=...。不要將佔位符直接複製到實際配置中。 ONLYOFFICE 文件在 Docs 7.2 及更高版本中預設啟用 JWT，並自動產生密鑰；指定您自己的穩定值可以避免容器重建時出現密鑰不匹配的情況。請參閱JWT 配置指南。

若要使用已購買的 Docker Enterprise 服務註冊該服務license.lic，請將主機目錄綁定掛載至/var/www/onlyoffice/Data文件伺服器服務。例如，將其匿名資料掛載點替換為 `/usr/local/bin` ./documentserver-data:/var/www/onlyoffice/Data，建立該主機目錄，並license.lic在啟動前將許可證檔案放入其中。請保留檔案的權限，並將該目錄新增至您的備份計畫。企業版註冊說明確認，許可證文件必須位於 Docker 的掛載資料夾中。

Compose 編輯器顯示了 HTTP 和 HTTPS 連接埠、已掛載的資料目錄以及啟用了基於變數的金鑰的 JWT。 — 文件伺服器服務需要持久性資料掛載點來取得許可證，並且需要穩定的 JWT 金鑰來連接連接器。

4. 啟動企業堆疊

從倉庫目錄，靜默驗證 Compose 配置，這樣就不會列印展開的金鑰，然後啟動服務。靜默驗證會檢查 Compose 模型，但不會證明容器能夠啟動。 Docker 在其Compose 配置參考文件中對此選項進行了說明：

docker compose -f docker-compose.enterprise.yml config --quiet
docker compose -f docker-compose.enterprise.yml up -d

首次啟動可能需要更長時間，因為需要建置或下載映像以及初始化依賴項。如果配置驗證報告某個變數未設置，請檢查您的設定.env檔以及 Compose 檔案中的變數名稱。除非金鑰是預期值的一部分，否則請勿在金鑰周圍新增引號。

請編寫 YAML 文件，其中顯示 ONLYOFFICE 文件伺服器服務以及 PostgreSQL、RabbitMQ 和 Redis 依賴項。 — 企業級 Compose 定義將文件伺服器與其所需的資料庫、訊息代理程式和快取組合在一起。

5. 連接平台前，請先確認準備就緒

查看服務和健康狀況：

docker compose -f docker-compose.enterprise.yml ps

等待文件伺服器運行狀況檢查通過。官方的 Compose 文件會http://localhost:8000/info/info.json在容器內部進行檢查，啟動時間為 60 秒。如果服務仍然運作狀況不佳，請檢查其日誌和依賴項狀態：

docker compose -f docker-compose.enterprise.yml logs --tail=100 onlyoffice-documentserver

然後，在主機上打開http://localhost，或透過可以存取伺服器的瀏覽器開啟映射的 URL。 ONLYOFFICE 的 Compose 說明使用歡迎頁面作為初始安裝檢查。對於遠端生產環境，請透過 HTTPS 在您的網域上公開服務，而不是讓編輯器流量透過純 HTTP 傳輸。設定網路存取和 TLS 時，請參閱企業版 Docker 連接埠指南和Docker 安裝指南。

瀏覽器在本機上顯示 ONLYOFFICE Docs 歡迎頁面，旁邊是執行 docker compose ps 的終端。 — 歡迎頁面確認瀏覽器可以存取 Docs；使用 Compose 狀態和健康檢查來確認服務已準備就緒。

最後，配置平台的文檔伺服器 URL 和匹配的 JWT 密鑰，然後透過該整合開啟、編輯並儲存測試文檔。僅憑歡迎頁面無法證明連接器、反向代理、JWT 或回呼 URL 配置正確。如果服務運作正常但編輯器無法從平台打開，請檢查平台是否可以存取文件 URL，以及雙方是否使用相同的 JWT 金鑰和標頭。對於多主機或高可用性部署，請將此 Compose 堆疊作為起點，並參考 ONLYOFFICE 的部署指南，而不是假設單一 Compose 主機即可提供叢集功能。