네트워크 통신에서 두 개의 프로그램은 양방향 통신 연결을 통해 데이터를 교환합니다. 이 연결의 한쪽 끝을 소켓(socket)이라고 합니다. 소켓은 IP 주소와 포트를 나타내며, 애플리케이션이 네트워크 요청을 보내거나 응답을 받을 때 사용하는 통신 핸들입니다.
파일 모듈이 지정된 파일을 열고, 읽고, 쓰고, 닫는 작업을 수행하는 반면, 소켓 모듈은 서버와 클라이언트 소켓을 열고, 읽고, 쓰고, 닫는 작업을 수행합니다.
네트워크 연결을 설정하려면 서버와 클라이언트가 모두 필요합니다. 서버는 먼저 실행되어 연결을 기다리고, 클라이언트는 서버의 주소 정보와 연결하여 통신을 시작합니다.
TCP 통신 예제
서버 측 코드:
import socket
# 서버 소켓 생성
server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
# 서버 IP 및 포트 바인딩 (튜플 형태로)
server_socket.bind(("192.168.14.39", 9999))
# 클라이언트 연결 요청 수신 대기 (최대 5개 연결 대기)
server_socket.listen(5)
print("서버가 연결을 기다리는 중...")
while True:
# 클라이언트 연결 수락 (블로킹 상태)
# conn: 클라이언트와 통신할 새로운 소켓 객체
# addr: 클라이언트의 주소 정보
client_connection, client_address = server_socket.accept()
print(f"클라이언트 {client_address} 연결됨")
try:
# 클라이언트에게 환영 메시지 전송 (바이트로 인코딩)
client_connection.sendall(bytes("환영합니다!", "utf-8"))
# 클라이언트로부터 메시지 수신 및 에코
while True:
received_data = client_connection.recv(1024)
if not received_data: # 클라이언트 연결 종료 시
break
message = received_data.decode("utf-8")
print(f"클라이언트로부터 수신: {message}")
# 받은 메시지를 다시 클라이언트에게 전송 (에코)
client_connection.sendall(bytes(f"서버가 받은 메시지: {message}", "utf-8"))
finally:
# 클라이언트 연결 종료
client_connection.close()
print(f"클라이언트 {client_address} 연결 종료")
# 서버 소켓 종료 (실제 실행 시에는 무한 루프이므로 도달하지 않음)
# server_socket.close()
클라이언트 측 코드:
import socket
# 클라이언트 소켓 생성
client_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
# 서버 주소와 포트로 연결 시도
server_address = ("192.168.14.39", 9999)
client_socket.connect(server_address)
try:
# 서버로부터 환영 메시지 수신
welcome_message = client_socket.recv(1024).decode("utf-8")
print(f"서버로부터 수신: {welcome_message}")
# 사용자 입력 메시지 전송 및 서버 응답 수신
while True:
user_input = input("서버에 보낼 메시지를 입력하세요 (종료하려면 'q'): ")
if user_input.lower() == 'q':
break
# 입력 메시지를 바이트로 인코딩하여 전송
client_socket.sendall(bytes(user_input, "utf-8"))
# 서버의 에코 응답 수신
server_response = client_socket.recv(1024).decode("utf-8")
print(f"서버 응답: {server_response}")
finally:
# 클라이언트 소켓 종료
client_socket.close()
print("서버 연결 종료.")
참고: 네트워크 통신 시 문자열은 반드시 바이트로 변환하여 전송해야 하며, 수신된 데이터는 바이트이므로 사람이 읽을 수 있는 문자열로 디코딩해야 합니다.
SocketServer 모듈을 이용한 동시 처리
SocketServer 모듈은 IO 다중화, 스레딩 또는 멀티프로세싱을 사용하여 여러 클라이언트의 요청을 동시에 처리하는 서버를 쉽게 구현할 수 있도록 도와줍니다. 각 클라이언트 연결마다 서버는 별도의 스레드나 프로세스를 생성하여 해당 클라이언트의 모든 요청을 전담 처리합니다.
스레드 기반 TCP 서버 예제:
import socketserver
class MyTCPHandler(socketserver.BaseRequestHandler):
"""
클라이언트 요청을 처리하는 핸들러 클래스.
request 속성은 클라이언트와의 연결 소켓을 나타냅니다.
"""
def handle(self):
# self.request는 클라이언트와의 연결 소켓입니다.
client_socket = self.request
client_address = self.client_address
print(f"클라이언트 {client_address} 연결됨")
try:
# 클라이언트에게 인사 메시지 전송
client_socket.sendall(bytes("SocketServer에 오신 것을 환영합니다!", "utf-8"))
# 클라이언트로부터 메시지 수신 및 에코
while True:
data = client_socket.recv(1024)
if not data:
break # 클라이언트 연결이 끊어졌을 경우
message = data.decode("utf-8")
print(f"{client_address}로부터 수신: {message}")
# 받은 메시지를 다시 클라이언트로 전송
client_socket.sendall(bytes(f"서버가 받은 내용: {message}", "utf-8"))
except ConnectionResetError:
print(f"클라이언트 {client_address} 연결이 예기치 않게 종료되었습니다.")
finally:
print(f"클라이언트 {client_address} 연결 종료.")
# handle 메소드가 종료되면 자동으로 클라이언트 소켓이 닫힙니다.
if __name__ == "__main__":
HOST, PORT = "127.0.0.1", 9989
# ThreadingTCPServer: 각 요청을 새로운 스레드로 처리하는 TCP 서버
# MyTCPHandler: 요청을 처리할 핸들러 클래스
server = socketserver.ThreadingTCPServer((HOST, PORT), MyTCPHandler)
print(f"서버 시작: {HOST}:{PORT}")
# 서버를 영구적으로 실행하여 클라이언트 연결 대기
server.serve_forever()
주요 Socket 메서드
socket.socket(socket.AF_INET, socket.SOCK_STREAM, 0): 소켓 객체를 생성합니다.AF_INET: IPv4 주소 체계를 사용합니다. (기본값)SOCK_STREAM: TCP 프로토콜을 사용합니다. (기본값)SOCK_DGRAM: UDP 프로토콜을 사용합니다.- 세 번째 인자는 프로토콜 번호로, 보통 0을 사용하면 시스템이 자동으로 적절한 프로토콜을 선택합니다.
bind(address): 소켓을 특정 IP 주소와 포트에 바인딩합니다. (서버 측)
listen(backlog): 서버 소켓이 클라이언트의 연결 요청을 수신 대기하도록 합니다. backlog은 동시에 대기할 수 있는 최대 연결 수를 지정합니다. (서버 측)
accept(): 클라이언트의 연결 요청을 수락하고, 통신을 위한 새로운 소켓 객체와 클라이언트 주소를 반환합니다. (서버 측, 블로킹)
connect(address): 원격 서버의 주소로 연결을 시도합니다. (클라이언트 측)
connect_ex(address): connect와 유사하지만, 연결 실패 시 오류 코드(정수)를 반환합니다. 성공 시 0을 반환합니다. (클라이언트 측)
send(string): 데이터를 원격 소켓으로 전송합니다. 보낸 바이트 수를 반환합니다.
sendall(string): send와 유사하지만, 지정된 모든 데이터가 전송될 때까지 시도합니다. 전송이 실패하면 예외를 발생시킵니다.
recv(bufsize): 원격 소켓으로부터 데이터를 수신합니다. bufsize는 한 번에 받을 최대 바이트 수입니다. (블로킹)
recvfrom(bufsize): UDP 소켓에서 데이터를 수신하고, 보낸 주소와 함께 반환합니다.
sendto(string, address): UDP 소켓에서 지정된 주소로 데이터를 전송합니다.
close(): 소켓 연결을 닫습니다.
setblocking(bool): 소켓의 블로킹 모드를 설정합니다. False로 설정하면 accept나 recv 호출 시 데이터가 없으면 오류를 발생시킵니다.
settimeout(timeout): 소켓 작업의 타임아웃(초 단위)을 설정합니다.
getpeername(): 연결된 원격 소켓의 주소를 반환합니다.
getsockname(): 소켓 자신의 주소를 반환합니다.
UDP 통신 예제
UDP 서버:
import socket
server_address = ('127.0.0.1', 9999)
udp_socket = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
udp_socket.bind(server_address)
print("UDP 서버 시작...")
while True:
# 데이터와 보낸 사람의 주소를 함께 수신
data, client_addr = udp_socket.recvfrom(1024)
message = data.decode("utf-8")
print(f"{client_addr}로부터 수신: {message}")
# 받은 메시지를 다시 클라이언트에게 전송
response = f"UDP 서버: '{message}'를 받았습니다."
udp_socket.sendto(bytes(response, "utf-8"), client_addr)
# 서버 소켓 종료 (실제 실행 시에는 무한 루프)
# udp_socket.close()
UDP 클라이언트:
import socket
server_address = ('127.0.0.1', 9999)
udp_socket = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
while True:
message_to_send = input("서버에 보낼 메시지를 입력하세요 (종료: exit): ")
if message_to_send.lower() == 'exit':
break
# 메시지를 바이트로 인코딩하여 서버로 전송
udp_socket.sendto(bytes(message_to_send, "utf-8"), server_address)
# 서버의 응답 수신
data, server_addr = udp_socket.recvfrom(1024)
response = data.decode("utf-8")
print(f"서버({server_addr}) 응답: {response}")
udp_socket.close()
print("UDP 통신 종료.")