Skip to content

Repository files navigation

Kami Tunnel

TCP/UDP Tunnel - Không giới hạn traffic
Multipath TCP, Zero-copy splice & KCP UDP tunnel

Telegram

Important

📢 Bản quyền & Giấy phép
Dự án thuộc bản quyền của Kami2k1 (Quang Dev), phát hành theo giấy phép CC BY-NC 4.0 (xem LICENSE).
Khi fork/copy/sửa đổi, BẮT BUỘC phải:

  • Giữ nguyên thông tin tác giả gốc (Kami2k1)
  • Ghi rõ nguồn gốc github.com/kami2k1/tunnel trong README của bạn
  • Chỉ sử dụng cho mục đích phi thương mại
  • Vi phạm bản quyền sẽ bị xử lý theo pháp luật

Note

🎯 DỰ ÁN GỐC (ORIGINAL PROJECT)
Đây là repository CHÍNH THỨCDUY NHẤT của Kami Tunnel.
Mọi bản copy/fork khác đều KHÔNG PHẢI là dự án gốc.
Repository gốc: github.com/kami2k1/tunnel


📖 Giới thiệu

Kami Tunnel là công cụ tạo đường hầm (tunnel) giúp bạn public port nội bộ ra Internet nhanh chóng, an toàn và đơn giản — tương tự ngrok nhưng gọn nhẹ hơn.

💡 Mã nguồn minh bạch: Toàn bộ mã nguồn client & server nằm ngay trong repository này, phát hành theo CC BY-NC 4.0 — bạn có thể tự build, tùy chỉnh và tự host server cho nhu cầu phi thương mại.

✨ Tính năng chính

  • 🚀 TCP/UDP Tunneling - Hỗ trợ cả hai giao thức
  • 🔀 Multipath TCP - Ghép nhiều kết nối song song (mặc định 8 conn) với tự phục hồi gói tin
  • Zero-copy - Tối ưu hiệu suất với splice trên Linux
  • 📡 KCP UDP - Đường UDP nhanh, chống mất gói (FEC 10/3)
  • 🔄 Auto reconnect - Tự động kết nối lại khi mất kết nối
  • 📁 File Server - Chia sẻ file qua web với upload/download
  • 🔐 Xác thực bảo mật - Mật khẩu bảo vệ File Server
  • 📊 Giao diện TUI - Dashboard đẹp mắt với thống kê real-time

📦 Tải xuống

Hệ điều hành Kiến trúc Download
Linux amd64 kami-tunnel-linux-amd64.tar.gz
Linux arm64 kami-tunnel-linux-arm64.tar.gz
Windows amd64 kami-tunnel-windows-amd64.tar.gz
Windows arm64 kami-tunnel-windows-arm64.tar.gz
macOS amd64 kami-tunnel-darwin-amd64.tar.gz
macOS arm64 kami-tunnel-darwin-arm64.tar.gz
Android arm64 kami-tunnel-android-arm64.tar.gz

🚀 Cài đặt nhanh

Linux / macOS

tar -xzf kami-tunnel-linux-amd64.tar.gz
chmod +x kami-tunnel
./kami-tunnel 80

Windows

tar -xzf kami-tunnel-windows-amd64.tar.gz
kami-tunnel.exe 80

Android (Termux)

tar -xzf kami-tunnel-android-arm64.tar.gz
chmod +x kami-tunnel
./kami-tunnel 80

⚙️ Các tùy chọn (Flags)

Flag Mô tả Mặc định
--port Port nội bộ cần tunnel 80
--host Host nội bộ 127.0.0.1
--proto Giao thức (tcp/udp) tcp
--key Key tunnel (giữ nguyên port remote) random
--server Địa chỉ server ip.tunnel.kami2k1.com:8881
--server-kcp Địa chỉ KCP (bỏ trống = tự suy ra từ --server) tự suy
--id Tên client tùy chọn random
--parallel Pipeline song song true
--conn Số kết nối multipath TCP 8
--files Bật chế độ File Server false
--upload Cho phép upload file (cần --files) false
--delete Cho phép xóa file (cần --files) false
--pass Mật khẩu File Server kami123

📁 Chế độ File Server

Chia sẻ file qua web với giao diện đẹp và bảo mật.

Bật File Server

