Skip to content

feat: Alpacon-CLI based tunneling(port-forwarding) #66

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
jisung-02 wants to merge 22 commits into
base: main
Choose a base branch
from
Open

feat: Alpacon-CLI based tunneling(port-forwarding) #66

jisung-02 wants to merge 22 commits into from

Conversation

@jisung-02
Copy link

@jisung-02 jisung-02 commented Dec 19, 2025

Summary

  • Added tunnel command for TCP tunneling functionality
  • Implemented efficient connection handling through WebSocket + smux multiplexing

Key Changes

New Feature: alpacon tunnel command

  • Creates TCP tunnels that forward local port traffic to remote server ports
  • Supports connection multiplexing using the smux library
  • Provides username/groupname specification options
  • Connection logs viewable in verbose mode

How to use

alpacon tunnel [SERVER NAME] -l 9000 -r 5432

  • Then connect to the tunneled service:
    psql -h localhost -p 9000 -U [user] postgres
  • This creates a local tunnel on port 9000 that forwards traffic to port 5432 on the remote server. You can then connect to PostgreSQL through the local port.

@jisung-02
Add smux library for multiplexing support
1b094d6
@jisung-02
Add core tunnel utilities
b42906b 
  - Add smux configuration with optimized settings
  - Add WebSocket to net.Conn adapter for smux compatibility
  - Add buffer pool for efficient memory management
@jisung-02
Add tunnel session API client
60fe0d5
@jisung-02
Add tunnel command for TCP port forwarding
3467318
@jisung-02
Add connection limiting and client_type to tunnel command
6538746
@jisung-02
Change url from websocket_url to connect_url
3045856
@jisung-02
Add username and groupname to tunnel session request
fe24a70 
  - Add username (required) and groupname fields to TunnelSessionRequest
  - Add -u/--username and -g/--groupname CLI flags
  - Default groupname to 'alpacon'
@jisung-02
Add omitempty to groupname for server default handling
b75b58d
@jisung-02
Merge branch 'main' into 51-tunneling
8bcdea4
@jisung-02
Remove unused limiter and proxy flag for tunnel command
589748a
@jisung-02
Remove unused protocol flag and related logics
9c6b526
@jisung-02
Minor fix
80e620e
@jisung-02
Simplify tunnel WebSocket dialer and improve help documentation
55829e0
@jisung-02
Remove and simplify codes in conn.go and pool.go
f62d069
@jisung-02
Move GetSmuxConfig from pkg/tunnel to config package
d26872f
@jisung-02
Minor fix
2ac86a0
@jisung-02
Align tunnel command with websh implementation
3a0ea81
@jisung-02
Modify the code to suppress logging by default and only enable it whe…
9228f28 
…n the verbose flag is present
@jisung-02
Close listener when session dies to stop accepting new connections
0dd90d5
@jisung-02 jisung-02 self-assigned this Dec 19, 2025
@jisung-02 jisung-02 marked this pull request as draft December 22, 2025 08:34
@jisung-02 jisung-02 marked this pull request as ready for review December 22, 2025 13:35
mingyu-00
mingyu-00 reviewed Dec 26, 2025
View reviewed changes
@jisung-02 jisung-02 marked this pull request as draft December 26, 2025 06:15
@jisung-02 jisung-02 marked this pull request as ready for review December 26, 2025 06:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@mingyu-00 mingyu-00 mingyu-00 approved these changes

@eunyoung14 eunyoung14 Awaiting requested review from eunyoung14

Assignees

@jisung-02 jisung-02

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@jisung-02 @mingyu-00