為 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 連線是否正常。

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

避免的常見錯誤

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

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

留下評論

使用 Redis 清除 Nextcloud 的檔案鎖定警告

啟用可靠的 Nextcloud 檔案鎖定,選擇適當的 Redis 或 Valkey 後端,並驗證警告是否清除,同時避免並發檔案變更的風險。

如何才能獲得 Nextcloud A+ 安全評級

如何才能獲得 Nextcloud A+ 安全評級

使用最新更新、HTTPS 和 HSTS、精確的反向代理信任以及針對公共伺服器的檢查,修復 Nextcloud 掃描中常見的錯誤。

啟用 Nextcloud 伺服器端加密,並評估其影響

為需要加密的儲存配置 Nextcloud SSE,保護加密金鑰,並在加密現有文件之前測量傳輸和 CPU 影響。

將 Elasticsearch 全文搜尋功能新增至 Nextcloud

將 Nextcloud 的檔案搜尋連接到 Elasticsearch,索引文件內容,並選擇適合您的伺服器和安全需求的設定。

為 Nextcloud 已刪除檔案設定可靠的過期策略

為 Nextcloud 已刪除檔案設定可靠的過期策略

配置 Nextcloud 在規定的保留期後刪除已刪除的文件,可靠地安排後台作業,並避免執行清除所有使用者回收站的命令。

清除 Nextcloud 缺少資料庫索引警告

清除 Nextcloud 缺少資料庫索引警告

安全地執行 Nextcloud 的 OCC 修復程序,預覽資料庫更改,並檢查警告仍然存在的原因。

將 Nextcloud 的 Web 上傳限制提高到 2 GB 以上

將 Nextcloud 的 Web 上傳限制提高到 2 GB 以上

透過調整 PHP、Nginx 或 Apache、暫存和逾時設置,讓 Nextcloud 瀏覽器上傳更大的文件,並驗證是哪個限制阻止了文件上傳。

清除 Nextcloud Web 伺服器上的 PHP 記憶體警告

設定 Nextcloud 實際使用的 PHP 記憶體限制,重新啟動對應的服務,並在管理概覽中確認 512 MB 設定。

將 S3 相容存儲桶連接到 Nextcloud 外部存儲

使用 Nextcloud 的 S3 後端,透過正確的端點、憑證、存取範圍和驗證步驟,掛載相容的物件儲存桶。

將 Nextcloud 資料遷移到外部磁碟機而不破壞存儲

將 Nextcloud 資料遷移到外部磁碟機而不破壞存儲

使用持久 UUID 掛載、維護模式、已驗證的副本和原始路徑符號鏈接,安全地將 Linux Nextcloud 資料目錄移至外部驅動器。