最後更新:2026-05-14
Cloudflare Pages 部署指南
從 GitHub 到上線
前置準備
- GitHub 帳號 + 倉庫
- Cloudflare 帳號(free plan)
- 自訂網域(選用)
方法 A:GitHub Actions(推薦)
在 repo 建立 .github/workflows/deploy.yml:
name: Deploy to Cloudflare Pages
on:
push:
branches: [main]
workflow_dispatch:
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Deploy
uses: cloudflare/wrangler-action@v3
with:
apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
command: pages deploy . --project-name=my-project --branch=main
GitHub repo → Settings → Secrets:加入 CLOUDFLARE_API_TOKEN 與 CLOUDFLARE_ACCOUNT_ID。
方法 B:Wrangler CLI
export CLOUDFLARE_API_TOKEN="cfut_..."
export CLOUDFLARE_ACCOUNT_ID="..."
npx wrangler pages deploy . --project-name=my-project --branch=main
自訂網域
Pages 專案 → Custom domains → 輸入 hub.agentsworld.live。Cloudflare 自動配發 SSL 憑證。
DNS 已在 Cloudflare 的話,CNAME 會自動被 Pages 偵測到。