test/.env.example

162 lines
8.0 KiB
Bash
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# Qwen3-ASR 环境变量覆盖示例
# 复制为 .env 后,只取消你需要修改的项的注释即可。
# -----------------------------------------------------------------------------
# 仅在需要 API Key 鉴权时开启。
# -----------------------------------------------------------------------------
# API_KEY=your_api_key_here
# -----------------------------------------------------------------------------
# Docker / 部署入口配置。
# -----------------------------------------------------------------------------
# NGINX_PORT:宿主机暴露的 Nginx 端口。
# NGINX_PORT=17003
# ASR_IMAGE:离线包或自定义部署时使用的镜像标签。
# ASR_IMAGE=unis/qwen3-asr:gpu-latest
# ASR_VISIBLE_DEVICES:统一可见卡编号配置,多个用逗号分隔;程序会按当前 accelerator 自动映射到底层变量。
# ASR_VISIBLE_DEVICES=0
# METAX_DRI_DEVICE:沐曦 / MuXi 需要映射的 DRI 设备路径。
# METAX_DRI_DEVICE=/dev/dri
# METAX_MXSMI_PATH:沐曦 / MuXi 的 mx-smi 工具路径。
# METAX_MXSMI_PATH=/opt/mxdriver/bin/mx-smi
# METAX_PRIVILEGED:沐曦 / MuXi 容器是否以 privileged 方式运行。
# METAX_PRIVILEGED=false
# ILUVATAR_USR_SRC:天数 / Iluvatar 容器内 usr/src 挂载路径。
# ILUVATAR_USR_SRC=/usr/src
# ILUVATAR_LIB_MODULES:天数 / Iluvatar 容器内模块目录挂载路径。
# ILUVATAR_LIB_MODULES=/lib/modules
# ILUVATAR_DEV:天数 / Iluvatar 设备目录挂载路径。
# ILUVATAR_DEV=/dev
# ILUVATAR_HOME:天数 / Iluvatar 主目录挂载路径。
# ILUVATAR_HOME=/home
# ILUVATAR_DATA:天数 / Iluvatar 数据目录挂载路径。
# ILUVATAR_DATA=/data
# MTHREADS_DEV:摩尔线程 / Moore Threads 设备目录挂载路径。
# MTHREADS_DEV=/dev
# MTHREADS_USR_SRC:摩尔线程 / Moore Threads 容器内 usr/src 挂载路径。
# MTHREADS_USR_SRC=/usr/src
# MTHREADS_LIB_MODULES:摩尔线程 / Moore Threads 容器内模块目录挂载路径。
# MTHREADS_LIB_MODULES=/lib/modules
# MTHREADS_HOME:摩尔线程 / Moore Threads 主目录挂载路径。
# MTHREADS_HOME=/home
# MTHREADS_DATA:摩尔线程 / Moore Threads 数据目录挂载路径。
# MTHREADS_DATA=/data
# MODEL_STORAGE_DIR:模型宿主机挂载目录。
# MODEL_STORAGE_DIR=/opt/dep/asr/models
# DATA_STORAGE_DIR:业务数据宿主机挂载目录。
# DATA_STORAGE_DIR=/opt/dep/asr/data
# NGINX_RATE_LIMIT_RPS:Nginx 全局限流,单位为每秒请求数。
# NGINX_RATE_LIMIT_RPS=0
# NGINX_RATE_LIMIT_BURST:Nginx 全局突发限流额度,0 表示自动按 RPS 处理。
# NGINX_RATE_LIMIT_BURST=0
# ASR_DEPLOY_TOPOLOGY:部署拓扑,isolated=每卡一个实例,sharded=单实例多卡分片,auto=优先 sharded 失败回退 isolated。
# ASR_DEPLOY_TOPOLOGY=isolated
# -----------------------------------------------------------------------------
# 运行时模型选择。
# 留空 QWEN3_ASR_MODEL 时会自动选择。
# 支持值:qwen3-asr-0.6b、qwen3-asr-1.7b
# -----------------------------------------------------------------------------
# ACCELERATOR:加速后端类型,常见值有 auto、cpu、nvidia、metax、iluvatar、mthreads。
# ACCELERATOR=auto
# DEVICE:具体运行设备,常见值有 auto、cpu、cuda:0。
# DEVICE=auto
# QWEN3_ASR_MODEL:手动指定离线识别模型,留空则自动挑选。
QWEN3_ASR_MODEL=qwen3-asr-0.6b
# -----------------------------------------------------------------------------
# 模型下载 / 缓存行为。
# 在 Docker Compose 中,默认宿主机挂载目录是 /opt/dep/asr/models。
# 实际模型目录通常位于:
# /opt/dep/asr/models/Qwen
# /opt/dep/asr/models/iic
# /opt/dep/asr/models/damo
# -----------------------------------------------------------------------------
# MODELS_DIR:项目主模型目录。
# MODELS_DIR=/opt/dep/asr/models
# MODELSCOPE_CACHE:ModelScope 缓存根目录,下面会生成 models/{publisher}/{model}。
# MODELSCOPE_CACHE=/opt/dep/asr
# MODELSCOPE_PATH:ModelScope 实际模型目录,建议保持在 models 目录下。
# MODELSCOPE_PATH=/opt/dep/asr/models
# -----------------------------------------------------------------------------
# 说话人注册 / pgvector 数据库配置。
# 表结构与 Model-Test-New 保持一致:speakers(id, name, user_id, embedding)。
# -----------------------------------------------------------------------------
# SPEAKER_DB_ENABLED:是否启用说话人库与 pgvector 检索。
# SPEAKER_DB_ENABLED=true
# DB_HOST:PostgreSQL 主机地址。
# DB_HOST=127.0.0.1
# DB_PORT:PostgreSQL 端口。
# DB_PORT=5432
# DB_USER:PostgreSQL 用户名。
# DB_USER=postgres
# DB_PASSWORD:PostgreSQL 密码。
# DB_PASSWORD=postgres
# DB_NAME:PostgreSQL 数据库名。
# DB_NAME=asr_db
# SV_MODEL:说话人识别模型。
# SV_MODEL=iic/speech_campplus_sv_zh-cn_16k-common
# SV_THRESHOLD:说话人相似度阈值,越大越严格。
# SV_THRESHOLD=0.6
# TEMP_DIR:临时文件目录。
# TEMP_DIR=/opt/dep/asr/data/temp
# LOG_FILE:日志文件路径。
# LOG_FILE=/opt/dep/asr/data/logs/qwen3-asr.log
# TASK_STATE_DIR:任务状态持久化目录。
# TASK_STATE_DIR=/opt/dep/asr/data/tasks
# TASK_RETENTION_HOURS:任务结果保留时间,单位小时。
# TASK_RETENTION_HOURS=24
# -----------------------------------------------------------------------------
# CPU Rust 后端覆盖配置。
# 一般不需要改;自动检测会检查 vendor/qwenasr/target/{release,debug}。
# -----------------------------------------------------------------------------
# QWENASR_LIBRARY_PATH:手动指定 libqwen_asr.so 的绝对路径。
# QWENASR_LIBRARY_PATH=/absolute/path/to/libqwen_asr.so
# -----------------------------------------------------------------------------
# 调优参数。除非你在做特定瓶颈测试,否则建议保持默认。
# -----------------------------------------------------------------------------
# REALTIME_STREAM_CHUNK_SEC:Qwen 流式解码间隔;0.6 秒参考 FunASR 每 10 个 60ms 音频帧解码一次。
# Qwen 每次解码会复用累计音频,缩短该值会降低显示延迟,也会增加推理开销。
# REALTIME_STREAM_CHUNK_SEC=0.6
# REALTIME_STREAM_MAX_PENDING_CHUNKS:Qwen 流式状态保留的待修订块数。
# REALTIME_STREAM_MAX_PENDING_CHUNKS=3
# REALTIME_ENABLE_VAD:启用 FSMN-VAD 流式端点和气泡时间边界。
# REALTIME_ENABLE_VAD=true
# REALTIME_VAD_CHUNK_MS:每次送入 FSMN-VAD 的音频块长度;参考 FunASR 示例使用 200ms。
# REALTIME_VAD_CHUNK_MS=200
# REALTIME_VAD_PRE_ROLL_MS:检测到语音起点时保留的前置音频,避免切掉首字。
# REALTIME_VAD_PRE_ROLL_MS=600
# ASR_BATCH_SIZE:批处理大小,表示一次并行推理的片段数。
# ASR_BATCH_SIZE=4
# ASR_ENABLE_WORD_TIMESTAMPS:是否启用字词级时间戳。
# ASR_ENABLE_WORD_TIMESTAMPS=false
# MAX_SEGMENT_SEC:离线 ASR 单段最大时长,单位秒。
# MAX_SEGMENT_SEC=60
# QWEN_RUST_CPU_WORKERS:Qwen Rust CPU 后端 worker 数。
# QWEN_RUST_CPU_WORKERS=4
# QWEN_RUST_ASR_CONCURRENCY:Qwen Rust ASR 并发数,0 通常表示自动。
# QWEN_RUST_ASR_CONCURRENCY=0
# QWEN_RUST_ALIGN_CONCURRENCY:Qwen Rust 对齐并发数,0 通常表示自动。
# QWEN_RUST_ALIGN_CONCURRENCY=0
# QWEN_GPU_MEMORY_UTILIZATION:GPU 显存使用比例。
# QWEN_GPU_MEMORY_UTILIZATION=0.9
# QWEN_VLLM_ENFORCE_EAGER:是否强制 vLLM eager 执行;国产卡/稳定优先建议 true,NVIDIA 性能测试可设 false。
# QWEN_VLLM_ENFORCE_EAGER=true
# QWEN_FORCE_ALIGNER_GPU_MEMORY_UTILIZATION:forced aligner 预留的显存比例。
# QWEN_FORCE_ALIGNER_GPU_MEMORY_UTILIZATION=0.15
# ASR_ENABLE_NEARFIELD_FILTER:是否启用近场/远场过滤。
# ASR_ENABLE_NEARFIELD_FILTER=true
# ASR_NEARFIELD_RMS_THRESHOLD:近场判断的 RMS 能量阈值。
# ASR_NEARFIELD_RMS_THRESHOLD=0.01
# -----------------------------------------------------------------------------
# 仅用于本地开发调试。
# -----------------------------------------------------------------------------
# LOG_LEVEL:日志级别。
# LOG_LEVEL=INFO
# FUNASR_STARTUP_UI:FunASR 启动界面模式。
# FUNASR_STARTUP_UI=auto