Chuyển đến nội dung

caddyserver / caddy

Caddy

Máy chủ web tự động bật HTTPS, cấu hình chỉ vài dòng, dùng làm reverse proxy cho website và ứng dụng tự cài

Caddy là máy chủ web viết bằng Go, nổi tiếng vì tự xin và tự gia hạn chứng chỉ HTTPS (ổ khoá xanh) cho tên miền của bạn mà không cần làm thêm gì. Bạn dùng nó để phục vụ website tĩnh hoặc đặt trước các ứng dụng tự cài (reverse proxy), với file cấu hình Caddyfile ngắn gọn dễ đọc hơn nhiều so với các máy chủ web truyền thống.

  • 79.072 sao
  • 5.266 fork
  • Go
  • Cập nhật 2 ngày trước
  • Apache 2.0 (dùng tự do, kể cả thương mại)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Web tự cài (self-host), Dòng lệnh (CLI)
Chạy trên
Windows, macOS, Linux, Docker
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng Caddy

Giả sử bạn vừa cài một ứng dụng tự host như Vaultwarden hay Umami và nó đang chạy ở một cổng nội bộ trên máy chủ. Bạn muốn truy cập bằng tên miền đẹp kèm HTTPS. Với Caddy, bạn tạo một file tên Caddyfile, ghi tên miền ở dòng đầu và một dòng reverse_proxy trỏ tới cổng của ứng dụng, rồi chạy Caddy. Việc xin chứng chỉ từ Let's Encrypt hoặc ZeroSSL được Caddy tự làm khi nó biết tên miền, bạn không phải chạy thêm công cụ nào.

Với người chưa quen máy chủ, trải nghiệm khác biệt nhất là sự im lặng: Caddy chạy nền, chứng chỉ tự gia hạn trước khi hết hạn, bạn gần như quên là nó tồn tại. Khi sửa cấu hình, lệnh caddy reload áp dụng thay đổi mà không phải tắt máy chủ, nên các ứng dụng đang chạy không bị gián đoạn.

Nếu chỉ muốn thử trên máy cá nhân, Caddy cũng có các lệnh một dòng như caddy file-server để chia sẻ một thư mục qua web, hoặc caddy reverse-proxy để bắc cầu nhanh từ cổng này sang cổng khác. Đây là cách tốt để làm quen trước khi viết Caddyfile thật.

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

HTTPS tự động

Khi biết tên miền, Caddy tự xin chứng chỉ từ Let's Encrypt hoặc ZeroSSL và tự gia hạn. Với tên nội bộ, nó có thể dùng chứng chỉ do chính nó quản lý.

Caddyfile dễ đọc

Cấu hình bằng file văn bản ngắn gọn, vài dòng là có một website hay reverse proxy chạy được. Muốn linh hoạt hơn thì có cả cấu hình JSON và API.

Reverse proxy sẵn có

Đặt Caddy phía trước các ứng dụng như Vaultwarden, Umami, Immich để mỗi ứng dụng có một tên miền riêng, cùng dùng HTTPS.

Hỗ trợ HTTP/2 và HTTP/3

Các giao thức web hiện đại được bật theo mặc định, bạn không phải cấu hình thêm.

Một file chạy, không cần cài thư viện

Caddy là một file thực thi duy nhất, README nói rõ nó chạy được mà không phụ thuộc thư viện ngoài. Việc cài, nâng cấp và gỡ khá gọn.

Mở rộng bằng module

Cần thêm tính năng (ví dụ xác thực DNS với một nhà cung cấp tên miền cụ thể) thì build bản Caddy riêng có plugin bằng công cụ xcaddy.

Tận dụng Caddy vào việc gì?

Người tự host ở nhà, chủ doanh nghiệp nhỏ

Đặt tên miền và HTTPS cho các ứng dụng tự host

Một Caddy đứng trước nhiều ứng dụng (trình quản lý mật khẩu, thống kê web, kho ảnh), mỗi ứng dụng một tên miền con, tất cả đều có HTTPS.

Freelancer, người bán hàng online

Chạy website tĩnh hoặc landing page

Đưa thư mục chứa HTML lên máy chủ, trỏ tên miền về, Caddy lo phần chứng chỉ. Hợp cho trang giới thiệu hoặc trang bán sản phẩm đơn giản.

Dân văn phòng, giáo viên

Chia sẻ nhanh một thư mục trong mạng nội bộ

