[Feature] UDP 转发（udp_session / udp_data / 会话超时）
Maintainer thường phản hồi trong vòng 7 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- nodejs, python, rust, typescript
- Lĩnh vực
- networking
Hướng nghiên cứu
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.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
背景
当前只支持 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 报文天然适合二进制帧）。
- Ngôn ngữ chính
- Python
- Star
- 0
- Fork
- 0
- Merge trung bình
- 6 ngày 2 giờ
- Pull request đã merge (30 ngày)
- 2
Chuẩn bị môi trường
- Có Dockerfile hoặc tệp Docker Compose
- Không có mẫu pull request
- Không có hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của jeffkit/tunely
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 85/100
Maintainer thường phản hồi trong vòng 7 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 87/100
Maintainer thường phản hồi trong vòng 7 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
jeffkit/tunely#24 · 3 bình luận ·
Maintainer thường phản hồi trong vòng 7 ngày
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 85/100
jeffkit/tunely#22 · 3 bình luận ·
Maintainer thường phản hồi trong vòng 7 ngày
-
fix(release): 发布链 fail-open（缺 secret 时 Actions 绿但什么都没发）+ PyPI 上的 0.10.0 恰是 /forward 无鉴权的安全缺口版本Đang mở
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 34/100
jeffkit/tunely#23 · 3 bình luận ·
Maintainer thường phản hồi trong vòng 7 ngày
Tất cả issue của jeffkit/tunely
Issue tương tự
-
component:benchmark
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
agentic-os-org/ANOLISA#9177 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
distrochooser/distrochooser#520 ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Status: Needs confirmation Status: Needs triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 64/100
Maintainer thường phản hồi trong vòng 1 ngày
-
[BUG] Published Docker images lack the redis extra: HEADROOM_COMPRESS_SESSION_STORE stops startupCó thể đã có người làm @AlessandroSpallina đã nhận hôm nay. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
headroomlabs-ai/headroom#4513 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 65/100
codespell-project/codespell#4060 ·
Maintainer thường phản hồi trong vòng 1 ngày