Router

UDP 路由器¶

UDP 路由器负责将传入的 UDP 数据包交给能够处理它们的服务。与 HTTP 和 TCP 路由器不同，UDP 路由器工作在传输层，并因 UDP 的无连接特性而具有独特行为。

UDP 路由器特性

结构化 (YAML)

udp:
  routers:
    my-udp-router:
      entryPoints:
        - "udp-ep"
        - "dns"
      service: my-udp-service

结构化 (TOML)

[udp.routers]
  [udp.routers.my-udp-router]
    entryPoints = ["udp-ep", "dns"]
    service = "my-udp-service"

容器标签

labels:
  - "traefik.udp.routers.my-udp-router.entrypoints=udp-ep,dns"
  - "traefik.udp.routers.my-udp-router.service=my-udp-service"

服务标签

{
  "Tags": [
    "traefik.udp.routers.my-udp-router.entrypoints=udp-ep,dns",
    "traefik.udp.routers.my-udp-router.service=my-udp-service"
  ]
}

字段	说明	默认值	必填
`entryPoints`	路由器附加到的入口点列表。如果未指定，UDP 路由器会附加到所有 UDP 入口点。	所有 UDP 入口点	否
`service`	处理匹配 UDP 数据包的服务名称。UDP 服务通常是将数据包分配给多个后端服务器的负载均衡服务。详见 UDP 服务。		是

尽管 UDP 无连接，Traefik 的 UDP 路由器实现仍依赖会话，维护客户端与后端之间正在进行的通信状态。这样代理才能知道应将后端的响应数据包转发到哪里。

每个会话都有关联的超时，用于在指定的不活动时长后清理不活动会话。

可以通过静态配置中的 entryPoints.name.udp.timeout 选项配置会话超时。详见入口点文档。