[Github] tududi – 可自托管的开源任务与生活管理系统

tududi 是一款可自托管的开源任务与生活管理系统，把任务、项目、领域、笔记和标签放进一套层级结构中，并加入循环任务、Telegram 快速收集、CalDAV 同步、项目协作、开放 API 与 OIDC 登录。它适合希望掌控数据、又不满足于普通待办清单的个人和小团队。

快速结论

截至 2026 年 7 月 15 日核对时，GitHub 页面显示 3,103 Stars、218 Forks；最新正式版为 v1.2.4，主分支最近提交日期为 2026 年 7 月 14 日，项目处于持续迭代状态。

项目概览

tududi 的基本结构是“领域包含项目，项目包含任务和笔记”。任务和笔记都可以加标签，项目也能关联多个笔记与标签。这种层级比单层待办更适合长期维护工作、健康、家庭、学习等不同生活板块。

系统提供 Today、Upcoming、Someday 等任务视图，还支持优先级、截止日期、子任务和灵活排序。响应式界面可在桌面、平板和手机浏览器中使用，README 当前列出 24 种界面语言。

核心功能

任务层级

任务可以归入项目，项目再归入领域；复杂工作可拆分为子任务并查看进度。它适合把短期行动和长期责任放在同一系统中，但层级越多，越需要提前约定命名和归档方式。

循环任务

循环规则支持每日、每周、每月、指定星期和月末等模式，也能按完成日期生成下一次任务。系统保留父子关系，用户可以从生成的实例回到循环规则进行调整，适合账单、保养、复盘等重复事项。

外部同步

Telegram 集成可通过消息创建任务并接收每日摘要；CalDAV 支持与 Nextcloud、Baikal 等服务器双向同步，也可让 tasks.org、Apple Reminders、Thunderbird 和 Evolution 等客户端访问任务。实际体验取决于客户端对 RRULE 和任务字段的支持。

协作接口

项目可以分享给团队成员，系统还提供版本化 REST API、个人访问密钥和 Swagger 文档。OIDC 可接入 Google、Okta、Keycloak、Authentik、PocketID、Azure AD 等兼容提供商，适合已有统一身份系统的自托管环境。

安装方式

官方 Quick Start 使用 Docker 镜像 chrisvel/tududi:latest，需要设置管理员邮箱、密码和会话密钥，并把数据库与上传目录映射到持久化存储。默认端口为 3002，长期使用时还应配置域名、HTTPS、反向代理和允许来源。

部署在反向代理后时，需要正确设置可信代理参数，避免限流组件无法识别客户端地址。若启用 CalDAV，还要单独设置加密密钥；升级前应备份数据库、上传目录和环境变量，并阅读 Release 中的迁移说明。

使用边界

tududi 提供丰富功能，但“可自托管”同时意味着用户要负责服务器安全、账号策略、HTTPS、备份和更新。对只需要简单购物清单或单机待办的人来说，它的部署和配置成本可能高于收益。

CalDAV 与 Telegram 都会扩大数据流转范围：任务可能进入第三方客户端或消息平台。开启 OIDC、开放 API 或互联网访问时，应使用强密钥、最小权限、防火墙和可靠反向代理，不要直接照搬示例密码。

适合人群

• 想把任务、项目、笔记与长期生活领域统一管理的个人。
• 愿意维护 Docker、域名、备份和更新的自托管用户。
• 需要 CalDAV、Telegram 或开放 API 的进阶用户。
• 希望用项目分享和 OIDC 支持小规模协作的团队。

如果你只想快速记录几条待办，或不愿承担服务器维护，系统可能显得过重。企业在正式采用前，还应测试权限、审计、备份恢复和身份提供商兼容性。

常见问题

tududi 免费吗

自托管代码采用 MIT 许可证，可以免费部署和使用，但服务器、域名、备份、邮件和运维仍会产生费用。项目同时提供托管订阅，适合不想自己维护基础设施的用户。

Docker 必须吗

官方为普通用户提供的快速启动方式是 Docker，文档也包含源码开发流程。生产环境建议使用容器与持久化卷，便于隔离和升级；从源码运行更适合开发和调试，不一定更省维护。

支持手机吗

它提供响应式 Web 界面，可通过手机浏览器使用；同时可借助 CalDAV 客户端访问任务。它不是传统意义上的原生手机应用，离线能力、通知和系统集成体验取决于浏览器与所用客户端。

能同步日历吗

项目支持 CalDAV 双向同步和循环规则，可连接 Nextcloud、Baikal 等服务器，也能供部分桌面与移动客户端访问。不同客户端对任务字段、提醒和循环规则的实现存在差异，正式迁移前应先做小范围测试。

适合团队吗

tududi 支持项目分享、用户协作、OIDC 和 API，能覆盖小团队的基本需求。但大型组织通常还需要更细的权限、审计、合规、服务保障和恢复演练，不能只根据功能列表直接替换成熟协作平台。

总结建议

tududi 的优势是用清晰层级连接任务、项目、领域和笔记，再通过循环任务、Telegram 与 CalDAV 扩展收集和同步。个人用户可以先用 Docker 在局域网试运行，确认结构适合自己后再开放外网；团队则应先验证权限、备份和身份接入。

相关链接

• GitHub 仓库：chrisvel/tududi
• 官方网站：https://tududi.com
• 官方文档：https://docs.tududi.com
• 最新 Release：https://github.com/chrisvel/tududi/releases/latest