Lệnh caddy file-server biến một thư mục thành trang web để đồng nghiệp xem hoặc tải file mà không cần dựng máy chủ phức tạp.

Lập trình viên

Thay máy chủ web cũ cho dự án nhỏ

Dùng Caddy làm lớp ngoài cho API hoặc ứng dụng web, tự lo HTTPS và nén, bớt hẳn việc cấu hình chứng chỉ thủ công.

Cần chuẩn bị gì?

  • Windows, macOS hoặc Linux; có sẵn gói cho Debian/Ubuntu, Fedora/RedHat và image Docker chính thức.
  • Để có HTTPS công khai tự động: một tên miền đã trỏ về máy chủ của bạn, và máy chủ nhận được kết nối ở cổng 80 và 443.
  • Cần biết dùng Terminal ở mức cơ bản và hiểu khái niệm tên miền, cổng mạng.
  • Nếu cần plugin của bên thứ ba: cài Go và công cụ xcaddy để tự build, hoặc dùng trang download của Caddy.

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

Cài trên Linux (Debian/Ubuntu)

  1. Dùng gói chính thức của Caddy, khuyến nghị cho máy chủ thật. Chạy lần lượt các lệnh dưới để thêm kho gói của Caddy.

    Terminal
    sudo apt install --yes debian-keyring debian-archive-keyring apt-transport-https curl
    curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
    curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
    sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
    sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
  2. Cập nhật danh sách gói rồi cài Caddy. Gói này tự bật Caddy thành dịch vụ chạy nền tên caddy.

    Terminal
    sudo apt update
    sudo apt install caddy
  3. Với Fedora, RedHat hoặc Arch, xem mục Install trên trang tài liệu chính thức caddyserver.com/docs/install.

Cài trên Windows / macOS

  1. Cách chính thức đơn giản nhất: vào trang Releases của Caddy trên GitHub, mở mục Assets và tải file đúng hệ điều hành, hoặc dùng trang download của caddyserver.com. Giải nén và đặt file caddy vào một thư mục nằm trong biến PATH để gõ được lệnh caddy.

  2. Tài liệu cũng liệt kê các cách do cộng đồng duy trì. Trên Windows có thể dùng Chocolatey hoặc Scoop, trên macOS dùng Homebrew.

    PowerShell
    choco install caddy
  3. Trên macOS với Homebrew:

    Terminal
    brew install caddy
  4. Kiểm tra đã cài được chưa.

    Terminal
    caddy version

Cài trên Docker

  1. Tải image chính thức về. Tài liệu Caddy có kèm cấu hình Docker Compose khuyến nghị ở trang Running, nên đọc trước khi chạy thật.

    Terminal
    docker pull caddy

Dùng thử lần đầu

  1. Thử reverse proxy một dòng: giả sử bạn có một ứng dụng web đang chạy ở cổng 9000 trên máy, lệnh dưới tạo cổng 2080 chuyển tiếp sang đó.

    Terminal
    caddy reverse-proxy --from :2080 --to :9000
  2. Cách bài bản hơn: tạo file tên Caddyfile trong một thư mục với nội dung dưới (cổng 2080 chuyển sang cổng 9000), rồi chạy lệnh bên dưới trong cùng thư mục.

    Văn bản
    :2080
    
    reverse_proxy :9000
  3. Chạy Caddy với cấu hình vừa viết. Lệnh này giữ cửa sổ Terminal mở, bấm Ctrl+C để dừng.

    Terminal
    caddy run
  4. Khi có máy chủ thật và tên miền, thay dòng đầu của Caddyfile bằng tên miền của bạn thay cho :2080. Caddy sẽ tự xin chứng chỉ HTTPS khi biết hostname.

  5. Mỗi lần sửa Caddyfile, áp dụng thay đổi mà không phải tắt máy chủ.

    Terminal
    caddy reload

Mẹo dùng hay

  • Làm quen bằng cổng 2080 hoặc localhost trước, khi mọi thứ chạy đúng mới chuyển sang tên miền thật để tránh vướng giới hạn xin chứng chỉ.
  • Muốn HTTPS công khai, hãy mở cổng 80 và 443 trên tường lửa và trỏ bản ghi DNS của tên miền về địa chỉ IP máy chủ trước khi chạy.
  • Khi chạy thật, nên cài Caddy thành dịch vụ hệ thống (gói apt làm sẵn việc này) thay vì mở cửa sổ Terminal cho nó.
  • Tài liệu chính thức khuyên mọi người, kể cả người mới, nên đọc hướng dẫn Getting Started trên caddyserver.com/docs trước khi dùng nghiêm túc.

