Nội dung
Cách đơn giản nhất để đưa một website Next.js lên Firebase Hosting là dùng static export: Next.js dựng sẵn toàn bộ trang thành file HTML, CSS, JavaScript trong thư mục out/, rồi Firebase phục vụ các file đó qua mạng CDN. Không cần máy chủ Node.js chạy liên tục, chi phí rất thấp và trang tải nhanh.
Đây cũng là cách website dangtrantai.com đang chạy. Bài này đi qua từng bước, kèm những lỗi mình đã gặp.
Khi nào nên dùng static export?
Static export hợp với website có nội dung biết trước lúc build: trang giới thiệu doanh nghiệp, blog, portfolio, landing page. Không hợp nếu bạn cần:
- Nội dung thay đổi theo từng người dùng ở phía máy chủ (đăng nhập, giỏ hàng tính trên server).
- API route của Next.js, middleware, ISR (tạo lại trang theo chu kỳ).
- Tối ưu ảnh tự động của
next/image(cần máy chủ).
Nếu website cần những thứ trên, hãy xem Firebase App Hosting hoặc một nền tảng chạy Node.js. Phần xử lý nhỏ như form liên hệ vẫn làm được bằng Cloud Function riêng.
Bước 1: Cấu hình Next.js
Trong next.config.ts:
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
output: 'export', // xuất trang tĩnh ra thư mục out/
trailingSlash: true, // URL có dấu "/" ở cuối, ví dụ /blog/
images: { unoptimized: true },
}
export default nextConfig
output: 'export'là dòng bắt buộc.trailingSlash: truegiúp giữ URL giống WordPress cũ (/website/elementor/). Nếu site mới hoàn toàn, chọn kiểu nào cũng được, miễn nhất quán.images: { unoptimized: true }vì không có máy chủ tối ưu ảnh. Bạn tự nén ảnh trước, ví dụ xuất WebP rộng tối đa 1600px.
Chạy npm run build. Nếu có trang dùng tính năng cần máy chủ, Next.js báo lỗi ngay, sửa trước khi đi tiếp.
Bước 2: Tạo dự án Firebase và cài Firebase CLI
- Vào Firebase Console, tạo project mới.
- Cài công cụ dòng lệnh:
npm install -g firebase-tools - Đăng nhập:
firebase login - Trong thư mục dự án:
firebase init hosting- Chọn project vừa tạo.
- Public directory:
out - Configure as single-page app: No (mỗi trang đã có file HTML riêng).
- Set up GitHub Action: có thể chọn sau.
Bước 3: Cấu hình firebase.json
{
"hosting": {
"public": "out",
"cleanUrls": true,
"trailingSlash": true,
"ignore": ["firebase.json", "**/.*"],
"redirects": [
{ "source": "/trang-cu/", "destination": "/trang-moi/", "type": 301 }
],
"headers": [
{
"source": "/_next/static/**",
"headers": [{ "key": "Cache-Control", "value": "public, max-age=31536000, immutable" }]
}
]
}
}
Lưu ý quan trọng: redirects và headers khai báo trong next.config không chạy khi static export. Mọi chuyển hướng 301 và header phải đặt trong firebase.json. Website của mình có hơn 50 quy tắc chuyển hướng từ URL WordPress cũ, tất cả nằm ở đây.
trailingSlash trong firebase.json nên khớp với cấu hình Next.js, nếu không bạn sẽ gặp chuyển hướng qua lại hoặc trang 404.
Bước 4: Deploy lần đầu
npm run build
firebase deploy --only hosting
Vài chục giây sau, website chạy ở địa chỉ <project-id>.web.app. Mở thử vài trang, thử một URL cũ xem có chuyển hướng đúng không.
Bước 5: Gắn tên miền riêng
- Firebase Console → Hosting → Add custom domain.
- Firebase cho một bản ghi TXT để xác minh và các bản ghi A trỏ về máy chủ của Firebase.
- Thêm các bản ghi đó ở nơi quản lý DNS.
- Chờ Firebase cấp chứng chỉ SSL, thường từ vài phút đến vài giờ.
Nếu tên miền đang dùng Cloudflare, để các bản ghi trỏ về Firebase ở chế độ DNS only (đám mây xám) trong lúc Firebase cấp chứng chỉ. Bật proxy của Cloudflare quá sớm là nguyên nhân phổ biến khiến chứng chỉ mãi không được cấp.
Bước 6: Tự động deploy bằng GitHub Actions
Gõ lệnh deploy bằng tay dễ quên. Mình dùng GitHub Actions với ba luồng:
- Mỗi lần merge vào
main: build và deploy lên site thật. - Mỗi Pull Request: deploy lên một preview channel, tức một link xem thử riêng, tự xóa sau 7 ngày. Duyệt bài viết hay giao diện mới trên link này trước khi merge.
- Mỗi sáng 06:00: build lại để bài viết hẹn giờ (ngày đăng ở tương lai) tự xuất hiện khi đến ngày.
Action chính thức là FirebaseExtended/action-hosting-deploy. Nó cần một service account của Firebase, lưu trong GitHub Secrets, không bao giờ để trong mã nguồn.
Những lỗi mình đã gặp
| Lỗi | Nguyên nhân | Cách sửa |
|---|---|---|
| Build báo trang không thể export | Trang dùng tính năng cần máy chủ | Bỏ tính năng đó hoặc chuyển sang Cloud Function |
| Ảnh không hiện | Dùng next/image mặc định |
Thêm images: { unoptimized: true } |
| Chuyển hướng không chạy | Khai báo trong next.config |
Chuyển sang firebase.json |
| URL bị 404 hoặc vòng lặp chuyển hướng | trailingSlash hai bên không khớp |
Đặt giống nhau ở Next.js và Firebase |
| Tên miền mãi chưa có SSL | Cloudflare đang bật proxy | Chuyển bản ghi sang DNS only |
Kết luận
Next.js static export cộng Firebase Hosting là bộ đôi gọn cho website nội dung: nhanh, rẻ, gần như không phải bảo trì máy chủ. Phần khó nhất không nằm ở lệnh deploy, mà ở việc giữ URL cũ và cấu hình chuyển hướng cho đúng khi chuyển từ nền tảng khác sang.
Nếu bạn định chuyển website sang Next.js và Firebase mà chưa chắc nên bắt đầu từ đâu, nhắn cho mình. Đọc thêm: Claude Code là gì? Cách mình dùng Claude Code để làm website.
