docs(README): 更新前后端部署说明
- 优化数据库配置步骤,增加创建数据库和导入SQL文件的详细说明 - 更新配置文件修改说明,提供更具体的配置示例 - 补充API文档访问说明 - 完善前端部署步骤,包括运行开发服务器和生产构建 - 增加SnowflakeIdUtil和TimeUtil工具类
This commit is contained in:
78
README.md
78
README.md
@@ -124,46 +124,88 @@
|
||||
|
||||
### 后端部署
|
||||
|
||||
1. 配置数据库
|
||||
1. **配置数据库**
|
||||
在您的MySQL服务器中,创建一个名为 `music_db` 的数据库,并使用 `utf8mb4` 字符集。
|
||||
```sql
|
||||
CREATE DATABASE music_db CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
|
||||
```
|
||||
然后,将 `sql/music_db.sql` 文件导入到 `music_db` 数据库中,以创建所有必需的表和初始数据。
|
||||
|
||||
2. 修改配置文件
|
||||
- 编辑 `music-houduan/src/main/resources/application.yml`
|
||||
- 配置数据库连接信息
|
||||
- 配置Redis连接信息
|
||||
- 配置文件上传路径
|
||||
2. **修改配置文件**
|
||||
- 打开 `music-houduan/src/main/resources/application.yml` 文件。
|
||||
- **数据库连接**:找到 `spring.datasource` 部分,并更新 `url`、`username` 和 `password` 以匹配您的MySQL配置。
|
||||
```yaml
|
||||
url: jdbc:mysql://localhost:3306/music_db?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
|
||||
username: your-mysql-username
|
||||
password: your-mysql-password
|
||||
```
|
||||
- **Redis连接**:找到 `spring.redis` 部分,并更新 `host` 和 `port`。
|
||||
```yaml
|
||||
host: localhost
|
||||
port: 6379
|
||||
```
|
||||
- **文件上传路径**:找到 `file.upload` 部分,并配置您希望存储上传文件的路径,或者保留不修改。
|
||||
```yaml
|
||||
path: /path/to/your/upload/folder/
|
||||
```
|
||||
请确保此目录存在并且您的应用程序具有写入权限。
|
||||
|
||||
3. 构建项目
|
||||
3. **构建项目**
|
||||
在 `music-houduan` 目录下,使用Maven构建项目。
|
||||
```bash
|
||||
cd music-houduan
|
||||
mvn clean package -DskipTests
|
||||
```
|
||||
|
||||
4. 运行项目
|
||||
4. **运行项目**
|
||||
构建成功后,运行生成的jar文件。
|
||||
```bash
|
||||
java -jar target/music-houduan-1.0.0.jar
|
||||
```
|
||||
默认情况下,后端服务将在 `http://localhost:8085` 上运行。
|
||||
|
||||
5. **API文档**
|
||||
您可以通过以下URL访问API文档:
|
||||
- **Swagger UI**: [http://localhost:8085/swagger-ui/index.html](http://localhost:8085/swagger-ui/index.html)
|
||||
- **Knife4j**: [http://localhost:8085/doc.html](http://localhost:8085/doc.html)
|
||||
|
||||
### 前端部署
|
||||
|
||||
1. 安装依赖
|
||||
1. **安装依赖**
|
||||
在 `music-qianduan` 目录下,使用npm安装项目依赖项。
|
||||
```bash
|
||||
cd music-qianduan
|
||||
npm install
|
||||
```
|
||||
|
||||
2. 修改配置
|
||||
- 编辑 `.env` 文件,配置API地址
|
||||
2. **修改配置**
|
||||
- 在 `music-qianduan` 根目录中,创建一个名为 `.env.development` 的文件(用于开发环境)或 `.env.production` 的文件(用于生产环境)。
|
||||
- 在此文件中,设置 `VITE_API_URL` 变量以指向您的后端API。
|
||||
```
|
||||
VITE_API_URL=http://localhost:8085
|
||||
```
|
||||
|
||||
3. 构建项目
|
||||
3. **运行开发服务器**
|
||||
对于开发,请使用以下命令启动Vite开发服务器:
|
||||
```bash
|
||||
npm run dev
|
||||
```
|
||||
前端应用程序将在 `http://localhost:5173` 上可用。
|
||||
|
||||
4. **构建项目**
|
||||
对于生产,请使用以下命令构建项目:
|
||||
```bash
|
||||
npm run build
|
||||
```
|
||||
|
||||
4. 部署静态资源
|
||||
- 将 `dist` 目录下的文件部署到Web服务器
|
||||
5. **部署静态资源**
|
||||
- 构建完成后,将 `music-qianduan/dist` 目录的内容部署到您的Web服务器(例如Nginx、Apache)。
|
||||
- 确保您的Web服务器配置正确,以处理单页应用程序(SPA)的路由。对于Nginx,您可能需要添加如下配置:
|
||||
```nginx
|
||||
location / {
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
```
|
||||
|
||||
## 使用说明
|
||||
|
||||
@@ -209,11 +251,3 @@
|
||||
- 后端开发:XXX
|
||||
- 产品设计:XXX
|
||||
- 测试:XXX
|
||||
|
||||
## 版权声明
|
||||
|
||||
本项目仅用于学习和演示目的,不得用于商业用途。音乐文件版权归原作者所有。
|
||||
|
||||
## 联系方式
|
||||
|
||||
如有问题或建议,请联系:example@example.com
|
||||
|
||||
Reference in New Issue
Block a user