Lưu ý và hạn chế

  • Caddy không có giao diện đồ hoạ: mọi thứ là file cấu hình và dòng lệnh, nên người chưa từng đụng tới máy chủ sẽ cần thời gian làm quen.
  • Các gói chính thức chỉ có module chuẩn. Cần plugin của bên thứ ba thì phải tự build bằng xcaddy hoặc tải bản có plugin từ trang download.
  • Các cách cài qua Chocolatey, Scoop hay Homebrew do cộng đồng duy trì, không phải do nhóm Caddy phát hành, nên có thể chậm hơn bản mới nhất.

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

Caddy khác Nginx hay Apache chỗ nào?

Điểm hay được nhắc nhất là HTTPS tự động và cấu hình ngắn gọn. Caddy tự xin và gia hạn chứng chỉ, còn nhiều máy chủ truyền thống cần cài thêm công cụ riêng. Nginx và Apache vẫn rất phổ biến, nên chọn cái nào thì tuỳ thói quen và hệ thống sẵn có của bạn.

Caddy có miễn phí không?

Có. Caddy là mã nguồn mở giấy phép Apache 2.0, dùng miễn phí cả cho mục đích thương mại.

Máy tính ở nhà không có IP công khai thì có dùng được không?

Dùng được để chạy thử và reverse proxy trong mạng nội bộ. Còn muốn lấy chứng chỉ HTTPS công khai thì thường cần tên miền và đường kết nối từ Internet vào máy chủ; tài liệu của Caddy có hướng dẫn các cách xác thực khác nếu bạn không mở được cổng.

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/caddyserver/caddy.git

Repo tương tự nên xem

Tự host & máy chủ nhà39,2K

Tailscale

tailscale / tailscale

Nối các thiết bị thành một mạng riêng an toàn, truy cập máy ở nhà từ bất cứ đâu mà không cần mở cổng router

DễWindowsmacOSLinuxAndroid+1
Tự host & máy chủ nhà70,8K

Vaultwarden

dani-garcia / vaultwarden

Máy chủ quản lý mật khẩu nhẹ, tự cài ở nhà, dùng chung ứng dụng Bitwarden chính thức

VừaDockerLinuxWeb
Tự host & máy chủ nhà66,1K

Coolify

coollabsio / coolify

Bảng điều khiển tự cài để đưa website, cơ sở dữ liệu và ứng dụng lên máy chủ riêng, kiểu Vercel

VừaLinuxDockerWeb

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ủ đề: Tự host & máy chủ nhà

Tự host & máy chủ nhà338K

Awesome-Selfhosted

awesome-selfhosted / awesome-selfhosted

Danh mục khổng lồ các phần mềm mã nguồn mở tự cài trên máy chủ của riêng bạn

DễWeb
Tự host & máy chủ nhà115K

Supabase

supabase / supabase

Nền tảng backend trên Postgres: cơ sở dữ liệu, đăng nhập, lưu file và API tự sinh, thay thế Firebase

KhóDockerWebNode.jsLinux+2
Tự host & máy chủ nhà111K

frp

fatedier / frp

Đưa máy hoặc dịch vụ trong mạng nhà ra internet qua một máy chủ trung gian, không cần mở cổng router

KhóWindowsmacOSLinux
Tự host & máy chủ nhà94,4K

Uptime Kuma

louislam / uptime-kuma

Theo dõi website và dịch vụ còn sống hay chết, báo qua Telegram, Discord, email bằng giao diện đẹp

VừaDockerLinuxWindowsNode.js
Tự host & máy chủ nhà92,3K

Home Assistant

home-assistant / core

Trung tâm nhà thông minh mã nguồn mở, điều khiển thiết bị ngay trong mạng nhà, ưu tiên riêng tư

VừaLinuxDockerWebWindows+3
Tự host & máy chủ nhà81,4K

Netdata

netdata / netdata

Giám sát máy chủ và hệ thống theo từng giây, cài xong là có bảng điều khiển ngay, gần như không cần cấu hình

VừaLinuxWindowsmacOSDocker

Xem cả 16 repo Tự host & máy chủ nhà Về Kho Repo