自行託管 Mindwtr Cloud
Mindwtr Cloud 是為需要 Mindwtr 專用伺服器，而不採用服務供應商同步的使用者所設計的自行託管同步選項。Mindwtr 的自行託管雲端後端是位於 apps/cloud 的小型同步伺服器；它為桌面版與行動版用戶端提供同步端點，並不是 Mindwtr 的應用程式介面。
適用時機
符合以下情況時，可使用自行託管雲端：
- 需要專屬的 Mindwtr 同步端點
- 能自行部署及更新小型伺服器
- 想掌控託管帳號、資料位置與存取控制
若只需要檔案式同步，WebDAV 可能更簡單。
主要參考文件
快速認識
- 自行託管雲端後端會為每個 bearer token 儲存一個 JSON 命名空間。
- 用戶端指向
/v1基礎 URL，並透過GET /v1/data與PUT /v1/data同步。 /v1/data是標準同步合約；任務、專案、領域、分區、搜尋及附件路由則是選用的便利 API。- 附件 API 位於
/v1/attachments/...。 - 請在 HTTPS 後方部署，並把 bearer token 視同密碼保護。
- 公開 URL 必須使用 HTTPS。只有
localhost、127.0.0.1、10.x.x.x、172.16.x.x至172.31.x.x、192.168.x.x、loopback/private IPv6 位址、*.local與*.home.arpa等本機或私有目標可使用 HTTP。
部署組成
一般部署包含：
- Mindwtr Cloud 伺服器
- 持久化資料庫或儲存後端
- 位於伺服器前方的 HTTPS
- 在每個 Mindwtr 用戶端中設定的伺服器 URL
- 由你為自己的部署建立的 token 或憑證
設定檢查清單
- 從主要裝置匯出備份。
- 依 Mindwtr 儲存庫中的最新說明部署伺服器。
- 確認伺服器健康狀態端點可透過 HTTPS 回應。
- 使用伺服器 URL 與憑證設定 Mindwtr。
- 執行手動同步，並確認第二部裝置顯示相同資料。
行事曆訂閱
自架伺服器可以發布一個唯讀的 iCalendar 訂閱來源，包含你已排程的任務與截止日期，任何行事曆應用程式都能訂閱。
- 在 Mindwtr 桌面版開啟設定，進入同步，並選擇自架。
- 在「行事曆訂閱」下選擇 產生網址。
- 複製該網址，並在行事曆應用程式中加入為訂閱行事曆。
訂閱來源顯示的內容與行事曆檢視一致：已排程的任務顯示在其開始時間，截止日期顯示為當天的全天事件；已完成、已封存、參考資料、已刪除以及不在使用中專案的任務都不會出現。事件僅包含任務標題，描述、清單、附件、標籤與專案資訊永遠不會發布。
任何取得此網址的人都能讀取訂閱內容
此網址是唯一的憑證，上面沒有密碼。請像分享私密連結那樣分享它；選擇 重新產生 可讓舊網址失效，選擇 撤銷 可完全下線此訂閱來源。
訂閱來源是唯讀的。在行事曆應用程式中編輯事件不會改變 Mindwtr 中的任務；它也不是 CalDAV——此訂閱來源是單向的。
不要將部署密鑰提交至 git
伺服器 token、資料庫 URL 與服務供應商憑證應存放在託管平台或本機密鑰管理工具中，請勿提交至儲存庫。
伺服器使用區域網路位址（家庭實驗室、反向代理）
當伺服器 URL 指向區域網路位址時，Apple 裝置會在首次連線時請求「本機網路」權限；請允許該提示，或稍後在隱私權與安全性的本機網路中啟用 Mindwtr。如果 Mac 應用程式從未顯示提示且無法連上伺服器，請先更新應用程式：v1.1.5 之前的版本沒有聲明該權限，macOS 15 及更新版本會靜默拒絕區域網路位址。