lxzan/gws

어떤 프로젝트인가요?

핵심 기능

• 01OnOpen, OnMessage, OnClose, OnPing, OnPong 콜백을 기반으로 하는 이벤트 기반 API입니다.
• 02여러 연결에 메시지를 배포할 때 한 번만 압축하는 Broadcaster입니다.
• 03context takeover와 설정 가능한 슬라이딩 윈도우 크기를 지원하는 permessage-deflate입니다.
• 04사용자 지정 Dialer를 통해 SOCKS5 또는 HTTP 프록시로 연결할 수 있습니다.
• 05TCP, KCP, Unix 도메인 소켓에서 실행할 수 있습니다.
• 06비동기 논블로킹 쓰기와 파일 세그먼트 쓰기를 지원합니다.

활용 사례

• Go로 실시간 채팅이나 인스턴트 메시징 백엔드를 구축합니다.
• 오래 유지되는 연결을 다수 처리하는 API 게이트웨이나 허브를 운영합니다.
• 브라우저 또는 앱 클라이언트에 실시간 업데이트나 pub/sub 메시지를 푸시합니다.
• SOCKS5 프록시를 통해 연결하는 WebSocket 클라이언트를 만듭니다.

빠른 시작

1. 1

   Go로 라이브러리를 설치합니다

   go get -v github.com/lxzan/gws@latest
2. 2

   Quick Start 코드를 넣은 main.go를 만들고 포트 6666에서 서버를 실행합니다

사용 전 알아둘 점

• !Go 1.18 이상이 필요합니다.

토픽

자주 묻는 질문

gws은(는) 무엇인가요?

permessage-deflate를 지원하고 TCP, KCP, Unix 소켓에서 사용할 수 있는 Go용 미니멀한 이벤트 기반 WebSocket 서버·클라이언트 라이브러리입니다. GWS(Go WebSocket)는 OnOpen, OnMessage, OnClose, OnPing, OnPong 콜백으로 구성된 간결한 이벤트 인터페이스를 기반으로 하는 Go용 WebSocket 라이브러리입니다. 각 연결은 자체 goroutine에서 이벤트 루프를 실행하므로 프로토콜 세부 사항은 감추고 애플리케이션 코드는 비즈니스 로직에 집중할 수 있습니다.

gws은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

gws은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

gws은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. gws의 마지막 커밋은 2026년 9월 11일입니다.

gws은(는) 어디에 사용할 수 있나요?

Go로 실시간 채팅이나 인스턴트 메시징 백엔드를 구축합니다. 오래 유지되는 연결을 다수 처리하는 API 게이트웨이나 허브를 운영합니다. 브라우저 또는 앱 클라이언트에 실시간 업데이트나 pub/sub 메시지를 푸시합니다. SOCKS5 프록시를 통해 연결하는 WebSocket 클라이언트를 만듭니다.

gws는 어떻게 설치하나요?

Go로 라이브러리를 설치합니다: go get -v github.com/lxzan/gws@latest Quick Start 코드를 넣은 main.go를 만들고 포트 6666에서 서버를 실행합니다

gws은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/lxzan/gws