主题
环境变量
发布脚本 scripts/deploy.py 读取以下环境变量,都可以在命令行前缀里覆盖:
| 变量 | 默认值 | 说明 |
|---|---|---|
SSH_HOST | 121.43.28.40 | 目标服务器 |
SSH_USER | root | 登录用户 |
SSH_PASS | 脚本内置 | 登录密码,建议用环境变量传入 |
REMOTE_PC | /var/www/emphant | 电脑版发布目录 |
REMOTE_M | /var/www/emphant/m | 手机版发布目录 |
REMOTE_DOCS | /var/www/emphant-docs | 文档站发布目录 |
REMOTE_BLOG | /var/www/emphant-blog | 随笔站发布目录 |
KEEP_BACKUPS | 5 | 备份保留份数 |
示例
bash
# 临时换服务器
SSH_HOST=1.2.3.4 SSH_PASS='***' ./deploy.sh pc
# 换发布目录(例如灰度到 /var/www/emphant-next)
REMOTE_PC=/var/www/emphant-next ./deploy.sh pc --skip-build
# 少留几份备份
KEEP_BACKUPS=2 ./deploy.sh docs安全建议
- 不要把密码写进 shell 历史:用
read -s SSH_PASS或.env文件(并加入.gitignore); - 更好的做法是配 SSH 免密(
ssh-copy-id),然后把脚本里的默认密码删掉; - 发布账号如果不用 root,需要目标目录的写权限与
nginx -t的执行权限。
构建期变量
VitePress 与 Vite 都支持 .env,但当前四个站点没有依赖任何构建期变量:域名、备案号、联系方式都写在源码里(pc-web/src/data/categories.js、两个 VitePress 的 config.mts)。
如果要接 CDN 或灰度域名,建议把 hostname 抽成 .env 的 SITE_ORIGIN,在 config.mts 里用 process.env 读取。