← 返回项目库

Booking Calendar｜自托管预约日历管理系统

面向个人与小团队的自托管预约日历，集中管理可预约时间段、预约记录、分享链接、活动和日历同步。

Booking Calendar 提供管理端日历总览、时间段和预约管理，并通过公开链接让访客选择空闲时段完成预约；数据保存在自有服务器 SQLite 中，支持邮件、Web Push、Webhook、CalDAV 和 iCal 导出等可选能力。当前固定版本保留上游英文界面，中文目录文案与交付说明已补齐。

真实界面

项目截图

共 6 张

Dashboard
Time Slots
Appointments
Booking Links
Community Events
Settings

Capabilities

核心功能

✓管理端日历总览
✓时间段与预约管理
✓可分享预约链接
✓社区活动审批流程
✓邮件、Web Push 与 Webhook 通知
✓CalDAV 忙闲同步与 iCal 导出

适用场景

咨询与客户服务预约
个人或团队可用时间发布
社区活动报名与审批

适合谁

需要自托管预约、咨询排期、客户服务时段或社区活动报名的小团队与开发者。

商业化思路

预约系统部署、界面中文化、企业流程定制、通知与日历集成维护服务。

你会拿到什么

  • ✓固定 commit 的完整源码包
  • ✓Docker/Bun 构建与本地运行说明
  • ✓许可证、来源和修改披露
  • ✓真实运行功能截图与验证记录

部署流程

  1. 1配置 .env 中的管理员、JWT_SECRET、端口和持久化数据库路径
  2. 2执行 bun install --frozen-lockfile，并在 src/client 执行 bun install --frozen-lockfile
  3. 3执行 bun run build 后运行 bun run src/server/index.ts，或使用 docker compose up --build

真实验证结果

固定 commit 身份与 source SHA 已复核；Bun 双 lockfile 安装、Vite/PWA 构建、Docker 生产镜像构建通过；本地运行已验证首页、登录、管理员 slots/appointments API、公开 booking link API 和六张 1440×900 功能截图。测试套件有五项与 seed 日期/测试数据隔离相关失败，已保留原始输出。

部署前须知

上游界面当前仍为英文；部分测试依赖固定历史日期和独立测试数据，当前日期运行时有五项失败；SMTP、Web Push、CalDAV 等能力需要使用者自行配置外部服务。

部署难度

中等

最低配置

Docker 或 Bun 1.3+；建议 1 vCPU、512 MB 内存及可写数据目录。生产部署必须配置强管理员密码、JWT_SECRET 和持久化 DB_PATH。

开源许可证

GNU General Public License v3.0

最后验证

2026-09-03

授权说明

上游 LICENSE 为 GPL-3.0。交付保留原许可证和版权信息，并披露本次中文目录与交付说明适配；再分发修改版本须继续履行 GPL-3.0 的源码与许可证义务。上游来源：https://github.com/sametcn99/booking-calendar

Release notes

版本记录

1 个已发布版本

vcn-c992a7e90123 当前推荐

固定上游版本的自托管预约日历交付；完成双 lockfile 构建、Docker 镜像、本地 API 功能验证和六页运行证据。

部署要求：Docker 或 Bun 1.3+；生产环境必须配置强管理员密码、JWT_SECRET 和持久化数据目录。

已知问题：界面中文化尚未完成，已作为证据警告记录。

登录后领取