Ruang kerja pembangun dengan kod fungsi kecil dan peta permintaan

Laman statik memang sangat tenang untuk dijaga. Fail HTML, CSS, dan gambar dijana sekali semasa proses build, kemudian terus diedarkan kepada pembaca dari CDN. Tiada pangkalan data untuk ditampal setiap minggu, tiada pelayan PHP atau Node yang tiba-tiba penuh memori pada pukul tiga pagi.

Tetapi cepat atau lambat, hampir setiap laman statik akan berdepan satu keperluan kecil yang tidak boleh dibuat di dalam pelayar pengguna sahaja. Contohnya: memproses borang hubungan tanpa mendedahkan kunci API e-mel, mengesahkan token Turnstile, menyemak status stok ringkas, atau melakukan ubah hala (redirect) pintar berdasarkan laluan URL.

Persoalannya: perlukah kita menyewa VPS baharu dan mengurus satu lagi pelayan backend semata-mata untuk satu endpoint /api/contact? Untuk kes begini, Cloudflare Workers jauh lebih masuk akal.

Tugas yang memang sesuai untuk Worker

Worker berfungsi paling baik apabila ia mengendalikan logik yang pendek, cepat, dan terasing, sementara 95% trafik laman lain kekal dilayan sebagai fail statik biasa. Antara kegunaan paling praktikal yang saya sendiri guna dalam projek harian:

  1. Endpoint borang hubungan atau maklum balas: Menerima JSON daripada frontend, menyemak token anti-bot, membersihkan input, dan menyimpan mesej ke D1 atau menghantar notifikasi ke e-mel/Telegram.
  2. Proksi ringan untuk API pihak ketiga: Menyimpan kunci API rahsia di sebelah server supaya pelayar tidak nampak kredensial tersebut, sambil menambah caching ringkas supaya kuota API tidak cepat habis.
  3. Header keselamatan dan pengubahsuaian respons: Menambah Content-Security-Policy, X-Content-Type-Options, atau menulis semula tag Open Graph secara dinamik sebelum HTML sampai ke crawler media sosial.

Contoh struktur asas Worker untuk mengendalikan borang hubungan secara selamat kelihatan seperti ini:

export default {
  async fetch(request, env) {
    const url = new URL(request.url);

    if (url.pathname === "/api/contact" && request.method === "POST") {
      const origin = request.headers.get("Origin");
      if (origin !== "https://contoh-laman.com") {
        return Response.json({ error: "Origin tidak dibenarkan" }, { status: 403 });
      }

      let body;
      try {
        body = await request.json();
      } catch {
        return Response.json({ error: "Format JSON tidak sah" }, { status: 400 });
      }

      const name = String(body.name || "").trim();
      const message = String(body.message || "").trim();
      if (!name || message.length < 10 || message.length > 2000) {
        return Response.json({ error: "Sila lengkapkan nama dan mesej." }, { status: 400 });
      }

      // Simpan ke D1 atau hantar ke perkhidmatan e-mel menggunakan env.API_KEY
      return Response.json({ ok: true }, { status: 201 });
    }

    return env.ASSETS.fetch(request);
  },
};

Tulis sempadan yang jelas sebelum deploy

Walaupun kodnya cuma 40 baris, ia tetap kod backend yang terdedah kepada internet awam. Tiga perkara ini wajib disemak sebelum mula digunakan:

  • Sahkan Origin dan hadkan saiz payload. Jangan terima teks tanpa had yang boleh memenuhkan storan atau menyebabkan fungsi tamat masa.
  • Jangan simpan kunci rahsia dalam kod sumber. Gunakan bindings dan secrets melalui wrangler secret put supaya tiada token masuk ke sejarah Git.
  • Fikirkan data peribadi (PDPA). Kalau borang mengumpul nama, nombor telefon, atau e-mel, tentukan siapa yang boleh mengakses papan pemuka storan dan berapa lama rekod itu disimpan sebelum dipadamkan.

Uji laluan gagal, bukan laluan gembira sahaja

Kesilapan biasa apabila membina fungsi kecil ialah kita hanya menguji kes “semua medan diisi dengan betul”. Sebaliknya, uji juga apa yang berlaku apabila:

  • Medan wajib dihantar kosong atau mengandungi aksara pelik.
  • Seseorang menghantar permintaan GET ke /api/contact yang sepatutnya hanya menerima POST.
  • Pangkalan data D1 atau API e-mel luaran gagal memberi respons—adakah pengguna mendapat mesej ralat yang sopan, atau halaman terus senyap membisu?

Selain itu, pastikan anda menyemak log masa nyata melalui wrangler tail atau papan pemuka Cloudflare Logs selepas pelancaran. Fungsi yang berjalan senyap tanpa log menyebabkan anda hanya tahu borang rosak apabila pelanggan telefon dan mengadu mereka tidak dapat menghantar pertanyaan sejak minggu lepas.

Dokumentasi rasmi Cloudflare Workers ialah rujukan terbaik untuk memahami model Request, Response, dan had masa CPU pelan percuma mahupun berbayar. Gunakan Worker apabila ia menyelesaikan satu tugasan kecil dengan bersih—bukan untuk memindahkan keseluruhan aplikasi kompleks yang sebenarnya lebih selesa berjalan di atas pelayan tradisional.