Tasks.md 3.3.0 介绍与选型指南

自托管 Markdown 文件式看板 Tasks.md 的定位、架构、功能与同类选型量化对比，数据为 2026-10-25 在线溯源。

Tasks.mdTasks.md看板任务管理自托管2026/10/25

Tasks.md 3.3.0 介绍与选型指南

目标：全面介绍自托管 Markdown 文件式任务看板 Tasks.md 的定位、架构与功能，并与主流同类看板做量化选型对比。本文为联网溯源评估，未在本地实测部署；数据来源均已标注出处与查询日期（2026-10-25）。

一、环境信息

  • 溯源方式：GitHub 仓库页面、官方 README、Releases 页面、Docker Hub 标签接口、shields.io 星数徽章（均通过本地代理 192.168.1.62:7897 抓取）
  • 查询日期：2026-10-25
  • 官方仓库：https://github.com/BaldissaraMatheus/Tasks.md
  • 最新稳定版：3.3.0（GitHub Releases 标记 Latest，发布于 2026-03-08）
  • 官方镜像：baldissaramatheus/tasks.md（Docker Hub 标签 3.3.0 与 latest 同指 2026-03-08 构建）

⚠️ 注意：本文为选型评估篇，所有星数、版本号、功能描述均来自 2026-10-25 当日在线溯源，未做本地安装实测；实测部署与验证见本专栏后续安装/Compose/配置/API 各篇。

二、软件概述

Tasks.md 是由 Matheus Baldissara 开发的一款自托管（self-hosted）任务管理看板，核心特征一句话概括：看板上的每一条泳道（lane）是文件系统中的一个目录，每一张卡片（card）是该目录下的一个 Markdown 文件。它不依赖任何数据库，所有任务数据以纯文本 Markdown 文件落盘，元数据（标签颜色、排序、主题）以 JSON 文件存放。

  • 开源协议：MIT（LICENSE 文件，版权人 Matheus Baldissara，2023 年起）
  • GitHub Stars：约 2.2k（shields.io 徽章 github/stars/BaldissaraMatheus/Tasks.md，2026-10-25 查询）
  • 技术栈：前端 SolidJS + Vite（构建产物含 PWA 支持），后端 Node.js + Koa，文本编辑器使用 Stack Exchange 开源的 Stacks-Editor（作者 fork 版）
  • 部署形态：单一 Docker 镜像（Alpine 基础，内置 Node.js 18 运行时）；也可克隆源码以 npm start 分别启动前后端
  • 默认监听端口：8080

💡 技术拓展：看板类工具的前端框架不止 SolidJS。常见选项对比——

框架特点适用场景
SolidJS编译期优化、无虚拟 DOM、包体极小轻量交互应用
Vue 3生态完善、上手平缓中大型 SPA
React社区与生态最大通用企业应用
Svelte编译时框架、产物精简轻量工具

Tasks.md 选用 SolidJS，目标是以最小运行时开销换取现代响应式交互（来源：官方 README「Technology stack」一节，2026-10-25 查询）。

三、核心架构

