在 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 设置文档。