guoyu/配置指南-192.168.137.1.md

国语教育平台配置指南

本机IP: 192.168.137.1

---

📁 一、本地电脑需要创建的文件夹

根据后端配置文件 application.yml 中的设置：

ruoyi:
  profile: D:\wwwroot\study_web\web\profile

需要创建的完整目录结构：

D:\
└── wwwroot\
    └── study_web\
        └── web\
            └── profile\
                └── upload\
                    ├── courseware\      # 课件文件（视频、文档等）
                    ├── voice\           # 语音评测音频文件
                    ├── screenshots\     # 屏幕监控截图
                    └── avatar\          # 用户头像

Windows PowerShell 创建命令：

# 以管理员身份运行PowerShell，执行以下命令：
New-Item -Path "D:\wwwroot\study_web\web\profile\upload\courseware" -ItemType Directory -Force
New-Item -Path "D:\wwwroot\study_web\web\profile\upload\voice" -ItemType Directory -Force
New-Item -Path "D:\wwwroot\study_web\web\profile\upload\screenshots" -ItemType Directory -Force
New-Item -Path "D:\wwwroot\study_web\web\profile\upload\avatar" -ItemType Directory -Force

说明：

• courseware - 存放课件文件（视频、PDF、PPT等）
• voice - 存放语音评测的录音文件
• screenshots - 存放学习监控的屏幕截图
• avatar - 存放用户头像图片

---

🔧 二、后端配置（Spring Boot）

1. 后端服务器地址配置

文件: Study-Vue-redis\ry-study-admin\src\main\resources\application.yml

当前配置:

server:
  port: 30091

ruoyi:
  profile: D:\wwwroot\study_web\web\profile

重要: 确保后端监听所有网络接口，而不仅仅是 localhost。

如果你需要让手机APP访问，需要确保后端配置为：

server:
  port: 30091
  address: 0.0.0.0  # 监听所有网络接口

2. 开放防火墙端口

Windows防火墙配置 - 必须执行！

# 以管理员身份运行PowerShell：
netsh advfirewall firewall add rule name="国语教育平台后端 30091" dir=in action=allow protocol=tcp localport=30091

或者通过图形界面：

1. 控制面板 → Windows Defender 防火墙 → 高级设置
2. 入站规则 → 新建规则
3. 端口 → TCP → 特定本地端口: 30091
4. 允许连接 → 完成

3. 启动后端服务

cd D:\Desktop\Project\ry_study-v_03\ry_study-v_03\Study-Vue-redis\ry-study-admin
# 使用Maven启动
mvn spring-boot:run

# 或者如果已经打包成jar
java -jar target/ry-study-admin.jar

---

📱 三、移动端APP配置

1. 修改APP的服务器地址配置

文件: fronted_uniapp\fronted_uniapp\src\utils\config.js

需要修改的内容:

// 第17行：修改默认服务器地址为你的电脑IP
const DEFAULT_SERVER_HOST = '192.168.137.1'  // ← 修改这里

// 第18行：确认端口号
const DEFAULT_SERVER_PORT = 30091

2. 验证配置

修改后，APP将访问：

• API地址: http://192.168.137.1:30091
• 文件访问地址: http://192.168.137.1:30091/profile/...

---

🎥 四、课件管理和视频播放说明

1. 课件文件存储路径

当你通过后台管理系统上传课件时：

存储规则:

• 数据库存储的路径: /profile/upload/2025/12/05/课件名称.mp4
• 实际物理路径: D:\wwwroot\study_web\web\profile\upload\2025\12\05\课件名称.mp4

2. 课件管理功能使用流程

后台管理系统操作：

1. 登录后台管理系统

   • 访问地址: http://localhost:20002 (本地开发)
   • 或: http://192.168.137.1:30091 (直接访问后端)

2. 上传课件

   • 进入"教学管理" → "课件管理"
   • 点击"新增课件"
   • 选择课程、填写课件信息
   • 上传视频/文档文件
   • 系统会自动保存到 D:\wwwroot\study_web\web\profile\upload\ 目录

3. 课件列表管理

   • 可以查看、编辑、删除课件
   • 支持按课程筛选
   • 支持课件排序

APP端使用：

1. 查看课件列表

   • 登录APP后，进入课程详情
   • 可以看到该课程的所有课件列表

2. 播放视频课件

   • 点击课件即可播放
   • 视频URL: http://192.168.137.1:30091/profile/upload/2025/12/05/xxx.mp4

3. 视频播放访问流程

APP发起请求
    ↓
