Host)条件匹配入站请求,实现多租户隔离、多环境并行、灰度分流等场景。mcp-prod.example.com 与测试域名 mcp-test.example.com。Host 或 X-Tenant-Id Header 将不同租户流量分发到独立入口。X-Canary: true 的请求单独走一条路由。X-Version 的正则模式(如 ^v[2-3]\\..*)匹配。术语 | 说明 |
默认路由 | 创建 MCP 服务时系统自动生成的路由,名称固定为 default,优先级为 0。不可修改、不可删除、不可禁用,作为兜底入口保证服务可达 |
自定义路由 | 用户手动创建的路由规则,优先级默认从 1000 起步。可增删改查、可启用/禁用 |
匹配表达式 | 系统根据你配置的 Path、Methods、Header 条件自动生成的路由匹配表达式,只读展示,无需手工编写 |
列名 | 说明 |
优先级 | 0,数值越大优先匹配。默认路由为 0 |
路由名称 | 默认路由固定为 default,并带默认标签 |
状态 | 已启用 / 已禁用 |
匹配路径 | 路径值 + 匹配方式标签(精确/前缀/正则) |
Host 匹配 | 不限 |
Path 匹配 | 精确匹配,/mcpservers/mcp 服务名称/mcp |
Header 匹配 | 无条件显示 — |
HTTP 方法 | 允许的方法列表 |
创建时间 | 路由创建时间 |
操作 | 编辑 / 启用/禁用 / 删除(默认路由行无操作按钮) |
参数名 | 是否必填 | 取值范围/默认值 | 说明 |
路由名称 | 必填 | 最长 64 个字符 | 同一 MCP 服务下不可重复。 不可使用 default(系统保留) |
优先级 | 选填 | 默认 1000 | 数值越大优先匹配。自定义路由建议保持 ≥ 1000,确保优先于默认路由 |
描述 | 选填 | 最长 200 个字符 | - |
参数名 | 是否必填 | 取值范围/默认值 | 说明 |
匹配路径 | 选填 | 最长 256 个字符 | 需以 / 开头,如 /api。不同路由的路径可以重复,通过其他条件区分 |
匹配方式 | 选填 | 精确 / 前缀 / 正则 | 精确:路径完全一致;前缀:路径以指定值开头;正则:路径符合 RE2 正则表达式 |
^/api/v[0-9]+$)。非法正则在提交时即被拦截。参数名 | 是否必填 | 取值范围/默认值 | 说明 |
匹配方式 | 必填 | 精确 / 前缀 / 正则 | 正则必须为合法 RE2 语法 |
匹配值 | 必填 | - | 填写目标 Host 值 |
参数名 | 是否必填 | 取值范围 | 说明 |
HTTP 方法 | 选填 | GET / POST / PUT / DELETE / PATCH / HEAD / OPTIONS | 多选,作为方法白名单。不选择表示不限制方法 |
参数名 | 是否必填 | 取值范围/默认值 | 说明 |
Header 名称 | 必填 | 最长 64 个字符 | 大小写不敏感。填写 Host 时系统自动识别为对请求域名的匹配(无需单独的 Host 配置项) |
匹配方式 | 必填 | 精确 / 前缀 / 正则 | 正则必须为合法 RE2 语法 |
匹配值 | 必填 | 最长 256 个字符 | - |
default)不支持修改。 该行不展示编辑按钮。文档反馈