在 Ubuntu LXC 用 Docker 部署 Hugo 個人網誌

Mon, 18 May 2026 00:00:00 +0000

前言

最近想把學習過程和筆記整理成網誌，選擇了 Hugo 這個 static site generator。因為運行環境是 Proxmox VE 上的 Ubuntu LXC（無特權容器），有一些需要注意的地方。這篇文章完整記錄從零開始部署 Hugo + PaperMod 主題到 Cloudflare Pages 的全过程。

環境準備

作業系統：Proxmox VE 上的 Ubuntu 24.04 LXC（無特權容器）
容器技術：Docker
Hugo 版本：使用 hugomods/hugo:exts Docker 映像檔（內含最新版 Hugo Extended）
部署平台：Cloudflare Pages（免費方案）

為什麼要用 Docker？

Hugo 的安裝方式很多，有 apt 安裝、go install、官方安裝腳本等。但這裡我選擇用 Docker 的原因很簡單：

版本隔離：不需要在宿主機安裝 Hugo，不會跟其他套件衝突
隨時更新：只要拉最新的 Docker 映像檔，就是最新版 Hugo
一致性：本地開發和雲端部署使用相同環境，減少版本差異問題

而且這個專案用的 hugomods/hugo:exts 映像檔內建的是 Hugo Extended 版本，支援 SCSS/SASS 編譯——PaperMod 主題需要這個功能。

第一步：建立 Hugo 網站

在 LXC 環境中，因為是無特權容器，sysctl 權限有限，Docker 的 bridge 網路常常建立失敗。所以所有 docker run 指令都要加上 --network host。

Docker on 凱凱的個人網誌

在 Ubuntu LXC 用 Docker 部署 Hugo 個人網誌

前言

環境準備

為什麼要用 Docker？

第一步：建立 Hugo 網站