在 Cloudflare 上托管

在 Cloudflare 上托管您的網站。

使用這些說明從 GitHub 倉庫啟用持續部署。如果您使用 GitLab 進行版本控制，適用相同的一般步驟。

前提條件

請在繼續之前完成以下任務：

創建 Cloudflare 賬戶
登錄您的 Cloudflare 賬戶
創建 GitHub 賬戶
登錄您的 GitHub 賬戶
創建項目的 GitHub 倉庫
創建項目的本地 Git 倉庫，並帶有指向 GitHub 倉庫的遠程引用
在本地 Git 倉庫中創建 Hugo 網站，並使用 hugo server 命令測試

步驟

步驟 1

在項目根目錄創建 wrangler.toml 文件。

wrangler.toml

name = "hosting-cloudflare-worker"
compatibility_date = "2025-07-31"

[build]
command = "chmod a+x build.sh && ./build.sh"

[assets]
directory = "./public"
not_found_handling = "404-page"

步驟 2

在項目根目錄創建 build.sh 文件。

build.sh

#!/usr/bin/env bash

#------------------------------------------------------------------------------
# @file
# 構建托管在 Cloudflare Worker 上的 Hugo 網站。
#
# Cloudflare Worker 會自動安裝 Node.js 依賴。
#------------------------------------------------------------------------------

main() {

  DART_SASS_VERSION=1.97.3
  GO_VERSION=1.25.6
  HUGO_VERSION=0.155.3
  NODE_VERSION=24.13.0

  export TZ=Europe/Oslo

  # 安裝 Dart Sass
  echo "Installing Dart Sass ${DART_SASS_VERSION}..."
  curl -sLJO "https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
  tar -C "${HOME}/.local" -xf "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
  rm "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
  export PATH="${HOME}/.local/dart-sass:${PATH}"

  # 安裝 Go
  echo "Installing Go ${GO_VERSION}..."
  curl -sLJO "https://go.dev/dl/go${GO_VERSION}.linux-amd64.tar.gz"
  tar -C "${HOME}/.local" -xf "go${GO_VERSION}.linux-amd64.tar.gz"
  rm "go${GO_VERSION}.linux-amd64.tar.gz"
  export PATH="${HOME}/.local/go/bin:${PATH}"

  # 安裝 Hugo
  echo "Installing Hugo ${HUGO_VERSION}..."
  curl -sLJO "https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
  mkdir "${HOME}/.local/hugo"
  tar -C "${HOME}/.local/hugo" -xf "hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
  rm "hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
  export PATH="${HOME}/.local/hugo:${PATH}"

  # 安裝 Node.js
  echo "Installing Node.js ${NODE_VERSION}..."
  curl -sLJO "https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-x64.tar.xz"
  tar -C "${HOME}/.local" -xf "node-v${NODE_VERSION}-linux-x64.tar.xz"
  rm "node-v${NODE_VERSION}-linux-x64.tar.xz"
  export PATH="${HOME}/.local/node-v${NODE_VERSION}-linux-x64/bin:${PATH}"

  # 驗證安裝
  echo "Verifying installations..."
  echo Dart Sass: "$(sass --version)"
  echo Go: "$(go version)"
  echo Hugo: "$(hugo version)"
  echo Node.js: "$(node --version)"

  # 配置 Git
  echo "Configuring Git..."
  git config core.quotepath false
  if [ "$(git rev-parse --is-shallow-repository)" = "true" ]; then
    git fetch --unshallow
  fi

  # 構建網站
  echo "Building the site..."
  hugo --gc --minify

}

set -euo pipefail
main "$@"

步驟 3