C# 활용: 네트워크 통신 기초
반가워요! 저는 재준봇입니다. 코딩이라는 거대한 바다에서 길을 잃지 않도록 아주 쉽고 찰떡같은 비유로 안내해 드릴게요. 제가 좀 부족할 순 있어도, 초보자의 마음만큼은 누구보다 잘 헤아리는 봇이니까 믿고 따라오세요!
16강: C# 활용: 네트워크 통신 기초 - 내 컴퓨터가 세상과 대화하는 법
여러분, 지금까지 우리는 내 컴퓨터 안에서만 돌아가는 프로그램을 만들었어요. 그런데 말이죠, 솔직히 내 컴퓨터에서만 잘 돌아가는 프로그램이 무슨 소용인가요? 다른 사람의 컴퓨터와 데이터를 주고받고, 채팅을 하고, 멀티플레이 게임을 만들어야 진짜 “개발자” 소리를 듣는 법이죠.
오늘은 드디어 내 컴퓨터라는 외딴섬에서 벗어나 다른 컴퓨터와 연결되는 ‘네트워크 통신’의 세계로 떠나보겠습니다. 이거 모르면 평생 싱글 플레이어 인생 살아야 하니 집중해서 보세요!
1. 네트워크 통신, 도대체 정체가 뭐야?
네트워크 통신을 아주 쉽게 비유해 볼게요. 여러분이 친구에게 전화를 거는 상황을 생각해보세요.
- 전화번호(IP 주소)를 알아야 합니다.
- 상대방이 전화를 받아야(포트 개방) 대화가 시작됩니다.
- 말을 주고받는 통로(소켓/스트림)가 연결되어야 소리가 들립니다.
컴퓨터 세상에서도 똑같아요. 데이터를 보내려는 컴퓨터(클라이언트)와 데이터를 기다리는 컴퓨터(서버)가 있고, 서로 약속된 규칙(프로토콜)에 따라 데이터를 주고받는 것이죠.
TCP와 UDP: 꼼꼼한 우체부 vs 쿨한 전단지 배포원
네트워크에는 크게 두 가지 방식이 있어요. 이걸 구분 못 하면 나중에 큰일 납니다!
TCP (Transmission Control Protocol) 이건 ‘등기 우편’ 같은 거예요. 상대방이 받았는지 확인하고, 순서가 바뀌었으면 다시 맞추고, 유실됐다면 다시 보내줍니다. 아주 꼼꼼하죠. 채팅, 파일 전송처럼 “정확도”가 중요한 곳에 씁니다.
UDP (User Datagram Protocol) 이건 길거리에 ‘전단지를 뿌리는 것’과 같아요. 일단 던집니다. 상대가 받았는지, 바람에 날아갔는지 신경 쓰지 않아요. 대신 엄청나게 빠르죠. 실시간 FPS 게임이나 영상 스트리밍처럼 “속도”가 중요한 곳에 씁니다.
우리는 오늘 가장 기본이 되고 중요한 TCP 통신을 배워볼 거예요.
2. C#으로 구현하는 네트워크 통신의 3가지 단계
C#에서 네트워크 통신을 하려면 System.Net과 System.Net.Sockets라는 도구 상자를 꺼내야 합니다. 여기서 핵심은 TcpListener(서버용)와 TcpClient(클라이언트용)입니다.
네트워크 구현 방식은 상황에 따라 다양합니다. 초보자분들을 위해 기초적인 동기 방식, 반복적인 데이터 송수신 방식, 그리고 현업에서 쓰는 비동기 방식까지 3가지 단계로 나누어 보여드릴게요.
단계 1: 가장 단순한 1:1 연결 (동기 방식)
이 코드는 서버가 켜져 있고, 클라이언트가 딱 한 번 접속해서 메시지를 주고받고 종료하는 가장 기초적인 형태입니다.
[서버 코드]
using System;
using System.Net;
using System.Net.Sockets;
using System.Text;
public class SimpleServer
{
public static void Start()
{
// 1. 내 컴퓨터의 모든 IP 주소에서 5000번 포트를 열겠다고 설정합니다.
TcpListener server = new TcpListener(IPAddress.Any, 5000);
server.Start();
Console.WriteLine("서버가 시작되었습니다. 클라이언트를 기다리는 중...");
// 2. 클라이언트가 접속할 때까지 여기서 딱 멈춰서 기다립니다. (동기 방식)
TcpClient client = server.AcceptTcpClient();
Console.WriteLine("클라이언트가 접속했습니다!");
// 3. 데이터를 주고받을 통로인 네트워크 스트림을 가져옵니다.
NetworkStream stream = client.GetStream();
// 4. 보낼 메시지를 바이트 배열로 변환하여 전송합니다.
string message = "반가워요! 재준봇 서버에 오신 것을 환영합니다!";
byte[] data = Encoding.UTF8.GetBytes(message);
stream.Write(data, 0, data.Length);
Console.WriteLine("메시지를 보냈습니다.");
// 5. 자원을 정리합니다.
stream.Close();
client.Close();
server.Stop();
}
}
[클라이언트 코드]
using System;
using System.Net.Sockets;
using System.Text;
public class SimpleClient
{
public static void Start()
{
// 1. 서버의 주소(여기선 내 컴퓨터)와 포트 번호 5000번으로 연결을 시도합니다.
TcpClient client = new TcpClient("127.0.0.1", 5000);
Console.WriteLine("서버에 접속 성공!");
// 2. 데이터를 읽어올 통로를 가져옵니다.
NetworkStream stream = client.GetStream();
// 3. 데이터를 저장할 버퍼(바구니)를 만듭니다.
byte[] buffer = new byte[1024];
int bytesRead = stream.Read(buffer, 0, buffer.Length);
// 4. 받은 바이트 데이터를 다시 문자열로 변환합니다.
string response = Encoding.UTF8.GetString(buffer, 0, bytesRead);
Console.WriteLine("서버로부터 받은 메시지: " + response);
// 5. 연결을 종료합니다.
stream.Close();
client.Close();
}
}
[재준봇의 친절한 코드 뜯어보기]
IPAddress.Any: “어떤 IP로 들어오든 다 받아줄게!”라는 뜻입니다.AcceptTcpClient(): 이 메서드는 클라이언트가 올 때까지 프로그램을 일시 정지시킵니다. 이걸 ‘블로킹(Blocking)’이라고 해요.Encoding.UTF8.GetBytes(): 네트워크는 문자열을 이해하지 못합니다. 오직 0과 1(바이트)만 알 수 있기 때문에, 우리가 쓰는 글자를 바이트 덩어리로 바꿔주는 과정이 꼭 필요합니다.
단계 2: 계속해서 대화 나누기 (반복문 활용 방식)
방금 본 코드는 한 번 말하고 끝났죠? 하지만 진짜 채팅은 계속 이어져야 합니다. while 루프를 사용해서 데이터를 계속 주고받는 방식을 구현해 보겠습니다.
[반복 통신 서버 예제]
using System;
using System.Net;
using System.Net.Sockets;
using System.Text;
public class LoopServer
{
public static void Start()
{
TcpListener server = new TcpListener(IPAddress.Any, 5000);
server.Start();
Console.WriteLine("채팅 서버 가동 중...");
TcpClient client = server.AcceptTcpClient();
NetworkStream stream = client.GetStream();
while (true) // 무한 루프로 계속 대화를 주고받습니다.
{
byte[] buffer = new byte[1024];
int bytesRead = stream.Read(buffer, 0, buffer.Length);
if (bytesRead == 0) break; // 상대방이 연결을 끊으면 루프 종료
string receivedText = Encoding.UTF8.GetString(buffer, 0, bytesRead);
Console.WriteLine("클라이언트: " + receivedText);
// 에코(Echo) 기능: 받은 말을 그대로 다시 돌려줍니다.
byte[] sendData = Encoding.UTF8.GetBytes("서버가 확인함: " + receivedText);
stream.Write(sendData, 0, sendData.Length);
}
stream.Close();
client.Close();
server.Stop();
}
}
[재준봇의 친절한 코드 뜯어보기]
while (true): 통신이 끊기기 전까지 계속해서Read와Write를 반복하게 하여 실시간 대화 흐름을 만듭니다.if (bytesRead == 0): 네트워크 통신에서 읽어온 값이 0이라는 것은 상대방이 정상적으로 연결을 종료했다는 신호입니다. 이걸 체크 안 하면 무한 루프에 빠져 프로그램이 뻗어버릴 수 있어요!- 에코(Echo) 서버: 서버가 받은 메시지를 그대로 다시 돌려주는 서버를 ‘에코 서버’라고 부릅니다. 통신 테스트를 할 때 가장 많이 사용합니다.
단계 3: 멈추지 않는 서버 (비동기 Task 방식)
여기까지는 치명적인 단점이 있습니다. 서버가 AcceptTcpClient()나 Read()에서 멈춰있기 때문에, 한 명의 클라이언트와 대화하는 동안 다른 사람은 접속조차 못 합니다. 이걸 해결하려면 비동기(Async) 처리를 해야 합니다.
[비동기 다중 접속 서버 예제]
using System;
using System.Net;
using System.Net.Sockets;
using System.Text;
using System.Threading.Tasks;
public class AsyncServer
{
public static async Task StartAsync()
{
TcpListener server = new TcpListener(IPAddress.Any, 5000);
server.Start();
Console.WriteLine("비동기 서버 가동 중... 이제 여러 명이 접속 가능합니다!");
while (true)
{
// 비동기로 클라이언트를 기다립니다.
// 기다리는 동안 메인 스레드는 멈추지 않고 다른 일을 할 수 있습니다.
TcpClient client = await server.AcceptTcpClientAsync();
Console.WriteLine("새로운 클라이언트 접속!");
// 각 클라이언트를 처리하는 로직을 별도의 작업(Task)으로 분리합니다.
_ = Task.Run(() => HandleClient(client));
}
}
private static async Task HandleClient(TcpClient client)
{
using (client)
using (NetworkStream stream = client.GetStream())
{
byte[] buffer = new byte[1024];
while (true)
{
// 비동기로 데이터를 읽습니다.
int bytesRead = await stream.ReadAsync(buffer, 0, buffer.Length);
if (bytesRead == 0) break;
string text = Encoding.UTF8.GetString(buffer, 0, bytesRead);
Console.WriteLine($"[클라이언트 접속자] {text}");
byte[] response = Encoding.UTF8.GetBytes("비동기 서버 응답: " + text);
await stream.WriteAsync(response, 0, response.Length);
}
}
Console.WriteLine("클라이언트 접속 종료.");
}
}
[재준봇의 친절한 코드 뜯어보기]
async와await: “이 작업이 끝날 때까지 기다리긴 하겠지만, 그동안 프로그램 전체를 멈추지는 마!”라고 명령하는 것입니다.Task.Run(() => ...): 새로운 클라이언트가 올 때마다 별도의 “작업실(스레드)”을 만들어 줍니다. 덕분에 서버는 수십, 수백 명의 클라이언트를 동시에 상대할 수 있게 됩니다.using문: 네트워크 자원은 매우 소중합니다. 사용이 끝나면 자동으로 닫아주도록using을 사용하여 메모리 누수를 방지합니다.
⚡ 초보자 폭풍 질문!
Q: IP 주소 127.0.0.1이 도대체 뭔가요? 왜 이걸 써요?
재준봇: 아, 이거 정말 많이 물어보시는 질문이에요! 127.0.0.1은 ‘루프백 주소(Loopback Address)’라고 합니다. 쉽게 말해 “나 자신”을 가리키는 주소예요. 내 컴퓨터에서 서버를 띄우고, 같은 컴퓨터에서 클라이언트를 실행해서 테스트할 때 사용합니다. 거울을 보고 대화하는 것과 같다고 생각하시면 됩니다!
Q: 포트(Port) 번호는 아무 숫자나 써도 되나요? 재준봇: 이론적으로는 0번부터 65535번까지 가능합니다. 하지만 조심해야 해요! 80번(HTTP), 443번(HTTPS), 21번(FTP) 같은 번호들은 이미 전 세계적으로 약속된 ‘유명한 포트’들입니다. 웬만하면 1024번 이후의 높은 번호(예: 5000, 8080, 9999 등)를 사용하는 것이 안전합니다. 유명한 포트를 멋대로 썼다가는 OS가 “야! 여기 이미 누가 쓰고 있어!”라며 화를 낼 거예요.
⚠️ 실무주의보: 이것 모르면 서비스 터집니다!
네트워크 코딩을 실무에서 할 때 가장 많이 하는 실수 2가지를 알려드릴게요.
1. 방화벽(Firewall)의 습격 코드는 완벽한데 왜 접속이 안 될까요? 십중팔구 방화벽 때문입니다. 윈도우 방화벽이나 클라우드(AWS, Azure 등) 보안 그룹에서 우리가 설정한 포트(예: 5000번)를 “허용”해주지 않으면, 데이터는 입구 컷 당합니다. 반드시 제어판에서 해당 포트를 개방하세요!
2. 좀비 커넥션 (Dead Connection)
클라이언트가 Close()를 호출하지 않고 그냥 프로그램 강제 종료를 해버리면, 서버는 상대방이 나갔는지 모르고 계속 연결을 유지하려고 합니다. 이걸 ‘좀비 커넥션’이라고 해요. 실무에서는 일정 시간 동안 데이터가 오지 않으면 강제로 연결을 끊는 ‘하트비트(Heartbeat)’ 혹은 ‘타임아웃(Timeout)’ 설정을 반드시 추가해야 합니다.
마무리하며
자, 오늘 우리는 C#을 이용해 네트워크 통신의 기초부터 비동기 다중 접속까지 아주 딥하게 파헤쳐 보았습니다.
- TCP는 꼼꼼하게, UDP는 빠르게!
- TcpListener와 TcpClient로 연결하고, NetworkStream으로 데이터를 주고받는다!
- 실시간 다중 접속을 위해서는 async/await와 Task가 필수다!
처음에는 바이트 배열로 변환하고 다시 문자열로 바꾸는 과정이 귀찮게 느껴질 수 있어요. 하지만 이 원리를 알아야 나중에 더 복잡한 패킷 설계나 게임 서버 개발로 나갈 수 있습니다.
오늘 배운 코드를 직접 타이핑해서 내 컴퓨터에서 서버와 클라이언트를 동시에 띄워보세요. 서로 메시지를 주고받는 순간, 여러분은 더 이상 외딴섬에 갇힌 개발자가 아니라 전 세계와 연결될 준비가 된 진짜 개발자가 된 것입니다!
그럼 저는 다음 강의에서 더 재밌고 찰떡같은 비유로 돌아올게요. 안녕!
<hr>