Files
happy-life-star/SERVER_DEPLOYMENT_CHECKLIST.md
T

6.0 KiB
Raw Blame History

服务器部署检查清单

📋 部署前检查

🖥️ 服务器要求

  • 操作系统: Linux (Ubuntu 18.04+, CentOS 7+, Debian 9+)
  • CPU: 2核心以上
  • 内存: 4GB以上(推荐8GB
  • 磁盘: 20GB以上可用空间
  • 网络: 稳定的互联网连接

🔧 软件环境

  • Docker: 20.10+ 已安装
  • Docker Compose: 1.29+ 已安装
  • Git: 已安装(可选)
  • Curl/Wget: 已安装

🌐 网络配置

  • 端口开放: 80, 443 已开放
  • 防火墙: 已配置允许HTTP/HTTPS流量
  • 域名解析: 域名已正确解析到服务器IP(如有)
  • SSL证书: 已准备好SSL证书文件(生产环境)

📦 部署包准备

📁 文件检查

  • 部署包: emotion-museum-1.0.0-20250713_111829.tar.gz 已下载
  • 校验和: SHA256校验通过
  • 解压: 部署包已成功解压
  • 权限: 脚本文件已设置执行权限

⚙️ 配置文件

  • 环境变量: .env 文件已配置
  • Coze API: API Token 已设置
  • 数据库密码: 已修改默认密码
  • 域名配置: Nginx配置中的域名已更新(生产环境)

🚀 部署执行

🔄 部署步骤

  • 1. 环境检查: ./quick-deploy.sh 环境检查通过
  • 2. Docker安装: Docker和Docker Compose安装成功
  • 3. 配置生成: 配置文件生成成功
  • 4. 镜像构建: Docker镜像构建成功
  • 5. 服务启动: 所有容器启动成功

📊 服务状态

  • MySQL: 容器运行正常,数据库连接成功
  • Redis: 容器运行正常,缓存服务可用
  • Nacos: 容器运行正常,注册中心可访问
  • Gateway: 容器运行正常,网关服务可用
  • AI Service: 容器运行正常,AI服务可用
  • User Service: 容器运行正常,用户服务可用
  • Frontend: 容器运行正常,前端应用可访问
  • Nginx: 容器运行正常,反向代理工作正常

部署验证

🌐 访问测试

🔍 功能测试

  • 用户注册: 新用户注册功能正常
  • 用户登录: 用户登录功能正常
  • AI对话: AI聊天功能正常
  • 数据存储: 对话记录正常保存
  • 情绪分析: 情绪分析功能正常

📈 性能测试

  • 响应时间: 页面加载时间 < 3秒
  • API响应: API接口响应时间 < 1秒
  • 并发测试: 支持预期的并发用户数
  • 资源使用: CPU和内存使用率在合理范围

🔒 安全配置

🛡️ 基础安全

  • 默认密码: 所有默认密码已修改
  • 防火墙: 只开放必要端口
  • 用户权限: 使用非root用户运行服务
  • 文件权限: 敏感文件权限设置正确

🔐 HTTPS配置(生产环境)

  • SSL证书: 证书文件已正确放置
  • Nginx配置: HTTPS配置已启用
  • HTTP重定向: HTTP自动重定向到HTTPS
  • 证书验证: SSL证书验证通过

🔑 API安全

  • JWT配置: JWT密钥已设置
  • CORS配置: 跨域配置正确
  • 限流配置: API限流规则已启用
  • 访问日志: 访问日志记录正常

📊 监控配置

📈 服务监控

  • 健康检查: ./manage.sh health 所有服务健康
  • 日志收集: 日志文件正常生成
  • 资源监控: ./manage.sh monitor 监控面板正常
  • 告警配置: 异常告警机制已配置(可选)

💾 数据备份

  • 备份脚本: ./manage.sh backup 备份功能正常
  • 备份策略: 定期备份计划已制定
  • 恢复测试: 数据恢复功能已测试
  • 备份存储: 备份文件存储位置已确定

📝 文档记录

📋 部署记录

  • 部署时间: 记录部署完成时间
  • 版本信息: 记录部署的版本号
  • 配置信息: 记录重要配置参数
  • 访问信息: 记录访问地址和账号

📖 运维文档

  • 管理命令: 熟悉 ./manage.sh 各项命令
  • 故障排除: 了解常见问题解决方案
  • 更新流程: 了解服务更新流程
  • 联系方式: 记录技术支持联系方式

🎯 部署后任务

🔧 优化配置

  • 性能调优: 根据实际负载调整配置
  • 缓存策略: 优化Redis缓存配置
  • 数据库优化: 调整MySQL配置参数
  • 网络优化: 优化Nginx配置

📊 监控设置

  • 日志轮转: 配置日志文件轮转
  • 磁盘清理: 设置定期清理任务
  • 性能监控: 配置性能监控工具
  • 告警通知: 设置异常告警通知

🔄 维护计划

  • 更新计划: 制定定期更新计划
  • 备份计划: 制定数据备份计划
  • 安全审计: 制定安全审计计划
  • 容量规划: 制定容量扩展计划

⚠️ 注意事项

🚨 重要提醒

  1. Coze API Token: 必须配置正确的API Token,否则AI功能无法使用
  2. 数据库密码: 生产环境必须修改默认密码
  3. 防火墙配置: 确保只开放必要的端口
  4. SSL证书: 生产环境强烈建议使用HTTPS
  5. 定期备份: 重要数据必须定期备份

📞 紧急联系


部署完成确认

部署工程师: ________________
部署时间: ________________
版本号: emotion-museum-1.0.0-20250713_111829
服务器IP: ________________
域名: ________________

签名确认: ________________
日期: ________________


🎉 恭喜完成部署!请妥善保存此检查清单作为部署记录。