AIclinicalresearch/docs/05-部署文档/11-Node.js后端-SAE部署配置清单.md

Node.js 后端 - SAE部署配置清单

创建时间：2025-12-24 部署环境：测试环境（Test） 应用名称：nodejs-backend-test 目标规格：1核2GB

---

🔐 生成的强JWT密钥

⚠️ 重要：请妥善保管此密钥，不要泄露！

JWT_SECRET=146c2fd064a69aa026496ee60e20483d07e951eae8323a501126469583433415

密钥特性：

• ✅ 64个十六进制字符（256位强度）
• ✅ 完全随机生成
• ✅ 符合生产环境安全标准

---

📋 完整环境变量配置

方式1：逐个配置（SAE控制台）

在SAE控制台 → 应用配置 → 环境变量中，逐个添加以下配置：

变量名	变量值	说明
DATABASE_URL	postgresql://airesearch:Xibahe%40fengzhibo117@pgm-2zex1m2y3r23hdn5.pg.rds.aliyuncs.com:5432/ai_clinical_research?connection_limit=18&pool_timeout=10	RDS数据库连接（注意@编码为%40）
JWT_SECRET	146c2fd064a69aa026496ee60e20483d07e951eae8323a501126469583433415	🔐 新生成的强密钥
JWT_EXPIRES_IN	7d	JWT过期时间
DEEPSEEK_API_KEY	sk-7f8cc37a79fa4799860b38fc7ba2e150	DeepSeek API密钥
DASHSCOPE_API_KEY	sk-75b4ff29a14a49e79667a331034f3298	阿里千问API密钥
CLOSEAI_API_KEY	sk-cu0ienbXYGGx2jc7BqP6ogtSWmP6fk918qV3RUdtGC3Ed1po	CloseAI代理密钥
CLOSEAI_OPENAI_BASE_URL	https://api.openai-proxy.org/v1	OpenAI代理地址
CLOSEAI_CLAUDE_BASE_URL	https://api.openai-proxy.org/anthropic	Claude代理地址
DIFY_API_URL	http://localhost/v1	Dify服务地址（未部署）
DIFY_API_KEY	dataset-mfvdiKvQ2l3NvxWm7RoYMN3c	Dify API密钥
PORT	3001	服务端口
NODE_ENV	production	运行环境
QUEUE_TYPE	pgboss	队列类型
CACHE_TYPE	postgres	缓存类型
OSS_REGION	oss-cn-beijing	OSS区域
OSS_BUCKET	ai-clinical-research	OSS Bucket名称
OSS_ACCESS_KEY_ID	LTAI5tB2Dt3NdvBL3G7nYGv7	OSS访问密钥ID
OSS_ACCESS_KEY_SECRET	1iSN9k39RkApP93QjUhC1DcPIeMG4V	OSS访问密钥Secret
OSS_ENDPOINT	oss-cn-beijing-internal.aliyuncs.com	OSS内网地址
PYTHON_SERVICE_URL	http://172.17.173.66:8000	Python微服务地址
LOG_LEVEL	info	日志级别

---

方式2：批量导入（推荐）

将以下内容复制，在SAE控制台使用"批量导入"功能：

DATABASE_URL=postgresql://airesearch:Xibahe%40fengzhibo117@pgm-2zex1m2y3r23hdn5.pg.rds.aliyuncs.com:5432/ai_clinical_research?connection_limit=18&pool_timeout=10
JWT_SECRET=146c2fd064a69aa026496ee60e20483d07e951eae8323a501126469583433415
JWT_EXPIRES_IN=7d
DEEPSEEK_API_KEY=sk-7f8cc37a79fa4799860b38fc7ba2e150
DASHSCOPE_API_KEY=sk-75b4ff29a14a49e79667a331034f3298
CLOSEAI_API_KEY=sk-cu0ienbXYGGx2jc7BqP6ogtSWmP6fk918qV3RUdtGC3Ed1po
CLOSEAI_OPENAI_BASE_URL=https://api.openai-proxy.org/v1
CLOSEAI_CLAUDE_BASE_URL=https://api.openai-proxy.org/anthropic
DIFY_API_URL=http://localhost/v1
DIFY_API_KEY=dataset-mfvdiKvQ2l3NvxWm7RoYMN3c
PORT=3001
NODE_ENV=production
QUEUE_TYPE=pgboss
CACHE_TYPE=postgres
OSS_REGION=oss-cn-beijing
OSS_BUCKET=ai-clinical-research
OSS_ACCESS_KEY_ID=LTAI5tB2Dt3NdvBL3G7nYGv7
OSS_ACCESS_KEY_SECRET=1iSN9k39RkApP93QjUhC1DcPIeMG4V
OSS_ENDPOINT=oss-cn-beijing-internal.aliyuncs.com
PYTHON_SERVICE_URL=http://172.17.173.66:8000
LOG_LEVEL=info

