项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1064
使用教程
环境要求
- 已安装 Docker(Docker / Docker Compose 部署方式需要)
- 已安装 git 和 Node.js(仅手动运行时需要)
- 可访问 3000 端口(默认映射端口)
安装与启动步骤
-
1拉取镜像
从 Docker Hub 拉取官方镜像,推荐使用 Docker 方式部署。
docker pull wxxxcxx/ms-ra-forwarder:latest -
2启动容器
以守护模式运行容器,并把容器 3000 端口映射到本机 3000。
docker run --name ms-ra-forwarder -d -p 3000:3000 wxxxcxx/ms-ra-forwarder -
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启动 Compose 服务
在 docker-compose.yml 所在目录执行,后台拉起服务。
docker compose up -d -
5获取源码
手动运行方式,先用 git 克隆仓库并进入项目目录。
git clone https://github.com/wxxxcxx/ms-ra-forwarder.git cd ms-ra-forwarder -
6安装依赖并构建
需要事先安装好 git 和 Node.js,安装依赖后执行构建。
npm install npm run build -
7启动服务
构建完成后启动 Node 服务,访问本机 3000 端口即可。
npm run start
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
TOKEN | 否 | 设置后可限制他人滥用,请求时需在请求头携带该令牌 | sk-xxxxxxxx |
如何确认成功
浏览器访问 http://localhost:3000,在页面中测试语音合成没有问题即表示部署成功。
常见问题
Q:如何防止他人滥用我部署的服务?
A:在环境变量中添加 TOKEN,并在请求头中加上 Authorization: Bearer <TOKEN> 访问即可。
Q:为什么 Railway 部署有时用不了?
A:Railway 每月有 500 小时限制且不会自动停机,所以每个月会有一段时间无法使用,有条件建议用 Docker 部署。
Q:怎么手动调用语音合成接口?
A:接口地址为 /api/text-to-speech,例如 GET /api/text-to-speech?voice=Microsoft+Server+Speech+Text+to+Speech+Voice+(zh-CN,+XiaoxiaoNeural)&volume=0&rate=0&pitch=0&text=你好。
Q:需要申请 Azure 密钥或付费吗?
A:不需要,项目通过转发微软 Edge 浏览器内置的语音合成接口实现,免费使用。
注意事项
- Docker 部署为推荐方式,部署在 Vercel 时请删除原项目重新部署。
- 手动运行需要事先安装好 git 和 nodejs。
- 微软官方 Azure TTS 有一定免费额度,如果够用建议支持官方服务。
- 如果只需要为固定文本生成语音,可以使用有声内容创作工具。
核心亮点
- 无需 Azure 密钥,开箱即用,零成本接入高质量 TTS
- 支持多语言和多种神经语音,音质自然,接近真人
- 提供简洁 REST API,支持 SSML 和参数调节,集成方便
不足之处
- 依赖微软非官方接口,可能因上游变动而失效
- 文档和示例相对简单,高级用法需自行探索
适用场景
- 个人开发者快速为应用添加语音播报功能
- 教育类工具生成语音朗读内容
- 自动化流程中生成语音提示或配音
替代项目
edge-tts、pyttsx3、gTTS
上一篇:ComfyUI-EdgeTTS
下一篇:M3-TTS
同类项目推荐
capcut-tts-api
开源
Python 封装语音合成与转写,快速接入 TTS/STT
capcut api tts & stt
Kokoro-TTS-windows
开源
解压即用,离线高质语音合成,小白也能玩转 TTS
Easy-to-use, zero-setup Kokoro TTS for Windows. High-quality offline Text-to-Speech ···
gTTS
开源
几行代码调用谷歌翻译,把文字变成语音
Python library and CLI tool to interface with Google Translate's text-to-speech API
AivisSpeech-Engine
开源
上传声音样本,即刻生成日文语音,还能模仿音色。
AivisSpeech Engine: AI Voice Imitation System - Text to Speech Engine
Tacotron-pytorch
开源
用 PyTorch 复现 Tacotron,快速搭建端到端语音合成模型
A Pytorch Implementation of Tacotron: End-to-end Text-to-speech Deep-Learning Model
voicevox_core
开源
把日语TTS引擎装进你的应用,离线生成自然语音
無料で使える中品質なテキスト読み上げソフトウェア、VOICEVOXのコア
video-bgm-generation
开源
根据视频内容自动生成匹配的背景音乐,省时又专业
[ACM MM 2021 Best Paper Award] Video Background Music Generation with Controllable M···
Parakeet
开源
用 PaddlePaddle 一键训练和部署多种主流语音合成模型
PAddle PARAllel text-to-speech toolKIT (supporting Tacotron2, Transformer TTS, FastS···
vibevoice-rs
开源
用Rust实现语音克隆与多说话人TTS,高性能低延迟。
Rust implementation of VibeVoice text-to-speech with voice cloning and multi-speaker···
