Skip to content

快速开始 ​

环境要求 ​

工具版本用途
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

首次发布前必须确认 ​

  1. pc-web/src/data/categories.js 里的 site 对象:站点名、域名、邮箱、ICP 备案号。
  2. deploy.sh 里的服务器地址与账号:建议改用环境变量,不要把密码写进脚本。
  3. 目标服务器已安装 nginx、rsync,且 /var/www/emphant 可写。
  4. 文档与随笔的两个子域已在 DNS 解析到同一台服务器。

发布命令见 构建与发布。

文档随仓库一起更新,站点内容全部在浏览器本地运行。