http://192.168.137.1:30091/profile/upload/2025/12/05/video.mp4
    ↓
Spring Boot接收请求 (ResourcesConfig.java)
    ↓
映射到物理路径: D:\wwwroot\study_web\web\profile\upload\2025\12\05\video.mp4
    ↓
返回视频文件流给APP
    ↓
APP播放器播放视频

---

🧪 五、测试连接是否正常

1. 测试后端服务是否启动

在浏览器中访问：

http://192.168.137.1:30091

应该看到若依管理系统的登录页面。

2. 测试文件访问是否正常

假设你已经上传了一个测试视频，可以在浏览器中直接访问：

http://192.168.137.1:30091/profile/upload/2025/12/05/test.mp4

如果能播放或下载，说明配置正确。

3. 测试APP连接

在APP中：

1. 打开控制台/日志
2. 查看请求地址是否为: http://192.168.137.1:30091/...
3. 尝试登录和访问课件
4. 检查是否有网络错误

---

⚠️ 六、常见问题排查

问题1: APP无法连接后端

检查清单:

• 手机和电脑在同一WiFi网络
• 防火墙已开放30091端口
• 后端服务已启动
• APP配置的IP地址正确 (192.168.137.1)

测试方法: 在手机浏览器访问: http://192.168.137.1:30091

问题2: 视频无法播放

检查清单:

• 文件夹权限正确（建议Everyone完全控制）
• 视频文件确实存在于指定路径
• 视频格式APP支持（推荐MP4）
• 文件路径没有中文或特殊字符

测试方法:

1. 在Windows资源管理器中找到视频文件
2. 直接双击播放确认文件完好
3. 在浏览器中访问视频URL测试

问题3: 上传课件失败

检查清单:

• 文件大小不超过2GB (application.yml配置)
• 目标文件夹存在且可写
• 磁盘空间充足

---

🚀 七、快速启动步骤

第1步：创建文件夹

New-Item -Path "D:\wwwroot\study_web\web\profile\upload\courseware" -ItemType Directory -Force
New-Item -Path "D:\wwwroot\study_web\web\profile\upload\voice" -ItemType Directory -Force
New-Item -Path "D:\wwwroot\study_web\web\profile\upload\screenshots" -ItemType Directory -Force
New-Item -Path "D:\wwwroot\study_web\web\profile\upload\avatar" -ItemType Directory -Force

第2步：开放防火墙

netsh advfirewall firewall add rule name="国语教育平台后端 30091" dir=in action=allow protocol=tcp localport=30091

第3步：修改APP配置

编辑: fronted_uniapp\fronted_uniapp\src\utils\config.js

const DEFAULT_SERVER_HOST = '192.168.137.1'  // 修改为你的IP

第4步：启动后端

cd Study-Vue-redis\ry-study-admin
mvn spring-boot:run

第5步：测试访问

浏览器访问: http://192.168.137.1:30091

第6步：编译和运行APP

在HBuilderX中运行APP到真机或模拟器

---

📝 八、文件上传API说明

通用文件上传接口

接口地址: POST /common/upload

请求方式: multipart/form-data

请求参数:

• file: 文件对象

返回示例:

{
  "code": 200,
  "msg": "操作成功",
  "fileName": "/profile/upload/2025/12/05/abc123.mp4",
  "newFileName": "abc123.mp4",
  "originalFilename": "课程视频.mp4",
  "url": "http://192.168.137.1:30091/profile/upload/2025/12/05/abc123.mp4"
}

课件管理API

获取课件列表: GET /study/courseware/list 新增课件: POST /study/courseware 修改课件: PUT /study/courseware 删除课件: DELETE /study/courseware/{id}

---

🔐 九、安全建议

1. 生产环境: 修改 application.yml 中的 token.secret 为随机32位字符串
2. Swagger: 生产环境设置 swagger.enabled: false
3. 防火墙: 仅开放必要端口
4. 文件上传: 设置合理的文件大小限制
5. 备份: 定期备份 D:\wwwroot\study_web\web\profile 目录

---

📞 附录：关键配置文件位置

项目根目录/
├── Study-Vue-redis/
│   └── ry-study-admin/
│       └── src/main/resources/
│           └── application.yml          # 后端主配置
│
└── fronted_uniapp/
    └── fronted_uniapp/
        └── src/utils/
            └── config.js                 # APP服务器地址配置

---

配置完成后，你就可以: ✅ 在后台管理系统上传和管理课件 ✅ APP端访问和播放视频课件 ✅ 语音评测功能正常使用 ✅ 屏幕监控功能正常使用