nerkeler/todo-app repository overview

⁠Personal Todo Vault

把待办、进度、提醒与 Markdown 上下文留在自己的设备上。

Personal Todo Vault 是一个轻量、可自托管的个人待办应用：数据保存在本地 SQLite 数据库和 Markdown 文件中，支持列表、日、月三种视图，任务预期完成时间、进度管理、邮件提醒和坚果云 WebDAV 备份/同步。

⁠核心能力

• 分类、优先级、进度与完成状态
• 创建任务时默认今天，也可以精确设置日期、小时和分钟
• 列表视图、日视图、月视图；月视图点击日期可进入对应日视图
• 每条待办关联独立 Markdown 笔记
• 移动端长按、桌面端右键打开操作菜单
• 单次、每周或指定次数邮件提醒
• 坚果云 WebDAV 增量备份与双向合并
• linux/amd64 与 linux/arm64 多架构镜像

⁠快速启动

docker run -d \\
  --name personal-todo-vault \\
  -p 8238:8238 \\
  -e TZ=Asia/Shanghai \\
  -v "$PWD/data:/data" \\
  -v "$PWD/config:/config" \\
  --restart unless-stopped \\
  nerkeler/todo-app:v1.0.1

打开 http://127.0.0.1:8238/⁠。

⁠数据持久化

• /data：SQLite 数据库、Markdown 笔记和本地备份
• /config：加密配置和本机配置密钥

镜像本身不包含任务、配置或备份数据。生产环境请务必挂载这两个目录，并不要把 8238 端口直接暴露到公网；应用目前没有登录、权限管理或多用户隔离。

⁠更新

docker pull nerkeler/todo-app:v1.0.1

追踪最新版本也可以使用 nerkeler/todo-app:latest。

⁠项目与文档

• GitHub：https://github.com/nerkeler/personal-todo-vault⁠
• 发布版本：https://github.com/nerkeler/personal-todo-vault/tree/v1.0.1⁠
• Docker Hub：https://hub.docker.com/r/nerkeler/todo-app⁠
• 许可证：MIT