
Docker一键部署Mindwtr自托管同步服务器Local-First用户自己的云端完整指南【免费下载链接】MindwtrGet tasks and ideas out of your head. A free GTD to-do app for desktop and mobile. Works offline, no account needed项目地址: https://gitcode.com/gh_mirrors/mi/MindwtrMindwtr 是一款免费、开源、支持离线使用的 GTD 待办事项应用覆盖桌面端和移动端无需注册账号即可使用。它的核心理念是Local-First本地优先你的任务数据始终保存在自己的设备上。如果你希望在多台设备间同步、又不想把数据交给第三方云最稳妥的方案就是用Docker 一键部署 Mindwtr 自托管同步服务器——几分钟内就能拥有只属于你自己的云端。什么是 Mindwtr 自托管同步服务器Mindwtr 官方内置了多种同步方式iCloud、WebDAV、Dropbox 等详见 docs/adr/0010-self-hosted-cloud-sync-server.md其中自托管云同步服务器mindwtr-cloud是一个极简的同步后端✅零账号体系用一个随机访问令牌Token代替注册登录✅数据完全私有任务快照和附件都存放在你自己服务器的硬盘上✅多令牌多用户不同 Token 对应相互隔离的数据集一家人可以共用一台服务器却互不可见✅资源占用极低官方 Compose 文件将容器限制在 1 核 CPU 512MB 内存一台树莓派或旧笔记本就绰绰有余✅同一套合并逻辑服务器直接复用 Mindwtr 核心apps/cloud/的同步合并规则行为与本地同步完全一致 设计取舍它刻意保持轻量是一个个人同步端点而不是多租户 SaaS 服务——这让它部署简单、易于备份。快速上手4 步一键部署本地 HTTP 版官方在 docker/README.md 中提供了开箱即用的 Compose 文件 docker/compose.yaml它会启动两个服务服务作用是否必需mindwtr-cloud同步服务器 REST API端口 8787✅ 桌面/手机客户端同步只需要它mindwtr-app浏览器 PWA 网页版端口 5173⭕ 可选想用浏览器访问才需要第 1 步获取部署文件只需克隆仓库无需编译源码镜像已公开发布git clone https://gitcode.com/gh_mirrors/mi/Mindwtr cd Mindwtr第 2 步配置访问令牌在仓库根目录创建.env文件Compose 会自动读取MINDWTR_CLOUD_AUTH_TOKENSreplace_with_a_token_at_least_20_characters_long MINDWTR_CLOUD_CORS_ORIGINhttp://localhost:5173两个配置项的含义MINDWTR_CLOUD_AUTH_TOKENS同步访问令牌长度 20–512 个字符是你自己的云端的唯一钥匙请妥善保管MINDWTR_CLOUD_CORS_ORIGIN浏览器 PWA 的精确访问地址含协议和端口只同步原生 App 时填本机地址即可快速生成一个强随机令牌cat /dev/urandom | LC_ALLC tr -dc a-zA-Z0-9 | fold -w 50 | head -n 1第 3 步一条命令启动docker compose pull docker compose up -d第 4 步验证服务状态# 进程是否存活 curl http://localhost:8787/health # 数据目录是否可读写镜像内置健康检查使用此接口 curl http://localhost:8787/ready看到正常响应你的 Mindwtr 自托管同步服务器就跑起来了 ⚠️ HTTP 版适合本地测试。客户端对 localhost、内网 IP 允许使用 HTTP但如果暴露到公网请务必使用下一节的 HTTPS 方案。生产推荐HTTPS 一键自动证书Caddy 方案正式让手机和电脑同步时推荐官方提供的 HTTPS 组合同步服务器 Caddy 反向代理Caddy 会自动申请并续期 Lets Encrypt 证书全程无需手动配置 SSL。# 1. 复制环境模板 cp docker/.env.https.example docker/.env.https.local编辑 docker/.env.https.example已复制为.env.https.localMINDWTR_CLOUD_DOMAINmindwtr.example.com MINDWTR_CLOUD_AUTH_TOKENS你的长随机令牌 MINDWTR_CLOUD_CORS_ORIGINhttps://mindwtr.example.com MINDWTR_CADDYFILECaddyfile.https只需确保MINDWTR_CLOUD_DOMAIN这条域名指向你的 Docker 主机然后docker compose --env-file docker/.env.https.local -f docker/compose.https.yaml up -d curl https://mindwtr.example.com/ready公网域名保持Caddyfile.https自动获取公网证书移动端兼容性最好仅局域网改用Caddyfile.local-https见 docker/Caddyfile.local-httpsCaddy 使用内置证书此时需要把导出的根证书安装到每台客户端设备上才可信任在 Mindwtr 中连接你自己的云端服务跑起来后客户端连接非常简单打开 Mindwtr桌面端或手机端→设置 → 同步 → Self-Hosted自托管填入基础地址例如http://你的主机IP:8787或https://mindwtr.example.com填入你在.env中配置的同一个令牌几个容易踩的坑填基础端点即可Mindwtr 会自动补上/v1/data多设备同步时同一组设备必须使用同一个令牌不同令牌的数据集相互隔离多人共用一台服务器逗号分隔配置多个令牌即可MINDWTR_CLOUD_AUTH_TOKENS令牌A,令牌B数据持久化与备份数据默认挂载到主机目录volumes: - ./data:/app/cloud_data所有data.json快照和附件都落在Mindwtr/data/目录下备份 定期打包这个目录简单直接。如果换成自定义主机路径请确保容器用户uid 1000可写sudo chown -R 1000:1000 /你的数据目录附赠REST API 让任务自动化更强大自托管服务器还对外暴露了与同步同一端口、同一令牌的 REST API基地址为http://localhost:8787/v1。比如一句话创建任务curl -X POST \ -H Authorization: Bearer 你的令牌 \ -H Content-Type: application/json \ -d {input:Review invoice /due:tomorrow #finance} \ http://localhost:8787/v1/tasks配合脚本、Home Assistant 或快捷指令就能把 Mindwtr 变成全屋的随手记入口 常见问题Q只想同步桌面和手机需要 PWA 吗不需要。mindwtr-app服务可以直接从 Compose 文件中删掉只保留mindwtr-cloud就是一个完整可用的同步方案。Q服务器挂在哪里最省心任何 7×24 在线的机器家用 NAS、树莓派、闲置笔记本或任意 VPS。Q令牌泄露了怎么办重新生成新令牌更新.env并重启容器即可旧令牌对应的数据仍在服务器上可定期清理data/目录回收。相关资源部署完整说明docker/README.md本地 HTTP 组合文件docker/compose.yamlHTTPS 组合文件docker/compose.https.yaml令牌文件挂载更安全docker/compose.secrets.yaml云同步服务端源码apps/cloud/架构决策记录docs/adr/0010-self-hosted-cloud-sync-server.md从git clone到docker compose up -d你只需要三条命令就能把 Mindwtr 的云端牢牢握在自己手里——离线可用、隐私自控这正是 Local-First 的终极意义。【免费下载链接】MindwtrGet tasks and ideas out of your head. A free GTD to-do app for desktop and mobile. Works offline, no account needed项目地址: https://gitcode.com/gh_mirrors/mi/Mindwtr创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考