优化新增耳机流程，优化界面
This commit is contained in:
eafonyang
@@ -21,6 +21,7 @@
|
||||
- 采用TypeScript-based构建系统，使用Vite进行前端构建
|
||||
- 简化了部署流程，专注于Docker Compose编排和手动上传方式
|
||||
- 更新了构建命令和环境配置说明
|
||||
- **新增**：部署脚本upload.sh进行了清理，移除了12行废弃功能代码，简化了部署流程
|
||||
|
||||
## 目录
|
||||
1. [简介](#简介)
|
||||
@@ -37,7 +38,7 @@
|
||||
## 简介
|
||||
本指南面向首次部署、本地构建上传以及后续更新部署的全流程操作，覆盖服务器准备工作、目录结构创建、环境变量配置、Docker Compose 配置说明、服务端口映射与网络设置、上传脚本使用方法、手动 rsync 方式、构建与启动命令、健康检查与服务验证、常见部署问题解决方案，以及生产环境安全配置建议与最佳实践。
|
||||
|
||||
**更新**：本项目已移除传统的前端Dockerfile和nginx.conf配置，采用更简洁的静态资源托管模式，通过Nginx镜像直接挂载构建产物。
|
||||
**更新**：本项目已移除传统的前端Dockerfile和nginx.conf配置，采用更简洁的静态资源托管模式，通过Nginx镜像直接挂载构建产物。同时，部署脚本upload.sh经过清理优化，移除了废弃功能代码，进一步简化了部署流程。
|
||||
|
||||
## 项目结构
|
||||
- 前端采用Nginx静态托管，后端为Node.js API，通过 Docker Compose 统一编排。
|
||||
@@ -81,6 +82,7 @@ BE --- VOL2
|
||||
- 上传脚本（upload.sh）
|
||||
- 基于 rsync + SSH，支持分模块上传（frontend、backend、compose），也支持自定义路径。
|
||||
- 提供虚拟执行（-n）预览能力，便于确认同步范围。
|
||||
- **更新**：脚本经过清理优化，移除了废弃功能代码，简化了部署流程。
|
||||
- 环境变量与配置
|
||||
- 根目录 .env 由 Docker Compose 注入后端容器。
|
||||
- 后端支持通过 APP_ENV 切换开发/生产环境行为。
|
||||
@@ -143,6 +145,7 @@ end
|
||||
- 使用上传脚本（推荐）：支持 all、frontend、backend、compose 等目标
|
||||
- 支持自定义路径上传，如单独上传配置文件
|
||||
- 虚拟执行（-n）可用于预览同步范围
|
||||
- **更新**：上传脚本经过清理优化，移除了废弃功能代码，提供更简洁的部署体验
|
||||
- 服务器构建与启动
|
||||
- 首次或依赖变更时，执行后端镜像构建
|
||||
- 启动/更新：docker compose up -d
|
||||
@@ -170,7 +173,7 @@ end
|
||||
- 本地构建前端并上传，服务器执行后端镜像构建与启动
|
||||
|
||||
**章节来源**
|
||||
- [DEPLOY.md:122-154](file://DEPLOY.md#L122-154)
|
||||
- [DEPLOY.md:122-154](file://DEPLOY.md#L122-L154)
|
||||
|
||||
### docker-compose.yml 说明
|
||||
- backend
|
||||
@@ -214,7 +217,7 @@ end
|
||||
- Redis EQ：REDIS_HOST、REDIS_PORT、REDIS_PASSWORD、REDIS_EQ_DB
|
||||
|
||||
**章节来源**
|
||||
- [DEPLOY.md:190-203](file://DEPLOY.md#L190-203)
|
||||
- [DEPLOY.md:190-203](file://DEPLOY.md#L190-L203)
|
||||
|
||||
### 目录结构（服务器）
|
||||
- /data/project/dashboard/
|
||||
@@ -244,6 +247,7 @@ end
|
||||
- 注意事项
|
||||
- **更新**：默认不同步nginx.conf（已移除）与Dockerfile，需要时需显式指定
|
||||
- 路径不在项目内会被跳过
|
||||
- **新增**：脚本经过清理优化，移除了废弃功能代码，提供更简洁的使用体验
|
||||
|
||||
**章节来源**
|
||||
- [scripts/upload.sh:39-75](file://scripts/upload.sh#L39-L75)
|
||||
@@ -383,16 +387,19 @@ end
|
||||
- **更新**：前端构建问题
|
||||
- 确认Vite构建成功，dist目录存在且包含必要的静态资源
|
||||
- 检查前端构建日志，确认没有编译错误
|
||||
- **更新**：上传脚本问题
|
||||
- 如果上传脚本出现异常，检查SSH连接权限和目标服务器路径
|
||||
- 使用虚拟执行模式（-n）预览同步范围，确认文件列表正确
|
||||
- 停止服务
|
||||
- docker compose down
|
||||
|
||||
**章节来源**
|
||||
- [DEPLOY.md:226-256](file://DEPLOY.md#L226-L256)
|
||||
- [DEPLOY.md:226-256](file://DEPLOY.md#L226-256)
|
||||
|
||||
## 结论
|
||||
本指南提供了从服务器准备、目录与环境配置、本地构建与上传、Docker Compose 编排与启动、健康检查与验证，到更新部署与故障排查的完整流程。遵循本文档可快速、稳定地完成 Audio Dashboard 的部署与运维。
|
||||
|
||||
**更新**：通过移除复杂的前端Dockerfile和nginx.conf配置，采用更简洁的静态资源托管模式，部署流程得到了显著简化。同时，通过自定义网络、只读卷挂载和额外的主机配置，系统在网络稳定性和安全性方面也得到了提升。
|
||||
**更新**：通过移除复杂的前端Dockerfile和nginx.conf配置，采用更简洁的静态资源托管模式，部署流程得到了显著简化。同时，部署脚本upload.sh经过清理优化，移除了废弃功能代码，进一步提升了用户体验。通过自定义网络、只读卷挂载和额外的主机配置，系统在网络稳定性和安全性方面也得到了提升。
|
||||
|
||||
## 附录
|
||||
|
||||
@@ -415,6 +422,9 @@ end
|
||||
- **新增**：构建安全
|
||||
- 前端使用Vite构建，确保生产环境构建产物不包含开发依赖
|
||||
- 定期更新前端依赖，修复已知安全漏洞
|
||||
- **新增**：脚本安全
|
||||
- 上传脚本经过清理优化，减少了潜在的安全风险点
|
||||
- 建议使用虚拟执行模式（-n）先预览同步范围，避免误操作
|
||||
|
||||
**章节来源**
|
||||
- [DEPLOY.md:36-42](file://DEPLOY.md#L36-L42)
|
||||
|
||||
Reference in New Issue
Block a user