---

🚀 SAE应用配置参数

基本信息

应用名称: nodejs-backend-test
部署方式: 容器镜像
命名空间: cn-beijing:test-airesearch
地域: 华北2（北京）

镜像配置

镜像类型: 私有镜像
镜像地址: crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v1.0
镜像版本: v1.0

ACR镜像仓库认证

Registry地址: crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com
用户名: gofeng117@163.com
密码: fengzhibo117

资源配置

CPU: 1核
内存: 2GB
实例数: 1个（固定）

网络配置

VPC ID: vpc-2ze055cptkew9c38w4r06
安全组ID: sg-2zedk6fi8sgmmcwdu7tu

端口配置

容器端口: 3001
协议: TCP

健康检查配置

检查类型: HTTP
检查路径: /health
检查端口: 3001
初始延迟: 30秒
检查间隔: 10秒
超时时间: 3秒
不健康阈值: 3次
健康阈值: 2次

启动命令

node dist/server.js

说明：

• ✅ 不需要执行 prisma migrate deploy（数据已通过pg_dump导入）
• ✅ 不需要执行 prisma generate（镜像构建时已生成）
• ✅ 直接启动编译后的服务即可

---

✅ 部署后验证清单

部署成功后，需要验证以下项目：

1. 应用状态检查

• SAE控制台显示应用状态为"运行中"
• 健康检查显示为"通过"
• 无重启或崩溃记录

2. 日志检查

查看实时日志，应该看到类似以下输出：

============================================================
🚀 AI临床研究平台 - 后端服务器启动成功！
============================================================
📍 服务地址: http://0.0.0.0:3001
🔍 健康检查: http://0.0.0.0:3001/health
📡 API入口: http://0.0.0.0:3001/api/v1
🌍 运行环境: production
============================================================

3. 健康检查测试

获取应用的内网地址后，执行：

curl http://172.17.x.x:3001/health

期望返回：

{
  "status": "ok",
  "timestamp": "2025-12-24T12:00:00.000Z",
  "database": "connected",
  "uptime": 123
}

4. 数据库连接测试

检查日志中是否有数据库连接成功的消息，无报错信息。

5. 记录内网地址

• 记录Node.js后端的内网地址（格式：http://172.17.x.x:3001）
• 更新到部署文档中

---

🎯 后续步骤

Node.js后端部署成功后：

1. 更新前端Nginx配置

   • 将Node.js后端的内网地址配置到前端Nginx
   • 环境变量：VITE_API_BASE_URL=http://172.17.x.x:3001

2. 部署前端Nginx

   • 使用Node.js后端的内网地址
   • 完成前端应用的SAE部署

3. 全链路测试

   • 前端 → Node.js后端 → Python微服务 → RDS
   • 验证完整的业务流程

---

📞 故障排查

问题1：应用无法启动

症状：健康检查一直失败，应用显示"异常"

排查步骤：

1. 查看"实时日志"，检查启动错误
2. 常见原因：
   • DATABASE_URL格式错误（@未编码）
   • 端口配置不匹配
   • 环境变量缺失

问题2：数据库连接失败

症状：日志显示数据库连接超时

排查步骤：

1. 检查RDS白名单是否包含VPC网段（172.17.0.0/16）
2. 检查DATABASE_URL中的密码是否正确编码（@编码为%40）
3. 在SAE的Webshell中测试：

   curl -v telnet://pgm-2zex1m2y3r23hdn5.pg.rds.aliyuncs.com:5432
   

问题3：健康检查路径404

症状：健康检查显示HTTP 404错误

解决方案：

• 确认健康检查路径为 /health（不是 /api/health）
• 确认健康检查端口为 3001

---

🔒 安全注意事项

1. JWT密钥保护：

   • ✅ 已生成强随机密钥
   • ⚠️ 不要将密钥提交到Git
   • ⚠️ 不要在日志中打印密钥

2. 数据库密码保护：

   • ✅ 使用环境变量管理
   • ⚠️ 注意URL编码（@编码为%40）

3. API密钥保护：

   • ✅ 所有LLM API密钥已配置为环境变量
   • ⚠️ 定期轮换密钥

---

文档创建时间：2025-12-24 维护人员：运维团队