↓ 跳过正文

我如何用云服务器搭建个人专属博客的?

·2246 字·5 分钟
求你不要再卷了
作者
求你不要再卷了

首先得有一台服务器。我买的是百度智能云的服务器,用新人首购优惠,花了 99 元买一年。我买到的是这个配置。

配置 规格
CPU 2 核
内存 4 GB
磁盘 80 GB
带宽 6 Mbps

我买的 99 元档现在好像没了。百度智能云还有 2 核 2 GB、59 元/年 的活动,点下面的图可以通过我的推广链接购买,价格以活动页为准。

百度智能云 2 核 2 GB 云服务器 59 元/年,点击参与购买

然后再说博客。我想用 Markdown 写博文,排版不希望太操心。博客最好是静态的,不用读写数据库。我这台服务器就 2 核 4 GB,还要跑别的服务,装得太多怕吃不消。所以我调研了几个博客服务方案。

方案 怎么写文章 部署要准备什么 网页后台
Hugo 支持 Markdown 和 HTML Hugo 构建静态页面,不需要数据库 可接 Decap CMS,用 GitHub 登录
WordPress 在网页端用区块编辑器写 自托管需要 PHP 和数据库 自带后台
Hexo 支持 Markdown 和 HTML 用 Node.js 构建静态页面,不需要数据库 网页编辑需要另外接后台

Hugo 和 Hexo 都可以直接用 HTML 文件写内容。Hugo 默认会忽略混在 Markdown 里的原始 HTML,需要在配置里显式开启。 Hugo 渲染配置 · Hexo 目录说明 · WordPress 环境要求

我自己做 Go 开发,Hugo 也是用 Go 写的,这套技术栈我更熟,就选了 Hugo。

Hugo 装好以后,我先碰到了两个问题
#

  1. 页面太简陋。 我最开始没装主题,首页只有站名和文章列表。能看,但样式很糙。
  2. 发一篇文章太麻烦。 按我最初的部署方式,写完得先登录服务器,把 Markdown 文件放到 content/posts/,再手动跑一次发布脚本。

博客未安装主题时的首页

我用最早那套无主题模板还原的首页。

样式这事我不想自己从头写,就去 Hugo Themes 找现成的,挑了 Hextra 和 Dream。Hextra 的 Blog 页主要展示文章标题和摘要,排得很干净。Dream 把封面、标题和摘要放进卡片。我想在同一个博客里写技术,也放些自己做的小玩意儿,最后选了 Dream。

Hextra 官方 Blog 页

Hextra 的 Blog 页。点图可以看 Demo。

Dream 作者博客的卡片式首页

Dream 作者的博客首页。点图可以看 Demo。

我把 Dream 放到 themes/dream/,然后在 hugo.toml 里启用。

博客名、头像、简介得有;站内搜索、GitHub 和 RSS 这些得加;正文封面图、右侧导航目录、点击图片放大得开。

我的博客文章页,正文右侧显示目录

整体的配置如下:

baseURL = 'https://blog.go-lab.top/'
title = '求你不要再卷了'
theme = 'dream'
# 默认语言用于选择主题译文,locale 用于日期等地区格式。
defaultContentLanguage = 'zh'
locale = 'zh-CN'

[params]
headerTitle = '求你不要再卷了'
# motto 显示在页头,description 用作站点描述。
motto = '后端程序员。分享一些后端技术、AI开发心得和自己做的小玩意儿'
description = '后端程序员。分享一些后端技术、AI开发心得和自己做的小玩意儿'
avatar = 'images/blog-avatar.jpg'
# 浏览器标签页图标,路径相对于站点根目录。
favicon = '<link rel="icon" type="image/png" sizes="64x64" href="/images/blog-icon.png">'
lightTheme = 'emerald'
darkTheme = 'forest'
rss = true
# 按这个顺序显示导航。github 和 products 是下面自定义的入口。
reorderNavItems = ['about', 'search', 'github', 'products', 'posts', 'categories', 'tags', 'rss']
# 文章设置了 cover,封面才会显示在正文顶部。
showSummaryCoverInPost = true
# 从 Markdown 小标题生成目录,桌面端显示在正文右侧。
showTableOfContents = true
imageZoomableInPost = true
# 有相邻文章时,在正文底部显示上一篇或下一篇。
showPrevNextPost = true

