Chuyển đến nội dung

calcom / cal.diy

Cal.diy (bản cộng đồng của Cal.com)

Trang đặt lịch hẹn mã nguồn mở tự cài, kiểu Calendly, bản cộng đồng của Cal.com

Cal.diy là phần mềm đặt lịch hẹn tự cài trên máy chủ riêng: bạn gửi một đường link, người khác chọn giờ trống và đặt hẹn, lịch của bạn tự cập nhật. Đây là bản cộng đồng, rút ra từ Cal.com với toàn bộ mã doanh nghiệp bị bỏ đi và giấy phép MIT. README khuyến cáo dùng cho mục đích cá nhân, không nên dùng cho sản xuất thương mại.

  • 50.070 sao
  • 15.649 fork
  • TypeScript
  • Cập nhật 3 ngày trước
  • MIT (dùng tự do, kể cả thương mại)
Độ khó
Khó Dành cho người biết lập trình
Dạng
Web tự cài (self-host)
Chạy trên
Docker, Node.js, Linux, Windows, macOS
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng Cal.diy (bản cộng đồng của Cal.com)

Sau khi dựng xong, bạn mở trình duyệt vào địa chỉ trang của mình và đi qua một trình hướng dẫn thiết lập: tạo tài khoản đầu tiên, đặt tên đường link cá nhân, tạo các loại cuộc hẹn như tư vấn 30 phút hay họp nhanh 15 phút. README lưu ý có thể có bước kết nối lịch hiện ra như bắt buộc, nhưng bạn bỏ qua được bằng cách vào thẳng trang event-types.

Khi đã nối với lịch cá nhân (nếu bạn chọn nối), người đặt hẹn chỉ thấy các khung giờ còn trống. Họ chọn giờ, điền email, bạn nhận thông báo và cuộc hẹn nằm trong lịch. Bạn không phải nhắn qua lại ba bốn tin chỉ để chốt một giờ họp, đúng ý tưởng của Calendly nhưng dữ liệu nằm ở máy chủ của bạn.

Đổi lại, bạn là người vận hành. Phải có PostgreSQL, tự tạo khoá bí mật, tự lo gửi email và sao lưu. Vì vậy repo này hợp với người có kinh nghiệm quản trị máy chủ hơn là người chỉ muốn một link đặt hẹn cho quán.

Tính năng nổi bật

Link đặt hẹn cá nhân

Tạo nhiều loại cuộc hẹn với thời lượng khác nhau, mỗi loại một đường link để gửi cho khách.

Tự chủ dữ liệu

Chạy trên máy chủ của bạn với cơ sở dữ liệu PostgreSQL của bạn, không cần tài khoản hay license key của Cal.com.

Giấy phép MIT trọn vẹn

Theo README, toàn bộ mã dùng giấy phép MIT và không có phần Enterprise đóng kín như Cal.com.

Chạy bằng Docker Compose

Có sẵn tệp Docker Compose để dựng cả ứng dụng lẫn cơ sở dữ liệu, có thể dùng cơ sở dữ liệu ở máy khác nếu muốn.

Nối được với lịch và công cụ họp

Hỗ trợ tích hợp lịch và họp trực tuyến; mỗi tích hợp thường cần thêm thông tin xác thực riêng, xem phần integrations trong README.

Tận dụng Cal.diy (bản cộng đồng của Cal.com) vào việc gì?

Người làm nghề tự do, thiết kế, dịch thuật

Link hẹn tư vấn cho freelancer

Gửi một đường link thay vì hỏi khách rảnh khi nào; khách tự chọn giờ trong khung bạn mở.

Chủ cửa hàng dịch vụ

Đặt lịch cho quán hoặc tiệm nhỏ có người lo kỹ thuật

Cho khách đặt giờ tư vấn hay bảo hành sản phẩm, không phải gọi điện từng người.

Giáo viên, trung tâm nhỏ, nhà tuyển dụng

