TimeMark 是面向个人与家庭的智能事件提醒系统，专注于管理生日、纪念日、节日等重要日期。内置 38+ 通知渠道，覆盖邮件、Telegram、飞书、钉钉、企业微信等国内外主流平台，通过多渠道通知确保您永远不会错过生命中的重要时刻。
支持完整的中国农历转换（含闰月自动处理）与公历/农历/双历三种日历模式，内置 18 种通知模板并支持自定义模板；配合智能关系映射、近期待办、Inbox 收件箱与 Webhook/ICS 日历集成，让传统节日与现代生活无缝衔接。
当前版本 v2.16.0，提供两种部署形态：面向 NAS / 服务器的 Docker 单容器版（SQLite 内置存储、零外部依赖、闲置内存约 256MB）与面向云端的 Vercel Serverless 版（PostgreSQL + Vercel Cron、零运维、Hobby 免费套餐可用）。两版同步 v2.7–v2.16 的双历/NTP 时区校准、Inbox、Integrations、待办完成历史、Passkey/Turnstile、零信任/SSRF 加固等能力。
同一套功能内核，按运行环境自由选择
| 对比项 | Docker 单容器版 | Vercel Serverless 版 |
|---|---|---|
| 部署平台 | Docker / NAS | Vercel Serverless |
| 数据库 | SQLite (sql.js 内置) | PostgreSQL (Vercel Postgres / Neon) |
| 定时任务 | Croner（进程内每分钟检查） | Vercel Cron + cron-job.org |
| 运维成本 | 需自备服务器 | 零运维，Hobby 免费套餐可用 |
| 密钥管理 | data/.env 首次启动自动生成 | Vercel Environment Variables |
| 通知渠道 | 38 个全部可用 | 30+ 云端可用 HTTP 渠道 |
| 静态资源 | 容器内置静态文件 | Vercel Edge Network (CDN) |
| 适合场景 | NAS / 家庭内网 / 数据完全自持 | 公网访问 / 免服务器 / 快速上线 |
TimeMark is a full-featured smart reminder system for birthdays, anniversaries and other important dates. It ships with 38+ notification channels (Email, Telegram, Discord, Slack, Feishu, WeCom, DingTalk, Ntfy, Pushover and more), 18 built-in message templates and full Chinese lunar calendar support.
It is available in two editions: a single-container Docker build (SQLite, zero external dependencies, ~256MB RAM, runs on any NAS) and a Vercel Serverless build (PostgreSQL + Vercel Cron, zero ops, free Hobby tier). Security highlights include AES-256-GCM encrypted credential storage, zero-trust gateway, SSRF protection, WebAuthn Passkey and Turnstile.
家人、朋友、同事的生日
结婚/恋爱/创业纪念日
传统节日和特殊日期
考试、面试等重要日期
工作会议、商务会议
项目截止、任务到期
出行计划、航班提醒
毕业典礼、学位授予
婚礼、订婚仪式
体检、复诊、用药提醒
驾照到期、保险续费
标准公历日期
精准农历转换，含闰月自动处理
同时显示公历 + 农历对应日期
为重要时刻，提供全方位的提醒保障
覆盖 Email/Telegram/Discord/Slack/微信/钉钉等主流平台，一键配置多渠道推送
完整农历公历双向转换，含闰月自动处理，传统节日与纪念日精准提醒
称呼智能适配，自动识别亲属关系，个性化问候语自动生成
AES-256加密凭证存储，登录锁定+告警，保障数据安全
完整记录每次提醒的触发时间、渠道、结果，便于追溯与调试
零配置启动，开箱即用，内存仅约256MB，一条命令即可完成部署
18种预设+自定义模板，按事件类型分组，创建事件时实时预览；批量邮件模板 · 变量 {{contact_name}}
支持每天/每周/每月/每年重复，自动创建下次事件，ICS日历一键导出
事件支持添加多个收件人邮箱，调度器每分钟检查，定时邮件精准发送
登录锁定自动通知管理员，异常行为实时告警，安全事件不遗漏
渠道可达性自动检测，提前发现网络问题，确保通知畅通无阻
主渠道发送失败时自动切换备用渠道，确保重要通知必达
只有已配置的渠道可选，避免误选无效渠道，配置更清晰
通知全链路收件箱 · 邮件记录与重试队列 · 一键重试失败通知
Webhook / 外部日历订阅 · SSRF 防护拉取 · ICS 导入导出联动
提醒窗口待办打勾完成 · 完成历史归档 · 365天自动清理
公历/农历/双历精准转换 · 闰月修复 · NTP按用户时区校准
WebAuthn Passkey + Turnstile 人机验证 · 单用户模式 · 登录加速
联系人多邮箱/手机 · 快捷发信勾选收件人 · 发信白名单校验
Docker 单容器（SQLite / ~256MB / 零依赖）与 Vercel Serverless（PostgreSQL / 零运维）双形态，按场景自由选择
多层安全防护，保障您的数据安全
连续 5 次失败触发锁定，锁定时间线性叠加（5/10/15/20... 分钟），防止暴力破解
触发锁定时，自动通过已配置的通知渠道发送告警通知
记录所有登录尝试（成功/失败），含 IP、时间、结果
JWT (15m/7d) 自动续期 · WebAuthn Passkey 无密码 · Turnstile 人机验证
API 限流 + 零信任网络 · 拦截扫描/恶意 UA · Cron/Webhook 独立鉴权
输出转义防 XSS · 全站 HTTPS · HSTS 响应头 · 密钥脱敏不回显
bcrypt (cost=10) 哈希存储，不可逆 · CSRF Origin/Referer 校验
AES-256 加密 API Key/Token · SMTP 587 requireTLS / 465 secure
外部日历/Webhook URL 拉取前校验公网安全地址，阻断内网穿透
recipientEmails 必须属于联系人邮箱白名单，禁止任意中间人发信
覆盖全球主流通讯平台，一处配置，全部可达
Docker 单容器版 38 个渠道全部可用；Vercel Serverless 版覆盖其中 30+ 个云端可用 HTTP 渠道（Webhook / Token 类）。
| 对比项 | v1.x | v2.16.0 |
|---|---|---|
| 数据库 | PostgreSQL + Redis | SQLite (零配置) |
| 容器数量 | 3 个 | 1 个 |
| 内存占用 | ~800MB | ~256MB |
| 部署复杂度 | 需配置数据库连接 | 开箱即用 |
| 安全加固 | 基础认证 | 登录锁定 + JWT + 限流 + CSRF |
| 通知账户 | 明文存储 | AES-256 加密存储 |
| 多账户支持 | 单渠道单账户 | 同渠道多账户 + 多邮箱 |
| 定时任务 | Redis + Bull | Croner (每分钟检查) |
| 事件类型 | 4 种 | 11 种 (含会议/旅行/婚礼等) |
| 通知模板 | 无 | 18 种预设 + 自定义模板 |
| 重复事件 | 不支持 | 每天/每周/每月/每年 + 待办打勾 |
| 收件箱/集成 | 无 | Inbox 全链路 + Webhook/日历集成 |
| 安全体系 | 基础认证 | 零信任 + SSRF + HSTS + SMTP TLS + Passkey |
低功耗 NAS 也能流畅运行
| 项目 | 最低配置 | 推荐配置 |
|---|---|---|
| CPU | 1 核 | 2 核 |
| 内存 | 256MB | 512MB |
| 磁盘 | 1GB | 5GB |
| Docker | 20.10+ | 24.0+ |
💡 Intel J4125、N5105 等低功耗 NAS 处理器完全够用，内存占用降低约 70%
60 秒完成部署，就这么简单
mkdir timemark && cd timemarkcurl -sSL https://raw.githubusercontent.com/WXFffff666/timemark-docker/master/docker-compose.dockerhub.yml -o docker-compose.ymldocker compose up -dadminTimeMark@2026首次登录后请立即修改密码！
所有变量均可选，不设置也能正常使用
| 变量 | 默认值 | 说明 |
|---|---|---|
| TZ | Asia/Shanghai | 时区设置 |
| DB_PATH | /app/data/timemark.db | SQLite 数据库路径 |
| JWT_SECRET | 首次启动自动生成（data/.env） | JWT 签名密钥 |
| MASTER_KEY | 首次启动自动生成（data/.env） | 主密钥（AES 加密） |
| DEFAULT_ADMIN_PASSWORD | TimeMark@2026 | 初始管理员密码 |
⚠️ 公网部署建议自定义 JWT_SECRET 和 MASTER_KEY 以增强安全性
SQLite 单文件数据库，备份非常简单
在线备份（推荐）
cp ./data/timemark.db ./data/timemark.db.bak完整备份
tar -czf timemark-backup.tar.gz ./data# 停止服务
docker compose down
# 恢复备份
cp ./data/timemark.db.bak ./data/timemark.db
# 重新启动
docker compose up -d# 每天凌晨 3 点自动备份
0 3 * * * cd /opt/timemark && tar -czf /backup/timemark-$(date +\%Y\%m\%d).tar.gz ./data初始版本发布
提醒多选、农历修复
登录锁定、UI 优化
架构重构：SQLite 单容器 · 零配置 · 安全加固 · 通知凭证加密
新增 8 个通知渠道 · 零配置即开即用
性能优化 · 安全加固 · API 增强
通知模板预览 · 自定义模板 · 重复事件 · ICS导出
模板按事件类型分组 · 定时邮件优化 · 调度器增强
安全加固 · 通知模板接入 · 用户时区 · 新增渠道(Ntfy/Pushover/Apprise/Nostr) · 渠道状态显示
固定联系人多邮箱/手机 · 近期待办与完成历史 · 日历三视图 · 按用户时区校准
双历/农历修复 · NTP 时区校准 · Inbox/Integrations · 待办/联系人 · 零信任/SSRF/Passkey 加固 · Docker + Vercel 双形态同步
单容器部署，零外部依赖，开箱即用
TimeMark v2.16.0
Docker single-container | Vercel Serverless
------------------------------------------------
Web UI (:3000, React)
|
v
Hono API (TypeScript)
|
+--> Croner (Docker) / Vercel Cron (Vercel)
|
+--> Static files (container) / Vercel Edge CDN
|
+--> Alert Service -> 38+ notification channels
|
+--> SQLite sql.js (Docker) / PostgreSQL (Vercel)