概述

这一组文档记录如何从零搭建一个基于 VitePress + themex 的个人网站，并部署到阿里云服务器。它按实际操作顺序组织，目标是以后搭建新站点时，不需要在 Git、Node、Nginx、HTTPS 和微信公众号登录之间来回猜。

适用范围

本文档默认使用：

• VitePress 作为静态站点框架
• themex 作为自定义主题
• GitHub 保存源代码
• 阿里云服务器运行 Node 后端
• Nginx 负责 HTTPS 和反向代理
• 个人公众号验证码登录作为访问控制方案

如果你的公众号不是认证服务号，不能使用带参数二维码登录接口，也不能直接拿到网页授权用户信息。当前方案使用的是“用户给公众号发送验证码，微信消息推送携带 openid，后端校验 openid 白名单”的方式。

推荐阅读顺序

1. 搭建 VitePress 网站
2. 使用 themex 主题
3. 个人公众号验证码登录
4. Git 与 SSH 配置
5. 搭建阿里云服务器环境
6. 配置 Nginx、HTTPS 与 Node 反代
7. 日常维护
8. 常见问题

整体流程

本地写内容
  -> git commit / git push
  -> 服务器 git pull
  -> npm install 或 npm run build
  -> PM2 重启 Node 服务
  -> Nginx 通过 HTTPS 反代到 Node
  -> 用户访问网站
  -> 未登录用户只能看到部分内容
  -> 微信公众号验证码登录后解锁全文

重要原则

• GitHub 提交源代码，不提交构建产物。
• 服务器可以拉源代码，但 Nginx 不要把项目根目录直接暴露给公网。
• .env、本地部署笔记、真实 token、真实 openid 不要提交。
• 每次提交前先看 git status。
• 每次改服务器环境变量后，PM2 重启要带 --update-env。