配置与环境变量

设置的来源与优先级复制锚点链接

生效的设置由四层合并而成，后面的覆盖前面的：

1. 内置默认值；
2. settings.toml（默认在数据目录中；RVC_NEXT_CONFIG_DIR、webui --config-dir 或嵌入方可以把它放到别的文件夹）；
3. 环境变量 RVC_NEXT_<GROUP>__<FIELD>；
4. 嵌入方传入的覆盖值（rvc-next 被其他程序以库的方式使用时才有，见 嵌入到其他程序）。

环境变量和覆盖值只在内存中生效，不会写回 settings.toml。Web UI 里被环境变量覆盖的文件夹设置会标注 由环境变量设置，被嵌入方固定的标注 由嵌入 rvc-next 的应用设置；rvc-next config set 修改一个被环境变量覆盖的设置时，会提示 "An environment variable overrides this setting."。

环境变量复制锚点链接

rvc-next env 列出 rvc-next 读取的环境变量，以及当前已设置的 RVC_NEXT_* 变量：

另外，引擎读取 RVC_NEXT_CUDA_GRAPH_MAX_CACHE：每个调用点最多缓存多少个 CUDA Graph（默认 8），一般不需要修改。

覆盖设置的规则：

• 去掉前缀 RVC_NEXT_ 后转成小写，__（两个下划线）表示下一级，例如 RVC_NEXT_COMPUTE__GPU_JOBS 对应 compute.gpu_jobs，RVC_NEXT_LIVE__STREAM__BLOCK_MS 对应 live.stream.block_ms。
• 值能按 JSON 解析就按 JSON 解析（数字、true/false、列表、对象），否则作为字符串；null 或 none 表示空值。

export RVC_NEXT_DATA_DIR=/data/rvc-next
export RVC_NEXT_COMPUTE__DEVICE=cuda:1
RVC_NEXT_SERVER__PORT=8000 rvc-next webui

用命令行查看和修改复制锚点链接

rvc-next config path                        # settings.toml 的路径
rvc-next config show                        # 生效的全部设置（JSON）
rvc-next config get compute.device
rvc-next config set compute.device cpu
rvc-next config set compute.gpu_jobs 2
rvc-next config set paths.browse_roots '["D:/music", "E:/datasets"]'
rvc-next config set server.access_token "一个足够长的随机字符串"
rvc-next config set server.access_token null # 清除令牌

• 键用点分隔，值按 JSON 解析；写入前整体校验，取值超出范围或类型不对时报错（退出码 4），文件不变。
• config show 不显示访问令牌，只显示 access_token_configured 是否已设置；它还会列出 resolved_paths（文件夹设置为空时实际使用的路径）、env_overrides（生效的环境变量）和 pinned。
• null 只能清除可以为空的设置（如 server.access_token、training.batch_size）；想恢复某项的默认值，用 config set 写回下表中的默认值即可。

全部设置项复制锚点链接

下表中"类型"一栏的 str?、int? 表示可以为空（null）。文件夹类设置留空表示"使用数据目录下的默认文件夹"。

server：服务器复制锚点链接

paths：文件夹复制锚点链接

compute：计算复制锚点链接

设备和精度的具体规则见 硬件与性能。

downloads：下载复制锚点链接

convert：转换复制锚点链接

convert.default_params（音色参数，含义见 音色参数）：

separation：分离复制锚点链接

training：训练默认值复制锚点链接

新建实验时使用的默认值；已有实验的设置保存在它自己的 experiment.json 里。

live：实时变声复制锚点链接

"设备选择"是一个对象：device_id（空为跟随系统默认）、physical_key、name、host_api、channels（输入为要混合成单声道的声道，从 1 开始；输出为写入的声道；空为输入第一个、输出前两个）、sample_rate、exclusive（WASAPI 独占模式）。这些通常在 Web UI 的设备面板里选择，或由 rvc-next live run --input/--output 写入，不需要手动编辑。

哪些修改需要重启复制锚点链接

数据目录复制锚点链接

数据目录的位置：

用环境变量 RVC_NEXT_DATA_DIR 或 rvc-next webui --data-dir 可以换到其他位置。rvc-next config show 的 data_dir 显示当前使用的目录，Web UI 中在 设置 › 关于 的 数据文件夹。

<数据目录>/
├── settings.toml            设置（另行指定配置目录时不在这里）
├── rvc-next.db              数据库：音色缓存、预设、任务、结果、界面状态
├── server.json              服务器运行时写入（地址和端口），退出时删除
├── assets-verified.json     已通过校验的资源记录
├── legacy-voices.json       原版 RVC 安装中音色的索引配对（含你的修改）
├── assets/                  资源（paths.assets_dir），与原版 RVC 的 assets 结构相同
│   ├── hubert_base/
│   ├── rmvpe/               rmvpe.pt、rmvpe.onnx
│   ├── fcpe/
│   ├── pretrained/          v1 底模
│   ├── pretrained_v2/       v2 底模
│   └── pymss_weights/       分离模型权重
├── models/                  模型库（paths.models_dir）
│   ├── voices/<名称>/        model.pth、model.index 或 spk<N>.index、voice.json
│   ├── indexes/             未分配的索引
│   ├── base/                导入的底模（G 和 D）
│   ├── separation/          导入的分离模型（检查点和 YAML）
│   └── attached-indexes/    为原版 RVC 安装中的音色附加的索引副本
├── experiments/<实验>/       训练实验（paths.experiments_dir），含 experiment.json 和原版的各阶段文件夹
├── outputs/<日期>/<任务 id>/  转换和分离的结果（paths.outputs_dir）
├── jobs/<任务 id>.log         任务日志
├── uploads/                 上传和导入的暂存文件（导入会话保留 24 小时）
├── cache/peaks/             波形缓存
└── trash/                   系统回收站不可用时，删除的文件移到这里

音色库以文件夹为准：数据库里的音色列表只是缓存，可以从 models/ 和原版 RVC 安装重建。实验是文件夹，不在数据库里。