4.1 KiB
4.1 KiB
VOSK 模型本地服务器配置说明
快速开始
方法一：使用启动脚本（推荐）
Windows 用户：
- 双击运行
启动服务器.bat - 服务器会自动启动并显示访问地址
Linux/Mac 用户：
- 给脚本添加执行权限：
chmod +x 启动服务器.sh - 运行脚本：
./启动服务器.sh
方法二：手动启动
- 打开终端/命令行
- 进入项目目录
- 运行命令：
python server.py # 或 python3 server.py
服务器配置
端口配置
默认端口为 8080，如需修改：
- 编辑
server.py文件 - 找到
PORT = 8080这一行 - 修改为你想要的端口号，例如：
PORT = 9090
模型文件位置
服务器会自动从 static 目录读取模型文件：
- 模型文件路径：
static/vosk-model-small-cn-0.22.zip - 确保该文件存在
获取服务器地址
启动服务器后，会显示如下信息：
============================================================
VOSK 模型服务器已启动
============================================================
本地访问: http://localhost:8080/vosk-model-small-cn-0.22.zip
局域网访问: http://192.168.1.100:8080/vosk-model-small-cn-0.22.zip
============================================================
在 APP 中配置服务器地址为上述局域网地址
按 Ctrl+C 停止服务器
============================================================
地址说明
- 本地访问 (
localhost:8080)：仅本机可访问 - 局域网访问 (
192.168.1.100:8080)：同一局域网内的设备都可以访问
在 APP 中配置
方式一：通过界面配置（推荐）
- 打开 APP，进入主页面
- 找到"模型服务器配置"区域
- 输入局域网访问地址，例如：
http://192.168.1.100:8080/vosk-model-small-cn-0.22.zip - 输入完成后，配置会自动保存
方式二：自动配置（需修改代码）
如果你想自动使用本地服务器地址，可以修改代码：
在 pages/speech/speech.vue 或 pages/index/index.vue 中，取消注释以下代码：
// 如果需要在代码中直接配置默认服务器地址，可以取消下面的注释
if (!serverUrl.value) {
serverUrl.value = 'http://192.168.1.100:8080/vosk-model-small-cn-0.22.zip'
}
注意：将 192.168.1.100 替换为你的实际局域网 IP 地址
获取本机局域网 IP 地址
Windows
- 打开命令提示符（CMD）
- 运行命令：
ipconfig - 找到"IPv4 地址"，通常是
192.168.x.x格式
Linux/Mac
- 打开终端
- 运行命令：
ifconfig # 或 ip addr show - 找到局域网 IP 地址（通常在
eth0或en0接口下）
防火墙配置
如果其他设备无法访问服务器，可能需要配置防火墙：
Windows
- 打开"Windows Defender 防火墙"
- 点击"高级设置"
- 新建入站规则
- 选择"端口"，允许 TCP 端口
8080
Linux (Ubuntu/Debian)
sudo ufw allow 8080/tcp
Mac
- 系统偏好设置 → 安全性与隐私 → 防火墙
- 点击"防火墙选项"
- 添加 Python 应用程序的允许规则
常见问题
Q: 端口被占用怎么办？
A: 修改 server.py 中的 PORT 变量，使用其他端口号（如 9090、8888 等）
Q: 手机无法访问服务器？
A: 确保：
- 手机和电脑在同一局域网（WiFi）下
- 防火墙允许端口访问
- 使用局域网 IP 地址（不是 localhost）
Q: 如何停止服务器？
A: 在服务器运行窗口中按 Ctrl + C
服务器特性
- ✅ 支持 CORS 跨域访问
- ✅ 自动获取本机局域网 IP
- ✅ 支持大文件下载（模型文件约 40MB）
- ✅ 自动检查模型文件是否存在
- ✅ 友好的错误提示
注意事项
- 确保模型文件存在：
static/vosk-model-small-cn-0.22.zip - 网络连接：手机和电脑必须在同一局域网
- 防火墙：确保防火墙允许端口访问
- 首次下载：首次从服务器下载模型需要一些时间，请耐心等待