*摘要:这是一篇超长的技术记录,详细阐述了一个零基础选手如何从一串打不开的 GitHub 链接出发,跨过网络墙、环境劫持、DNS 死结三道坎,最终把一棵"槐序"种在公网上的全过程。*标签:#博客搭建 #零基础 #AI #Vercel
缘起:一串 404 的链接
一切的开始,是深夜甩过来的一串 GitHub 地址。点开,404。仓库名少了三个字母,真身是 XinghuisamaBlogs,一个毛玻璃风格的 Next.js 博客系统。那天晚上我决定,把它变成自己的。
第一道坎:环境体检
Node v24、npm 11、Git 2.55、Python 3.11,全齐,全是新版本。正要欢呼,发现 python 命令指向的不是系统 Python,而是一个叫 hermes-agent 的虚拟环境,里面连 pip 都没有。环境被"劫持"了。补一针 ensurepip,问题解决。
第二道坎:克隆与点火
GitHub 直连超时,开了全局代理,15.75 MiB 一次拉完。npm install 装了 651 个包,36 秒。Python 依赖自动补齐。启动脚本却闪退,查了半天,是 Start.bat 自己的版本检测有 bug,把 Python 3.11.15 的主版本号误判成了 11。绕开它,直接 python run_me.py,控制台亮了。
第三道坎:双轨同步
这套系统用"双轨同步":本地控制台写作,推 GitHub 私有仓库,Vercel 自动构建上线。配 Deploy Key、智能初始化、同步源码,一步步走完。第一次在浏览器看到 Auto sync source code for Vercel 🚀 的提交记录时,成就感是真的。
第四道坎:域名之战
买了 yun.l2.ink,Vercel 却提示"linked to another account",要求在根域 l2.ink 加一条 TXT 验证。问题在于:面板权限只到子域,根域归平台管。换了个名字 huaixu.l2.ink,一样的坑。最后找到平台社区,发帖让官方帮忙加记录。这件事的教训:共享子域名,验证权永远在别人手里。
装修:煤球与图床
博客上线后开始装修。图床用的是自建的 Cloudflare Workers 图床,博客的图床引擎是兰空格式,接不上,先走外链。AI 猫猫默认接 Gemini,国内用不了,改一行代码接入小米 MiMo,养了一只叫"煤球"的暹罗猫,进度是它已经会叫我铲屎官了。
经验总结
- 链接打不开,先看是不是少了几个字母
- 环境报错,先看
python指向哪 - 共享子域名,验证权不在你手里
- 一切按流程走,暂存、更新、同步、上线,四个按钮就是全部
- 深夜写代码,进度卡在 99% 是常态,但能上线就是胜利
- 这篇文章编者为我的ai助手小槐,看得出来很流水账
