在 ONLYOFFICE 文件伺服器中新增字型：Docker 與 Linux

若要為 ONLYOFFICE 文件伺服器新增自訂字體，請將已授權的字型檔案放置在伺服器可存取的目錄中並執行命令/usr/bin/documentserver-generate-allfonts.sh。對於 Docker 部署，通常建議使用綁定掛載的字型目錄，而不是將檔案複製到正在執行的容器中，因為綁定掛載的字型目錄在容器重建後仍然存在。

正確的安裝方法取決於 ONLYOFFICE Docs 的運作位置、重建頻率，以及在刷新字型目錄時是否可以接受短暫的服務中斷。

選擇字型安裝方式

官方的 Docker 字體說明文件介紹如何複製文件並重建字體清單。 Docker 的綁定掛載參考文件解釋了為什麼掛載專用的主機資料夾可以讓檔案在容器替換後仍然可用。這些是不同的部署方式，而不是不同的字體格式。

準備字型檔案並確認目標伺服器

1. 確定目前活動的 ONLYOFFICE 部署

docker ps如果編輯器運行在容器中，請在 Docker 主機上執行。在NAMES對應列中尋找文件伺服器容器名稱；以下範例使用 `<container_name>` onlyoffice-documentserver。如果您的名稱不同，請替換該值。 Nextcloud 或 ownCloud 整合通常不會改變字型必須安裝在 ONLYOFFICE Docs 伺服器上的事實，而不僅僅是在儲存伺服器或檢視文件的電腦上。

docker ps

2. 收集授權字型文件

選擇完整且獲得正確授權的字體系列，包括文件實際使用的字重和樣式。 ONLYOFFICE在其Linux 字型文件.ttf中列出了 TrueType 和 OpenType 格式（例如.tf 和 .tf），以及其他支援的字型副檔名。為了確保首次部署的可預測性，請使用普通的 TTF 或 OTF 文件，並核實字體許可中允許的伺服器和用戶端使用方式。.otf

對於 Docker 範例，請將檔案暫存在/srv/onlyoffice/custom-fontsDocker 主機上。範例檔案名稱Inter-Regular.ttf僅供Inter-Bold.ttf參考；請使用您有權安裝的檔案。

