Ming 的博客

用 Hugo 十分钟搭一个静态博客

Thu, 20 Aug 2026 00:00:00 +0000

静态博客是个人网站的最优选：快、安全、零维护。这篇记录我用 Hugo 搭建博客的完整流程。

为什么选 Hugo

单二进制，安装即用，没有 Node 依赖
构建极快，几百篇文章也是秒级
主题丰富，hugo-blog-awesome 这类主题开箱即大气
原生支持分类（Categories）和标签（Tags）

三步上手

# 1. 安装 Hugo (macOS / Linux / Windows 都有对应版本)
brew install hugo          # macOS
sudo apt install hugo      # Ubuntu/Debian

# 2. 创建站点
hugo new site myblog
cd myblog

# 3. 安装主题 + 写第一篇文章
git clone https://github.com/hugo-sid/hugo-blog-awesome.git themes/hugo-blog-awesome
hugo new posts/hello.md
hugo server -D             # 本地预览 http://localhost:1313

写文章

文章就是带 front matter 的 Markdown 文件，分类通过 categories 字段声明：

---
title: "我的第一篇文章"
date: 2026-08-20
categories: ["技术"]
tags: ["Hugo"]
---

正文内容...

发布

hugo --minify     # 生成 public/ 静态目录
# 把 public/ 里的文件丢到 Nginx / GitHub Pages 即可

静态博客最爽的地方：构建产物就是一堆文件，部署到哪都行。

VPS 部署全记录：从裸机到 HTTPS

Wed, 19 Aug 2026 00:00:00 +0000

第一次用 VPS 部署网站，踩了不少坑，把关键步骤整理出来。

基础环境

# Ubuntu 22.04 为例
sudo apt update && sudo apt upgrade -y
sudo apt install -y nginx python3 python3-venv git

Nginx 反向代理

让 Nginx 监听 80 端口，把动态请求转发给本地服务（比如 Gunicorn 起的 5000 端口）：

server {
    listen 80;
    server_name your-domain.com;

    # 静态文件直接服务
    location / {
        root /var/www/blog/public;
        try_files $uri $uri/ =404;
    }

    # 动态接口转发
    location /api/ {
        proxy_pass http://127.0.0.1:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

免费 HTTPS

用 Let’s Encrypt 五分钟搞定：

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com

证书到期前 certbot 会自动续期，一劳永逸。

给自己的网站做访客统计：IP、地理、设备一个不少

Tue, 18 Aug 2026 00:00:00 +0000

第三方统计（百度统计、Google Analytics）把数据都留在别人那里。自建一套轻量追踪，数据完全归自己。

原理

追踪 = 服务端捕获 + 客户端上报，双通道互补：

服务端：每次请求都能拿到 IP 和全部 HTTP 头，即使用户禁用 JS 也逃不掉
客户端：浏览器里能拿到屏幕分辨率、GPU 型号、时区、Canvas 指纹等更细的信息

服务端要点

Flask 里提取真实 IP 要穿透代理链：

def get_client_ip(request):
    # 优先取代理链头
    fwd = request.headers.get("X-Forwarded-For", "")
    if fwd:
        return fwd.split(",")[0].strip()
    return request.remote_addr

拿到 IP 后用 ip-api.com 免费接口定位国家、城市、经纬度。

客户端要点

// 一个 fetch 就把数据发回去
fetch("/collect", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
        screenWidth: screen.width,
        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
        canvasFingerprint: getCanvasHash(),
        // ...更多字段
    }),
    keepalive: true
});

数据存哪

SQLite 就够了，单文件无运维成本。数据量大了再平滑迁移 PostgreSQL。

别忘了合规

采集访客信息前，务必在网站加隐私政策，说明收集了哪些数据、用来做什么。这是底线。

Markdown 写作指南：从入门到排版自如

Sat, 15 Aug 2026 00:00:00 +0000

Markdown 让你专注于内容而不是排版。写博客、写 README、写笔记，一套语法全搞定。

常用语法速查

效果	语法
标题	`# 一级` `## 二级` `### 三级`
加粗	`加粗`
斜体	`斜体`
链接	`[文字](https://example.com)`
行内代码	`code`
引用	`> 引用内容`

代码块

def hello(name):
    print(f"Hello, {name}!")

列表

无序列表用 -，有序列表用 1. 2. 3.，嵌套缩进即可。

排版小技巧

每段只表达一个意思，短段落比长段落更好读
列表和表格能大幅提升可读性
插入分隔线用 ---，注意和标题语法区分
中文排版习惯：中英文之间加一个空格，比如 使用 Hugo 写博客

进阶

图床 / 图片引用
数学公式（KaTeX / MathJax）
Mermaid 流程图

需要的时候再学，Markdown 的核心就是：简单到让你忘记格式。

八月读书：三本值得反复读的书

Wed, 12 Aug 2026 00:00:00 +0000

这个月的阅读书单，三本完全不同领域的书，但都值得反复读。

《代码整洁之道》

关于"什么是好代码"最经典的回答。读完最大的收获：代码是写给人看的，顺便让机器执行。命名的艺术、函数的单一职责、注释的真正用途，每一章都值得对照自己的代码反思。

让营地比你来时更干净。

《深度工作》

在信息爆炸的时代，专注本身就是稀缺能力。书中给出了可操作的规则：深度工作要安排进日程而不是靠意志力，减少浅层工作的占比，固定仪式感。

《写作这回事》

斯蒂芬·金的自传式写作教程。没有玄乎的理论，核心就是两个字：多写。去掉多余的副词、多用动词、写完放一放再改。

一点感想

技术书、效率书、写作书各一本，交叉阅读的乐趣在于：它们其实在讲同一件事——把复杂的事情做得简单、干净、可维护。

你好，世界：博客开张了

Mon, 10 Aug 2026 00:00:00 +0000

折腾了几天，这个博客终于上线了。

为什么要写博客

对抗遗忘 —— 踩过的坑、想通的道理，写下来才真正属于自己
整理思路 —— 把一个想法讲清楚，比在脑子里想十遍更有用
连接同好 —— 也许某篇文章能帮到屏幕前的另一个人

这里会写什么

技术实践：部署、开发、工具链
学习笔记：书、课程、思考
生活记录：偶尔的碎碎念

技术栈

这个站基于 Hugo + hugo-blog-awesome 主题，静态托管在自己的 VPS 上，用 Nginx 提供服务。没有花哨的东西，内容才是主角。

第一篇就先这样。接下来，保持记录。