easyVoice

环境要求

• Docker（使用 docker run 或 docker-compose 部署时）
• Node.js 环境（本地运行项目时）
• pnpm 包管理器（本地运行项目时，可用 corepack 开启或 npm 全局安装）
• 服务器或本地机器需开放 3000 端口

安装与启动步骤

1. 1Docker 一键运行

   最简单的方式，映射 3000 端口并把音频目录挂载到当前目录的 audio 下，可通过 -e 指定环境变量。

   docker run -d -p 3000:3000 -v $(pwd)/audio:/app/audio cosincox/easyvoice:latest

   复制

2. 2克隆仓库用 Compose

   把仓库克隆到本地后，使用 Docker Compose 一键启动服务，无需手动写 docker run 参数。

   git clone git@github.com:cosin2077/easyVoice.git
   cd easyVoice
   docker-compose up -d

   复制

3. 3准备工作：Node 与 pnpm

   本地运行前先确保已安装 Node.js，再开启或安装 pnpm；已有 pnpm 可跳过。

   corepack enable
   npm install -g pnpm

   复制

4. 4拉取项目源码

   从 GitHub 克隆 easyVoice 仓库并进入项目根目录，后续命令都在此目录执行。

   git clone git@github.com:cosin2077/easyVoice.git
   cd easyVoice

   复制

5. 5安装项目依赖

   使用 pnpm 递归安装工作区所有依赖，首次安装耗时较长属正常现象。

   pnpm i -r

   复制

6. 6开发模式启动

   适合调试和二次开发，启动后即可在浏览器访问本地服务。

   pnpm dev:root

   复制

7. 7生产模式启动

   先构建再启动，适合正式部署使用，构建完成后运行 start 命令拉起服务。

   pnpm build:root
   pnpm start:root

   复制

关键配置

如何确认成功

浏览器访问 http://localhost:3000 能看到页面；或调用 curl -X POST http://localhost:3000/api/v1/tts/generateJson 有响应。

常见问题

注意事项

• Windows PowerShell 下 $(pwd) 语法不适用，需替换为实际宿主机路径。
• Docker 运行时注意 audio 挂载目录的读写权限，否则可能无法写入音频。
• 本地运行请先安装 Node.js，再执行 pnpm 相关命令。
• 接口调用地址为 http://localhost:3000/api/v1/tts/generateJson，需服务已启动。