|
| Hướng dẫn cách tạo Dynamic Link với CloudFlare Worker |
Bạn có bao giờ thấy một link mà bấm trên iPhone thì mở App Store, bấm trên Android thì mở Play Store, còn bấm trên máy tính thì ra trang web bình thường chưa? Đó chính là dynamic link. Hôm nay tôi sẽ chỉ bạn cách tự dựng một link như vậy bằng Cloudflare Worker, không cần trả phí cho dịch vụ dynamic link nào cả.
Dynamic Link là gì?
Dynamic Link là link có thể đổi hướng (redirect) khác nhau tùy điều kiện: thiết bị người dùng, vị trí địa lý, thời gian trong ngày, hoặc bất kỳ logic nào bạn tự định nghĩa. Bạn có thể hình dung nó như một lễ tân thông minh: khách tới cùng một quầy, nhưng lễ tân nhìn giấy tờ (thiết bị, vị trí, giờ giấc) rồi chỉ mỗi người tới đúng cửa họ cần, thay vì bắt tất cả đi chung một lối.
Vì sao nên dùng Cloudflare Worker?
Cloudflare Worker là nền tảng edge computing: code JavaScript của bạn chạy tại hàng trăm điểm (data center) gần người dùng nhất, thay vì tập trung ở một server duy nhất. Vài lý do đáng dùng cho bài toán này:
- Gói Free cho 100.000 request mỗi ngày - đủ dùng cho hầu hết dự án cá nhân
- Độ trễ thấp vì Worker chạy gần người dùng, không phải đi vòng về một server trung tâm
- Triển khai và quản lý đơn giản, không cần lo server, scaling
- Tùy chỉnh logic phức tạp bằng JavaScript như bình thường
Cách hoạt động
-> Cloudflare Worker chạy tại điểm edge gần nhất
-> Worker đọc User-Agent, tham số URL, request.cf (thông tin vị trí)
-> So khớp điều kiện (platform, quốc gia, khung giờ...)
-> Trả response redirect tới URL phù hợp
Ví dụ: dựng Dynamic Link bằng Worker
1. Đăng ký tài khoản Cloudflare
Nếu bạn chưa có tài khoản, hãy đăng ký tại cloudflare.com. Quá trình này hoàn toàn miễn phí.
2. Tạo Worker mới
Sau khi đăng nhập:
- Vào mục "Workers & Pages"
- Click "Create Worker"
- Đặt tên cho Worker của bạn (ví dụ: dynamic-link)
3. Code cho Worker
Dưới đây là code mẫu để tạo một Dynamic Link đơn giản:
addEventListener('fetch', event => {
event.respondWith(handleRequest(event.request))
})
async function handleRequest(request) {
// Lấy URL hiện tại
const url = new URL(request.url)
// Lấy các tham số từ URL (nếu có)
const targetPlatform = url.searchParams.get('platform')
const source = url.searchParams.get('source')
// Logic chuyển hướng
let redirectUrl = 'https://default-website.com'
// Kiểm tra thiết bị
const userAgent = request.headers.get('User-Agent') || ''
const isMobile = /Mobile|Android|iPhone/i.test(userAgent)
if (isMobile) {
if (targetPlatform === 'ios') {
redirectUrl = 'https://apps.apple.com/your-app'
} else if (targetPlatform === 'android') {
redirectUrl = 'https://play.google.com/store/your-app'
}
}
// Thêm UTM parameters nếu có source
if (source) {
redirectUrl += `?utm_source=${source}`
}
// Trả về response chuyển hướng
return Response.redirect(redirectUrl, 302)
}
addEventListener('fetch', ...) ở trên là cú pháp Service Worker kiểu cũ, vẫn chạy tốt trên Cloudflare. Dự án mới thường dùng cú pháp module: export default { async fetch(request, env, ctx) { ... } }. Cả hai cách đều hợp lệ, chọn theo hướng dẫn hiện tại trên dashboard của bạn.
4. Triển khai và sử dụng
Sau khi lưu code, Worker của bạn sẽ được triển khai tự động. Bạn có thể dùng link với format:
https://[ten-worker].[username].workers.dev?platform=[ios/android]&source=[nguon]
Ví dụ:
https://dynamic-link.your-name.workers.dev?platform=ios&source=facebook
redirectUrl += `?utm_source=${source}` chỉ an toàn khi bạn chắc chắn URL đích chưa có query string nào. Nếu sau này bạn đổi URL đích thành một link đã có sẵn ?abc=1, kết quả sẽ ra ...?abc=1?utm_source=x, sai định dạng và trình duyệt có thể bỏ qua tham số thứ hai. Cách an toàn hơn: dùng URL và searchParams.set() thay vì nối chuỗi tay.
Một số tính năng có thể mở rộng
-
Chuyển hướng theo vị trí địa lý
const country = request.cf.country if (country === 'VN') { redirectUrl = 'https://vietnam-site.com' } else { redirectUrl = 'https://global-site.com' } -
Chuyển hướng theo thời gian
const hour = new Date().getHours() if (hour >= 22 || hour < 6) { redirectUrl = 'https://night-time-site.com' } -
Theo dõi số lượt click
// Sử dụng Cloudflare KV để lưu số liệu const total = Number(await CLICKS.get('total')) || 0 await CLICKS.put('total', String(total + 1))
CLICKS.get() luôn trả về chuỗi (string) hoặc null, không phải số. Nếu bạn viết (await CLICKS.get('total') || 0) + 1 mà không ép kiểu, lần đầu ra 1 (số), nhưng từ lần thứ hai trở đi JavaScript sẽ nối chuỗi thay vì cộng: "1" + 1 ra "11" chứ không phải 2. Luôn dùng Number() với giá trị đọc từ KV trước khi tính toán.
Cạm bẫy và lưu ý thực tế
Workers KV là kho dữ liệu "eventually consistent": một lần ghi có thể mất một khoảng thời gian mới lan truyền tới tất cả điểm edge. Nó hợp để lưu cấu hình ít thay đổi, nhưng không phải lựa chọn tốt nếu bạn cần đếm click chính xác tuyệt đối theo thời gian thực - trường hợp đó nên cân nhắc Durable Objects hoặc Analytics Engine.
Ở gói Free, Worker cũng có giới hạn thời gian CPU xử lý cho mỗi request, nên tránh nhét logic quá nặng (vòng lặp lớn, tính toán phức tạp) vào một Worker chỉ dùng để redirect. Nếu cần xử lý nặng, tách phần đó ra một service riêng và chỉ gọi khi thật sự cần.
Tóm tắt
- Dynamic Link là link đổi hướng theo điều kiện (thiết bị, vị trí, thời gian...), xử lý ngay tại edge bằng Cloudflare Worker.
- Gói Free đủ dùng cho dự án cá nhân, độ trễ thấp vì Worker chạy gần người dùng.
- Nối query string bằng tay và cộng số đọc từ KV là hai cạm bẫy hay gặp nhất - nhớ dùng
URL/searchParamsvàNumber(). - KV hợp để lưu cấu hình, không hợp để đếm số liệu cần chính xác theo thời gian thực.
Bạn có thể tùy chỉnh logic chuyển hướng theo nhu cầu của mình, ví dụ tích hợp API bên ngoài, thêm xác thực, tạo trang đích riêng, hoặc gắn thêm analytics.
Nếu gặp khó khăn gì, để lại comment nhé, tôi sẽ cố gắng hỗ trợ.
- Kai