部署与运维概览

VTJ.PRO 是一套基于 Vue 前端和 NestJS 后端的全栈网站，生产环境需要同时满足高可用、易维护、快速迭代三大目标。下面内容在原有技术实现的基础上。加入了常见使用者痛点及对应解决思路，帮助您在实际落地时少走弯路。

一、基础设施架构 & 常见痛点

痛点 1：Nginx 配置散落，SSL 与静态资源冲突导致页面加载异常。

说到方法。统一使用以下结构化配置，并通过 include 引入子文件，确保 SSL、静态托管和 API 代理互不干扰。

# /etc/nginx/conf.d/vtj-pro.conf
server {
listen 80;其实，server_name vtj.pro www.vtj.pro;return 301 https://$host$request_uri;}
server {
listen 443 ssl http2;server_name vtj.pro www.vtj.pro;其实，# SSL 配置
ssl_certificate /etc/ssl/certs/vtj-pro.crt;ssl_certificate_key /etc/ssl/private/vtj-pro.key;ssl_protocols TLSv1.2 TLSv1.3;ssl_ciphers HIGH:!aNULL:，MD5;# 静态资源根目录
root /home/vtj-pro/frontend/dist;index index.html;老实说，# SPA 路由兼容
location / {
try_files $uri $uri/ /index.html;client_max_body_size 10M;}
# API 代理
location /api/ {
proxy_pass http://127.0.0.1:3000;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;proxy_http_version 1.1;proxy_set_header Connection "";client_max_body_size 20M;}
# 本地上传文件直通
location /uploadfiles/ {
alias /home/vtj-pro/backend/uploadfiles/;autoindex on;expires 30d，不过，}
# 日志
access_log /var/log/nginx/vtj-pro.access.log main;老实说，error_log /var/log/nginx/vtj-pro.error.log warn;}

二、进程管理 & 常见痛点

痛点 2：进程异常退出后无法自动恢复，导致服务短暂不可用。

方法的观点是，采用 PM2 的守护模式并开启日志轮转。其实，

# 启动后端
pm2 start backend/dist/main.js \
--name vtj-pro-api \
--watch false \
--max-restarts 10 \
--restart-delay 3000 \
--log-date-format "YYYY-MM-DD HH:mm:ss"
# 开启程序级守护
pm2 startup
pm2 save
# 日志轮转
pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 50M
pm2 set pm2-logrotate:retain 7

三、发布打包与变体选择 & 常见痛点

痛点 3：手动打包步骤繁琐且易出错。 导致不同环境产物不一致，

从方法来看。统一使用 scripts/publish.mjs 脚本，一键完成前后端建立、资源拷贝还有变体切换。

# 发布脚本示例
import { execSync } from 'child_process';不过，import { copyFileSync。mkdirSync } from 'fs';import path from 'path';// 参数：--variant=full|cloud
const args = process.argv.slice;const variant = args.find)?.split || 'full';console.log，// 前端建立
execSync;// 后端编译
execSync;// 拷贝公共资源
mkdirSync;copyFileSync;copyFileSync;// 根据变体拷贝额外模板或配置
if {
copyFileSync;} else {
copyFileSync;不过，}
console.log;

变体对比表

四、环境变量管理 & 常见痛点

痛点 4：不同环境变量混用导致启动报错或安全凭证泄漏。老实说，

再看方法。

• 所有敏感信息统一放入 .env.production/.env.staging 中；.gitignore 已排除该文件。
• Nginx 与 PM2 均通过 /etc/profile.d/vtj-pro.sh 加载统一的 $VTJ_ENV_PATH,防止进程间变量不一致。
• 前端 Vite 环境变量以 EASY_*/EASY_VITE_* 前缀区分，避免误暴露给浏览器。

# .env.production 示例
# ---------- 数据库 ----------
DB_HOST=127.0.0.1
DB_PORT=3306
DB_USER=vtj_admin
DB_PASSWORD=******
# ---------- 对象存储 ----------
OSS_ENDPOINT=oss-cn-beijing.aliyuncs.com
OSS_ACCESS_KEY_ID=******
OSS_ACCESS_KEY_SECRET=******
# ---------- 安全 ----------
JWT_SECRET=************
AUTH_CODE=************
# ---------- 前端 ----------
VITE_API_URL=https://api.vtj.pro
VITE_SDK_URL=https://sdk.vtj.pro
VITE_STATIC_ROOT=/uploadfiles/

五、运维日常操作 & 常见痛点

5.1 清理与重建

痛点 5：旧建立残留占满硬盘空间，新版本部署失败。

# clean.mjs 示例
import { rmSync } from 'fs';rmSync，rmSync;rmSync，console.log;

5.2 日志监控

Nginx 与 PM2 的日志分别位于：

• 说到Nginx。/var/log/nginx/vtj-pro.access.log & vtj-pro.error.log
• P M2：/home/{user}//.pm2/logs/vtj-pro-api-out.log & vtj-pro-api-error.log
• Kibana/Grafana 可接入 将上述日志统一采集，实现告警和可视化。

5.3 安全加固

• Nginx：仅开放 :80 & :443;禁用 HTTP 方法 PING TRACE CONNECT DELETE PUT OPTIONS PROPFIND PROPPATCH MKCOL COPY MOVE LOCK UNLOCK PATCH SEARCH MERGE NOTIFY SUBSCRIBE UNSUBSCRIBE PURGE LINK UNLINK VIEWPORT CONNECT META REPORT BIND REBIND UNBIND ACL SEARCH PATCH LINK UNLINK VIEWPORT DUMMY..
• P M2：SYSTEMD 启动时指定非 root 使用者（如 appuser);使用 定期检查依赖漏洞，
• 文件权限：/home/vtj‑pro 下全部目录设置为 755 / 644 ,上传目录单独设为 770 .
• Docker 可选：

六、参考资料 & 常见问答

• 至于官方文档，
• 在线演示网站这方面。
• 再看开源仓库，
• PM₂ 官方教程：https://pm2.keymetrics.io/​
• Nginx 官方常用方法：https://nginx.org/en/docs/beginners_guide.html​

通过上述结构化排版并面对使用者最易碰到的“部署复杂”“日志难找”“安全隐患”等痛点提供对应对策，即可明显提高 VTJ.PRO 网站在生产环境中的可用性与运维效率。祝您上线顺利，