VoxFlow项目安装配置

VoxFlow 后端一键安装脚本

系统: Ubuntu 20.0
路径: /opt/shenco/voxflow

[OK] 项目目录结构检查通过
[INFO] [1/7] 安装系统依赖和 Python 3.11...
[INFO] 测试当前 apt 源...
[OK] 当前 apt 源可用，无需切换
[INFO] 尝试通过 deadsnakes PPA 安装 Python 3.11...
命中:1 https://download.docker.com/linux/ubuntu focal InRelease
命中:2 http://ppa.launchpad.net/deadsnakes/ppa/ubuntu focal InRelease      
命中:3 http://ports.ubuntu.com/ubuntu-ports focal-security InRelease       
命中:4 http://ap-osaka-1-ad-1.clouds.ports.ubuntu.com/ubuntu-ports focal InRelease
命中:5 http://ap-osaka-1-ad-1.clouds.ports.ubuntu.com/ubuntu-ports focal-updates InRelease
命中:6 http://ap-osaka-1-ad-1.clouds.ports.ubuntu.com/ubuntu-ports focal-backports InRelease
正在读取软件包列表... 完成
[WARN] PPA 安装失败（ARM64 等架构常见），改为源码编译...
[INFO] 从源码编译 Python 3.11.9（约需 5-10 分钟）...
[OK] 源码编译 Python 3.11.9 安装完成
[OK] Python 3.11 安装完成
[OK] 系统依赖安装完成
[INFO] [2/7] 创建运行用户...
[OK] 用户 voxflow 创建完成
[INFO] [3/7] 创建 Python 虚拟环境...
[INFO] 安装后端核心依赖...
[INFO] 安装 Kokoro 引擎依赖（可选，失败不影响 Edge-TTS）...
[OK] 虚拟环境创建完成，依赖安装成功
[INFO] [4/7] 检查环境变量和目录权限...
[WARN] JIANSPEAKER_JWT_SECRET 未配置或为默认值，建议修改
[WARN] 部分配置项需要修改，请编辑 /opt/shenco/voxflow/backend/.env 后重启服务
[OK] 目录权限设置完成
[INFO] [5/7] 配置 systemd 服务...
Created symlink /etc/systemd/system/multi-user.target.wants/voxflow.service → /etc/systemd/system/voxflow.service.
[OK] systemd 服务配置完成
[INFO] [6/7] 配置日志轮转...
[OK] 日志轮转配置完成
[INFO] [7/7] 启动 VoxFlow 后端服务...
[OK] VoxFlow 后端服务启动成功
[INFO] 验证服务运行状态...
[OK] 端口 5000 正在监听
[WARN] API 接口未响应，服务可能仍在初始化
[WARN] 请稍后手动测试: curl http://127.0.0.1:8000/api/engines

VoxFlow 后端部署完成！

  安装路径:    /opt/shenco/voxflow
  后端目录:    /opt/shenco/voxflow/backend
  虚拟环境:    /opt/shenco/voxflow/venv
  运行用户:    voxflow
  监听端口:    5000
  服务器 IP:   10.0.0.18
  日志目录:    /opt/shenco/voxflow/logs
  配置文件:    /opt/shenco/voxflow/backend/.env

  引擎状态:
    Edge-TTS:  已安装（云端推理，需外网访问）
    Kokoro:    已尝试安装（本地推理，查看上方日志确认）
    CosyVoice: 未安装（预留接口）

  管理命令:
    sudo systemctl status voxflow     # 查看状态
    sudo systemctl restart voxflow    # 重启服务
    sudo systemctl stop voxflow       # 停止服务
    sudo journalctl -u voxflow -f     # 实时日志
    tail -f /opt/shenco/voxflow/logs/voxflow.log      # 日志文件

  前端 Nginx 配置提示:
    upstream 指向: 10.0.0.18:5000
    proxy_pass http://10.0.0.18:5000

重要提醒:

1. 请编辑 /opt/shenco/voxflow/backend/.env
 - JIANSPEAKER_CORS_ORIGINS 设为前端域名
 - JIANSPEAKER_TRUSTED_PROXY_COUNT 设为 1
2. 修改后重启: sudo systemctl restart voxflow
3. 确保服务器 5000 端口对前端服务器可达

VoxFlow项目安装配置

评论

文章目录