為 Collabora 管理控制台設定安全密碼

根據伺服器部署方式設定 Collabora Online 管理控制台密碼：對於 CODE Docker 映像，配置其username環境password變數；對於 Linux 軟體包安裝，運行coolconfig set-admin-password。然後重新啟動或重新建立服務，並登入管理頁面以確認新憑證有效。

一個類似 Collabora 的管理員控制台登入表單，使用者名稱和密碼欄位為空，並帶有一個紅色的「登入」按鈕。 — 管理控制台使用自己的登入表單；其憑證與您的文件平台帳戶是分開的。

務必清楚你要更改的是哪個密碼。

管理控制台是 Collabora Online 的服務管理頁面。它獨立於 Nextcloud 或其他儲存平台的管理員帳戶，更改其密碼不會更改文件使用者登入資訊或平台用於連接 Collabora 的憑證。此外，基於 Docker 和軟體套件的安裝方式也使用不同的設定流程，因此在進行任何變更之前，請務必先確認您的部署環境。

對於 Docker 中的 CODE 映像，Collabora 文件中username提供password了容器環境設定。對於基於軟體包的安裝，Collabora 的設定工具可以互動式地設定管理員密碼。目前的配置參考文件指出，admin_console.password在大多數平台上直接使用該設定已被棄用，並建議改用 PAM 或coolconfig其他方式。請參閱Collabora 的 CODE Docker 映像文件和Collabora 的配置參考文件。

更改憑證前請做好準備

確認主機名稱、容器或服務名稱，以及 Collabora 是在 Docker 中運作還是作為 Linux 軟體包運作。如果您有多個實例，請記下哪個實例服務您的使用者。
選擇一個獨特的密碼，並將其儲存在密碼管理器或部署金鑰儲存庫中。切勿使用教學中的範例密碼。
如果您管理 Docker Compose，請備份或提交 Compose 文件，但不要提交任何金鑰。限制對包含密鑰檔案的存取權限；環境變數仍然對可以檢查容器的管理員可見。
將管理後台置於常規存取控制之後。強密碼固然重要，但它並不能取代限制管理頁面存取權限的做法。

為 CODE Docker 容器設定密碼

在 Collabora 的 Compose 服務中，設定文件中username提到的password變數。此範例從本機檔案讀取密碼，.env而不是將金鑰直接放入 Compose 檔案：

services:
  collabora:
    image: collabora/code
    environment:
      username: admin
      password: "${COLLABORA_ADMIN_PASSWORD:?Set it in .env}"

在同一個專案目錄中，將密鑰放在.env：

COLLABORA_ADMIN_PASSWORD=replace-with-your-unique-secret

請將範例值替換為您的真實密碼，並且不要提交.env到共用儲存庫。如果 Compose 服務已存在，則變更其在磁碟上的環境不會變更正在執行的容器的環境。請重新建立該服務以使新設定生效：

docker compose up -d --force-recreate collabora

如果不是，請使用您實際的 Compose 服務名稱collabora。這將重新啟動 Collabora 容器；不會刪除您的文檔，文件儲存在您連接的平台上。如果您的部署由 Kubernetes、Helm 或其他控制平台管理，請在這些平台上變更對應的金鑰或值，並套用該部署的正常發佈流程，而不是手動編輯正在執行的容器。

Docker Compose 編輯器顯示使用者名稱設定為 admin，密碼透過 COLLABORA_ADMIN_PASSWORD 變數提供。 — 對於 Compose 部署，請將憑證放在 Collabora 服務環境中，並將金鑰保存在共用 YAML 檔案之外。

設定 Linux 軟體包安裝密碼

在已將 Collabora 作為系統軟體包安裝的伺服器上，執行該伺服器上的設定工具：

sudo coolconfig set-admin-password

該工具會提示輸入新密碼，因此您無需將其包含在 shell 命令中。在提示符號處輸入密碼，如果再次提示，請重複輸入。然後重啟服務以載入更新後的配置：

sudo systemctl restart coolwsd

Nextcloud 目前的 Ubuntu 安裝範例也會在設定完成後coolconfig set-admin-password重新啟動coolwsd。其他發行版所使用的軟體套件和服務管理員可能有所不同；如果找不到所需的指令或服務名稱，請參考對應發行版的 Collabora 安裝說明。 Nextcloud 範例的詳細說明請參閱其 Ubuntu 24.04 安裝指南。

終端機執行 `sudo coolconfig set-admin-password` 指令，新密碼隱藏在提示字元處。 — 基於軟體包的工作流程會提示輸入新密碼，但不會將其放在命令本身中。

登入並查看結果

開啟 Collabora 主機的管理控制台，通常位於 `<example_host>` https://collabora.example.com/browser/dist/admin/admin.html，請將範例主機替換為您伺服器的公共 URL。使用配置的管理員使用者名稱和新密碼登入。登入成功僅表示控制台接受憑證；它本身並不能驗證文件編輯或 WOPI 連線是否正常。

如果 Docker 登入失敗，請確認您已編輯實際提供該 URL 的 Compose 項目，變數名稱是否完全是 `<your_url>`username或 `<your_url> password`，以及變更後是否已重新建立容器。
如果軟體包更新後登入失敗，請確認服務coolwsd已成功重啟，並且瀏覽器可以連接到目標伺服器。請檢查服務日誌中是否有設定錯誤，但請勿將金鑰複製到支援貼文中。
如果啟用了 PAM 身份驗證，則配置的使用者名稱admin_console.username和admin_console.password密碼將被忽略。請改用為主機配置的 PAM 帳戶和密碼；更改 CODE Docker 環境變數不會覆蓋 PAM 設定。
如果登入成功但管理頁面無法加載，請檢查反向代理的 Collabora 路由和存取策略。代理或網路問題與密碼被拒絕是不同的。

一個類似 Collabora 的管理員控制台登入表單，其中包含管理員使用者名稱和已封鎖的密碼。 — 重新啟動或重建容器後，在正確的 Collabora 主機上的管理控制台中測試新憑證。

避免的常見錯誤

請勿將管理控制台密碼與 Nextcloud 管理員密碼混淆，也不要將金鑰貼到任何命令中，以免docker run -e password=...shell 歷史記錄或進程檢查洩漏金鑰。對於 Compose 部署，請將金鑰保存在受保護的環境檔案或可用的金鑰管理員中，並將存取權限限制在 Docker 主機上。此外，請避免coolwsd.xml直接編輯金鑰：Collabora 已將舊式密碼設定標識為在大多數平台上已棄用。

如果在按照正確的步驟操作後仍然無法登錄，請先確認實例和驗證模式，然後驗證新配置是否已實際套用。這樣可以區分過期的容器或錯誤的主機與密碼輸入錯誤，並明確下一步的排查方向。