Skip to content

环境变量 ​

发布脚本 scripts/deploy.py 读取以下环境变量,都可以在命令行前缀里覆盖:

变量默认值说明
SSH_HOST121.43.28.40目标服务器
SSH_USERroot登录用户
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_BACKUPS5备份保留份数

示例 ​

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 读取。

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