自托管 Mindwtr Cloud
Mindwtr Cloud 是面向希望使用 Mindwtr 专用服务器、而非第三方服务同步的用户所提供的自托管同步选项。Mindwtr 的自托管云端后端是 apps/cloud 下的小型同步服务器；它是桌面端和移动端客户端的同步端点，不是 Mindwtr 应用界面。
何时使用
以下情况适合使用自托管云端：
- 你需要专用的 Mindwtr 同步端点
- 你能自行部署和更新一台小型服务器
- 你希望拥有托管账户、数据位置和访问控制
如果只需要基于文件的同步，WebDAV 可能更简单。
权威参考
- 选择同步后端和配置客户端，请参阅数据与同步。
- 设置服务器、执行运维和配置环境变量，请参阅云端部署。
- 了解
/v1端点详情，请参阅云端 API。 - 如需基于 Docker 的部署路径，请参阅 Docker 部署。
快速了解
- 自托管云端后端会为每个 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、环回/私有 IPv6 地址、*.local和*.home.arpa等本地或私有目标可使用 HTTP。
部署组成
典型部署包括：
- Mindwtr Cloud 服务器
- 持久化数据库或存储后端
- 位于服务器前端的 HTTPS
- 每个 Mindwtr 客户端中配置的服务器 URL
- 由你为自己的部署创建的令牌或凭据
设置清单
- 从主要设备导出备份。
- 按 Mindwtr 仓库中的最新说明部署服务器。
- 确认服务器健康检查端点可通过 HTTPS 响应。
- 使用服务器 URL 和凭据配置 Mindwtr。
- 执行手动同步，并确认第二台设备上出现相同数据。
日历订阅
自托管服务器可以发布一个只读的 iCalendar 订阅源，包含你已安排的任务和截止日期，任何日历应用都能订阅。
- 在 Mindwtr 桌面版中打开设置，进入同步，并选择自托管。
- 在“日历订阅”下选择 生成链接。
- 复制该链接，并在日历应用中添加为订阅日历。
订阅源展示的内容与日历视图一致：已安排的任务显示在其开始时间，截止日期显示为当天的全天事件；已完成、已归档、参考资料、已删除以及不在活动项目中的任务都不会出现。事件仅包含任务标题，描述、清单、附件、标签和项目信息永远不会发布。
任何拿到该链接的人都能读取订阅源
该链接是唯一的凭据，上面没有密码。请像对待私密链接一样分享它；选择 重新生成 可让旧链接失效，选择 撤销 可彻底下线该订阅源。
订阅源是只读的。在日历应用中编辑事件不会改变 Mindwtr 中的任务；它也不是 CalDAV——该订阅源是单向的。
不要把部署密钥提交到 git
请将服务器令牌、数据库 URL 和服务提供方凭据存放在托管平台或本地密钥管理器中，不要提交到代码仓库。
服务器使用局域网地址（家庭实验室、反向代理）
当服务器 URL 指向局域网地址时，Apple 设备会在首次连接时请求"本地网络"权限；请允许该提示，或稍后在隐私与安全性的本地网络中启用 Mindwtr。如果 Mac 应用从未弹出提示且无法连接服务器，请先更新应用：v1.1.5 之前的版本没有声明该权限，macOS 15 及更高版本会静默拒绝局域网地址。