Cách Thiết Lập Cloudflare Pages

Tại Sao Chọn Cloudflare Pages?

Cloudflare Pages là nền tảng lưu trữ miễn phí với CDN toàn cầu (mạng phân phối nội dung). Trang web của bạn tải nhanh từ bất kỳ đâu trên thế giới, và nó tự động triển khai mỗi khi bạn đẩy mã lên GitHub.

Những gì bạn được miễn phí:

Băng thông không giới hạn
CDN toàn cầu
SSL tự động (HTTPS)
Triển khai xem trước cho các nhánh
Hàm serverless (cho biểu mẫu liên hệ)

Bước 1: Tạo Tài Khoản Cloudflare

Truy cập cloudflare.com và nhấn Sign Up
Nhập email và tạo mật khẩu
Xác minh email

Bước 2: Kết Nối Kho Lưu Trữ GitHub

Sau khi trang web đã được xây dựng (bạn đã chạy prompt Giai đoạn 1 và đẩy lên GitHub):

Trong bảng điều khiển Cloudflare, vào Workers & Pages
Nhấn Create
Chọn tab Pages
Nhấn Connect to Git
Cho phép Cloudflare truy cập tài khoản GitHub của bạn
Chọn kho lưu trữ chứa mã trang web

Bước 3: Cấu Hình Cài Đặt Build

Trên màn hình cấu hình:

Production branch: main (hoặc master, tùy repo của bạn dùng cái nào)
Build command: bundle exec jekyll build
Build output directory: _site

Nhấn Save and Deploy. Lần build đầu tiên có thể mất một đến hai phút.

Bước 4: Thêm Biến Môi Trường

Nếu trang web có biểu mẫu liên hệ, bạn cần thêm các biến môi trường SendGrid:

Vào dự án Pages > Settings > Environment variables
Thêm các biến sau cho môi trường Production:

Biến	Giá trị
`JEKYLL_ENV`	`production`
`SENDGRID_API_KEY`	API key SendGrid của bạn
`CONTACT_EMAIL`	Email doanh nghiệp của bạn
`FROM_EMAIL`	`noreply@yourdomain.com`

Chưa có SendGrid? Xem Cách thiết lập SendGrid. Nếu trang web không dùng biểu mẫu liên hệ, bạn chỉ cần biến JEKYLL_ENV.

Bước 5: Thiết Lập Tên Miền Riêng

Sau khi triển khai lần đầu thành công:

Vào dự án Pages > Custom domains
Nhấn Set up a custom domain
Nhập tên miền (ví dụ www.yourbusiness.com)
Cloudflare sẽ cho bạn biết cần thêm bản ghi DNS nào

Nếu tên miền đã trên Cloudflare: Các bản ghi DNS được thêm tự động. Xong!

Nếu tên miền được đăng ký ở nơi khác: Bạn có hai lựa chọn:

Chuyển nameserver sang Cloudflare (khuyến nghị — cho bạn toàn quyền kiểm soát)
Thêm bản ghi CNAME tại nhà đăng ký hiện tại trỏ đến URL Pages của bạn

Cách Triển Khai Hoạt Động

Sau khi kết nối, quy trình hoàn toàn tự động:

Bạn đẩy mã lên GitHub (vào nhánh main)
Cloudflare phát hiện thay đổi
Nó xây dựng trang Jekyll của bạn
Phiên bản mới được triển khai toàn cầu

Quá trình này mất khoảng 30-60 giây. Bạn cũng có thể đẩy lên các nhánh khác để có bản triển khai xem trước — hữu ích để kiểm tra thay đổi trước khi chính thức ra mắt.

Khắc Phục Sự Cố

Build thất bại với lỗi “ruby not found” Đảm bảo repo có tệp .ruby-version (prompt Giai đoạn 1 đã tạo tệp này). Cloudflare Pages dùng nó để cài đúng phiên bản Ruby.

Build thất bại với lỗi “bundle not found” Lỗi này thường tự khắc phục — Cloudflare Pages tự động cài Bundler. Nếu vẫn lỗi, thử kích hoạt một lần triển khai mới.

Tên miền riêng hiển thị “too many redirects” Vào cài đặt SSL/TLS của tên miền trong Cloudflare và đặt chế độ mã hóa thành Full (strict).