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)
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.
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.listCậ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.
sudo apt update sudo apt install caddyVớ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
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
caddyvào một thư mục nằm trong biến PATH để gõ được lệnhcaddy.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.
choco install caddyTrên macOS với Homebrew:
brew install caddyKiểm tra đã cài được chưa.
caddy version
Cài trên Docker
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.
docker pull caddy
Dùng thử lần đầu
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 đó.
caddy reverse-proxy --from :2080 --to :9000Cá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.
:2080 reverse_proxy :9000Chạ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.
caddy runKhi 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.
Mỗi lần sửa Caddyfile, áp dụng thay đổi mà không phải tắt máy chủ.
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.
git clone https://github.com/caddyserver/caddy.gitRepo tương tự nên xem
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
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
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