Hẹn phỏng vấn hoặc buổi học thử

Người học hoặc ứng viên chọn giờ phù hợp trong số khung giờ bạn công bố.

Lập trình viên

Học cách dựng ứng dụng Next.js thật

Mã nguồn dùng Next.js, tRPC, Prisma, Tailwind; hợp để đọc và học cấu trúc một dự án SaaS.

Cần chuẩn bị gì?

  • Docker và Docker Compose (cách dễ nhất theo README), hoặc Node.js từ 18 trở lên cùng Yarn nếu chạy từ mã nguồn.
  • PostgreSQL phiên bản 13 trở lên, hoặc dùng cơ sở dữ liệu có sẵn trong Docker Compose.
  • Một máy chủ có tên miền nếu muốn khách bên ngoài truy cập; kèm khả năng cấu hình bảo mật cơ bản.
  • Thông tin xác thực (credentials) riêng cho từng dịch vụ lịch hay họp bạn muốn nối.

Hướng dẫn cài đặt chi tiết

Cài trên Docker Compose

  1. Cài Docker (có Docker Compose) rồi mở Terminal. Tải mã nguồn và vào thư mục dự án.

    Terminal
    git clone --recursive https://github.com/calcom/cal.diy.git
    cd cal.diy
  2. Sao chép tệp cấu hình mẫu thành tệp .env.

    Terminal
    cp .env.example .env
  3. Tạo hai khoá bí mật rồi dán vào .env ở mục NEXTAUTH_SECRET và CALENDSO_ENCRYPTION_KEY. README cảnh báo dùng giá trị mặc định là rủi ro bảo mật.

    Terminal
    openssl rand -base64 32
    openssl rand -base64 24
  4. Nếu gặp lỗi liên quan khoá VAPID khi chạy, tạo khoá thông báo đẩy rồi thêm vào .env theo README.

    Terminal
    npx web-push generate-vapid-keys
  5. Khởi động toàn bộ hệ thống gồm cơ sở dữ liệu và ứng dụng.

    Terminal
    docker compose up -d
  6. Mở http://localhost:3000 (hoặc địa chỉ bạn đặt trong NEXT_PUBLIC_WEBAPP_URL) và làm theo trình hướng dẫn tạo người dùng đầu tiên.

Cài trên Chạy thử từ mã nguồn

  1. Cần Node.js 18 trở lên, Yarn, và Docker. Lấy mã nguồn, vào thư mục rồi cài thư viện. Trên Windows, README khuyên chạy lệnh clone trong Git Bash với quyền quản trị và thêm tuỳ chọn symlink.

    Terminal
    git clone https://github.com/calcom/cal.diy.git
    cd cal.diy
    yarn
  2. Tạo .env từ .env.example rồi điền hai khoá bí mật như trên. Sau đó chạy lệnh khởi động nhanh; nó dựng PostgreSQL cục bộ và tạo vài tài khoản thử nghiệm, thông tin đăng nhập sẽ in ra trong Terminal.

    Terminal
    yarn dx
  3. Mở http://localhost:3000 để đăng nhập bằng một tài khoản thử. Cách này chỉ để dùng thử và phát triển, không phải cách chạy cho khách.

Dùng thử lần đầu

  1. Đăng nhập bằng tài khoản vừa tạo và vào trang loại cuộc hẹn (event types) để tạo một loại mới, ví dụ tư vấn 30 phút.

  2. Đặt khung giờ bạn rảnh trong tuần. Đây là phần quyết định khách thấy những giờ nào.

  3. Mở đường link công khai của loại cuộc hẹn đó ở một cửa sổ ẩn danh để xem trải nghiệm của khách, rồi thử đặt một cuộc hẹn bằng email thật của bạn.

  4. Nếu muốn lịch tự cập nhật, vào phần cài đặt tích hợp và nối lịch hoặc công cụ họp bạn dùng. Có thể cần xin thông tin xác thực ở nhà cung cấp đó.