sudo mkdir -p /srv/onlyoffice/custom-fonts
sudo cp Inter-Regular.ttf Inter-Bold.ttf /srv/onlyoffice/custom-fonts/
sudo chmod 644 /srv/onlyoffice/custom-fonts/*.ttf

請在包含字體檔案的目錄中執行這些命令。繼續操作前，請檢查資料夾內容。在受管系統中，請根據您的安全性原則調整所有權和權限，而不是將資料夾設定為所有人可寫入。

推薦用於 Docker：持久掛載字型目錄

3. 在現有的 Compose 服務中新增綁定掛載

在目前的 Compose 檔案中，找到執行 ONLYOFFICE 文件伺服器映像的服務。在其現有volumes清單中新增以下條目；保留已配置的其他磁碟區、連接埠、憑證和環境變數：

services:
  onlyoffice-documentserver:
    volumes:
      - /srv/onlyoffice/custom-fonts:/usr/share/fonts/truetype/custom:ro

來源路徑位於 Docker 主機上；目標路徑位於容器內部。:ro後綴限制容器對字體目錄的寫入。掛載專用custom目錄，而不是替換整個目錄/usr/share/fonts樹，因為替換整個目錄樹可能會隱藏鏡像提供的字體。官方ONLYOFFICE Dockerfile在其社群版和企業版映像階段都將自訂 TrueType 字型目錄宣告為一個磁碟區。

查看修改後的 Compose 配置，然後從專案目錄套用它docker compose up -d。這可能會重新建立服務：請安排在編輯人員可以安全關閉文件時進行變更。如果您使用普通部署，請在重新建立容器時docker run新增對應的唯讀參數。--mount type=bind,src=/srv/onlyoffice/custom-fonts,dst=/usr/share/fonts/truetype/custom,readonly

4. 確認容器可以辨識字型文件

服務執行後，檢查已掛載的目錄，如果可用，也應檢查 fontconfig 清單。 fontconfig 報告的字型系列名稱可能與檔案名稱不同。

docker exec onlyoffice-documentserver ls -l /usr/share/fonts/truetype/custom
docker exec onlyoffice-documentserver fc-list | grep -i 'Inter'

對於範例 Inter 字體，如果 fontconfig 偵測到符合的字體系列，則第二個命令應該列出該字體系列。如果檔案存在但字體系列未顯示，請檢查權限並執行命令docker exec onlyoffice-documentserver fc-cache -f，然後再次檢查fc-list。僅靠 fontconfig 的偵測功能無法填入 ONLYOFFICE 編輯器的選單。

5. 重新產生 ONLYOFFICE 字型目錄

利用容器內的文件，執行文件伺服器的字型產生腳本：

docker exec onlyoffice-documentserver /usr/bin/documentserver-generate-allfonts.sh

ONLYOFFICE 使用此步驟刷新其字型選擇資料和資源。此操作可能會影響正在執行的編輯器服務，因此請在適當的維護期間執行。文件中記錄的 Docker 環境變數GENERATE_FONTS也預設為true`--font-data-data-name`，即在容器啟動時重新產生字型資料；這在重新啟動後很有用，但不能取代將檔案安裝到持久位置。

請勿GENERATE_FONTS僅為了掩蓋卷缺失而進行更改或強制重啟。請先確認所需文件是否已實際掛載。

替代方案：臨時 Docker 映像或原生 Linux

6. 使用直接容器副本進行短期測試

如果無法立即變更 Compose，請將檔案複製到目前容器並重新建置目錄。這遵循 ONLYOFFICE 官方文件中記錄的 Docker 方法，避免了為了快速測試而重新建置容器：

docker cp ./Inter-Regular.ttf onlyoffice-documentserver:/usr/share/fonts/truetype/custom/
docker exec onlyoffice-documentserver /usr/bin/documentserver-generate-allfonts.sh

這種方法便於故障排除，但作為部署方案可靠性較低。鏡像更新或新容器可能會刪除已複製的檔案；重啟同一個容器並不等於重新建立。當後續工作需要使用該字體時，應將測試成功的鏡像提升到綁定掛載或單獨維護的自訂鏡像。

7. 直接安裝在非容器化的 Linux 文件伺服器上

對於原生 Linux 軟體包安裝，請將檔案放入伺服器的系統字型目錄，並在該主機上執行相同的重新產生腳本。此命令不能在普通使用者的桌面上運行。

sudo install -d -m 755 /usr/share/fonts/truetype/custom
sudo install -m 644 Inter-Regular.ttf /usr/share/fonts/truetype/custom/
sudo /usr/bin/documentserver-generate-allfonts.sh

這種方法會將字型檔案保留在 Linux 系統安裝目錄下，而不是 Docker 磁碟區中，但管理員在重建主機時必須將其儲存在設定管理或備份中。有關軟體包安裝伺服器的設定步驟，請參閱 ONLYOFFICE 官方 Linux 文件。如果您的編輯人員使用多個文件伺服器節點，請在每個節點上配置相同的字型系列及其變體。

8. 在實際文件中驗證字體

在連接到文件伺服器的應用程式中開啟一個新的編輯會話。在測試 DOCX 檔案中，從字體下拉清單中選擇已安裝的字體系列，輸入一行普通文本、一行粗體文本，如果該字體適用於多語言，則輸入一些代表性的非英文字元。儲存、關閉、重新開啟並匯出為 PDF 檔案。將文字寬度、換行、字形覆蓋率以及粗體/斜體變體與已知的參考文件進行比較。

如果下拉式選單中缺少某個字體，請fc-list依序檢查伺服器路徑、`npm run dev` 指令的輸出以及目錄產生指令。如果字體系列出現但佈局發生變化，請確認文件要求的字體系列是否正確，以及所需的字重是否存在；否則，編輯器可能會替換為其他字體。僅在使用者桌面安裝字型並不會將其新增至伺服器。

需要注意一點，這僅適用於特定版本的瀏覽器：ONLYOFFICE 的字體設定說明指出，在8.1.3 或更早版本中，需要清除瀏覽器快取並重新開啟編輯器。在更高版本中，則無需執行此額外步驟。如果您的安裝版本較舊，請先嘗試清除緩存，然後再排查更複雜的問題。

如果重新開啟編輯器後自訂字體系列仍然可選，已儲存的文件能夠正確渲染，並且（對於 Docker 而言）從相同配置重新建立服務後字體仍然存在，則表示修復已成功。如果上述任何一項檢查失敗，請檢查該圖層，而不是重複將字體複製到容器中。