Hugo 静态网站部署指南，本地到 VPS 实战操作

你有一个 Hugo 项目，想把它部署到 VPS 上，以便在服务器上生成静态网站，而不是依赖于浏览器，如何实现这个目标呢？别担心，我来一步步教你。

准备阶段

确保 VPS 基础配置

在 VPS 上运行 Hugo 需要一些基础配置，确保你的 VPS 有以下配置：

• 操作系统： Hugo 支持 Ubuntu、Fedora 等Linux版本。
• HTTP 服务： 确保 Apache 或 Nginx 安装并配置好。
• SSH 访问： 确保 VPS 上有SSH权限，方便后续操作。

操作：检查系统版本，确保符合 Hugo 的最低要求。

示例命令：

ls -la

安装依赖

安装 Hugo 和其依赖项：

sudo apt-get update && sudo apt-get install -y \
    hugo \
    git \
    python3 \
    python3-jinja2

解释：安装 Hugo、Git、Python 和 Jinja2 模块，这些是 Hugo 运行所需的工具。

Hugo 部署步骤

安装 Hugo 的关键组件

Hugo 需要安装以下组件：

• Hugo 本身： 通过官方仓库安装。
• Gin 作为中间件： 提高性能。
• GFM 作为语法转换器： 支持GitHub Flavored Markdown。
• Markdown 扩展： 支持多种 Markdown 格式。

操作：

# 安装 Hugo
sudo apt-get update && sudo apt-get install -y \
    hugo \
    git \
    python3 \
    python3-jinja2
# 安装 GFM 和 Markdown 扩展
sudo apt-get install -y \
    hugo-ext-gfm \
    hugo-ext-markdown

配置 Hugo

配置 Hugo 以适应你的需求：

# 添加 GFM 语法转换器
{{ set config.gfm enabled = 'true' }}
# 添加 Markdown 扩展
{{ set config.markdown = 'kramdown' }}

解释：通过配置文件让 Hugo 支持GitHub的Markdown格式和Kramdown渲染器。

配置 VPS 端点

告诉 Hugo 如何通过SSH或HTTPS访问你的VPS：

<VirtualHost *:80>
    ServerName your-vps-name
    DocumentRoot /var/www/{domain}
    <Directory /var/www/{domain}>
        AllowOverride All
        <Options -MultiViews>
            <Option "(SSP)" value="on" />
            <Option "X-Frame-Options" value="Deny" />
        </Options>
        <SetEnv PATH_INFO ${uri:.*} />
        <SetEnv SCRIPT_FILENAME $uri>
        <AddHandler hitron-judge">
            <Directory /var/www/{domain}/static
                DenyAll
                Require all granted
            </Directory>
        </AddHandler>
    </Directory>
</VirtualHost>

解释：配置 Apache 子配置，指定域名和HTTPS，允许Hugo访问VPS上的静态文件。

生成配置文件

生成配置文件后,运行 Hugo：

hugo --config

解释：Hugo 会生成一个hugo.conf文件，包含你配置的所有内容。

测试部署

访问 VPS

通过SSH访问你的VPS：

ssh -i ~/.ssh/id_rsa your-vps-name

运行 Hugo

在VPS上运行 Hugo：

hugo

解释：Hugo 会生成静态网站文件，通常位于public或static目录下。

注意事项

• 权限：确保所有用户都有适当的访问权限。
• 日志：检查Hugo和Apache的日志，确保没有错误。
• 测试：在测试环境中部署，避免影响生产环境。

通过以上步骤,你已经成功将本地的Hugo项目部署到VPS上，这样，你的静态网站可以在服务器上运行，无需依赖浏览器，希望这篇指南能帮助你顺利完成部署。