#颐学云私有化部署指南

版本：2026-06

## 部署目标

私有化部署用于客户自有机房、专有云、隔离网或强数据本地化场景。目标是在客户环境内完整运行学习、考试、监考、证书与数据分析能力。

## 推荐架构

- Web 前端：官网、管理端、学员端。
- 应用服务：认证、系统管理、业务模块、License 模块。
- 数据库：MySQL 或客户指定兼容数据库。
- 缓存：Redis。
- 文件服务：MinIO、S3 或本地存储。
- 监控：应用日志、数据库连接池、Redis 状态和关键业务指标。

## 基础环境

- Java 8 或项目指定运行时。
- MySQL 8.x 或兼容版本。
- Redis 6.x 及以上。
- Nginx 或同类反向代理。
- 可选：Docker Compose 或客户标准容器平台。

## 交付步骤

1. 环境确认：网络、端口、域名、数据库、存储和证书。
2. 服务部署：应用包、前端静态资源、Nginx 路由。
3. 初始化数据：管理员账号、字典、菜单、角色和演示数据。
4. License 激活：生成机器指纹并导入授权文件。
5. 联调验收：登录、课程、题库、考试、证书、通知和监考流程。
6. 运维交接：备份策略、日志路径、升级方式和故障处理。

## License 激活

- 管理后台生成机器码。
- 商务或交付团队基于机器码签发授权文件。
- 客户管理员上传授权文件完成激活。
- 隔离网环境无需公网访问。

## 上线检查

- 管理端、学员端、公开证书查验页均可访问。
- 邮件、短信或站内信通道按客户要求连通。
- 日志、备份、监控和告警策略已启用。
- 压测结果满足客户并发要求。

## 注意事项

- 演示账号和默认密码必须在正式上线前禁用或修改。
- 对外公开路径应单独梳理白名单。
- 监考截图、录屏等敏感数据建议单独设置保存周期和访问审批。