最後更新: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_TOKENCLOUDFLARE_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 偵測到。