Jotty 1.29.2 介绍与选型指南
基于官方渠道溯源：Jotty 软件定位、功能全景、版本策略、部署形态与同类笔记/清单组件选型对比。
Jotty 1.29.2 介绍与选型指南
目标：为需要在 Linux 服务器上自建个人笔记与清单中心的读者，梳理 Jotty（jotty·page）的软件定位、功能全景、版本策略与同类组件的选型对比。本文信息全部来自上游官方渠道联网溯源（来源与查询日期在文中逐项标注），部署与配置实测见《Jotty 1.29.2 Docker Compose 部署指南》。
一、组件定位
Jotty（站名 jotty·page，仓库 fccview/jotty，曾用名 rwMarkable）是一款轻量级自托管笔记（notes）与清单（checklists）应用。官方一句话定位：
"A self-hosted app for your checklists and notes." —— 仓库 README（GitHub
fccview/jotty，查询日期 2026-10-30）
它的三个核心主张同样出自 README：
- 极简部署：单服务进程，无外部数据库依赖，数据落盘为纯 Markdown 与 JSON 文件；
- 数据自主：全部数据保留在用户自己的服务器上；
- 隐私可选：笔记支持 PGP 加密/解密（详见官方 howto/ENCRYPTION.md）。
需要注意的是，Jotty 并不是 Notion/Obsidian 的全功能替代品：它的设计目标是"个人清单 + 笔记"这一高频轻量场景，将简单场景做到极致（README 强调 "extremely easy to deploy"），而不是知识图谱级的重型工具。
二、项目背景与活跃度
- 上游仓库：GitHub
fccview/jotty（来源：仓库主页，查询日期 2026-10-30）。作者 fccview 单人主导，社区提供 Discord、Reddit（r/jotty）、Telegram 三个交流渠道（README"Join our communities"章节）。 - 历史沿革：README 明确标注 "ex rwMarkable"，即项目由 rwMarkable 演化更名而来，产品主线未断。
- 发布节奏：官方 releases.atom 显示 2026-10-25 一天内连续发布 1.29.1、1.29.2 两个稳定版（1.29.2 修复编辑器快速输入时光标跳动问题并合入两个新 API 端点；发布说明中作者提到安全补丁驱动的高频发布策略）。同页 1.29.0 说明中披露：官方 Docker 交付累计下载量已突破 100 万次（releases.atom，查询日期 2026-10-30）。
- 文档体系：仓库 howto/ 目录提供 15 份专题文档（API、SSO、MFA、LDAP、加密、分享、主题、翻译、模板、MCP 等），并由站内 How to 页面同步呈现，是同类轻量组件中文档密度相当高的一个（来源：仓库 howto/ 目录清单，查询日期 2026-10-30）。
三、功能全景
以下功能清单逐项对照仓库 README"Features"章节（查询日期 2026-10-30）：
| 功能域 | 能力说明 |
|---|---|
| 清单 | 拖拽排序、进度条、分类；既支持简单清单，也支持带 Kanban 看板与时间追踪的高级任务项目 |
| 笔记 | 基于 TipTap 的所见即所得编辑器，完整 Markdown 支持、语法高亮 |
| 分享 | 实例内多用户互享，也支持生成公开链接对外分享 |
| 存储 | 无数据库，全部数据为 data/ 目录下的 Markdown 与 JSON 文件 |
| 多用户 | 管理面板创建/管理账户，含会话追踪 |
| 外观 | 14 套内置主题，支持自定义主题、自定义 emoji 与图标 |
| 加密 | PGP 全量加密（公私钥成对存于 data/encryption/） |
| API | REST API 供程序化访问清单与笔记，带鉴权（x-api-key 头，密钥 ck_ 前缀） |
| PWA | 移动优先设计，可安装 PWA，支持部分离线缓存浏览（离线 CRUD 暂不支持） |
| 实时协作 | 1.29.0 起支持多人协同编辑同一笔记（release notes，2026-10-25） |
| 高可用 | 1.29.0 起支持多个实例共享同一文件系统（JOTTY_NODE 节点名区分索引） |
| MCP | 内置 MCP 服务（伴生发布物 ghcr.io/fccview/jotty-mcp），支持将看板任务指派给虚拟 agent，面向 AI 编排场景 |
| SSO | OIDC 单点登录（Authentik/Keycloak/Auth0 等），支持组/角色映射管理员、Docker Secrets 注入密钥 |
| MFA | 多因素认证（howto/MFA.md） |
| 国际化 | 多语言界面（i18n.ts + howto/TRANSLATIONS.md），默认 en |
其中三条能力在同类轻量组件里辨识度较高：Kanban + 时间追踪的任务项目、面向 AI 智能体编排的 MCP 看板（agent 指派、spec 笔记、依赖关系），以及多实例共享文件系统的水平扩展模式。
四、版本策略
Jotty 不采用严格 SemVer，而是 [STABLE].[FEATURE].[FIX] 三段式（README"Versioning Scheme"章节，查询日期 2026-10-30）：
1.x.x（Stable）：当前稳定代际，仅产品重写或根本性转向时变更；x.10.x（Feature）：主要版本号，新特性、重构或显著变更时递增；x.x.1（Fix）：仅热修复、纯 bug 修复或极小特性时递增。
作者特别说明：Feature 版本可能包含数据结构迁移，但迁移脚本在首次启动时自动执行，因此不视为 breaking change；官方仍强烈建议升级前备份 data/ 目录。
本批次基线版本：1.29.2（Stable，2026-10-25 发布；依据：releases.atom 最新 entry "Stable 1.29.2" 与仓库 package.json version: 1.29.2 双源一致，查询日期 2026-10-30）。
五、部署形态与运行要求
依据仓库 README 与 docker-compose.yml（查询日期 2026-10-30）：
- 官方主推形态：Docker Compose（README"Getting Started"明确 "My recommended way to run jotty·page is with Docker"）。官方交付物发布于 ghcr.io/fccview/jotty，标签
latest与具体版本号（如 1.29.2）并行维护。 - 辅助形态：Proxmox VE 社区脚本（community-scripts/ProxmoxVE 的 ct/jotty.sh）、Unraid 社区应用模板（howto/DOCKER.md#unraid）；亦可从源码或预构建 tarball 直接运行，要求 Node.js 24+。
- 持久化路径：
/app/data（笔记、清单、用户、分享、加密密钥）、/app/config、/app/.next/cache（可选）。 - 端口：服务内部监听 3000，由部署方映射任意宿主端口（官方示例 1122）。
- 运行身份：默认以
user: "1000:1000"运行，支持PUID/PGID/UMASK环境变量适配 NAS 场景。 - 伴生服务（可选）：MCP 网关 ghcr.io/fccview/jotty-mcp，HTTP 传输监听 3001，通过
JOTTY_MCP_AUTH_TOKEN鉴权（仓库 docker-compose.mcp.yml）。
资源占用方面，官方未给出最低配置承诺；从单进程 Node.js 24 运行时 + 文件存储的架构推断，属内存占用较低的轻量组件（此判断将在部署实测篇中以实测数据佐证）。
六、同类组件选型对比
对比数据来源为各项目官方仓库/官网 README 定性描述（查询日期 2026-10-30），仅收录可公开验证的特征：
| 维度 | Jotty 1.29.2 | Flatnotes | Joplin | Memos | Trilium Notes |
|---|---|---|---|---|---|
| 定位 | 笔记 + 清单 + Kanban 任务 | 纯 Markdown 笔记 | 全平台笔记/待办 | 轻量微博式短笔记 | 层级树知识库 |
| 存储形态 | Markdown/JSON 文件，无数据库 | Markdown 文件，无数据库 | 客户端数据库 + 同步服务 | SQLite 数据库 | SQLite 数据库 |
| 富文本编辑 | TipTap 所见即所得 + Markdown | 纯 Markdown | 富文本 + Markdown | Markdown 为主 | 富文本 + Markdown |
| 清单/任务 | 简单清单 + Kanban + 时间追踪 | 无原生清单 | 待办事项 | 无 | 无原生看板 |
| 多用户 | 管理面板 + 会话追踪 | 单用户取向 | 多设备单用户 | 多用户 | 单用户为主 |
| SSO | OIDC（组/角色映射管理员） | 无 | 无原生 | 部分支持 | 无 |
| REST API | 有（62 个端点，OpenAPI 3.1 文档随实例输出） | 有限 | 有（数据 API） | 有 | 无官方 REST |
| E2E/PGP 加密 | PGP 笔记加密 | 无 | 端到端加密同步 | 无 | 无 |
| PWA | 有（部分离线缓存） | 有 | 原生 App 为主 | 有 | 无 |
| 许可 | AGPL-3.0 | 以官方仓库为准 | MIT | 以官方仓库为准 | 以官方仓库为准 |
选型结论建议：
- 要"清单/任务 + 笔记"一体化、且看板与 AI 编排有加分：Jotty 是该组合位上少有的轻量选项——Flatnotes/Joplin 均无原生 Kanban。
- 要纯极简 Markdown 笔记墙：Flatnotes 更纯粹，但功能面窄；Jotty 功能更全但仍保持文件存储。
- 要多端原生客户端与端到端加密同步：Joplin 更成熟，代价是需要维护客户端生态与同步服务。
- 要时间线/碎片化记录：Memos 的信息流形态更合适。
- 要重知识管理（层级树、关系图谱）：Trilium 更强，但架构更重。
七、适用场景与边界
适合：个人或小团队的日常清单与笔记、家庭服务器（NAS 场景有 PUID/PGID 适配）、给 AI 编排工具提供任务看板后端（MCP + agent 指派）、需要把数据以纯文本形态纳入既有备份策略（data/ 目录整体备份即可）的场景。
边界（均为官方文档明示的当前限制，查询日期 2026-10-30）：
- 无离线 CRUD：PWA 离线仅支持浏览已访问页面（README"Features"PWA 条目）；
- 大规模协作编辑、细粒度权限矩阵不是设计目标，分享模型以"用户级/链接级"为主（howto/SHARING.md）；
- 单代稳定线（1.x），升级 Feature 版本前官方要求备份 data/ 目录（自动迁移不承诺无损）。
八、许可与合规
Jotty 采用 GNU AGPL-3.0 许可（仓库 LICENSE 文件，查询日期 2026-10-30）。对内部部署无额外义务；若对外提供网络服务且修改了源码，需按 AGPL-3.0 开放修改版本源码。商用/二次分发前请自行评估合规要求。
九、信息溯源清单
| 信息项 | 来源 | 查询日期 |
|---|---|---|
| 最新稳定版 1.29.2（2026-10-25） | GitHub releases.atom（fccview/jotty） | 2026-10-30 |
| 功能清单、存储结构、版本策略 | 仓库 README.md | 2026-10-30 |
| API 能力（x-api-key、ck_ 前缀、OpenAPI 3.1） | 仓库 howto/API.md | 2026-10-30 |
| 环境变量全集（NODE_ENV、PUID/PGID、SSO 组等） | 仓库 howto/ENV-VARIABLES.md | 2026-10-30 |
| Docker Compose 形态与官方发布物 | 仓库 docker-compose.yml、docker-compose.mcp.yml | 2026-10-30 |
| 许可 AGPL-3.0 | 仓库 LICENSE | 2026-10-30 |
| MCP 网关与 agent 编排 | 仓库 howto/MCP.md、docker-compose.mcp.yml | 2026-10-30 |
| 官网定位 "Self-hosted notes and checklists" | jotty.page 站点标题 | 2026-10-30 |
下一篇行动建议：若确定采用，直接按《Jotty 1.29.2 Docker Compose 部署指南》完成部署，随后通过《Jotty 1.29.2 配置参数详解》调优运行参数，并用《Jotty 1.29.2 REST API 实战指南》接入自动化。