### [雨云搭建 Cal.com 开源预约调度平台教程](https://www.jiyueip.com/article/12350)

**Published:** 2026-07-28T11:06:27

**Author:** 斑斓助理

**Excerpt:** 在雨云 VPS 用 Docker 部署 Cal.com，提供对外预约链接、Google/Microsoft 日历双向同步与自动邮件提醒，替代 Calendly 自托管，附配置坑与合规要点。

做咨询、培训、设计、维修这类「靠预约吃饭」的服务，最尴尬的是来回拉群约时间：你发一串空档，对方挑一个，又撞了别的事。Cal.com 是开源的预约调度工具，相当于自托管的 Calendly——你设好可约时段，对方点开链接选时间，自动双向同步日历、发邮件提醒、防撞档。本文记录在雨云 VPS 上用 Docker 部署 Cal.com 的过程与坑。

## 一、Cal.com 解决什么

核心能力：

-   **预约链接**：生成一条个人预约页，对方自己挑空闲时段，不用你手动排；
-   **日历双向同步**：对接 Google / Microsoft 日历，已存在的会议自动避开，不会撞档；
-   **自动提醒**：预约前后发邮件，减少爽约；
-   **多人/团队**：支持把多个成员的空闲时间聚合成团队预约页。

和前面写过的 Vikunja（见 [12302](https://www.jiyueip.com/article/12302)）不同，Vikunja 是「自己管任务」，Cal.com 是「对外约时间」，一个是内部台账一个是外部入口。

## 二、环境准备

Cal.com 比一般轻量应用重一些，官方建议至少 2 核 2G，推荐 2 核 4G。系统 Ubuntu 22.04，装好 Docker（入门见 [12235](https://www.jiyueip.com/article/12235)）。雨云国内节点延迟低，面向国内客户预约体验更好。

> 新用户用优惠码 **admin01** 可享 **五折**优惠，雨云支持 7 天无理由退款。入口：[雨云官网](https://www.jiyueip.com/link/5617)。

## 三、部署要点与坑

Cal.com 官方主推用 Vercel + 托管数据库，自托管走 Docker 稍复杂，关键是环境变量。最小可用需要：

-   `DATABASE_URL`：PostgreSQL 连接串（Cal.com 用 Prisma + Postgres，不支持 SQLite）；
-   `NEXT_PUBLIC_WEBAPP_URL`：你对外访问的域名；
-   `CALENDSO_ENCRYPTION_KEY`：用于加密日历令牌，必须自定义且保密；
-   首次启动要跑数据库迁移 `prisma migrate deploy`。

踩坑提醒：

-   **加密密钥不能少**：`CALENSO_ENCRYPTION_KEY` 缺失会导致日历对接失败、令牌无法保存；
-   **必须用域名而非 IP**：Cal.com 大量功能依赖 `NEXT_PUBLIC_WEBAPP_URL` 的正式域名，用 IP 访问会出现回调异常；
-   **Postgres 要单独起**：建议用 Docker Compose 把 postgres 和 calcom 放一起，数据挂卷备份（见 [12306](https://www.jiyueip.com/article/12306)）。

## 四、对接日历与发信

在 Cal.com 后台「Connections」里授权 Google / Outlook 日历即可双向同步。邮件提醒需要配置 SMTP：可以接前面写过的 Listmonk（见 [12332](https://www.jiyueip.com/article/12332)）同款 SMTP，或任意支持 SMTP 的服务。配置好 SPF/DKIM/DMARC 能显著提升预约邮件的到达率。

如果担心后台暴露，可用 Authelia（见 [12340](https://www.jiyueip.com/article/12340)）给管理路径加一层登录保护。

## 五、典型场景

-   **自由职业者**：把预约链接放简历 / 公众号，客户自助约咨询；
-   **小班课 / 答疑**：设固定可约时段，学生自行选；
-   **售后上门**：维修、安装类服务约时间，自动避开已有排程。

## 合规提醒

Cal.com 会收集预约人的姓名、邮箱、电话等个人信息，属于《个人信息保护法》规定的处理活动，需向预约人明示用途并取得同意，不得超范围使用或对外提供。邮件提醒须遵守《互联网电子邮件服务管理办法》，仅向有预约关系的用户发送，不得借机群发营销内容。

**Tags:** 云服务器, 建站教程, 雨云, 雨云优惠码

**Categories:** 行业洞察

---