你已準備好伺服器,卻不確定 Sure 的資料庫設定和持久化目錄是否正確。
最快做法:先對照 Sure 官方部署文件與目前版本的設定範例,再啟動服務、建立帳戶,逐項驗證讀寫、重啟留存及備份還原;未核實的鏡像與環境變數不要照搬舊教學。
適合準備在自有伺服器部署 Sure、管理個人或家庭財務資料的你。
如果你已使用 Docker,並希望自行管理資料庫、憑據及備份,本文可作為部署與驗收流程。
若你只需要一般記帳工具、並不打算維護伺服器,則不必為自託管增加維運工作。
開始前先核對 Sure 官方設定
開源個人財務管理系統能否穩定使用,不只看首頁能不能打開。還要確認目前版本的 Docker 部署入口、依賴服務、必填環境變數,以及應保留哪些資料。Sure 的部署方式可能隨版本調整,先查官方 Docker 部署說明、Compose 範例和環境變數範例,再開始設定。
不要把範例檔直接當成適用所有版本的標準答案。先確認文件所指的版本、鏡像與設定檔是否一致;如果部署文件要求的環境變數在你使用的版本範例中不存在,先停下來查明版本差異,不要自行猜一個值補上。
| 開始前檢查 | 怎樣才算可以繼續 | 未通過時的處理 |
|---|---|---|
| Docker 與 Compose | 伺服器可執行 Compose 指令,並能讀取官方提供的部署檔 | 先安裝或修正 Docker 環境;不要以未核實的替代部署方式猜測 |
| Sure 部署檔與版本 | 文件、Compose 範例及環境變數範例指向相符的版本 | 先固定版本,再按該版本文件設定 |
| 資料庫 | 已確認目前版本支援的資料庫類型、連線設定與所需依賴服務 | 不要套用其他版本或其他專案的資料庫設定 |
| 持久化 | 已辨認需要保留的資料卷、掛載路徑及資料庫資料 | 先規劃保存位置,再建立服務 |
| 網路與憑據 | 服務所需連線可用;密碼、金鑰有安全保存方式 | 不公開環境變數檔,不把真實憑據寫進公開版本控制 |
Sure Docker 部署要配置哪些資料庫參數?
先從官方設定範例確認該版本實際使用的變數名稱,再核對資料庫位址、連接埠、資料庫名稱、帳戶、密碼及可能要求的連線選項。這些是檢查連線時要辨識的欄位,不代表 Sure 每個版本都使用相同名稱或支援相同資料庫;以實際範例和部署文件為準。
第一步:準備部署檔與安全憑據
將官方部署說明所需的 Compose 設定及環境變數範例放在同一個工作目錄。若文件指定特定檔名或啟動方式,按文件執行;不要假設任何單一檔名或預設路徑適用所有版本。
編輯環境設定時,先確認範例中的每個必要欄位,再以自己的部署環境填入資料。以下內容只示範佔位形式,不能直接作為可用憑據:
<資料庫帳戶>=<你的資料庫帳戶>
<資料庫密碼>=<自行產生的強密碼>
<連線設定>=<依目前 Sure 文件填寫>
不要把實際密碼、工作階段金鑰或其他秘密提交到公開程式碼庫,也不要將含憑據的設定檔當成一般附件傳送。若需要多人維護,應限制設定檔的讀取權限,並記錄秘密存放位置與更換程序。
第二步:啟動 Sure 並查看服務狀態
設定完成後,先用 Compose 的設定檢查指令確認檔案可解析,再依官方文件指定的方式啟動。常見的 Compose 操作包括設定檢查、背景啟動、查看服務狀態及讀取日誌;指令用途可參閱Docker Compose 命令參考。
docker compose config
docker compose up -d
docker compose ps
docker compose logs --tail=100 <服務名稱>
上面是 Docker Compose 的通用操作範例,不代表 Sure 官方 Compose 檔一定使用相同服務名稱或檔名。若設定檔不在目前目錄,或官方文件要求指定檔案,請按文件調整指令。查看日誌時,先找啟動錯誤、資料庫連線失敗及缺少必要設定等線索;不要只憑容器顯示「執行中」就判定應用程式已可用。
Sure 怎樣用 Docker 安裝和啟動?
先按目前官方部署文件取得對應版本的 Compose 設定與環境變數範例,填妥必要欄位,再執行 Compose 設定檢查和啟動。接著確認相關服務狀態及啟動日誌,並從瀏覽器或部署文件指定的連線方式測試服務;若畫面無法使用,先查應用程式與資料庫日誌,不要急著改用未核實的鏡像。
第三步:驗證資料庫連線與資料持久化
Sure 的資料庫支援範圍、服務名稱、連線變數和資料存放方式都應以目前版本文件為準。不要因為別的自託管應用使用某種資料庫,就推定 Sure 也支援。下表是核對設定時的工作清單,不是對 Sure 預設值或資料庫支援項目的宣告。
| 核對項目 | 要確認的內容 | 驗證方式 |
|---|---|---|
| 資料庫類型 | 目前版本文件明確列出的支援類型 | 對照官方部署說明及所用版本範例 |
| 連線參數 | 主機、連接埠、資料庫名稱、使用者、密碼及其他必要選項 | 確認變數名稱與值都符合目前版本文件 |
| 服務依賴 | 應用程式與資料庫服務的啟動順序及連線方式 | 檢查 Compose 設定與兩邊日誌 |
| 資料保存 | 資料庫資料卷及應用程式要求保存的目錄 | 對照官方掛載設定,確認不是只寫入容器可丟棄的檔案系統 |
| 寫入測試 | 新增或修改一筆可辨認的測試資料 | 重新讀取資料,確認寫入成功後再測試重啟 |
Docker 說明,資料卷可用來在容器生命週期之外保存資料;因此,應確認官方 Compose 設定把需要保留的資料放在適當的卷或掛載位置,而不是只存在容器內。Docker 資料卷文件說明了資料卷的用途與管理方式。對 Sure 而言,究竟哪些路徑需要保留,仍要按其實際設定核對。
連線失敗時,先逐項對照主機名稱、連接埠、帳戶與密碼,再確認資料庫服務是否已啟動、應用程式是否能連到該服務,以及兩者是否使用一致的資料庫名稱。若日誌顯示缺少環境變數,回到官方範例查該變數是否為目前版本所需;不要直接改動資料庫設定來掩蓋其他啟動問題。遇到伺服器操作或連線方面的疑問,可參考支援中心的相關說明,並以 Sure 官方文件核對應用程式本身的設定。
第四步:建立帳戶並確認存取
Sure 部署後如何建立和管理帳戶?
首次建立帳戶時,按目前版本實際提供的初始化流程操作,再登出並重新登入,確認帳戶可正常使用。帳戶建立、登入或其他管理操作的入口,應以應用程式畫面和對應版本文件為準;沒有官方依據時,不要假設 Sure 具備特定角色、權限層級或管理介面。
選擇不重複使用的強密碼,並妥善保存登入資料。若畫面提供帳戶管理或存取控制功能,只按實際可見功能設定,並確認哪些使用者能讀取或修改財務資料。即使服務僅供自己使用,也要避免把管理憑據放在公開設定檔或與備份一同未加保護地保存。
第五步:備份資料,並在隔離環境測試還原
Sure 的 Docker 資料如何備份並恢復?
先列出官方設定中所有需要保存的部分:資料庫本身、應用程式資料目錄,以及文件明確指出的其他設定或秘密。Compose 設定中掛載的資料卷也要納入盤點;不要只備份環境變數檔,就以為財務記錄已經保全。
如果你核實所用版本與部署方式使用 PostgreSQL,可依PostgreSQL 官方 pg_dump 文件選擇適用的資料庫匯出方式。以下僅是參數佔位範例,服務名稱、帳戶及資料庫名稱須以你的 Compose 設定為準:
docker compose exec -T <資料庫服務> \
pg_dump -U <資料庫帳戶> <資料庫名稱> > sure-backup.sql
若實際使用的不是 PostgreSQL,不能照用這個命令,應查該資料庫的官方備份工具與 Sure 部署文件。資料庫匯出檔也未必涵蓋應用程式所需的全部資料卷,因此要另外依 Docker 的資料卷方式保存掛載資料。備份應存放在有存取控制的位置,並與正式伺服器分開保存;同時記錄備份時間、涵蓋範圍及所用部署版本。
還原測試應在隔離或測試環境進行,不要直接覆蓋正式資料。依資料庫官方工具還原資料庫,再按部署文件掛回需要的資料卷,啟動服務後登入帳戶,檢查帳戶資訊與幾筆可辨認的財務記錄是否能讀取。只看到備份檔存在,不代表備份可以使用;成功還原並讀到資料,才算完成驗證。
上線前用清單驗收
- [ ] Sure 的部署方式、鏡像與環境變數已按目前官方文件核對。
- [ ] Compose 設定可解析,相關容器狀態正常,啟動日誌沒有未處理錯誤。
- [ ] 服務可透過預期的連線方式開啟,首次帳戶可建立並重新登入。
- [ ] 資料庫連線正常,測試資料能寫入並重新讀取。
- [ ] 已確認資料庫資料及其他必要路徑使用持久化卷或掛載。
- [ ] 重啟相關服務後,帳戶與測試資料仍可讀取。
- [ ] 備份涵蓋已盤點的資料,並已在隔離環境完成還原讀取測試。
- [ ] 已記錄 Sure 版本、設定檔位置、必要憑據的保管方式及備份步驟。
如果容器啟動失敗,先檢查 Compose 設定是否符合該版本要求,再查看相關服務日誌;如果容器運作但服務不可用,核對連線方式和網路設定;如果重啟後資料消失,重新檢查實際掛載位置及資料卷,而不是只檢查備份檔。將每次確認過的設定與還原步驟記錄下來,日後更新版本或搬遷伺服器時,才有可重複執行的依據。
Sure 的自託管方案讓你直接管理部署與資料保存,但也要自行處理伺服器維護、憑據保護、資料庫故障和備份驗證;如果你沒有持續維運的時間,這些工作就是實際成本,不宜只按安裝是否成功來決定是否採用。先按上方清單確認服務、資料持久化與還原能力;若另有 macOS 開發、建置或遠端使用需求,可延伸了解雲端 Mac 的遠端使用場景,亦可參考遠端開發、建置環境準備及資料安全方面的相關指南。Kvmzen 僅是這類額外需求的延伸選項,並非 Sure 部署或財務資料備份的替代方案。