# 自定义导航项。target = '_self' 表示在当前标签页打开,icon 使用主题支持的 Ionicons 名称。
[params.navItems.github]
title = 'GitHub'
href = 'https://github.com/super9du'
target = '_self'
icon = 'logo-github'

[params.navItems.products]
title = '作者的产品'
href = '/products/'
target = '_self'
icon = 'planet'

我还想在后台看访问人数,下面再说这些数据从哪来。

发文章不用再登录服务器
#

我希望打开网页就能发文,找了一下,Decap CMS 可以接 Hugo,也能用 GitHub 账号登录。更合我意的是,Decap 写出来的文章就是 Git 仓库里的 Markdown。平时想在自己的编辑器里写,也可以直接改同一套文件。 Decap 的 Hugo 接入指南 · GitHub 登录配置

Decap 点击发布后,实际上是将文件提交到了 Git 的 main 分支。这一步只更新 GitHub 仓库,并不会直接把文章发布到博客网站。所以我想让 GitHub 一有推送,文章就自动发布到我的网站。

我博客的 Decap CMS 文章编辑器

这是我博客的后台。填完内容,左上角就能点发布。

最初 Codex 是通过给我在服务器上设了个半分钟拉取一次 Git 分支的定时任务。我一看这哪成,这不得让 GitHub 给我把服务器封掉嘛,赶紧让 Codex 换了个方案,改用 GitHub Webhook。我在仓库设置里添加服务器的 Webhook 地址,设好签名密钥,只订阅推送事件。服务器校验签名,确认是博客仓库的 main 分支有新提交,才拉取代码、让 Hugo 构建。构建成功就更新页面,失败时线上还能访问上一版。 GitHub Webhook 文档

所以我在电脑上写完,可以预览后推到 GitHub;想用浏览器写,就进后台发布。我的发布记录都在同一个仓库里,服务器也只需要管这一条发布流程。

flowchart TD
    A["本地写 Markdown"] --> C["GitHub 私有仓库 · main"]
    B["Decap CMS 网页后台"] --> C
    C --> D["GitHub 通知服务器,服务器拉取"]
    D --> E["Hugo 构建静态页面"]
    E --> F["Nginx 提供 HTTPS 访问"]

我还想在后台看看文章有多少人读
#

我一开始只想按 Nginx 日志数一下页面请求,后来把这个简单计数撤了。我想知道的是哪些文章有人读、这周访问多不多,最好打开写文章的后台就能看到。

我打算先用开源的 GoAccess 读 Nginx 访问日志,在服务器上定时更新 HTML 报表。这样博客前台不用加统计脚本,也不用另买统计服务。日志按站点区分后,博客和 DeepSearch 可以各自看访问量,有需要也能查哪些路径经常报 404。这里的「独立访客」是按同一天的 IP 和浏览器标识去重得出的估算。 GoAccess 快速入门 · 统计口径

我准备在 Decap CMS 后台顶部加一个「访问统计」入口。登录后就能看今天的独立访客数、和昨天同时段的对比、近 7 天趋势,以及按近 7 天浏览次数排的热门文章。服务器也会检查登录会话,直接打开报表链接也要先登录。

Decap CMS 访问统计看板设计稿,使用模拟数据

统计页的设计稿,图里是模拟数据。

我已经 fork 了 Decap CMS,接下来会把通用入口、报表界面、接入说明和示例配置放到公开 fork,改好后再部署到自己的服务器。真实部署配置、登录密钥、访问日志和报表留在服务器上。 Decap CMS 项目

还有一件事留到最后说。这套博客是我用 Codex 搭起来的。我让它装 Hugo、换 Dream 主题、接 Decap CMS 管理后台,再建 GitHub 仓库,用 Webhook 把自动发布接起来。