[Feature] UDP 转发(udp_session / udp_data / 会话超时)
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 25/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Bastante claro
- Estado de actividad
- Activo
- Stack tecnológico
- nodejs, python, rust, typescript
- Área
- networking
Línea de trabajo
Start with issue #3's Protocol v2 binary data-plane design and the existing WS_TUNNEL_TCP_LISTEN handling. Trace the server session lifecycle and the TypeScript dgram and Rust tokio::net::UdpSocket client paths before deciding how the three clients fit. Done means the DNS, timeout cleanup, conformance, and WS-disconnect acceptance checks pass without leaked resources.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
背景
当前只支持 TCP。frp / rathole / bore 均支持 UDP(DNS、游戏、QUIC 等场景)。
设计草图
UDP 无连接,但需要 NAT 会话语义。建议:
- 新增消息(与 TCP 三件套平行):
udp_open { session_id, conn_id }(服务端 → 客户端):外部 UDP 首包到达时,服务端为该 (外部地址, 端口) 分配会话并通知客户端建 socketudp_data { session_id, data(base64) }(双向):数据报传递udp_close { session_id, reason? }(双向):会话结束- 复用现有 WS 会话,session_id 由服务端分配
- 服务端:新增 UDP 监听器(每端口绑一条隧道,复用 0.5.0 的 WS_TUNNEL_TCP_LISTEN 格式,如
"9080:dsh/udp");会话表 (endpoint → session_id),空闲超时(建议 30s 可配)后回收并下发 udp_close - 客户端:每 session 绑定一个 UdpSocket(TS: dgram / Rust: tokio::net::UdpSocket),回包按 session_id 路由
- 顺序与重复:UDP 本身不保证,不做重传;分片由 IP 层处理,单报文不超过 MTU(服务端按 1472 截断告警)
验收
- DNS 查询经隧道往返成功(A 记录)
- 会话空闲超时回收,客户端资源不泄漏
- 三客户端实现 + conformance 场景
- WS 断开时会话全量清理(与 TCP 行为一致)
依赖
建议与 Protocol v2 二进制数据面 同期实施(UDP 报文天然适合二进制帧)。
- Lenguaje dominante
- Python
- Estrellas
- 0
- Forks
- 0
- Métricas de merge de PR
- Sin PR fusionados en 30 d
Preparar el entorno
- Incluye un Dockerfile o un archivo de Docker Compose
- Sin plantilla de pull request
- Sin guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de jeffkit/tunely
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 80/100
-
fix(release): 发布链 fail-open(缺 secret 时 Actions 绿但什么都没发)+ PyPI 上的 0.10.0 恰是 /forward 无鉴权的安全缺口版本Abierto
Dificultad 4/5 3-5 días Aptitud para principiantes 34/100
-
Dificultad 3/5 1-2 días Aptitud para principiantes 45/100
Todos los issues de jeffkit/tunely
Issues similares
-
changelog investigate
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
ramnes/notion-sdk-py#409 ·
-
good first issue help wanted
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
lindicaphxag-tech/kaggle#28 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
BSData/horus-heresy-3rd-edition#3211 ·
Los mantenedores suelen responder en 1 día
-
bug needs-triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
Los mantenedores suelen responder en 1 día
-
Unreachable-proxy mount test depends on fixed port 9999Posiblemente ocupada Un pull request vinculado a esta issue está abierto o ya se fusionó. Abiertobug tests
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
Los mantenedores suelen responder en 1 día