
Ilustrasi editorial; gambar mewakili aliran kerja pembangunan daripada repositori Git ke pelayan tepi Cloudflare.
Lama juga saya mengurus blog peribadi di atas CMS tradisional—kemas kini pemalam hampir setiap minggu, pelayan VPS yang sesekali penuh ruang cakera sebab fail log, dan bot spam yang tidak pernah penat menghentam borang hubungi. Untuk laman peribadi dan nota teknikal, beban penyelenggaraan itu sebenarnya tidak berbaloi.
Sekarang, susunan yang saya gunakan jauh lebih ringkas: artikel ditulis dalam fail Markdown biasa, dibina menjadi HTML statik ke dalam folder _site/, dan dihoskan terus melalui Cloudflare Workers Assets. Borang hubungi pula tidak memerlukan pelayan PHP atau pangkalan data berasingan—ia diproses oleh fungsi Worker yang menyimpan mesej ke dalam pangkalan data SQL Cloudflare D1 selepas disahkan oleh Cloudflare Turnstile. Kos operasinya hampir sifar, tiada pangkalan data berat untuk laman membaca artikel, dan setiap perubahan ada sejarah Git.
Persediaan akaun dan persekitaran kerja tempatan
Langkah pertama ialah menyediakan akaun Cloudflare dan GitHub. Sahkan alamat e-mel kedua-duanya dan aktifkan pengesahan pelbagai faktor (MFA) lebih awal—anda boleh ikut 10 semakan sebelum mengaktifkan MFA supaya kod pemulihan disimpan dengan betul sebelum anda mengunci akaun sendiri.
Di komputer, pastikan Git dan Node.js versi LTS sudah dipasang:
git --version
node --version
npm --version
Satu tip praktikal untuk pengguna Windows dan macOS: letakkan folder projek di luar direktori yang disegerakkan secara agresif oleh OneDrive, Google Drive atau iCloud. Folder node_modules/ dan _site/ mengandungi ribuan fail kecil yang mudah mencetuskan konflik fail terkunci semasa skrip binaan berjalan.
Selepas membuat repositori kosong di GitHub, tetapkan identiti Git tempatan anda dan pastikan .gitignore menyenaraikan node_modules/, _site/, .wrangler/ serta .dev.vars*. Jangan sesekali menyimpan token API atau kunci rahsia di dalam repositori; rujuk juga panduan mengelakkan pendedahan kunci API di pelayar web untuk memahami sempadan antara kunci awam dan rahsia.
Struktur projek dan sempadan fail sumber
Sebelum menyentuh sebarang fail, fahamkan apa yang anda sunting dan apa yang dijana oleh komputer:
index.htmldanassets/: Halaman utama laman, gaya CSS, skrip pelayar, serta imej artikel di bawahassets/blog/.blog-src/post/danblog-src/posts/: Fail sumber artikel dalam format Markdown beserta metadata frontmatter.scripts/build-blog.mjs: Skrip Node.js yang menyemak frontmatter, mengesahkan laluan imej tempatan dan teks alt, lalu menjana HTML statik ke_site/, suapan RSS (/blog/feed.xml) dansitemap.xml.worker.jsdanwrangler.jsonc: Pengendali Cloudflare Worker yang menghalakan permintaan/api/contactke fungsi borang dan permintaan lain keenv.ASSETS.fetch(request).
Peraturan paling penting di sini: sunting fail sumber sahaja. Jangan ubah HTML di dalam blog/ atau _site/ secara terus kerana setiap kali npm run build dijalankan, folder output itu akan dibersihkan dan ditulis semula dari awal.
Menulis artikel Markdown dan menyemak binaan tempatan
Setiap artikel baharu disimpan mengikut format YYYY-MM-DD-slug-artikel.md di dalam blog-src/post/YYYY/MM/. Lengkapkan frontmatter YAML dengan title, date, lang (ms atau en), description dan tags, serta pastikan setiap artikel mempunyai sekurang-kurangnya satu imej tempatan di bawah /assets/blog/ dengan teks alt yang jelas. Sebelum menerbitkan artikel, anda boleh semak semula dengan senarai 10 semakan editorial dan teknikal sebelum menerbitkan artikel laman web.
Untuk menguji hasil binaan di komputer, pasang kebergantungan dan jalankan skrip binaan:
npm install
npm run build
Jika terdapat imej yang hilang, teks alt kosong atau sintaks frontmatter yang rosak, npm run build akan terus gagal dan memaparkan ralatnya di terminal—jauh lebih baik daripada menyedari halaman rosak selepas laman sudah live.
Mengkonfigurasi Worker, pangkalan data D1 dan Turnstile
Dalam wrangler.jsonc, pastikan main menunjuk ke ./worker.js dan assets.directory menunjuk ke ./_site. Log masuk ke Cloudflare melalui CLI Wrangler untuk menguji pelayan tempatan:
npx wrangler login
npx wrangler dev
Untuk menyimpan mesej daripada borang hubungi tanpa bergantung pada e-mel semata-mata, cipta pangkalan data D1 dan ikat namanya sebagai DB di dalam wrangler.jsonc:
npx wrangler d1 create mzulkamal-contact
Salin database_id yang keluar ke dalam blok d1_databases pada wrangler.jsonc, kemudian jalankan fail skema SQL (schema.sql) untuk kedua-dua persekitaran tempatan dan produksi:
npx wrangler d1 execute mzulkamal-contact --local --file=./schema.sql
npx wrangler d1 execute mzulkamal-contact --remote --file=./schema.sql
Seterusnya, hasilkan widget Cloudflare Turnstile di papan pemuka Cloudflare. Letakkan site key awam pada elemen borang di index.html, manakala secret key pula disimpan sebagai rahsia Worker menggunakan CLI—bukan ditulis di dalam wrangler.jsonc:
npx wrangler secret put TURNSTILE_SECRET_KEY
Di dalam worker.js, pastikan setiap permintaan POST /api/contact menghantar token borang ke titik akhir https://challenges.cloudflare.com/turnstile/v0/siteverify bersama env.TURNSTILE_SECRET_KEY sebelum memasukkan baris baharu ke dalam D1. Tanpa semakan di sebelah pelayan (server-side), bot masih boleh menghantar permintaan terus ke API anda tanpa mempedulikan widget di pelayar. Untuk lapisan pertahanan tambahan seperti had kadar (rate limiting), rujuk panduan berlapis menghentikan spam borang hubungi.
Auto-deploy melalui GitHub dan sambungan domain tersuai
Apabila binaan dan ujian npx wrangler dev berjalan lancar, semak git status dan git diff untuk memastikan tiada fail sensitif seperti .dev.vars termasuk, kemudian tolak kod ke GitHub:
git add .
git commit -m "Sediakan konfigurasi blog, Worker dan borang D1"
git push -u origin main
Di papan pemuka Cloudflare (Workers & Pages → Settings → Builds), sambungkan repositori GitHub anda dengan tetapan berikut:
- Production branch:
main - Build command:
npm run build - Deploy command:
npx wrangler deploy
Selepas berjaya diterbitkan pada subdomain workers.dev, tambah Custom Domain di papan pemuka Worker dan kemas kini site.url di dalam scripts/build-blog.mjs supaya URL kanonikal, suapan RSS dan sitemap.xml menggunakan domain sebenar anda. Jika domain tersuai masih gagal dimuatkan selepas rekod DNS ditukar, semak punca biasa dalam panduan penyelesaian masalah DNS laman web.
Perangkap biasa yang selalu makan masa
Sepanjang mengurus susunan ini, ada empat kesilapan yang paling kerap menyebabkan kerja tertangguh:
- Menyunting fail HTML di dalam
_site/ataublog/: Segala suntingan akan hilang sebaik sahajanpm run buildberjalan di komputer atau di Cloudflare Builds. - Memasang widget Turnstile di HTML tanpa semakan
siteverifydiworker.js: Ini hanya menyekat pengguna jujur jika berlaku ralat UI, tetapi tidak menghalang skripcurlautomatik. - Meletakkan
TURNSTILE_SECRET_KEYdi dalamwrangler.jsonc: Sebaik sahaja andagit pushke repositori awam, kunci itu dianggap terdedah. Sentiasa gunanpx wrangler secret putuntuk produksi dan.dev.varsuntuk ujian tempatan. - Malas menjalankan
npm run buildsebelumgit push: Menunggu 1–2 minit di Cloudflare Builds semata-mata untuk melihat ralat laluan imej yang salah membazir masa sedangkan ujian tempatan mengambil masa beberapa saat sahaja.
Apabila aliran ini sudah siap, kerja penerbitan harian menjadi sangat tenang: tulis Markdown, semak imej, jalankan npm run build, dan git push. Selebihnya diuruskan secara automatik di rangkaian tepi Cloudflare.