OG image Next.js: tạo ảnh chia sẻ tự động cho từng bài viết
OG image Next.js cho blog: dựng ảnh chia sẻ 1200x630 bằng ImageResponse, nhúng font Be Vietnam Pro, xử lý tiêu đề dài và kiểm tra bằng test.
OG image là tấm ảnh hiện ra khi ai đó dán link bài viết vào Facebook, Zalo hay Slack. Trong Next.js bạn tạo nó cho từng bài bằng file opengraph-image.tsx và ImageResponse, vẽ tiêu đề bằng JSX. Muốn link của blog trông ra dáng hơn không? Cùng mình làm nhé.
Link dán lên Facebook mà không có ảnh thì sao?
Ở bài trước, blog đã có metadata, sơ đồ trang và JSON-LD để Google hiểu từng bài. Nhưng khách của blog không chỉ đến từ Google. Một người bạn dán link vào nhóm Zalo, và nếu bài không có ảnh thì ứng dụng chỉ hiện một dòng chữ xanh trơ trọi, rất dễ bị lướt qua.
Ứng dụng lấy tấm ảnh đó từ thẻ <meta property="og:image"> trong <head> của trang. Chữ "og" là Open Graph, một chuẩn do Facebook đưa ra mà nhiều ứng dụng nhắn tin khác cũng đọc. Chuẩn được mô tả ở ogp.me.
Cách nhanh nhất là làm một tấm ảnh duy nhất cho cả blog. Cách đó chạy được, nhưng mọi bài dán ra đều trông giống hệt nhau, nên người xem không biết bài nào nói gì. Muốn mỗi bài một ảnh có tiêu đề riêng mà không phải ngồi thiết kế từng tấm, mình cho code vẽ ảnh. Next.js có sẵn công cụ cho việc này là ImageResponse trong next/og, và bạn có thể xem tài liệu của nó để biết đầy đủ các tùy chọn.
Dựng thử bằng font mặc định
Mình muốn bạn làm theo được mà không cần dựng cả một app Next.js, nên mình chạy ImageResponse trực tiếp bằng Node.js, rồi ghi ra file PNG để mở ra xem. Bạn cần Node.js 22.18 trở lên. Tạo thư mục og-blog với cấu trúc sau (hai file ở thư mục assets/fonts mình nói ở mục sau):
og-blog/
package.json
tsconfig.json
thu-ban-dau.tsx
ve-anh.tsx
assets/fonts/BeVietnamPro-SemiBold.ttf
assets/fonts/BeVietnamPro-ExtraBold.ttf
src/tieu-de.ts
src/the-chia-se.tsx
src/png.ts
src/the-chia-se.test.ts{
"name": "blog-mini-10-og-image",
"private": true,
"type": "module",
"scripts": { "test": "vitest run" },
"dependencies": { "next": "16.4.4", "react": "19.3.1", "react-dom": "19.3.1" },
"devDependencies": { "@types/react": "^19.3.0", "tsx": "4.23.15", "vitest": "5.1.0" }
}tsx chạy file TypeScript có JSX, và nó cần biết JSX dùng kiểu nào nên mình thêm một tsconfig.json nhỏ. Sau đó chạy npm install.
{
"compilerOptions": {
"jsx": "react-jsx",
"module": "esnext",
"moduleResolution": "bundler",
"target": "es2022",
"strict": true,
"skipLibCheck": true,
"allowImportingTsExtensions": true,
"noEmit": true
}
}Mình cần ba tiêu đề thử. Hai tiêu đề đầu là tiêu đề bình thường. Tiêu đề thứ ba dài bất thường (199 ký tự), giống lúc ai đó dán cả đoạn mô tả vào ô tiêu đề, và đó là loại đầu vào làm hỏng thiết kế ở các mục sau.
// Ba tiêu đề thử: ngắn, vừa, và một tiêu đề dài bất thường (199 ký tự, giống lúc ai đó dán cả mô tả vào ô tiêu đề).
export const TIEU_DE = {
ngan: "Làm blog cá nhân 0đ",
vua: "Nén ảnh trước khi upload: từ 8,7 MB xuống 440 KB cho blog",
dai: "Hướng dẫn đầy đủ từ A đến Z cách dựng một blog cá nhân bằng Next.js và Supabase, có đăng nhập tác giả, trình soạn bài an toàn, ảnh nén tự động, sơ đồ trang cho Google và ảnh chia sẻ cho từng bài viết",
};Cách làm đầu tiên của mình là tối giản nhất có thể: một thẻ div, chữ cỡ 72, độ đậm 800, không nhúng font nào.
// Cách làm đầu tiên: không nhúng font, cỡ chữ cố định. Chạy: npx tsx thu-ban-dau.tsx
import { mkdir, writeFile } from "node:fs/promises";
import { ImageResponse } from "next/og";
import { TIEU_DE } from "./src/tieu-de.ts";
await mkdir("ra", { recursive: true });
const anh = new ImageResponse(
(
<div style={{ display: "flex", width: "100%", height: "100%", padding: "64px 72px", background: "#fff9f0", color: "#1b1433", fontSize: 72, fontWeight: 800, lineHeight: 1.12 }}>
{TIEU_DE.vua}
</div>
),
{ width: 1200, height: 630 },
);
await writeFile("ra/1-ban-dau.png", Buffer.from(await anh.arrayBuffer()));
console.log("Đã ghi ra/1-ban-dau.png");npx tsx thu-ban-dau.tsxĐã ghi ra/1-ban-dau.pngMở ra/1-ban-dau.png bạn sẽ thấy hai điều. Thứ nhất, chữ trông mảnh dù mình đặt fontWeight: 800. Font mặc định của ImageResponse chỉ có một độ đậm, nên các độ đậm khác bị bỏ qua. Thứ hai, ảnh chỉ có mỗi tiêu đề: không có tên blog, không có chuyên mục, trông như một tờ giấy trắng.
Có một điều cần sửa lại cho đúng. Trong code của blog Tech Notes có một ghi chú nói rằng font mặc định không có dấu tiếng Việt, và ghi chú đó dễ khiến người đọc nghĩ đó là lý do phải nhúng font. Khi thử lại để viết bài này (13/11/2026, Next.js 16.4.4), mình thấy font mặc định vẽ đủ cả những dấu chồng như "ế", "ệ", "ữ", "ặ" mà không lỗi. Vậy ghi chú đó cần được sửa. Lý do thật để nhúng font ở đây là độ đậm và nhận diện của blog, không phải chuyện dấu.
Nhúng font và vẽ thẻ hoàn chỉnh
Mình dùng Be Vietnam Pro, một font thiết kế cho tiếng Việt và có giấy phép SIL Open Font License, nên dùng và đóng gói thoải mái. Bạn tải hai file BeVietnamPro-SemiBold.ttf và BeVietnamPro-ExtraBold.ttf về thư mục assets/fonts. ImageResponse nhận các định dạng ttf, otf và woff, và tài liệu khuyên dùng ttf hoặc otf vì phân tích nhanh hơn woff.
File dưới là phần chính của bài. Nó nhận tiêu đề, nhãn chuyên mục và dòng chân trang, rồi trả về một ImageResponse. Ba chỗ cần để ý.
Font được đọc một lần ở cấp module, vì nó không phụ thuộc vào yêu cầu nào (tài liệu của Next.js cũng làm vậy). Mọi div đều có display: "flex", vì ImageResponse chỉ hỗ trợ flexbox và một phần các thuộc tính CSS, nên display: grid không chạy. Và hàm coChuTieuDe làm cho chữ nhỏ lại khi tiêu đề dài, mà mình sẽ giải thích ngay sau đây:
// Thẻ ảnh chia sẻ (Open Graph) 1200x630 của một bài viết, vẽ bằng ImageResponse của Next.js.
// Cùng ý với src/lib/og/render.tsx của blog Tech Notes; trong blog thật, hàm này được gọi từ file opengraph-image.tsx.
import { readFile } from "node:fs/promises";
import { join } from "node:path";
import { ImageResponse } from "next/og";
export const OG_SIZE = { width: 1200, height: 630 };
// Font không phụ thuộc vào yêu cầu nên đọc một lần ở cấp module (cách tài liệu Next.js khuyên).
const dam = await readFile(join(process.cwd(), "assets/fonts/BeVietnamPro-ExtraBold.ttf"));
const vua = await readFile(join(process.cwd(), "assets/fonts/BeVietnamPro-SemiBold.ttf"));
/** Tiêu đề càng dài thì chữ càng nhỏ, để luôn nằm gọn trong khoảng ba đến năm dòng. */
export function coChuTieuDe(tieuDe: string): number {
if (tieuDe.length <= 40) return 72;
if (tieuDe.length <= 70) return 60;
return 50;
}
export type TheChiaSe = { tieuDe: string; nhan: string; chanTrang: string };
export function veTheChiaSe({ tieuDe, nhan, chanTrang }: TheChiaSe, coChu: number = coChuTieuDe(tieuDe)) {
return new ImageResponse(
(
<div style={{ display: "flex", flexDirection: "column", justifyContent: "space-between", width: "100%", height: "100%", padding: "64px 72px", background: "#fff9f0", color: "#1b1433", fontFamily: "Be Vietnam Pro" }}>
<div style={{ display: "flex", flexDirection: "column", gap: 28 }}>
<div style={{ display: "flex", fontSize: 30, fontWeight: 800, color: "#6d4aff" }}>{nhan}</div>
<div style={{ display: "flex", fontSize: coChu, fontWeight: 800, lineHeight: 1.12, letterSpacing: -2 }}>{tieuDe}</div>
</div>
<div style={{ display: "flex", justifyContent: "space-between", fontSize: 28, fontWeight: 600 }}>
<div style={{ display: "flex", fontWeight: 800 }}>Tech Notes</div>
<div style={{ display: "flex", color: "#5b5470" }}>{chanTrang}</div>
</div>
</div>
),
{
...OG_SIZE,
fonts: [
{ name: "Be Vietnam Pro", data: vua, weight: 600, style: "normal" },
{ name: "Be Vietnam Pro", data: dam, weight: 800, style: "normal" },
],
},
);
}Đến đây mình có một hàm vẽ thẻ. Giờ mình thử nó với ba tiêu đề.
Tiêu đề dài thì ảnh ra sao?
Script dưới vẽ ba tiêu đề bằng hàm trên. Để thấy vì sao cần coChuTieuDe, mình cố ý thêm một lần ép cỡ chữ 72 cho tiêu đề dài. Mỗi lần vẽ, script in kích thước ảnh, dung lượng và thời gian. Để kiểm tra kích thước mà không cần thư viện ảnh, mình đọc thẳng phần đầu của file PNG, nơi nó ghi chiều rộng và chiều cao:
// Đọc chiều rộng và chiều cao từ phần đầu của một file PNG: 8 byte chữ ký, rồi khối IHDR (rộng và cao mỗi số 4 byte, big-endian).
const CHU_KY_PNG = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
export function docKichThuocPng(anh: Buffer): { rong: number; cao: number } {
if (anh.length < 24 || !anh.subarray(0, 8).equals(CHU_KY_PNG)) throw new Error("Không phải file PNG");
return { rong: anh.readUInt32BE(16), cao: anh.readUInt32BE(20) };
}// Vẽ thẻ chia sẻ cho ba tiêu đề, và một lần ép cỡ chữ 72 cho tiêu đề dài để thấy lỗi. Chạy: npx tsx ve-anh.tsx
import { mkdir, writeFile } from "node:fs/promises";
import { docKichThuocPng } from "./src/png.ts";
import { TIEU_DE } from "./src/tieu-de.ts";
import { coChuTieuDe, veTheChiaSe } from "./src/the-chia-se.tsx";
await mkdir("ra", { recursive: true });
const thongTin = (tieuDe: string) => ({ tieuDe, nhan: "WEB THỰC CHIẾN · Trung cấp", chanTrang: "9 phút đọc" });
const mucTieu = [
{ tep: "2-ngan", tieuDe: TIEU_DE.ngan, coChu: coChuTieuDe(TIEU_DE.ngan) },
{ tep: "3-vua", tieuDe: TIEU_DE.vua, coChu: coChuTieuDe(TIEU_DE.vua) },
{ tep: "4-dai-ep-co-72", tieuDe: TIEU_DE.dai, coChu: 72 }, // cố ý sai: cỡ chữ không đổi theo độ dài
{ tep: "5-dai", tieuDe: TIEU_DE.dai, coChu: coChuTieuDe(TIEU_DE.dai) },
];
for (const { tep, tieuDe, coChu } of mucTieu) {
const batDau = performance.now();
const anh = Buffer.from(await veTheChiaSe(thongTin(tieuDe), coChu).arrayBuffer());
const ms = Math.round(performance.now() - batDau);
await writeFile(`ra/${tep}.png`, anh);
const { rong, cao } = docKichThuocPng(anh);
console.log(`ra/${tep}.png`.padEnd(26), `${String(tieuDe.length).padStart(3)} ký tự, chữ ${coChu}px, ${rong}x${cao}, ${(anh.length / 1024).toFixed(1)} KB, ${ms} ms`);
}npx tsx ve-anh.tsxra/2-ngan.png 19 ký tự, chữ 72px, 1200x630, 36.5 KB, 295 ms
ra/3-vua.png 57 ký tự, chữ 60px, 1200x630, 47.8 KB, 25 ms
ra/4-dai-ep-co-72.png 199 ký tự, chữ 72px, 1200x630, 96.2 KB, 40 ms
ra/5-dai.png 199 ký tự, chữ 50px, 1200x630, 84.0 KB, 33 msCả bốn ảnh đều 1200x630, và nặng dưới 100 KB. Lần vẽ đầu mất 295 ms vì phải khởi động bộ vẽ, các lần sau chỉ 25 đến 40 ms. Ảnh mở ra mới là phần đáng xem. ra/2-ngan.png và ra/3-vua.png đẹp: chuyên mục màu tím ở trên, tiêu đề đậm, tên blog và thời gian đọc ở chân.
Còn ra/4-dai-ep-co-72.png là một thảm họa nhỏ. Tiêu đề 199 ký tự ở cỡ 72 ngốn bảy dòng, chữ "Tech Notes" ở chân ảnh bị chồng lên dòng cuối, và dòng cuối bị cắt mất phần dưới vì tràn khỏi mép ảnh. Một tấm ảnh như vậy sẽ nằm trên Facebook của ai đó.
Hàm coChuTieuDe sửa việc này theo cách đơn giản nhất: tiêu đề tới 40 ký tự dùng cỡ 72, tới 70 ký tự dùng cỡ 60, dài hơn thì 50. Với cỡ 50, cùng tiêu đề 199 ký tự nằm gọn trong năm dòng ở ra/5-dai.png, chân ảnh còn nguyên. Các ngưỡng 40 và 70 là mình chỉnh bằng mắt cho khuôn thẻ này, không phải con số chuẩn nào. Nếu bạn đổi font hay đổi lề thì nên thử lại.
Có một cách nữa là cắt tiêu đề ở một độ dài tối đa rồi thêm dấu "…". Mình chưa chọn cách đó, vì theo mình một tiêu đề bị cắt giữa chừng trông tệ hơn một tiêu đề chữ nhỏ.
Gắn vào Next.js thế nào?
Trong một app Next.js, bạn không gọi veTheChiaSe từ script mà đặt một file tên opengraph-image.tsx cạnh trang bài viết. Theo tài liệu về opengraph-image, Next.js tự thêm các thẻ og:image vào <head> của trang, kèm chiều rộng, chiều cao, loại ảnh và mô tả nếu bạn có export alt. Ở Next.js 16, params là một Promise nên phải await nó. Đoạn dưới nằm trong app Next.js, không nằm trong thư mục demo, và mình giả định có hàm layBai(slug) lấy bài từ nơi bạn lưu (Supabase, file Markdown…):
import { OG_SIZE, veTheChiaSe } from "@/lib/the-chia-se";
import { layBai } from "@/lib/bai-viet"; // tùy nơi bạn lưu bài
export const alt = "Ảnh chia sẻ của bài viết";
export const size = OG_SIZE;
export const contentType = "image/png";
export default async function Image({ params }: { params: Promise<{ slug: string }> }) {
const { slug } = await params;
const bai = await layBai(slug);
return veTheChiaSe({ tieuDe: bai.tieuDe, nhan: bai.chuDe, chanTrang: `${bai.phutDoc} phút đọc` });
}Cũng theo tài liệu, ảnh được tạo lúc build và lưu lại (statically optimized) trừ khi bạn dùng dữ liệu hoặc API chỉ có ở lúc yêu cầu. Nghĩa là mỗi bài chỉ tốn một lần vẽ chứ không vẽ lại cho từng người xem. Ở blog Tech Notes, file này còn xử lý thêm trường hợp không tìm thấy bài (trả về ảnh mặc định của cả blog), và lấy màu cùng biểu tượng theo chuyên mục của bài.
Những giả định sai của chính blog này
Hai chuyện đầu có trong lịch sử Git của blog này, và chúng giống bài học của bài trước: metadata của nhiều tầng không tự gộp như ta tưởng.
Chuyện thứ nhất là commit 8ccc85d ngày 4/11/2026. Những trang tự đặt dữ liệu Open Graph riêng (như trang danh sách, trang giới thiệu) làm ảnh chia sẻ mặc định của cả blog biến mất, nên lúc đó chỉ có các bài viết mới có ảnh. Cách sửa là các trang đó gọi tên ảnh mặc định một cách tường minh.
Chuyện thứ hai là commit 17a2d49 ngày 11/11/2026. Bản tiếng Anh /en vẫn dùng ảnh mặc định chỉ có chữ tiếng Việt. Cách sửa là lấy chữ trên ảnh từ bộ từ điển theo ngôn ngữ, và mỗi ngôn ngữ ngoài tiếng Việt có một địa chỉ ảnh riêng.
Chuyện thứ ba là ghi chú về font ở trên, nằm trong code một thời gian mà chưa ai thử lại. Chuyện nào cũng bắt đầu từ một giả định chưa được kiểm tra.
Kiểm tra bằng test, rồi mới tin
Mình viết năm test cho các hàm trong bài, và chúng chạy bằng vitest. Test kiểm tra cỡ chữ đổi đúng ở ranh giới 40 và 70 ký tự, ảnh trả về là PNG, mọi tiêu đề (kể cả tiêu đề 199 ký tự) cho ảnh 1200x630, ảnh nhẹ hơn 200 KB, và hàm đọc kích thước từ chối dữ liệu không phải PNG. Đây là bản đầy đủ:
import { describe, expect, test } from "vitest";
import { docKichThuocPng } from "./png.ts";
import { coChuTieuDe, veTheChiaSe } from "./the-chia-se.tsx";
import { TIEU_DE } from "./tieu-de.ts";
const thongTin = (tieuDe: string) => ({ tieuDe, nhan: "WEB THỰC CHIẾN · Trung cấp", chanTrang: "9 phút đọc" });
const ve = async (tieuDe: string) => {
const phanHoi = veTheChiaSe(thongTin(tieuDe));
return { phanHoi, anh: Buffer.from(await phanHoi.arrayBuffer()) };
};
describe("coChuTieuDe", () => {
test("tiêu đề càng dài, chữ càng nhỏ, đổi cỡ đúng ở ranh giới 40 và 70 ký tự", () => {
expect([40, 41, 70, 71].map((n) => coChuTieuDe("a".repeat(n)))).toEqual([72, 60, 60, 50]);
});
});
describe("veTheChiaSe", () => {
test("trả về PNG với đúng kiểu nội dung", async () => {
const { phanHoi } = await ve(TIEU_DE.vua);
expect(phanHoi.status).toBe(200);
expect(phanHoi.headers.get("content-type")).toBe("image/png");
});
test("mọi tiêu đề (kể cả tiêu đề 199 ký tự) cho ảnh 1200x630", async () => {
for (const tieuDe of Object.values(TIEU_DE)) {
const { anh } = await ve(tieuDe);
expect(docKichThuocPng(anh)).toEqual({ rong: 1200, cao: 630 });
}
});
test("ảnh nhẹ hơn 200 KB (nhiều lần dưới giới hạn 8 MB của Facebook)", async () => {
for (const tieuDe of Object.values(TIEU_DE)) {
const { anh } = await ve(tieuDe);
expect(anh.length).toBeLessThan(200 * 1024);
}
});
});
describe("docKichThuocPng", () => {
test("từ chối dữ liệu không phải PNG", () => {
expect(() => docKichThuocPng(Buffer.from("không phải ảnh, chỉ là chữ thôi nhé"))).toThrow("Không phải file PNG");
});
});npx vitest run Test Files 1 passed (1)
Tests 5 passed (5)Các test này không thấy được ảnh có đẹp hay không, nên mình vẫn phải mở file PNG ra xem, như đã làm ở mục trên. Chúng chỉ giữ cho những thứ đo được (kích thước, dung lượng, cỡ chữ) không tệ đi sau những lần sửa.
Có hai giới hạn nữa bạn nên biết. Thứ nhất, tài liệu của Next.js ghi rằng ImageResponse có giới hạn kích thước gói 500 KB, tính cả JSX, CSS, font và ảnh. Hai font của mình nặng khoảng 270 KB, nên còn dư chỗ, nhưng thêm vài font nữa là sát.
Thứ hai, với ảnh đã được chia sẻ, Facebook thường giữ lại bản xem trước đã lấy. Theo các hướng dẫn mình đọc, công cụ Sharing Debugger của họ có nút lấy lại thông tin trang (Scrape Again). Mình chưa thử việc này trên blog thật trong bài, nên bạn hãy tự thử với một link của bạn.
Làm sao biết ai đang đọc bài nào?
Đến đây mỗi bài của blog có một tấm ảnh riêng khi được chia sẻ. Nhưng khi link bắt đầu đi lung tung trên Zalo và Facebook, mình lại không biết bài nào được đọc nhiều và bài nào không ai mở. Đo lượt đọc mà không theo dõi người đọc là việc của các bài viết sau.
Bạn theo dõi cả hành trình ở Xây blog với Next.js + Supabase. Nếu muốn nhớ lại phần ảnh nhẹ, bài nén ảnh trước khi upload có số đo, và các câu hỏi về Next.js nằm trong ngân hàng câu hỏi phỏng vấn.