From October to November 2026 the main branch's deploy command uploaded versions without deploying them, so every release went live by a manual promote. The owner set it to `npx wrangler deploy` on 2026-11-21; merging this is also the first check that a merge now deploys by itself. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
15 KiB
07 — Hướng dẫn set Cloudflare (làm một lần, theo thứ tự)
Điều kiện: tài khoản Cloudflare có Workers Paid ($5). Mọi mục dưới nằm trong zone Free — không mua thêm gói zone nào.
1. Mua domain
Dashboard → Domain Registration → Register Domains → tìm poli0981.dev → giá at-cost hiển thị ngay (~US$12–13/năm) → thanh toán. WHOIS redaction tự bật. Zone poli0981.dev tự tạo với nameserver Cloudflare.
Ngay sau khi mua: Domain Registration → Manage → poli0981.dev:
- Auto-renew: ON (kiểm tra thẻ còn hạn — ghi vào lịch bảo trì
17). - Transfer lock: ON.
2. Bảo vệ tài khoản
My Profile → Authentication: bật 2FA (TOTP + lưu recovery codes offline). Tạo thói quen: mọi thao tác registrar đều qua tài khoản chính, không API.
3. DNS & DNSSEC
- Zone → DNS → Settings → Enable DNSSEC → chờ trạng thái Success (registrar cùng nhà nên DS record tự cấu hình).
- Record cho site sẽ do Workers custom domain tự tạo khi làm bước 9 — không tự thêm A/CNAME tay.
- Xoá record thừa nếu có; mọi record web phải Proxied (đám mây cam).
4. SSL/TLS
Zone → SSL/TLS:
- Overview: mode Full (Strict) (với Workers là mặc định đúng).
- Edge Certificates: Always Use HTTPS ON · Minimum TLS 1.2 · TLS 1.3 ON · Automatic HTTPS Rewrites ON.
5. Bot & WAF cơ bản
Zone → Security:
- Bots → Bot Fight Mode: ON. (Tuỳ chọn cùng chỗ: Block AI Scrapers and Crawlers: ON — khuyến nghị bật vì truyện/ảnh là ARR; đi kèm robots.txt ở
13§5.) - WAF → Managed rules: bật Cloudflare Managed Ruleset (free ruleset).
- Settings → Security Level: Medium · Browser Integrity Check: ON.
6. Rate limiting rule (free có 1 rule) — lớp ngoài cho toàn site
Gói Free: 1 rule, biểu thức chỉ dùng được trường URI Path và Verified Bot, đếm theo IP, chu kỳ 10 s, thời gian chặn 10 s, không đổi được trang chặn (Cloudflare trả 429, trang "Error 1015"). Rule chặn ở edge, trước Worker ⇒ flood không tốn request Worker.
Lớp trong Worker (06 §2) đếm thấp hơn — RL_SITE 100/10s cho mọi request tới Worker — để khách thật gặp trang 429 của site trước; rule này chỉ hứng flood thô, nên ngưỡng phải cao hơn 100.
Security → Security rules → Rate limiting rules (đang có rule mẫu "Leaked credential check" chiếm slot duy nhất — site không có form mật khẩu nào trên zone, admin đăng nhập qua Access ở *.cloudflareaccess.com, nên rule đó không bao giờ khớp: sửa nó thành rule dưới, hoặc xoá rồi tạo mới):
- Name:
site-outer-limit - Expression (Edit expression):
(not starts_with(http.request.uri.path, "/_astro/") and not cf.client.bot)— bỏ file tĩnh đã hash (lần tải đầu một trang có thể kéo vài chục file) và bot đã xác thực (Googlebot…; bot AI đã bị chặn ở §5). - Characteristics: IP · Rate: 150 requests / 10 seconds · Action: Block · Duration: 10 seconds.
- Gói Free không lọc được theo hostname, nên rule này đếm cả
admin.*(RL_SITE thì miễn admin). Thư viện ảnh admin tải thumbnail lười (loading="lazy"), mỗi màn hình vài chục request — dưới 150. - Khi bị tấn công: hạ xuống 60–80/10s hoặc đổi Action sang Managed Challenge; xong thì trả về.
Kiểm tra: npm run probe:ratelimit -- https://poli0981.dev/legal/privacy/ 400 — dòng worker 429 là RL_SITE (trang của site), waf 429 là rule này (trang 1015). Rule chưa bật ⇒ chỉ thấy worker 429.
7. Custom rules (free có ~5 rule) — chặn IP/dải/quốc gia khi cần
Security → WAF → Custom rules. Mẫu để dành, chỉ bật khi có sự cố:
- Chặn dải IP:
(ip.src in {203.0.113.0/24 198.51.100.7})→ Block. - Chặn ASN:
(ip.src.asnum eq 64496)→ Block hoặc Managed Challenge. - Chặn quốc gia khỏi /api:
(ip.src.country eq "XX" and starts_with(http.request.uri.path, "/api/"))→ Managed Challenge. Danh sách IP dài → Manage Account → Configurations → Lists → tạo IP Listblocked_ipsrồi rule dùngip.src in $blocked_ips. Ghi chú: các rule này khi khớp sẽ hiện trang chặn mặc định của Cloudflare (zone free không đổi được) — chấp nhận vì là traffic độc hại; trang 403/429 "đẹp" của mình phục vụ từ Worker cho trường hợp mềm hơn (denylist KV, rate-limit trong app).
8. Turnstile
Account Home → Turnstile → Add widget: domain poli0981.dev, mode Managed, loại Invisible/Non-interactive tuỳ test. Lưu Site Key vào code (public), Secret Key → wrangler secret put TURNSTILE_SECRET.
Cổng xác minh (06 §3b) dùng lại widget này với action: "gate" (form báo lỗi dùng action: "report"; server kiểm tra action + hostname nên token không dùng chéo được). Secret ký vé: GATE_SECRET (chuỗi ngẫu nhiên ≥ 32 byte, không ai cần biết) — openssl rand -base64 48 | npx wrangler secret put GATE_SECRET.
8b. Transform Rule — đánh dấu bot hợp lệ cho cổng
Rules → Transform Rules → Modify Request Header → Create:
- Tên:
verified-bot-flag· When: Custom filter(http.host eq "poli0981.dev") - Then: Set dynamic · Header
x-verified-bot· Valueto_string(cf.client.bot)
Rule ghi đè header cho mọi request (client không giả được). Worker thấy "true" ⇒ bot đã được Cloudflare xác thực (Googlebot, Bingbot, bot preview Facebook/Discord/X…) ⇒ đi thẳng. Không thấy header ⇒ coi như rule chưa có ⇒ cổng tự mở (fail-open) và log lỗi — tránh khoá công cụ tìm kiếm. Giữ Block AI bots bật (§5): bot AI "verified" cũng có cf.client.bot, nên chúng phải bị chặn từ WAF chứ không trông vào cổng.
9. Deploy Worker & custom domain
-
Workers Builds (dashboard → worker
poli0981-dev→ Settings → Build), nối repopoli0981/poli0981-dev:Mục Giá trị Production branch mainBuild command npm run buildDeploy command (production) npx wrangler deployNon-production branch deploy command npx wrangler versions upload— chỉ upload version + alias preview, không nhận trafficBuild variables NODE_VERSION=26,PUBLIC_TURNSTILE_SITE_KEY=<site key>Build cache bật Bẫy đã gặp (19/10/2026): Deploy command của nhánh PR từng là
wrangler deploy⇒ mỗi PR (cả Dependabot) được đưa lên production 100%. Ngược lại, nếu Deploy command củamainlàversions uploadthì merge không deploy — khi đó promote tay:npx wrangler versions list→npx wrangler versions deploy <id>@100% --yes --message "main <sha>". Xác minh sau mỗi merge:curl https://poli0981.dev/api/healthphải trả đúngversion.commit(vàversion.content= commit repo nội dung đã publish). Từ v2.3.0 admin tự xuất bản sau mỗi lần lưu ⇒ Deploy command củamainphải lànpx wrangler deploy, nếu không mọi lần lưu dừng ở pha "đã merge — đang deploy" (đã xảy ra từ 10/2026 tới 11/2026: mọi deploy trong thời gian đó là promote tay). Đã sửa ngày 21/11/2026 (Deploy command =npx wrangler deploy, Version command =npx wrangler versions upload); deployment do Workers Builds tạo hiện trongnpx wrangler deployments listngay sau khi buildmainxong, không cần promote. -
Local (khẩn cấp):
npm run build && npx wrangler deploy(lần đầu wrangler mở OAuth login). -
Gắn domain: Workers & Pages → worker
poli0981-dev→ Settings → Domains & Routes → Add → Custom domain →poli0981.dev(tự tạo DNS + cert).www.poli0981.devlà custom domain thứ hai; worker entry redirect 301 về apex. -
Worker widgets (không nối Workers Builds):
npx wrangler deploy --config workers/widgets/wrangler.jsonc→ kiểm tra Triggers có cron.
10. API token cho CI (least privilege)
Workers Builds tự có quyền deploy nên GitHub Actions không cần token Cloudflare. Chỉ tạo khi muốn deploy từ máy khác/CI riêng: My Profile → API Tokens → Create Token → Custom → Account → Workers Scripts → Edit (+ Workers KV Storage → Edit nếu cần seed KV), đúng account, TTL ≤ 1 năm.
11. Email (Google Workspace)
Mail của domain chạy trên Google Workspace (MX → aspmx.l.google.com, SPF include:_spf.google.com, DKIM google._domainkey, DMARC p=none) — không dùng Cloudflare Email Routing (hai bên không thể cùng giữ MX). Một hộp thư, các địa chỉ dưới đây là alias (Admin console → Users → Alternate email addresses):
| Địa chỉ | Dùng cho | Xuất hiện ở |
|---|---|---|
contact@ |
Liên hệ chung (fallback) | Footer, /links, /now, trang 403 |
security@ |
Báo lỗ hổng | /.well-known/security.txt, SECURITY.md |
privacy@ |
Yêu cầu về dữ liệu cá nhân | Privacy §7–8 |
accessibility@ |
Báo rào cản trợ năng (trả lời ≤ 7 ngày) | /legal/accessibility §5, ACCESSIBILITY.md, issue template accessibility.yml, README |
legal@ |
Vấn đề pháp lý | Terms |
copyright@ · dmca@ · takedown@ |
Xin phép · khiếu nại bản quyền · yêu cầu gỡ khác | Licenses, CONTENT-LICENSE.md |
collab@ · press@ · sponsor@ |
Hợp tác · báo chí · tài trợ | /links, Q&A, footer |
code@ · games@ |
Mã nguồn · key game/playtest | /dev, /gaming, /links |
Địa chỉ công khai trên site lấy từ src/lib/links.ts (CONTACT_EMAILS); địa chỉ pháp lý nằm trực tiếp trong content/legal/*.md. Đổi/bỏ alias → sửa cả hai chỗ + security.txt (xem 17 §runbook).
12. Web Analytics
Account → Analytics & Logs → Web Analytics → site poli0981.dev ở chế độ JS snippet (manual) — tắt tự động chèn, nếu không mỗi trang sẽ có 2 beacon (và beacon tự chèn là script inline mà CSP chặn).
- Snippet nằm ở
src/components/CfBeacon.astro(token là site tag công khai, không phải secret), chèn vào<head>củaBaseLayout+ErrorLayout. - Chỉ render khi build trên Workers Builds nhánh
main(WORKERS_CI=1+WORKERS_CI_BRANCH=main→PUBLIC_CF_BEACON), nên CI/Lighthouse/preview không làm bẩn số liệu. Ép bật/tắt: biến buildPUBLIC_CF_BEACON=true|false. - CSP:
script-src https://static.cloudflareinsights.com,connect-src https://cloudflareinsights.com. - Không cookie, khớp Privacy Policy §2.
13b. Admin — admin.poli0981.dev
- Workers →
poli0981-dev→ Domains & Routes → Custom domainadmin.poli0981.dev(cùng Worker). - Zero Trust → Access → Applications → Self-hosted, domain
admin.poli0981.dev(cả host), policy Allow theo email chủ site (IdP Google hoặc One-time PIN). Lấy team domain + AUD tag →vars.ACCESS_TEAM_DOMAIN/vars.ACCESS_AUDtrongwrangler.jsonc(không phải secret). - Hai GitHub fine-grained PAT (hạn ≤ 1 năm; Settings → Developer settings → Fine-grained tokens):
- Content: Repository access = Only select repositories →
poli0981/content; Repository permissions → Contents: Read and write →npx wrangler secret put GITHUB_CONTENT_TOKEN. - Publish: Repository access = Only select repositories →
poli0981/poli0981-dev; Repository permissions → Actions: Read and write →npx wrangler secret put GITHUB_PUBLISH_TOKEN. - Sửa quyền của token có sẵn không đổi giá trị token ⇒ không cần đặt lại secret.
ADMIN_EMAILS(bắt buộc) = email được vào admin, phân cách dấu phẩy:printf '%s' "you@example.com" | npx wrangler secret put ADMIN_EMAILS. Thiếu secret này admin từ chối mọi người (fail-closed). Đặt khi version mới nhất là bảnmain(06§4).- Báo lỗi: thêm repo private
poli0981/site-reportsvàoGITHUB_ISSUES_TOKEN(Issues: Read and write). 3b. Siết Access (applicationadmin.poli0981.dev→ Settings): Session duration ≤ 24h (Worker cũng từ chối token > 24 giờ), policy yêu cầu MFA (IdP có 2FA hoặc rule Access), bật Binding cookie, cookieSameSite=LaxhoặcStrict,HttpOnly.
- Content: Repository access = Only select repositories →
- Repo
poli0981-dev→ Settings → Actions → General → bật Allow GitHub Actions to create and approve pull requests (chocontent-bump.yml); quyền mặc định của GITHUB_TOKEN giữ read. - R2
poli0981-media(wrangler r2 bucket create poli0981-media --location apac), không bật public URL. Images binding không cần bật gì thêm (gói Free: 5.000 biến đổi/tháng).
14. Observability
wrangler.jsonc → observability: logs bật (invocation logs, lấy mẫu 100%, query string bị che), traces lấy mẫu 10%. Xem ở Workers → poli0981-dev → Logs (giữ 7 ngày): lọc theo field event (log JSON của src/lib/log.ts, 06 §10) hoặc ray (mã trên trang 500). Binding version_metadata cho biết version đang chạy; /api/health trả cả commit.
13. Checklist nghiệm thu
dig poli0981.devra IP Cloudflare; DNSSEC = Success- https:// bắt buộc, chứng chỉ hợp lệ, HSTS header có mặt
- Bot Fight ON · Managed WAF ON · (AI crawlers block ON nếu chọn)
- Rate limit rule active —
npm run probe:ratelimit(§6) thấyworker 429rồiwaf 429 - Turnstile hoạt động trên form report (site key đúng domain)
- Custom domain trỏ Worker,
wwwredirect về apex - Cron widgets chạy (Workers → widgets → Logs thấy execution)
contact@vàsecurity@poli0981.devnhận mail test- Web Analytics bắt đầu có số liệu sau ~24h
- Trình duyệt ẩn danh vào
/→ thấy bước xác minh rồi vào trang;curl -s https://poli0981.dev/ | grep data-human-checkcó kết quả; RSS/sitemap/trang pháp lý không bị chặn - Search Console (URL Inspection → Test live URL) thấy trang thật; Facebook Sharing Debugger đúng title/ảnh
https://admin.poli0981.dev/→ đăng nhập Access → thấy admin;curl -H 'cf-access-jwt-assertion: x' …/api/admin/content(qua host chính) → 404/403ADMIN_EMAILSđã đặt; Access session ≤ 24h + MFA + binding cookie- Workers Builds: Deploy command
main=npx wrangler deploy, nhánh khác =npx wrangler versions upload; sau merge/api/healthtrả đúng commit - Auto-renew ON + transfer lock ON + 2FA ON