主题
快速开始
环境要求
| 工具 | 版本 | 用途 |
|---|---|---|
| Node.js | ≥ 18(当前用 22.23) | 构建四个站点 |
| npm | ≥ 9(当前用 10.9) | 安装依赖 |
| Python | ≥ 3.8 | 发布脚本 scripts/deploy.py |
| paramiko | 任意近期版本 | SSH / SFTP 上传 |
bash
node -v && npm -v
python3 -c 'import paramiko; print("ok")'paramiko 缺失时:
bash
pip3 install paramiko拉代码并安装依赖
仓库里四个站点各自独立安装依赖,没有 workspace:
bash
cd tools-site
cd pc-web && npm install && cd ..
cd mobile-web && npm install && cd ..
cd docs-site && npm install && cd ..
cd blog-site && npm install && cd ..首次安装大约需要 3~5 分钟,之后有 npm 缓存会快很多。
本地启动
bash
# 电脑版,http://localhost:5173
cd pc-web && npm run dev
# 手机版,http://localhost:5174(--host 允许手机连同一局域网调试)
cd mobile-web && npm run dev
# 文档,http://localhost:5173
cd docs-site && npm run dev
# 随笔,http://localhost:5173
cd blog-site && npm run dev四个站点默认端口都是 5173,同时启动时需要错开:
npx vitepress dev --port 5178。
本地预览构建产物
bash
cd pc-web && npm run build && npm run preview构建产物在各自目录的 dist/,是纯静态文件,可以直接用任意静态服务器打开:
bash
npx serve pc-web/dist首次发布前必须确认
pc-web/src/data/categories.js里的site对象:站点名、域名、邮箱、ICP 备案号。deploy.sh里的服务器地址与账号:建议改用环境变量,不要把密码写进脚本。- 目标服务器已安装 nginx、rsync,且
/var/www/emphant可写。 - 文档与随笔的两个子域已在 DNS 解析到同一台服务器。
发布命令见 构建与发布。