DokumentePreiseBlog
Kontaktieren Sie uns
AnmeldenKOSTENLOS anmelden
Back to Tech Articles

수천 개의 동시 연결을 위한 확장 가능한 Go WebSocket 서비스 구축

Jul 08, 2025
# Misc

Daniel Hayes

Full-Stack Engineer · Leapcell

Dieser Beitrag ist auch in English, 日本語 und Deutsch verfügbar
Cover of "수천 개의 동시 연결을 위한 확장 가능한 Go WebSocket 서비스 구축"

소개

오늘날 상호 연결된 세상에서 실시간 통신은 더 이상 사치가 아닌 기대치입니다. 라이브 채팅 애플리케이션, 협업 편집 도구부터 온라인 게임 및 금융 대시보드에 이르기까지 즉각적인 업데이트 및 상호 작용 경험에 대한 수요는 계속 증가하고 있습니다. 클라이언트와 서버 간의 지속적이고 전이중 통신 채널을 제공하는 웹소켓은 이러한 애플리케이션을 구축하기 위한 사실상의 표준이 되었습니다. 그러나 수천 또는 수백만 개의 동시 웹소켓 연결을 처리하는 것은 상당한 엔지니어링 과제를 제시합니다. 이러한 종류의 로드에서는 기존의 요청-응답 아키텍처가 어려움을 겪으며 종종 리소스 고갈과 성능 병목 현상을 초래합니다. Go는 경량 고루틴과 효율적인 동시성 모델을 통해 고성능 네트워크 서비스를 구축하는 데 놀랍도록 적합합니다. 이 문서는 Go의 강점을 활용하여 수천 개의 동시 연결을 효과적으로 관리할 수 있는 확장 가능한 웹소켓 서버를 구축하는 방법을 탐구하며, 강력한 실시간 애플리케이션의 토대를 마련합니다.

핵심 구성 요소 이해

구현 세부 사항을 자세히 살펴보기 전에 확장 가능한 웹소켓 서비스를 구축하는 데 중요한 몇 가지 기본 개념을 명확히 하겠습니다.

웹소켓

웹소켓은 단일 TCP 연결을 통해 지속적이고 양방향 통신 채널을 제공합니다. 상태 비저장(stateless)이며 요청-응답 모델에 의존하는 HTTP와 달리 웹소켓은 초기 핸드셰이크 이후 클라이언트와 서버 모두 언제든지 메시지를 보낼 수 있으므로 오버헤드와 지연 시간을 크게 줄입니다. Go에서는 github.com/gorilla/websocket 라이브러리가 웹소켓 작업을 위한 가장 인기 있는 선택지로, 강력하고 사용하기 쉬운 API를 제공합니다.

고루틴

고루틴은 Go의 경량이며 동시 실행 함수입니다. 기존 OS 스레드보다 훨씬 저렴하여 Go 프로그램이 수천 또는 수백만 개의 고루틴을 동시에 실행할 수 있습니다. 각 연결을 상당한 리소스 오버헤드 없이 자체 고루틴으로 관리할 수 있으므로 수많은 웹소켓 연결을 처리할 때 중요한 이점입니다.

채널

채널은 고루틴이 값을 보내고 받을 수 있는 형식화된 통신 경로입니다. 고루틴 간의 통신을 위해 설계되었으며 데이터 공유를 위한 안전한 메커니즘 역할을 하여 경쟁 상태를 방지합니다. 채널은 Go의 동시성 모델의 기본이며 웹소켓 서버에서 메시지 흐름 관리 및 고루틴 조정에 광범위하게 사용됩니다.

Fan-out/Fan-in 패턴

이것은 Go에서 일반적인 동시성 패턴입니다. "fan-out" 단계는 여러 고루틴으로 작업을 분산하고, "fan-in" 단계는 해당 고루틴의 결과를 수집합니다. 웹소켓 컨텍스트에서 단일 클라이언트의 단일 메시지는 여러 구독 클라이언트에 "fan-out"되어야 할 수 있으며, 다양한 클라이언트의 메시지를 "fan-in"하여 중앙 처리 장치로 보낼 수 있습니다.

확장 가능한 웹소켓 서비스 구축

Go에서 확장 가능한 웹소켓 서비스를 구축하려면 주로 효율적인 연결 관리, 메시지 브로드캐스팅 및 리소스 처리에 중점을 둔 몇 가지 주요 설계 고려 사항이 필요합니다.

연결 관리

각 들어오는 웹소켓 연결은 수락 및 관리되어야 합니다. 일반적인 접근 방식은 연결된 각 클라이언트에 고루틴을 전담하는 것입니다. 이 고루틴은 클라이언트로부터 메시지를 읽고, 클라이언트로 메시지를 쓰고, 연결별 논칙을 처리하는 역할을 합니다.

package main

import (
	"log"
	"net/http"
	"time"

	"github.com/gorilla/websocket"
)

