enmanuelmoreira/hugo

Hugo Docker镜像

https://gitlab.com/enmanuelmoreira/hugo/badges/main/pipeline.svg](https://gitlab.com/enmanuelmoreira/hugo/-/commits/main) https://img.shields.io/docker/pulls/enmanuelmoreira/hugo](https://hub.docker.com/r/enmanuelmoreira/hugo/)

https://gohugo.io/ 是一款快速灵活的静态网站生成器，使用Go语言编写。它能灵活处理多种格式，非常适合博客、文档、作品集等场景。Hugo的速度优势激发创作灵感，让网站构建重新变得有趣。

本轻量级Docker镜像基于Debian构建，并包含rsync以支持持续部署。

快速开始

打印Hugo帮助信息：

bash
docker run --rm -it enmanuelmoreira/hugo:latest hugo help

创建新的Hugo管理网站：

bash
docker run --rm -it -v $PWD:/src -u hugo enmanuelmoreira/hugo:latest hugo new site mysite
cd mysite

# 现在，你可能需要添加一个主题（参见 https://themes.gohugo.io/）：
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke;
echo 'theme = "ananke"' >> config.toml

添加内容：

bash
docker run --rm -it -v $PWD:/src -u hugo enmanuelmoreira/hugo:latest hugo new posts/my-first-post.md

# 现在，你可以编辑这篇文章，添加内容并移除"draft"标记：
xdg-open content/posts/my-first-post.md

构建网站：

bash
docker run --rm -it -v $PWD:/src -u hugo enmanuelmoreira/hugo:latest hugo

本地服务网站：

bash
docker run --rm -it -v $PWD:/src -p 1313:1313 -u hugo enmanuelmoreira/hugo:latest hugo server -w --bind=0.0.0.0

然后在浏览器中打开 http://localhost:1313/%E3%80%82

要了解更多，请阅读 https://gohugo.io/documentation/%E3%80%82

Bash别名

为方便使用，你可以创建bash别名：

bash
alias hugo='docker run --rm -it -v $PWD:/src -u hugo enmanuelmoreira/hugo:latest hugo'
alias hugo-server='docker run --rm -it -v $PWD:/src -p 1313:1313 -u hugo enmanuelmoreira/hugo:latest hugo server --bind 0.0.0.0'

现在，你可以使用 hugo help、hugo new foo/bar.md、hugo-server -w 等命令。

支持的标签

最新构建版本：

• https://gitlab.com/enmanuelmoreira/hugo/-/blob/main/docker/extended/Dockerfile.ubuntu

版本列表：

• https://gitlab.com/enmanuelmoreira/hugo/-/blob/main/docker/Dockerfile - 常规版本
• https://gitlab.com/enmanuelmoreira/hugo/-/blob/main/docker/extended/Dockerfile.extended - 扩展版本

完整标签列表可在 https://store.docker.com/community/images/enmanuelmoreira/hugo/tags 查看。

用户

默认情况下，此Docker镜像以root用户运行。这使其易于作为其他Dockerfile的基础镜像（频繁切换用户会增加额外层，不符合Docker当前建议的https://docs.docker.com/engine/userguide/eng-image/dockerfile_best-practices/#user%EF%BC%89%E3%80%82%E5%A4%A7%E5%A4%9A%E6%95%B0%EF%BC%88%E6%89%80%E6%9C%89%E5%AE%98%E6%96%B9%EF%BC%9F%EF%BC%89%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E9%BB%98%E8%AE%A4%E7%94%A8%E6%88%B7%E4%B8%BAroot%E3%80%82

不过，此Docker镜像也定义了非root用户 hugo（UID 1000，GID 1000），可在运行时使用 --user 标志切换：

bash
docker run --rm -it -v $PWD:/src --user hugo enmanuelmoreira/hugo:latest hugo

你也可以根据需要修改UID/GID。例如，以 www-data:www-data 用户（UID 33，GID 33）运行hugo：

bash
docker run --rm -it -v $PWD:/src -u 33:33 enmanuelmoreira/hugo:latest hugo

此Docker镜像还包含：

• rsync
• git
• openssh-client
• https://github.com/tdewolff/minify

Docker Compose

常规构建：

yaml
  build:
    image: enmanuelmoreira/hugo:0.97.3
    volumes:
      - ".:/src"

运行服务器：

yaml
  server:
    container_name: hugo-server
    image: enmanuelmoreira/hugo:0.97.3
    command: server # 添加更多hugo命令参数
    volumes:
      - ".:/src"
    ports:
      - "1313:1313"

启动容器：

bash
docker-compose up -d

问题反馈

如果对此Docker镜像有任何问题或疑问，请通过 https://gitlab.com/enmanuelmoreira/hugo/-/issues 联系我。如果问题与Hugo本身相关，请在 https://github.com/gohugoio/hugo 提交issue。

贡献

欢迎通过 https://gitlab.com/enmanuelmoreira/hugo/-/merge_requests 为本容器贡献新功能、修复或更新。

灵感与特别感谢

本项目的灵感来自于以下Hugo构建项目：https://github.com/jguyomard/docker-hugo%EF%BC%8C%E9%9D%9E%E5%B8%B8%E6%84%9F%E8%B0%A2%EF%BC%81

作者

Enmanuel Moreira