Mẹo dùng hay

  • Luôn đổi hai khoá bí mật trước khi cho ai truy cập; không dùng giá trị mẫu.
  • Sao lưu cơ sở dữ liệu PostgreSQL định kỳ vì mọi cuộc hẹn nằm ở đó.
  • Nếu chỉ cần một link đặt hẹn cho nhu cầu thật của doanh nghiệp, cân nhắc bản Cal.com hosted mà README nhắc tới thay vì tự lo vận hành.

Lưu ý và hạn chế

  • README ghi rõ Cal.diy dành cho cá nhân tự cài, không khuyến nghị dùng cho môi trường production; ai cần giải pháp thương mại được hướng tới Cal.com.
  • Bản này đã bỏ các tính năng doanh nghiệp như Teams, Organizations, Insights, Workflows, SSO/SAML so với Cal.com.
  • Tự cài đòi hỏi kiến thức quản trị máy chủ, cơ sở dữ liệu và bảo mật; dữ liệu khách đặt hẹn là thông tin cá nhân nên bạn cần bảo vệ cẩn thận.
  • Tài khoản thử nghiệm mà yarn dx tạo có mật khẩu công khai trong README, đừng để lộ cổng này ra internet.

Câu hỏi thường gặp

Cal.diy khác Cal.com ở điểm nào?

Cal.diy là bản cộng đồng, bỏ hết mã doanh nghiệp và dùng MIT hoàn toàn; không có bản hosted chính thức, bạn tự chạy. Cal.com có thêm tính năng cho đội nhóm và doanh nghiệp.

Có miễn phí không?

Phần mềm miễn phí, nhưng bạn tự trả tiền máy chủ, tên miền và thời gian vận hành.

Người không rành kỹ thuật dùng được không?

Khó. Cần cài Docker, tạo khoá bí mật, cấu hình cơ sở dữ liệu. Nếu chỉ cần link đặt hẹn, nhờ người có kinh nghiệm hoặc dùng dịch vụ có sẵn sẽ nhẹ nhàng hơn.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/calcom/cal.diy.git

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Năng suất & ghi chú

Năng suất & ghi chú136K

Excalidraw

excalidraw / excalidraw

Bảng trắng vẽ sơ đồ phong cách nét vẽ tay, dùng ngay trên trình duyệt, miễn phí và có thể cộng tác trực tiếp

DễWebNode.js
Năng suất & ghi chú80,8K

Hoppscotch

hoppscotch / hoppscotch

Công cụ gửi và kiểm thử API ngay trên trình duyệt, nhẹ hơn Postman và có thể tự cài trên máy chủ riêng

VừaWebWindowsmacOSLinux+1
Năng suất & ghi chú79K

AppFlowy

AppFlowy-IO / AppFlowy

Không gian làm việc kiểu Notion mã nguồn mở: ghi chú, tài liệu, bảng dữ liệu, bạn giữ quyền với dữ liệu

DễWindowsmacOSLinuxAndroid+1
Năng suất & ghi chú74,6K

AFFiNE

toeverything / AFFiNE

Không gian làm việc gộp tài liệu, bảng trắng và bảng dữ liệu, ưu tiên lưu trên máy và có thể tự cài

VừaWindowsmacOSLinuxWeb+1
Năng suất & ghi chú65,5K

NocoDB

nocodb / nocodb

Biến cơ sở dữ liệu thành bảng tính kiểu Airtable: xem, lọc, nhập liệu và chia sẻ mà không cần viết code

VừaDockerWeb
Năng suất & ghi chú64,5K

Memos

usememos / memos

Sổ ghi chú nhanh tự cài trên máy chủ của bạn, ghi chú theo dòng thời gian, hỗ trợ Markdown và thẻ

VừaDockerWebLinuxmacOS+1

Xem cả 18 repo Năng suất & ghi chú Về Kho Repo