FMR 配置手册

🚀 快速配置（推荐）

使用交互式设置向导，自动引导填写 Key 和选择模型：

fmr setup

向导会依次询问：

• 选择要启用的 Provider（多选）
• 输入每个 Provider 的 API Key
• 为每个 Provider 选择默认模型
• 设置路由策略（轮询 / 权重 / 优先级）

📝 手动配置

直接编辑配置文件，适合批量配置或自动化部署：

# 配置文件路径
~/.free-model-router/data/config.json

# 或使用环境变量
export FMR_CONFIG_PATH=/path/to/config.json

配置示例（单 Provider）：

{
  "providers": [
    {
      "id": "sensenova",
      "enabled": true,
      "apiKey": "sk-your-key-here",
      "model": "deepseek-v4-flash",
      "baseUrl": "https://api.sensenova.cn/v1"
    }
  ],
  "routing": {
    "strategy": "round-robin",
    "fallback": true
  }
}

📊 支持的 Provider 列表

🔄 内置策略

⚙️ 配置示例

{
  "routing": {
    "strategy": "health",
    "fallback": true,
    "healthCheck": {
      "interval": 300,
      "timeout": 30
    },
    "weights": {
      "sensenova": 3,
      "nvidia-nim": 2,
      "openrouter": 1
    }
  }
}

🖥️ 访问面板

启动服务后，浏览器访问本地管理面板：

http://127.0.0.1:5678/admin

面板功能：

• 实时监控 — 各 Provider 健康状态、响应延迟、成功率
• 模型列表 — 查看所有可用模型及其能力标签
• 事件通知 — Provider 故障、额度告警、模型下架预警
• 配置管理 — 在线修改 Provider 配置，无需重启
• 用户反馈 — 提交问题、建议，直接进 GitHub issue

v3.0 新增的 MoA 多模型聚合、自定义 Provider、自定义分组三个功能都在面板里操作，分步教程见 FMR v3.0 新功能操作指引。

📱 远程访问（可选）

如果在服务器上部署，建议通过 SSH 隧道安全访问：

# 本地端口转发
ssh -L 5678:localhost:5678 user@your-server

或使用 Cloudflare Tunnel 等安全方案暴露到公网（不推荐直接暴露 Admin 面板）。

❌ 无法连接到 Provider

• 检查 API Key 是否正确（注意 Key 是否有过期）
• 确认 Provider 服务是否正常（访问官网状态页）
• 检查网络连接（部分 Provider 需要特定网络环境）
• 查看 FMR 日志：fmr logs 或 ~/.free-model-router/data/logs/

🔄 路由不切换 / 一直失败

• 确认 fallback: true 已开启
• 检查多个 Provider 是否都已启用
• 查看 Admin 面板健康评分，确认备用 Provider 可用
• 尝试切换路由策略：fmr config set routing.strategy round-robin

⏱️ 响应慢 / 超时

• 使用 latency 策略自动选择最快节点
• 增加超时时间：routing.timeout: 60
• 检查本地网络是否稳定
• 部分 Provider 高峰期限流，建议多 Provider 配置