HUGO
Menu
GitHub 87548 stars Mastodon

在 GitLab Pages 上托管

在 GitLab Pages 上托管您的網站。

假設

  • 熟悉使用 Git 進行版本控制
  • 完成 Hugo [快速入門]
  • 擁有 GitLab 賬戶
  • 在本地計算機上准備好發布的 Hugo 網站

BaseURL

如果您使用默認 GitLab Pages URL(例如 https://<YourUsername>.gitlab.io/<your-hugo-site>/)而不是自定義域名,則 網站配置 中的 baseURL 必須反映 GitLab pages 倉庫的完整 URL。

配置 GitLab CI/CD

通過在項目根目錄創建 .gitlab-ci.yml 文件來定義您的 CI/CD 作業。

.gitlab-ci.yml
variables:
  # 應用程序版本
  DART_SASS_VERSION: 1.97.3
  HUGO_VERSION: 0.155.3
  NODE_VERSION: 24.13.0
  # Git
  GIT_DEPTH: 0
  GIT_STRATEGY: clone
  GIT_SUBMODULE_STRATEGY: recursive
  # 時區
  TZ: Europe/Oslo

image:
  name: golang:1.25.6-bookworm

pages:
  stage: deploy
  script:
    # 為用戶特定的可執行文件創建目錄
    - echo "Creating directory for user-specific executable files..."
    - mkdir -p "${HOME}/.local"

    # 安裝實用工具
    - echo "Installing utilities..."
    - apt-get update
    - apt-get install -y brotli xz-utils zstd

    # 安裝 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}"

    # 安裝 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)"
    - "echo brotli: $(brotli --version)"
    - "echo xz: $(xz --version)"
    - "echo zstd: $(zstd --version)"

    # 安裝 Node.js 依賴
    - echo "Installing Node.js dependencies..."
    - "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci --prefer-offline || true"

    # 配置 Git
    - echo "Configuring Git..."
    - git config core.quotepath false

    # 構建網站
    - echo "Building site..."
    - hugo --gc --minify --baseURL "${CI_PAGES_URL}"

    # 壓縮發布的文件
    - echo "Compressing published files..."
    - find public/ -type f -regextype posix-extended -regex '.+\.(css|html|js|json|mjs|svg|txt|xml)$' -print0 > files.txt
    - time xargs --null --max-procs=0 --max-args=1 brotli --quality=10 --force --keep < files.txt
    - time xargs --null --max-procs=0 --max-args=1 gzip -9 --force --keep < files.txt
  artifacts:
    paths:
      - public
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

將 Hugo 網站推送到 GitLab

接下來,在 GitLab 上創建新倉庫。不必將倉庫設為公開。此外,您可能想將 /public 添加到 .gitignore 文件,因為無需將編譯的資源推送到 GitLab 或將輸出網站保留在版本控制中。

# 初始化新的 git 倉庫
git init

# 將 /public 目錄添加到 .gitignore 文件
echo "/public" >> .gitignore

# 提交並將代碼推送到 master 分支
git add .
git commit -m "Initial commit"
git remote add origin https://gitlab.com/YourUsername/your-hugo-site.git
git push -u origin master

等待頁面構建

就是這樣!您現在可以在 https://gitlab.com/<YourUsername>/<your-hugo-site>/pipelines 關注 CI 代理構建您的頁面。

構建通過後,您的新網站可在 https://<YourUsername>.gitlab.io/<your-hugo-site>/ 訪問。

後續步驟

GitLab 支持使用自定義 CNAME 和 TLS 證書。有關 GitLab Pages 的更多詳情,請參閱 GitLab Pages 設置文檔


Last updated: January 1, 0001
Improve this page