ms-ra-forwarder

环境要求

• 已安装 Docker（Docker / Docker Compose 部署方式需要）
• 已安装 git 和 Node.js（仅手动运行时需要）
• 可访问 3000 端口（默认映射端口）

安装与启动步骤

1. 1拉取镜像

   从 Docker Hub 拉取官方镜像，推荐使用 Docker 方式部署。

   docker pull wxxxcxx/ms-ra-forwarder:latest

   复制

2. 2启动容器

   以守护模式运行容器，并把容器 3000 端口映射到本机 3000。

   docker run --name ms-ra-forwarder -d -p 3000:3000 wxxxcxx/ms-ra-forwarder

   复制

3. 3创建 Compose 文件

   如需用 Compose 管理，新建 docker-compose.yml 并写入以下内容，不需要 TOKEN 时删除该行。

   version: '3'
   
   services:
     ms-ra-forwarder:
       container_name: ms-ra-forwarder
       image: wxxxcxx/ms-ra-forwarder:latest
       restart: unless-stopped
       ports:
         - 3000:3000
       environment:
         # 不需要可以不用设置环境变量
         - TOKEN=sk-xxxxxxxx

   复制

4. 4启动 Compose 服务

   在 docker-compose.yml 所在目录执行，后台拉起服务。

   docker compose up -d

   复制

5. 5获取源码

   手动运行方式，先用 git 克隆仓库并进入项目目录。

   git clone https://github.com/wxxxcxx/ms-ra-forwarder.git
   cd ms-ra-forwarder

   复制

6. 6安装依赖并构建

   需要事先安装好 git 和 Node.js，安装依赖后执行构建。

   npm install
   npm run build

   复制

7. 7启动服务

   构建完成后启动 Node 服务，访问本机 3000 端口即可。

   npm run start

   复制

关键配置

如何确认成功

浏览器访问 http://localhost:3000，在页面中测试语音合成没有问题即表示部署成功。

常见问题

注意事项

• Docker 部署为推荐方式，部署在 Vercel 时请删除原项目重新部署。
• 手动运行需要事先安装好 git 和 nodejs。
• 微软官方 Azure TTS 有一定免费额度，如果够用建议支持官方服务。
• 如果只需要为固定文本生成语音，可以使用有声内容创作工具。