跳轉至

建立 2026-11-22 更新 2026-11-22

直接上傳與 Wrangler

Direct Upload(直接上傳)是把已經建置好的網站檔案直接上傳到 Cloudflare Pages,不讓 Cloudflare 幫你建置。適合已經有自己的 CI 流程(例如 GitHub Actions)、建置環境比較特殊,或只是想把一個資料夾快速放上網的情況。上傳方式有兩種:在儀表板拖放檔案,或用命令列工具 Wrangler。

兩種模式不能互換

Pages 專案建立時就決定是「Git 整合」或「Direct Upload」,之後無法切換。想改模式需要建立新專案。

方法一:儀表板拖放上傳

  1. 進入 Workers & Pages → Create → Pages → Upload assets。
  2. 輸入專案名稱,把整個網站資料夾(或 zip 檔)拖進上傳區。
  3. 按 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 可以部署成預覽版本,不影響正式網站:

npx wrangler pages deploy dist --project-name=my-site --branch=staging

方法三:在 GitHub Actions 自動上傳

適合想保留自己 CI 流程、又要自動部署的情況。

  1. 到 My Profile → API Tokens → Create Token,使用 Edit Cloudflare Workers 範本建立 Token(含 Pages 權限),或自訂權限只給 Account → Cloudflare Pages → Edit。
  2. 在 GitHub 儲存庫的 Settings → Secrets and variables → Actions 新增:
    • CLOUDFLARE_API_TOKEN:剛建立的 Token
    • CLOUDFLARE_ACCOUNT_ID:在儀表板 Workers & Pages 右側可以找到
  3. 新增 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。

相關資料