Hugo + GitHub Pages 绑定自定义域名完整指南

前言 之前一直使用 GitHub Pages 默认的域名 QwQBiG.github.io,虽然免费但不够专业。毕竟在 Cloudflare 买了 iqwqi.win 域名,决定将博客绑定到这个自定义域名上。本文详细记录整个配置流程。 准备工作 现有环境 博客框架: Hugo 托管平台: GitHub Pages 域名注册: Cloudflare 原域名: QwQBiG.github.io 新域名: iqwqi.win 配置目标 主域名 iqwqi.win 访问博客 www.iqwqi.win 自动跳转到主域名 QwQBiG.github.io 自动跳转到新域名 启用 HTTPS 配置步骤 第一步:修改 Hugo 配置 编辑 hugo.toml 文件,修改 baseURL: 1 2 3 4 5 # 修改前 baseURL = "https://QwQBiG.github.io/" # 修改后 baseURL = "https://iqwqi.win/" 作用: 确保生成的所有链接都使用新域名。 第二步:创建 CNAME 文件 在 static/ 目录下创建 CNAME 文件(无后缀): 1 2 static/ └── CNAME # 新建此文件 文件内容: ...

March 3, 2026 · 2 min · map[name:QwQBiG]

史诗级 ”Hello World“:如何从0到1(划掉)搭建个人技博(技术博客)

你好,世界! 多年之后,看到这些文字,如今的你,是否还会想起,多年前看b站视频打印"hello world!“的那个遥远的下午… 如果你能看到这篇文章,那说明我成功了。作为一只冲浪老资历,我一直梦想拥有一个属于自己的、可以记录学习笔记、分享心得的个人博客(东方homo馆)。这便是我的”Hello World“——一个通往更广阔数字世界的起点。(兴许是"读瘾"犯了,要写点东西自己咂摸) 溯洄从之,道阻且长。如同伊人,此间追寻的过程远比我想象的要曲折,但也比我想象的要收获更多。我遇到了各种各样的问题:从 Docker 的内网穿透失败(其实成功了(但是https)),到 Windows 开发环境的重重陷阱,再到网络连接的神秘莫测,最后到项目结构的频频阻折… 所幸“时来天地皆同力”,假借实验室老老资历学长给的焚诀(代理,ai,服务器的一块ubuntu…)得以为今后的所有故事作一个序。 而我的感觉是:尽管ai飞速发展,博客、论坛、群聊比比皆是,我自己搜寻资料时,找相应操作时,或者找一些有的没有的奇怪资源时,还是有些力不从心(哈基米赛高(25.11));加上我喜欢鼓捣些长久的、有趣的、有意味(意味深)的东西,顾影自怜,自我怀念,比如写诗著文,都是些艺术形式,于是便有了这个界面的出现。 谁不想要一个自己的文章网站呢~ 现在,我想把这条被我”踩“出来的、不怕ta”爱而不见“的路,分享给你。 最终技术栈 内容生成:Hugo (静态网站生成器) 免费托管:GitHub Pages (”免费虚拟主机“) 版本控制:Git (”时光机“,记录你的每一次修改) 域名:GitHub Pages 自带 username.github.io 或自定义域名 前置准备:Windows 开发环境搭建 1. 安装 Scoop (Windows 的包管理器) 打开一个普通用户权限的 PowerShell 窗口(不要"以管理员身份运行”),执行以下两条命令: 1 2 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser irm get.scoop.sh | iex 这里有趣的是如果管理员运行会报错,这是因为Scoop 的 “用户级” 设计哲学,十分不错。 2. 安装所有核心工具 拥有了 Scoop,我们就可以一键安装所有需要的软件。 1 2 3 4 5 6 7 8 9 10 11 12 # 安装 Git (版本控制) scoop install git # 安装 Go 语言 (Hugo 模块系统依赖) scoop install go # 安装 Hugo (网站生成器) scoop install hugo # 安装 VS Code (代码编辑器), 需要先添加 'extras' 仓库 scoop bucket add extras scoop install vscode 创建你的 Hugo 网站 1. 创建站点 1 2 3 4 5 6 # 创建一个名为 'myblog' 的新站点 hugo new site myblog cd myblog # 初始化 Git 仓库 git init 2. 添加主题 这里使用 PaperMod 主题,它简洁、快速且功能丰富: ...

November 13, 2025 · 2 min · map[name:QwQBiG]
Loading...