👋 Chào mừng đến với Nocoem — kiến thức Backend, System Design và lập trình. Khám phá ngay

Hướng dẫn cách tạo Dynamic Link với CloudFlare Worker

Hướng dẫn cách tạo Dynamic Link với CloudFlare Worker
Hướng dẫn cách tạo Dynamic Link với CloudFlare Worker
TL;DR: Dynamic Link là link "biết tự đổi hướng" theo thiết bị, vị trí địa lý hoặc thời gian, thay vì trỏ chết tới một địa chỉ duy nhất. Trong bài này tôi viết một Cloudflare Worker chạy ở edge để làm việc đó, kèm vài cạm bẫy hay gặp khi nối chuỗi URL và khi đọc/ghi số đếm bằng Workers KV.

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

Người dùng click link
-> 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:

  1. Vào mục "Workers & Pages"
  2. Click "Create Worker"
  3. Đặ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)
}
Cú pháp 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
Đoạn nối 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))
Cẩn thận với ví dụ đếm click: 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/searchParams và 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

Thấy bài viết hữu ích?

0 lượt thích

Đăng nhận xét