// Upgrader upgrades HTTP connections to WebSocket connections.
var upgrader = websocket.Upgrader{
	ReadBufferSize:  1024,
	WriteBufferSize: 1024,
	CheckOrigin: func(r *http.Request) bool {
		// Allow all origins for simplicity in this example.
		// In production, restrict this to your domain.
		return true
	},
}

// Client represents a single connected WebSocket client.
type Client struct {
	conn *websocket.Conn
	send chan []byte // Channel to send messages to the client
}

// readPump reads messages from the WebSocket connection.
func (c *Client) readPump() {
	defer func() {
		// Clean up the client connection when the goroutine exits
		log.Printf("Client disconnected: %s", c.conn.RemoteAddr())
		// TODO: Unregister client from the hub
		c.conn.Close()
	}()

	for {
		_, message, err := c.conn.ReadMessage()
		if err != nil {
			if websocket.IsUnexpectedCloseError(err, websocket.CloseGoingAway, websocket.CloseAbnormalClosure) {
				log.Printf("Read error: %v", err)
			}
			break
		}
		log.Printf("Received: %s", message)
		// TODO: Process received message (e.g., broadcast to others)
	}
}

// writePump writes messages to the WebSocket connection.
func (c *Client) writePump() {
	ticker := time.NewTicker(time.Second * 10) // Ping interval
	defer func() {
		ticker.Stop()
		c.conn.Close()
	}()

	for {
		select {
		case message, ok := <-c.send:
			if !ok {
				// The hub closed the channel.
				c.conn.WriteMessage(websocket.CloseMessage, []byte{})
				return
			}
			if err := c.conn.WriteMessage(websocket.TextMessage, message); err != nil {
				log.Printf("Write error: %v", err)
				return
			}
		case <-ticker.C:
			// Send ping messages to keep the connection alive
			if err := c.conn.WriteMessage(websocket.PingMessage, nil); err != nil {
				log.Printf("Ping error: %v", err)
				return
			}
		}
	}
}

// serveWs handles WebSocket requests from peers.
func serveWs(w http.ResponseWriter, r *http.Request) {
	conn, err := upgrader.Upgrade(w, r, nil)
	if err != nil {
		log.Println("Upgrade error:", err)
		return
	}

	client := &Client{conn: conn, send: make(chan []byte, 256)}
	log.Printf("Client connected: %s", conn.RemoteAddr())
	// TODO: Register client with the hub

	go client.writePump()
	client.readPump() // Blocks until client disconnects or error
}

func main() {
	http.HandleFunc("/ws", serveWs)
	log.Fatal(http.ListenAndServe(":8080", nil))
}

serveWs 함수에서 성공적인 웹소켓 업그레이드 후에, 연결과 버퍼링된 채널(send)을 보유하는 Client 구조체를 생성합니다. 이 send 채널은 메시지 프로듀서와 컨슈머를 디커플링하고, 데드락을 방지하며, 백프레셔를 제공하는 데 중요합니다. readPump 고루틴은 클라이언트로부터 메시지를 지속적으로 읽고, writePump 고루틴은 send 채널에서 클라이언트로 메시지를 보내며, 연결을 유지하기 위한 주기적인 핑 메시지도 처리합니다.

메시지 브로드캐스팅을 위한 중앙 집중식 허브

효율적으로 여러 클라이언트에게 메시지를 브로드캐스팅하려면 중앙 집중식 "허브"가 필수적입니다. 이 허브는 모든 활성 클라이언트 연결을 관리하고 메시지 배포를 촉진합니다.

package main

import (
	"log"
	"net/http"
	"time"

	"github.com/gorilla/websocket"
)

// ... (Client, upgrader, readPump, writePump definitions as above) ...

// Hub maintains the set of active clients and broadcasts messages to them.
type Hub struct {
	// Registered clients.
	clients map[*Client]bool

	// Inbound messages from the clients.
	broadcast chan []byte

	// Register requests from the clients.
	register chan *Client

	// Unregister requests from clients.
	unregister chan *Client
}

// NewHub creates and returns a new Hub instance.
func NewHub() *Hub {
	return &Hub{
		broadcast:  make(chan []byte),
		register:   make(chan *Client),
		unregister: make(chan *Client),
		clients:    make(map[*Client]bool),
	}
}

// run starts the hub's main event loop.
func (h *Hub) run() {
	for {
		select {
		case client := <-h.register:
			h.clients[client] = true
			log.Printf("Client registered: %s (Total: %d)", client.conn.RemoteAddr(), len(h.clients))
		case client := <-h.unregister:
			if _, ok := h.clients[client]; ok {
				delete(h.clients, client)
				close(client.send) // Close the client's send channel
				log.Printf("Client unregistered: %s (Total: %d)", client.conn.RemoteAddr(), len(h.clients))
			}
		case message := <-h.broadcast:
			for client := range h.clients {
				select {
				case client.send <- message:
					// Message sent successfully
				default:
					// If send channel is full, assume client is slow or dead.
					// Unregister and close connection.
					close(client.send)
					delete(h.clients, client)
					log.Printf("Client send channel full, unregistering: %s", client.conn.RemoteAddr())
				}
			}
		}
	}
}

