Cal.com Docker镜像文档

镜像概述

Cal.com是一款开源的日程安排基础设施，作为Calendly的替代方案，支持自托管部署。用户可完全掌控自身数据、工作流和界面外观，通过API驱动的设计实现高度定制，适用于个人、团队及企业的预约管理场景。该镜像基于Next.js、React、Tailwind CSS和Prisma构建，确保功能丰富且易于扩展。

核心功能与特性

• 开源替代方案：完全开源，提供与Calendly相当的核心功能，避免供应商锁定
• 自托管控制：支持本地部署，用户拥有数据所有权，满足隐私合规需求
• 高度定制化：可自定义预约页面、工作流规则及品牌外观
• 多平台集成：支持Google Calendar、Microsoft 365、Zoom、HubSpot等主流工具
• 自动化提醒：内置邮件和SMS预约提醒功能，减少未出席情况
• API驱动：提供完整API接口，便于与现有系统集成
• 团队协作：支持多用户管理和团队预约规则配置

使用场景

• 企业内部预约：部门间会议、资源预约等内部协作场景
• 客户咨询管理：顾问、律师、医生等专业人士的客户预约系统
• 团队对外服务：销售团队演示预约、技术支持排期等
• 教育机构：讲师与学生的辅导时间预约
• 数据隐私敏感场景：对数据存储位置有严格要求的组织或个人

使用方法

前提条件

• Docker及Docker Compose（推荐）
• PostgreSQL数据库（自建或第三方服务）
• 必要的第三方集成API密钥（如需要Google Calendar、Zoom等集成）

获取镜像

bash
docker pull calendso/calendso

基本部署步骤

1. 配置环境变量
   创建.env文件，设置必要参数：

   env
   # 数据库配置
   DATABASE_URL=postgresql://<user>:<pass>@<db-host>:<db-port>/<db-name>
   
   # 安全配置
   NEXTAUTH_SECRET=<32位随机字符串，使用openssl rand -base64 32生成>
   CALENDSO_ENCRYPTION_KEY=<24位随机字符串，使用openssl rand -base64 24生成>
   
   # 基础URL
   NEXT_PUBLIC_WEBAPP_URL=http://localhost:3000
   NEXTAUTH_URL=http://localhost:3000
   

2. 运行容器

   bash
   docker run -d \
     --name calcom \
     -p 3000:3000 \
     --env-file .env \
     calendso/calendso
   

3. 初始化数据库
   进入容器执行数据库迁移：

   bash
   docker exec -it calcom yarn workspace @calcom/prisma db-deploy
   

4. 创建管理员用户
   通过Prisma Studio添加初始用户：

   bash
   docker exec -it calcom yarn db-studio
   

   在浏览器访问http://localhost:5555，添加用户记录（需使用BCrypt加密密码）。

配置参数

核心环境变量

集成相关环境变量

部署示例

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  calcom:
    image: calendso/calendso
    container_name: calcom
    restart: always
    ports:
      - "3000:3000"
    env_file: .env
    depends_on:
      - postgres
    volumes:
      - ./data:/app/data # 持久化数据（如需要）

  postgres:
    image: postgres:14
    container_name: calcom-db
    restart: always
    environment:
      POSTGRES_USER: calcom
      POSTGRES_PASSWORD: securepassword
      POSTGRES_DB: calcom
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

启动服务：

bash
docker-compose up -d

注意事项

• Docker支持：Cal.com Docker配置由社区维护，***不提供直接支持，问题可在calcom/docker仓库讨论
• 升级说明：升级时需拉取最新镜像，并执行数据库迁移命令yarn workspace @calcom/prisma db-deploy
• 许可证：遵循AGPLv3许可证，商业使用需确保源代码公开或获取商业许可

相关资源

• ***网站
• GitHub仓库
• Docker配置仓库
• 集成文档
• 社区Slack