docs(deploy): 补充 /api 反代与生产迁移的踩坑说明
- 静态站点默认没有 /api/ 反代,前端同源 /api 后会全部命中 SPA 回退返回 index.html, 补充现象描述与宝塔「扩展配置」放置位置(面板重写主配置不丢) - 新增「数据库迁移」小节:runMigrations=false 时如何手动执行(含 sequelize-cli 临时安装与 prune) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
parent
1847e17ba7
commit
378e1bf7b1
@ -171,6 +171,32 @@ server {
|
||||
宝塔面板:站点 `oms.gztbyc.com` 的**网站目录**设为 `/www/wwwroot/oms.gztbyc.com/current`,
|
||||
并删掉指向 `127.0.0.1:6090` 的旧 `/api` 反代,改成上面的 `include`。
|
||||
|
||||
> ⚠️ 静态站点默认只有 `location / { try_files $uri $uri/ /index.html; }`,**没有 `/api/` 反代**:
|
||||
> 前端改成同源 `/api` 后,所有接口都会命中 SPA 回退返回 `index.html`(表现为「配置没生效」、
|
||||
> 刷新页面正常但任何接口都拿不到数据)。缺这一段时 `curl https://<站点域名>/api/auth/wechat/enabled`
|
||||
> 会返回 HTML 而不是 JSON。
|
||||
>
|
||||
> 宝塔面板改「网站目录 / 伪静态」会重写站点主配置,建议把 `/api/` 反代放进
|
||||
> 站点 → 设置 → 配置文件 → **扩展配置**(实际落盘 `/www/server/panel/vhost/nginx/extension/<域名>/*.conf`),
|
||||
> 用 `location ^~ /api/ { include .../nginx-upstream.conf; proxy_set_header ...; }`,面板重写主配置也不会丢。
|
||||
|
||||
### 数据库迁移
|
||||
|
||||
发布脚本默认 `runMigrations: false`(见 `config/deploy.config.local.cjs`),不会执行迁移。
|
||||
新增迁移后有两种做法:
|
||||
|
||||
1. 发布前把该配置改成 `true`(发布流程第 4 步会跑 `npm run migration:up`,失败即中断本次发布);
|
||||
2. 发布后到**当前活跃版本目录**手动执行:
|
||||
|
||||
```bash
|
||||
cd /www/wwwroot/api.oms.gztbyc.com/v1 # 版本看 current.md
|
||||
npm install --no-save sequelize-cli@6.6.5 # 生产依赖是 npm install --production,不含 sequelize-cli
|
||||
node_modules/.bin/sequelize-cli db:migrate
|
||||
npm prune --omit=dev --no-audit --no-fund # 跑完清掉临时装的开发依赖
|
||||
```
|
||||
|
||||
迁移前建议先备份:`mysqldump ... --single-transaction | gzip > .deploy/backups/db-<时间>.sql.gz`。
|
||||
|
||||
### 服务器端 `.env`(仅首次,之后由 shared-config 管理)
|
||||
|
||||
需要包含:`MYSQL_*`、`REDIS_*`、`JWT_SECRET`、`UPLOAD_DIR=<deployRoot>/uploads`(版本目录之外,
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user