// serveWs handles WebSocket requests for connections.
func serveWs(hub *Hub, w http.ResponseWriter, r *http.Request) {
	conn, err := upgrader.Upgrade(w, r, nil)
	if err != nil {
		log.Println("Upgrade error:", err)
		return
	}
	client := &Client{conn: conn, send: make(chan []byte, 256)}
	hub.register <- client // Register the new client

	go client.writePump() // Client's write goroutine
	client.readPump()     // Client's read goroutine (blocks)

	// When readPump exits, unregister the client
	hub.unregister <- client
}

func main() {
	hub := NewHub()
	go hub.run() // Start the hub's goroutine

	http.HandleFunc("/ws", func(w http.ResponseWriter, r *http.Request) {
		serveWs(hub, w, r)
	})

	// Example: Broadcast a message every 5 seconds
	go func() {
		for {
			time.Sleep(5 * time.Second)
			message := []byte("Hello from server!")
			select {
			case hub.broadcast <- message:
				log.Println("Broadcasting message:", string(message))
			default:
				log.Println("Hub broadcast channel full, skipping message.")
			}
		}
	}()

	log.Fatal(http.ListenAndServe(":8080", nil))
}

Hub 구조체는 세 개의 채널, 즉 register, unregister, broadcast를 포함합니다. 별도의 고루틴에 있는 run 메서드는 이러한 채널을 지속적으로 수신합니다.

  • register가 새 클라이언트를 수신하면 해당 clients 맵에 클라이언트를 추가합니다.
  • unregister가 클라이언트를 수신하면 이를 제거하고 해당 send 채널을 닫습니다.
  • broadcast가 메시지를 수신하면 등록된 모든 클라이언트를 반복하여 각 클라이언트의 send 채널로 메시지를 보내려고 시도합니다. default 케이스가 있는 select 문을 사용하여 클라이언트의 send 채널이 가득 차서 블록되는 것을 방지하므로 느린 컨슈머가 다른 클라이언트에 영향을 미치는 것을 방지합니다.

확장을 위한 최적화

수천 개의 연결에 대한 확장성을 더욱 향상시키려면:

  1. 버퍼링된 채널: 클라이언트 send 큐에 대해 충분히 버퍼링된 채널(예: make(chan []byte, 256))을 사용합니다. 이렇게 하면 서버가 클라이언트가 일시적으로 읽기 속도가 느리더라도 메시지를 보낼 수 있어 버퍼 역할을 합니다.
  2. 효율적인 메시지 인코딩: 고처리량 시나리오의 경우 JSON 대신 Protocol Buffers 또는 FlatBuffers와 같은 효율적인 바이너리 직렬화 형식을 고려하십시오. 그러면 메시지 크기와 구문 분석 오버헤드를 줄일 수 있습니다.
  3. 수평적 확장: 매우 많은 수의 연결(수만 개 또는 수백만 개)의 경우 로드 밸런서 뒤의 여러 Go 웹소켓 서버에 연결을 분산하는 것을 고려하십시오. 별도의 메시지 큐(예: Kafka, NATS, Redis PubSub)를 사용하여 이러한 독립적인 웹소켓 서버 간에 메시지를 동기화할 수 있습니다. 각 서버는 관련 주제를 구독하여 분산 시스템 전체에 메시지를 효과적으로 팬아웃합니다.
  4. 리소스 관리: 메모리 및 CPU 사용량을 신중하게 모니터링하십시오. 고루틴은 가볍지만 수천 개의 연결은 여전히 메모리를 소비합니다. 서버 인프라가 모든 연결과 해당 버퍼의 결합된 메모리 사용량을 처리할 수 있는지 확인하십시오.
  5. 정상 종료: 서버가 모든 활성 웹소켓 연결을 닫고 리소스를 정리하여 정상적으로 종료되도록 적절한 신호 처리를 구현하십시오.

결론

Go의 강력한 동시성 기본 요소를 활용하여 확장 가능한 Go 웹소켓 서비스를 구축하는 것이 가능합니다. 각 연결에 고루틴을 전담하고, 클라이언트 관리 및 메시지 브로드캐스팅을 위한 중앙 집중식 허브를 사용하며, 효율적인 메시지 전달을 위해 버퍼링된 채널을 활용함으로써 우리는 견고성과 높은 성능으로 수천 개의 동시 웹소켓 연결을 처리할 수 있습니다. github.com/gorilla/websocket 라이브러리는 견고한 기반을 제공하며, 연결 관리, 메시지 흐름 및 리소스 최적화를 중심으로 신중하게 설계하면 Go는 정교한 실시간 애플리케이션을 만드는 데 탁월한 선택이 됩니다. 핵심은 고루틴과 채널을 효과적으로 사용하여 동시성을 관리하여 수요에 따라 애플리케이션이 원활하게 확장될 수 있도록 복원력 있고 내결함성 있는 아키텍처를 설계하는 것입니다.

Share this article

HackerNews

More Posts from Leapcell

Popular Posts