依据官方 README 与 backend/server.js、entrypoint.sh 源码（2026-10-25 查询）：

  1. 文件系统即数据层：TASKS_DIR（容器内默认 /tasks）下每个一级目录 = 一条泳道；泳道目录下的 .md 文件 = 一张卡片；卡片正文即文件内容。
  2. 无数据库：标签颜色映射存 CONFIG_DIR/tags.json，卡片排序存 CONFIG_DIR/sort.json，上传图片存 CONFIG_DIR/images/，自定义样式存 CONFIG_DIR/stylesheets/custom.css。
  3. 前后端一体进程：启动时 entrypoint 将前端 vite build 产物移到后端 static/ 目录，Koa 通过 koa-static 同时提供静态页面与 /_api/* 接口，对外只需暴露一个端口。
  4. 子项目支持：TASKS_DIR 的子目录可作为独立项目访问（如访问 /backlog 路径即把该子目录当作独立看板），各子项目有独立的泳道、卡片与标签。

四、功能特性

以下特性均摘录自官方 README「Features」一节（2026-10-25 查询）：

  • 在现代化响应式界面中创建卡片、泳道与标签
  • 卡片以 Markdown 文件书写与存储
  • 单 Docker 镜像极简安装
  • 明/暗主题跟随操作系统设置自动切换
  • 内置 3 套配色主题（Adwaita、Nord、Catppuccin），可深度自定义
  • 支持基于子路径的反向代理（BASE_PATH 环境变量）
  • 可安装为 PWA（渐进式 Web 应用）
  • 多语言支持：按浏览器 locale 自动检测并按用户持久化
  • 本地图片自动清理：按 LOCAL_IMAGES_CLEANUP_INTERVAL（分钟，默认 1440）周期删除未被任何卡片引用的图片，置 0 关闭

五、快速开始（最小可用示例）

官方 README 给出的最小运行命令（原文摘录，未经本文实测，端口与路径请按实际环境调整）：

docker run -d \
  --name tasks.md \
  -e PUID=1000 \
  -e PGID=1000 \
  -p 8080:8080 \
  -v /path/to/tasks/:/tasks/ \
  -v /path/to/config/:/config/ \
  --restart unless-stopped \
  baldissaramatheus/tasks.md

⚠️ 注意：以上为官方示例原文，仅用于说明部署形态；完整的实测部署流程（含版本锁定、Compose、反向代理）见本专栏部署篇。

六、适用场景与限制

适用场景

  • 个人或小团队的轻量看板，尤其是已有 Obsidian / 纯文本工作流、希望任务文件可被任意编辑器直接读写的用户
  • 无数据库运维能力的 NAS、树莓派、边缘节点
  • 需要 Git 对任务数据做版本控制、离线可读写的场景
  • 需要按目录拆分多个独立看板（子项目）的场景

限制与不足

  • 无内置用户认证与多用户权限体系（截至 3.3.0，任何能访问端口的人即可读写全部任务），暴露公网必须自行加前置认证
  • 无高级看板能力：无 WIP 限制、无自动化规则、无甘特图、无统计报表
  • 无内置通知（邮件 / Webhook / IM 推送）
  • 文件系统存储不适合高并发写入与复杂查询
  • 作者自述为低维护（low maintenance）项目，功能范围刻意收窄，不适合期待快速迭代的团队（来源：README「Contribute」一节，2026-10-25 查询）

七、同类选型对比

星数为 2026-10-25 通过 shields.io 徽章实查；其余维度取自各项目官方仓库/README 当日页面。

项目Stars（2026-10-25）技术栈存储认证/多用户Markdown 文件即卡片部署复杂度许可证
Tasks.md约 2.2kSolidJS + Koa文件系统（无数据库）无✅ 是极简（单容器/单进程）MIT
Kanboard约 9.9kPHPSQLite/MySQL/PostgreSQL内置❌ 否低MIT
Wekan约 21kMeteor + Node.jsMongoDB内置❌ 否中MIT
Vikunja约 5.8kVue + GoMySQL/PostgreSQL/SQLite内置❌ 否中AGPL-3.0
Planka约 13kReact + Node.jsPostgreSQL内置❌ 否中AGPL-3.0
Focalboard约 27kReact + GoSQLite/PostgreSQL内置❌ 否低Apache-2.0
4ga Boards约 731Vue + Node.jsPostgreSQL内置❌ 否低MIT

版本节奏对比：Tasks.md 3.x 系列自 2025-08 起约每月 1–2 个补丁/次版本（3.0.x → 3.3.0 共 11 个 tag，来源：GitHub Releases 页面，2026-10-25 查询），属于个人维护者的稳健节奏；Wekan、Focalboard 等由更大社区/公司维护，迭代更密集。

选型建议

  • 要「Markdown 文件即数据、零数据库、可与 Obsidian 联动」→ 选 Tasks.md
  • 要多用户协作 + 权限 + 甘特图/报表 → 选 Focalboard 或 Planka
  • 要极简 PHP + SQLite、插件体系成熟 → 选 Kanboard
  • 要功能最全的大型看板 + 大量集成 → 选 Wekan

💡 技术拓展：自托管看板的持久化方案对比——

方案优点缺点
纯文件系统零依赖、Git 可管、任意编辑器可读写无事务、无权限粒度、高并发弱
SQLite轻量、免独立进程并发写受限、横向扩展难
PostgreSQL/MySQL事务完善、生态成熟需额外运维、资源占用高

Tasks.md 采用纯文件系统方案，用功能边界换取零依赖与极简运维。

八、参考链接