
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
该服务是Linto平台栈中的必填组件,作为语音转文本(STT)工具包的核心进程,需与https://github.com/linto-ai/linto-platform-stt-standalone-worker%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%EF%BC%8C%E9%80%9A%E8%BF%87Docker Swarm编排运行API接口,实现对STT服务的管理功能。
适用于Linto平台栈环境中需要语音转文本功能的应用场景,主要用于管理STT服务的部署、运行、配置及资源调度,支持离线和在线两种解码模式,满足不同语音处理需求。
推荐通过官方提供的栈https://github.com/linto-ai/linto-platform-stack%E8%BF%9B%E8%A1%8C%E9%83%A8%E7%BD%B2%E3%80%82
依赖项
使用STT-manager服务前,需确保已安装并启动以下依赖服务:
docker pull docker.xuanyuan.run/mongodocker pull docker.xuanyuan.run/nginxdocker pull docker.xuanyuan.run/traefik下载与安装
下载源代码:
bashgit clone https://github.com/linto-ai/linto-platform-stt-service-manager.git cd linto-platform-stt-service-manager
构建Docker镜像(需安装Docker和Docker Compose):
bashdocker build -t lintoai/linto-platform-stt-standalone-worker .
或使用docker-compose构建:
bashdocker-compose build
也可直接从Docker Hub拉取预构建镜像:
bashdocker pull docker.xuanyuan.run/lintoai/linto-platform-stt-standalone-worker:latest
注意:若不使用Docker安装,需按照
Dockerfile中的说明手动操作(包括构建kaldi、安装NLP包、安装npm模块等步骤)。
配置
构建服务后,需配置环境变量。项目提供默认配置文件.envdefault,可复制并修改为自定义配置:
bashcp .envdefault .env nano .env
主要环境变量说明
| 环境变量 | 描述 | 示例 |
|---|---|---|
| LINTO_STACK_DOMAIN | 部署域名(使用traefik控制器时必填) | dev.linto.local |
| LINTO_STACK_STT_SERVICE_MANAGER_HTTP_PORT | STT-manager服务端口 | 80 |
| LINTO_STACK_STT_SERVICE_MANAGER_DIRECTORY | 模型保存文件夹路径 | ~/linto_shared_memory/ |
| LINTO_STACK_STT_SERVICE_MANAGER_CLUSTER_MANAGER | 容器编排工具(仅支持DockerSwarm) | DockerSwarm |
| LINTO_STACK_STT_SERVICE_MANAGER_INGRESS_CONTROLLER | 入口控制器(支持nginx|traefik) | nginx |
| LINTO_STACK_STT_SERVICE_MANAGER_LINSTT_TOOLKIT | ASR引擎(仅支持kaldi) | kaldi |
| LINTO_STACK_STT_SERVICE_MANAGER_NGINX_HOST | nginx主机地址 | localhost |
| LINTO_STACK_STT_SERVICE_MANAGER_MONGODB_HOST | MongoDB主机地址 | localhost |
| LINTO_STACK_STT_SERVICE_MANAGER_MONGODB_PORT | MongoDB服务端口 | 27017 |
| LINTO_STACK_STT_SERVICE_MANAGER_MONGODB_DBNAME | MongoDB数据库名称 | linSTTAdmin |
| LINTO_STACK_STT_SERVICE_MANAGER_MONGODB_REQUIRE_LOGIN | 是否启用MongoDB认证 | true |
| LINTO_STACK_STT_SERVICE_MANAGER_MONGODB_USER | MongoDB用户名 | root |
| LINTO_STACK_STT_SERVICE_MANAGER_MONGODB_PSWD | MongoDB用户密码 | root |
| LINTO_STACK_LINSTT_OFFLINE_IMAGE | 离线解码模式镜像 | lintoai/linto-platform-stt-standalone-worker |
| LINTO_STACK_LINSTT_STREAMING_IMAGE | 在线解码模式镜像 | lintoai/linto-platform-stt-standalone-worker-streaming |
| LINTO_STACK_LINSTT_NETWORK | Docker网络名称 | linto-net |
| LINTO_STACK_LINSTT_PREFIX | 服务前缀(与入口控制器配合) | stt |
| LINTO_STACK_IMAGE_TAG | 镜像标签 | latest |
| LINTO_STACK_LINSTT_NAME | Docker栈名称 | stt |
非Docker运行时额外配置
若不使用Docker运行,需额外配置以下环境变量:
| 环境变量 | 描述 | 示例 |
|---|---|---|
| SAVE_MODELS_PATH | 模型保存路径(与LINTO_STACK_STT_SERVICE_MANAGER_DIRECTORY相同) | ~/linto_shared_memory/ |
| LINTO_STACK_STT_SERVICE_MANAGER_SWAGGER_PATH | Swagger文件路径 | ~/linto-platform-stt-service-manager/config/swagger.yml |
| LINTO_STACK_STT_SERVICE_MANAGER_NGINX_CONF | Nginx配置文件路径 | ~/linto-platform-stt-service-manager/config/nginx.conf |
注意:若需使用用户界面,需配置Swagger文件
~/linto-platform-stt-service-manager/config/swagger.yml,在host部分指定服务部署的主机和地址。
执行
LINTO_STACK_STT_SERVICE_MANAGER_INGRESS_CONTROLLER指定)bashcd linto-platform-stt-service-manager docker-compose up
详细文档请参考:https://doc.linto.ai/#/services/stt_manager
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务