sish

HTTP(S), WS(S), TCP, 별칭 및 SNI를 위한 오픈 소스 SSH 터널링.

serveo/ngrok 스타일 공유의 간편함을 좋아하지만 일반 SSH를 사용하고 자체 인프라를 운영하고 싶다면 sish가 그 목적으로 만들어졌습니다.

• 최종 사용자에게 별도의 클라이언트 불필요
• 공개 및 비공개 터널 워크플로
• Docker 및 바이너리 릴리스
• 프로덕션 수준의 자체 호스팅에 적합

Docs | Managed Service | Releases | Docker Images | Sponsored by pico.sh

sish를 사용하는 이유

sish는 포워딩 및 멀티플렉싱에 중점을 둔 SSH 서버를 실행합니다. 사용자는 이미 알고 있는 명령어로 연결하고 sish가 라우팅을 처리합니다.

일반적인 사용 사례

• 로컬 웹 앱을 HTTPS를 통해 즉시 공유
• TCP 서비스를 고정 또는 임의의 외부 포트로 노출
• 인증된 SSH를 통해서만 접근 가능한 비공개 TCP 별칭 생성
• TLS를 종료하지 않고 SNI를 통해 여러 백엔드로 TLS 트래픽 라우팅

빠른 시작

1) 관리형 서비스 사용해보기

워크플로를 검증하는 가장 빠른 방법:

ssh -R 80:localhost:8080 tuns.sh

로컬에서 8080 포트로 실행 중인 앱에 대한 공개 URL이 생성됩니다.

2) Docker로 자체 호스팅

이미지 가져오기:

docker pull antoniomika/sish:latest

디렉토리 준비:

mkdir -p ~/sish/ssl ~/sish/keys ~/sish/pubkeys
cp ~/.ssh/id_ed25519.pub ~/sish/pubkeys

실행:

docker run -itd --name sish \
	-v ~/sish/ssl:/ssl \
	-v ~/sish/keys:/keys \
	-v ~/sish/pubkeys:/pubkeys \
	--net=host antoniomika/sish:latest \
	--ssh-address=:2222 \
	--http-address=:80 \
	--https-address=:443 \
	--https=true \
	--https-certificate-directory=/ssl \
	--authentication-keys-directory=/pubkeys \
	--private-keys-directory=/keys \
	--bind-random-ports=false \
	--domain=example.com

그런 다음 연결:

ssh -p 2222 -R 80:localhost:8080 example.com

포워딩 예제

HTTP 터널

ssh -R myapp:80:localhost:8080 tuns.sh

localhost:8080에서 실행 중인 앱이 https://myapp.tuns.sh에서 사용 가능해집니다.

TCP 터널

ssh -R 2222:localhost:22 tuns.sh

localhost:22가 tuns.sh:2222에서 사용 가능해집니다.

비공개 TCP 별칭

ssh -R mylaptop:22:localhost:22 tuns.sh

다른 클라이언트에서 접근:

ssh -J tuns.sh mylaptop

주요 기능

• HTTP(S), WS(S), TCP 포워딩 및 멀티플렉싱
• 비공개 내부 전용 접근 패턴을 위한 TCP 별칭
• TLS 기반 백엔드 라우팅을 위한 SNI 프록시 지원
• HTTP/TCP/SNI 별칭을 위한 선택적 로드 밸런싱 모드
• 포워딩된 요청 검사를 위한 서비스 콘솔 지원
• 동적 키 재로드가 가능한 키 및 비밀번호 인증
• 더 안전한 멀티 테넌트 설정을 위한 제한적 바인딩 정책

로컬 개발

복제:

git clone [email protected]:antoniomika/sish.git
cd sish

로컬에서 시작:

go run main.go --http-address localhost:3000 --domain testing.ssi.sh

또는 다음 사용:

make dev

터널 테스트:

ssh -p 2222 -R 80:localhost:8080 testing.ssi.sh

testing.ssi.sh는 개발을 위해 localhost를 가리키도록 구성되어 있습니다.

더 알아보기

• Getting Started
• Forwarding Types
• CLI Reference
• FAQ

커뮤니티

• IRC: #sish on libera / #pico.sh on libera
• 이메일: [email protected]