./kami-tunnel --files

Bật với Upload + Delete

./kami-tunnel --files --upload --delete

Đặt mật khẩu tùy chỉnh

./kami-tunnel --files --upload --pass "matkhaucuaban"

Tính năng File Server

  • 📂 Duyệt thư mục - Navigate qua các folder
  • ⬆️ Upload file - Kéo thả hoặc chọn file (chunked upload)
  • ⬇️ Download - Tải file đơn lẻ hoặc nhiều file (ZIP)
  • 🗑️ Xóa file - Xóa an toàn với xác nhận
  • 📁 Tạo thư mục - Tạo folder mới
  • 🔐 Bảo mật - Yêu cầu đăng nhập với mật khẩu

Mật khẩu mặc định: kami123


🎮 Ví dụ sử dụng

Tunnel port 80 (Web server)

./kami-tunnel 80

Tunnel port 22 (SSH)

./kami-tunnel 22

Tunnel UDP (Minecraft PE)

./kami-tunnel --proto udp --host 127.0.0.1 19132

Giữ nguyên port với key

./kami-tunnel --key mykey123 80

Tăng số kết nối multipath

./kami-tunnel --conn 16 80

File Server đầy đủ tính năng

./kami-tunnel --files --upload --delete --pass "secret123"

📊 Giao diện TUI

Khi chạy, bạn sẽ thấy giao diện dashboard với:

  • Status - Trạng thái kết nối
  • Public - URL public để truy cập
  • Traffic - Thống kê upload/download real-time
  • Ping - Độ trễ TCP/UDP
  • Logs - Log hoạt động

Phím tắt:

  • q hoặc Ctrl+C - Thoát
  • Esc - Thoát

⚠️ Lưu ý quan trọng

  1. Minecraft PE: Bắt buộc thêm --host 127.0.0.1 --proto udp
  2. Rate limit: Vui lòng tắt rate limit cho 127.0.0.1
  3. Firewall: Đảm bảo port không bị chặn bởi firewall

🛠️ Build từ mã nguồn

Yêu cầu: Go 1.24+. Go module: github.com/kami2k1/tunnel.

Build client (chạy thử nhanh)

go build -o kami-tunnel ./cmd/client
# hoặc dùng script:
./build.sh

Build server (Linux)

GOOS=linux GOARCH=amd64 go build -o bin/ngrok-server ./cmd/server
# hoặc build + deploy systemd (ngrok-server.service):
./build_server_.sh

Build đa nền tảng (release)

./build_clients.sh
# → 7 file tar.gz trong bin/ (linux/windows/darwin/android × amd64/arm64)

Cấu trúc mã nguồn

cmd/client      - CLI client + TUI
cmd/server      - CLI server
internal/app    - Engine client & server
internal/multipath  - Multipath TCP (ARQ/NACK)
internal/transport  - Zero-copy splice (Linux)
internal/udp        - KCP framing/session
internal/filesrv    - File server web
internal/protocol   - Giao thức control plane

🔗 Liên hệ & Hỗ trợ


📜 Giấy phép

CC BY-NC 4.0 (Creative Commons Attribution-NonCommercial 4.0 International) © 2026 - Kami2k1 (Quang Dev)

⚠️ THÔNG BÁO QUAN TRỌNG:

  • ĐƯỢC PHÉP sử dụng, xem và chỉnh sửa mã nguồn cho mục đích phi thương mại
  • BẮT BUỘC ghi công tác giả gốc Kami2k1 (Quang Dev) và dẫn link repo gốc github.com/kami2k1/tunnel trong mọi bản sao hoặc bản sửa đổi
  • CẤM sử dụng dự án (nguyên bản hoặc bản đã sửa) cho bất kỳ mục đích thương mại nào: bán, cho thuê, nhúng vào sản phẩm/dịch vụ thu phí...
  • Chi tiết đầy đủ điều khoản: xem file LICENSE
  • Mọi vi phạm sẽ bị xử lý theo pháp luật sở hữu trí tuệ

📁 Repository: Thư mục /tunnel là repository công khai chính thức của dự án Kami Tunnel — chứa đầy đủ mã nguồn client + server.

About

TUNELL TCP/UDP NO LIMIT TRAFFIC

Topics

Resources

Stars

53 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages