直接上傳與 Wrangler
Direct Upload(直接上傳)是把已經建置好的網站檔案直接上傳到 Cloudflare Pages,不讓 Cloudflare 幫你建置。適合已經有自己的 CI 流程(例如 GitHub Actions)、建置環境比較特殊,或只是想把一個資料夾快速放上網的情況。上傳方式有兩種:在儀表板拖放檔案,或用命令列工具 Wrangler。
兩種模式不能互換
Pages 專案建立時就決定是「Git 整合」或「Direct Upload」,之後無法切換。想改模式需要建立新專案。
方法一:儀表板拖放上傳
- 進入 Workers & Pages → Create → Pages → Upload assets。
- 輸入專案名稱,把整個網站資料夾(或 zip 檔)拖進上傳區。
- 按 Deploy site,幾秒後就能用
專案名稱.pages.dev瀏覽。
適合快速展示、活動頁或沒有建置流程的純 HTML 網站。
方法二:用 Wrangler 命令列上傳
Wrangler 是 Cloudflare 官方的命令列工具(詳見 Wrangler 命令列工具)。
# 登入 Cloudflare(會開啟瀏覽器授權)
npx wrangler login
# 建置網站(依你的專案而定)
npm run build
# 上傳 dist 目錄;專案不存在時會詢問是否建立
npx wrangler pages deploy dist --project-name=my-site
加上 --branch 可以部署成預覽版本,不影響正式網站:
方法三:在 GitHub Actions 自動上傳
適合想保留自己 CI 流程、又要自動部署的情況。
- 到 My Profile → API Tokens → Create Token,使用 Edit Cloudflare Workers 範本建立 Token(含 Pages 權限),或自訂權限只給 Account → Cloudflare Pages → Edit。
- 在 GitHub 儲存庫的 Settings → Secrets and variables → Actions 新增:
CLOUDFLARE_API_TOKEN:剛建立的 TokenCLOUDFLARE_ACCOUNT_ID:在儀表板 Workers & Pages 右側可以找到
- 新增 workflow 檔:
.github/workflows/deploy.yml
name: Deploy to Cloudflare Pages
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
- run: npm ci && npm run build
- uses: cloudflare/wrangler-action@v3
with:
apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
command: pages deploy dist --project-name=my-site
API Token 權限越小越好
Token 外洩等同別人可以改你的網站。只給需要的帳號與權限,不要使用權限全開的 Global API Key。