以下流程以 Bitwarden 2024 之後的「Unified」映像檔(docker-compose)與傳統 bitwarden.sh
腳本都適用;請依自己環境挑選對應做法。
(以下指令均在 bwdata/
目錄或與之等效的 Compose 資料夾中執行)
1 │ 先確定「續約檔」已在手上
- 登入 Bitwarden 雲端後台 → Admin Console → Billing → Subscription。
- 點 Download license,系統會要求輸入 Installation ID。
- 下載得到最新的
license.json
(或license.lic
)檔案。(bitwarden.com)
續約後有 60 天寬限期 可以替換檔案,逾期付費功能才會停用。(bitwarden.com)
2 │ 找回(或重新申請)Installation ID / Key
找回現有 ID
伺服器上有舊安裝時,直接開啟
bwdata/env/global.override.env
即可看到 globalSettings__installation__id=
與 ...key=
兩行。(reddit.com)
若遺失/搬家需要新 ID
到官方表單填信箱就能重新申請一組新的 Installation ID / Key。(bitwarden.com)
一台伺服器建議只用一組 ID/Key;若改用新組,記得下一步一起更新。
3 │ 把新 License 套到自架伺服器
版本 | 操作介面 | 步驟 |
---|---|---|
Unified (docker-compose) | Web Admin (https://<你的域名>/admin ) |
1. 以站長帳號登入 2. Admin Console → Billing → Subscription 3. 在「License and billing management」選 Manual upload → 選檔上傳 license.json → Submit |
CLI | bash docker cp license.json bitwarden:/etc/bitwarden/license.lic docker compose restart bitwarden |
|
傳統腳本 (bitwarden.sh ) |
CLI | bash cp license.json bwdata/core/license.json ./bitwarden.sh apply # 或 ./bitwarden.sh restart |
同時更換 Installation ID / Key | CLI | 1. 編輯 bwdata/env/global.override.env ,更新兩行2. bash ./bitwarden.sh rebuild && ./bitwarden.sh restart |
執行
apply/restart
/Composerestart
後,系統會在 1-2 分鐘內重新載入授權。
4 │ 驗證續約是否成功
- 重新整理 Web Vault,進入 Admin Console → Billing → Subscription。
- 確認 Expiration Date 已更新到下一年;若仍顯示舊日期,可再點一次 Sync license 或重啟容器。(bitwarden.com)
5 │ 想少動手?啟用自動同步
在 global.override.env
加上
globalSettings__enableCloudCommunication=true
之後執行 rebuild
,再到 Admin Console 設定 Automatic sync,日後就不用手動上傳檔案,只要按一下 Sync license 即可。(bitwarden.com)
常見錯誤排除
情況 | 解法 |
---|---|
Version not supported | 先 ./bitwarden.sh updateself && ./bitwarden.sh update (或 docker pull + compose up -d )升級伺服器,再重新上傳 license。 |
Invalid Installation ID | 確認下載 license 時填的 ID 與 global.override.env 內一致;若改用新 ID/Key,記得同檔案一起修改。 |
上傳後功能仍鎖定 | 確認自己登入的是「組織」而非個人保險箱;企業版功能只在組織範疇生效。 |
照以上步驟即可完成 Bitwarden 自架版的續約與授權更新,確保企業功能不中斷。若仍有疑問,可回報具體日誌訊息協助診斷。祝更新順利!