enmanuelmoreira/hugo

Hugo Docker镜像

![流水线状态]([***]

Hugo 是一款快速灵活的静态网站生成器，使用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/。

要了解更多，请阅读 Hugo文档。

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 等命令。

支持的标签

最新构建版本：

• latest

版本列表：

• 0.120.4 - 常规版本
• 0.120.4-ext - 扩展版本

完整标签列表可在 Docker Store页面 查看。

用户

默认情况下，此Docker镜像以root用户运行。这使其易于作为其他Dockerfile的基础镜像（频繁切换用户会增加额外层，不符合Docker当前建议的最佳实践）。大多数（所有官方？）基础镜像默认用户为root。

不过，此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镜像有任何问题或疑问，请通过 GitLab issue 联系我。如果问题与Hugo本身相关，请在 https://github.com/gohugoio/hugo 提交issue。

贡献

欢迎通过 GitLab Merge Request 为本容器贡献新功能、修复或更新。

灵感与特别感谢

本项目的灵感来自于以下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