Nginx 代理与 HTTPS
本章目标
使用正式 HTTPS 域名访问前台与 /admin/ 后台。
操作步骤
- 宝塔添加对应域名站点,申请覆盖该域名的证书。
- 按发行包 infra/nginx/yumxq-baota.conf 配置 location,将其中的目录替换为 /www/wwwroot/yume-site。
- 核对代理中的 3003、3004 是否与本站环境一致。
- 保存前执行 Nginx 配置检查,通过后平滑重载并启用 HTTPS。
必须保留的路由关系
| 路径 | 处理方式 |
|---|---|
| / | 代理到 Nuxt 官网 3003 |
| /api/v1/ 与 /api/session/ | 通过 Nuxt 会话与 CSRF 代理 |
| /admin/ | 后台静态文件 apps/admin/dist |
| /admin-api/ | 去掉该前缀后代理到 API 3004 |
| /uploads/ | 通过 API 核验公开图片 |
| 支付回调、外部授权接口 | 按包内配置精确直达 API |
不能将全部 /api/ 直接代理给 NestJS,否则可能破坏登录、Cookie 和 CSRF。代理应保留 Host 与 X-Forwarded-Proto。公开图片不等于允许公开私有源码 ZIP 或整个 .local 目录。
完成检查
nginx -t
curl -f https://example.com/api/v1/health
curl -f https://example.com/admin-api/api/v1/health打开 https://example.com/ 与 https://example.com/admin/,确认无证书错误、后台资源 404 或混合内容。新站首页为空白内容区可能只是尚未配置首页模块。
部署遇到问题?
带上当前章节与适用版本,让助手帮你查找解决步骤。

