VPS 博客运维：常用 Linux 与 Hugo 命令手册

在搭建 Hugo 博客的过程中，这些命令是我使用频率最高的“神兵利器”。现整理如下，方便日后查阅。

📂 文件与目录操作

#

• cd /var/www/my-website
  • 功能：切换目录。进入博客项目的根目录，这是所有 Hugo 操作的前提。
• ls -F
  • 功能：列出当前目录下的文件。查看主题、文章内容是否都在正确的位置。
• mv /旧路径 /新路径
  • 功能：移动或重命名文件。例如将项目从 /root 移到 /var/www 以解决 Nginx 权限问题。
• rm -rf public/
  • 功能：强制删除目录。在切换主题或内容大改后，清理旧的静态网页文件。

🛠 系统权限与服务

#

• sudo chown -R www-data:www-data /var/www/my-website
  • 功能：递归修改所属用户。让 Nginx 拥有读取博客文件的权限，解决 404/403 报错。
• sudo systemctl restart nginx
  • 功能：重启 Nginx 服务。修改配置文件（如网站路径、域名）后必须执行此步。
• grep "root" /etc/nginx/sites-available/default
  • 功能：搜索配置。快速确认 Nginx 当前指向的网页根目录。

✍️ Hugo 核心命令

#

• hugo new posts/文件名.md
  • 功能：创建新文章。它会自动生成带有时间戳和标题的 Markdown 模板。
• hugo
  • 功能：构建静态网站。将 Markdown 文件渲染成浏览器能识别的 HTML/CSS。
• nano hugo.toml
  • 功能：编辑配置文件。用于修改博客名称、切换主题或调整首页显示效果。

🌐 网络与解析

#

• git clone 链接
  • 功能：从 GitHub 下载主题到 themes 文件夹。
• cat <<EOF | sudo tee 文件名
  • 功能：批量写入内容。这是一种在终端快速生成或覆盖配置文件的“高级姿势”。

温馨提示：每次修改完 hugo.toml 或文章后，记得运行一遍 hugo 命令，并去 Cloudflare 清理缓存。

本手册由 Gemini 总结提供，助你轻松掌控 VPS！