파이썬 소켓 프로그래밍 sendfile 파일 전송 서버 구현과 중단 재개 offset 지원 예제

🔗 파이썬 소켓 프로그래밍의 기본 개념

네트워크 프로그래밍에서 가장 중요한 개념 중 하나가 바로 소켓(Socket)입니다.
소켓은 네트워크를 통해 데이터를 주고받을 수 있는 양쪽 끝단을 의미하며, 클라이언트와 서버가 서로 연결되는 통로 역할을 합니다.
파이썬은 내장 라이브러리로 socket 모듈을 제공하기 때문에 별도의 추가 설치 없이 손쉽게 네트워크 프로그램을 작성할 수 있습니다.

소켓 프로그래밍을 이해하려면 먼저 TCP와 UDP라는 두 가지 주요 전송 방식의 차이를 알아야 합니다.
TCP는 연결 지향적이며, 데이터가 순서대로 안전하게 전달되는 것을 보장합니다.
반면 UDP는 비연결형으로 속도가 빠르지만 데이터 손실이 발생할 수 있습니다.
대용량 파일 전송이나 안정적인 통신을 위해서는 대부분 TCP 기반 소켓을 활용합니다.

📡 서버와 클라이언트의 기본 구조

서버는 특정 포트에서 클라이언트의 연결 요청을 기다리고, 클라이언트는 해당 주소와 포트로 접속을 시도합니다.
연결이 성립되면 소켓을 통해 데이터를 주고받을 수 있습니다.
이때 서버는 여러 클라이언트와 동시에 연결될 수 있기 때문에 멀티스레드 또는 비동기 방식으로 구현되는 경우가 많습니다.

import socket

# 서버 소켓 생성
server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
server_socket.bind(('0.0.0.0', 9000))
server_socket.listen(1)

print("서버가 연결을 기다립니다...")

conn, addr = server_socket.accept()
print("클라이언트 연결:", addr)

# 데이터 송수신
data = conn.recv(1024)
print("받은 데이터:", data.decode())

conn.sendall("안녕하세요 클라이언트".encode())
conn.close()

위의 예시는 가장 단순한 TCP 서버 구조를 보여줍니다.
클라이언트는 해당 포트에 접속해 데이터를 주고받을 수 있으며, 이 과정을 확장하면 파일 전송, 채팅 서버, API 서버 등 다양한 응용 프로그램을 구현할 수 있습니다.

🛠️ sendfile 함수의 특징과 장점

파일 전송 서버를 구현할 때 보통은 read()로 파일을 읽고 send()로 데이터를 전송하는 방식을 떠올립니다.
하지만 이 방식은 사용자 공간과 커널 공간 사이에서 데이터를 여러 번 복사해야 하기 때문에 비효율적일 수 있습니다.
파이썬 3.5부터 지원되는 sendfile() 함수는 이러한 불필요한 복사를 줄여 네트워크 성능을 크게 개선해 줍니다.

sendfile은 파일 디스크립터와 소켓을 직접 연결해 운영체제가 데이터를 바로 전송하도록 합니다.
즉, 데이터가 사용자 공간으로 복사되지 않고 커널 내부에서 바로 소켓으로 전송되기 때문에 속도가 빠르고 CPU 자원도 절약됩니다.
이런 특성 덕분에 대용량 파일 전송에서 특히 강력한 성능을 발휘합니다.

🚀 sendfile의 주요 장점

• ⚡데이터 복사가 줄어들어 빠른 전송 속도 확보
• 💻CPU 부하 감소로 서버 자원 효율적 활용
• 📂대용량 파일 전송 시 안정적인 처리 가능
• 🔄offset 인자를 활용해 중단 지점부터 재전송 가능

즉, sendfile은 단순히 빠른 전송을 제공하는 것뿐 아니라, 파일 이어받기 기능을 구현할 수 있는 기반도 마련해 줍니다.
이는 네트워크 장애로 인해 전송이 끊겼을 때 다시 처음부터 다운로드하지 않고 이어서 받을 수 있도록 해주기 때문에 사용자 경험이 크게 개선됩니다.

💬 실제 대규모 서비스(예: 클라우드 저장소, 스트리밍 서버)에서도 sendfile은 성능 최적화를 위해 적극적으로 활용됩니다.

⚙️ 파일 전송 서버 기본 구조 구현

이제 실제로 sendfile()을 활용한 파일 전송 서버의 기본 구조를 살펴보겠습니다.
서버는 클라이언트 요청을 받아 지정된 파일을 전송하며, 클라이언트는 해당 파일을 받아 저장하는 방식입니다.
중요한 점은, 서버가 파일을 한 번에 다 읽는 것이 아니라 sendfile을 사용해 효율적으로 전송한다는 것입니다.

🖥️ 서버 코드 예제

import socket
import os

HOST = '0.0.0.0'
PORT = 9000
FILE_PATH = "sample.zip"

server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
server_socket.bind((HOST, PORT))
server_socket.listen(1)

print("파일 전송 서버 시작...")

while True:
    conn, addr = server_socket.accept()
    print("클라이언트 연결:", addr)

    with open(FILE_PATH, 'rb') as f:
        conn.sendfile(f)

    conn.close()

위 코드는 서버 측의 기본적인 파일 전송 구조를 보여줍니다.
클라이언트가 연결되면 sendfile()을 통해 파일 전체를 전송합니다.
이때 별도의 루프를 돌며 read()와 send()를 반복하지 않아도 되므로 코드가 간결하고 속도도 빠릅니다.

📥 클라이언트 코드 예제

import socket

HOST = '127.0.0.1'
PORT = 9000

client_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
client_socket.connect((HOST, PORT))

with open("received.zip", "wb") as f:
    while True:
        data = client_socket.recv(4096)
        if not data:
            break
        f.write(data)

print("파일 수신 완료")
client_socket.close()

클라이언트는 서버로부터 데이터를 받아 파일로 저장합니다.
이 구조만으로도 충분히 동작하지만, 만약 전송이 중단된다면 다시 처음부터 받아야 하는 불편함이 있습니다.
이를 해결하기 위해 다음 단계에서 offset 기반의 이어받기 기능을 적용할 수 있습니다.

🔌 offset을 활용한 전송 중단 재개

네트워크 환경이 불안정하거나 장시간 연결이 필요한 경우, 파일 전송 도중 끊기는 상황이 종종 발생합니다.
이럴 때 처음부터 다시 다운로드한다면 사용자 입장에서는 매우 불편하겠죠.
파이썬의 sendfile()은 offset 인자를 지원하기 때문에 원하는 지점부터 파일 전송을 이어갈 수 있습니다.
즉, 클라이언트가 이미 받은 부분은 건너뛰고 남은 데이터만 이어받는 방식이 가능합니다.

📡 offset을 활용한 서버 코드

import socket
import os

HOST = '0.0.0.0'
PORT = 9000
FILE_PATH = "sample.zip"

server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
server_socket.bind((HOST, PORT))
server_socket.listen(1)

print("파일 전송 서버 시작...")

while True:
    conn, addr = server_socket.accept()
    print("클라이언트 연결:", addr)

    # 클라이언트로부터 offset 요청 수신
    offset = int(conn.recv(1024).decode())

    with open(FILE_PATH, 'rb') as f:
        f.seek(offset)  # 파일 포인터 이동
        conn.sendfile(f, offset=offset)

    conn.close()

서버는 클라이언트로부터 offset 값을 받아 해당 지점부터 파일 전송을 시작합니다.
이 방식은 대용량 파일 전송 시 중간에 네트워크가 끊기더라도, 다음번 연결에서 이어받기를 가능하게 해줍니다.

📥 이어받기 클라이언트 코드

import socket
import os

HOST = '127.0.0.1'
PORT = 9000
FILE_NAME = "received.zip"

# 기존에 받은 파일 크기 확인
offset = os.path.getsize(FILE_NAME) if os.path.exists(FILE_NAME) else 0

client_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
client_socket.connect((HOST, PORT))

# 서버에 offset 전송
client_socket.send(str(offset).encode())

with open(FILE_NAME, "ab") as f:
    while True:
        data = client_socket.recv(4096)
        if not data:
            break
        f.write(data)

print("파일 이어받기 완료")
client_socket.close()

클라이언트는 이미 저장된 파일의 크기를 기준으로 offset을 계산하고, 서버에 이를 전달합니다.
서버는 해당 offset 이후 데이터를 전송하므로 클라이언트는 이어받기를 성공적으로 수행할 수 있습니다.

💡 실무에서의 활용 사례와 응용 팁

파이썬의 sendfile()과 offset 기능은 단순한 학습용 예제를 넘어서 실제 프로젝트에서도 폭넓게 사용됩니다.
클라우드 스토리지, P2P 파일 공유, 동영상 스트리밍 서비스 같은 대규모 시스템에서는 대용량 데이터를 전송하면서도 안정성과 효율성을 동시에 확보하는 것이 핵심이기 때문입니다.

🌐 실무 활용 사례

📝 응용 팁

• 🔒TLS/SSL 암호화를 적용해 보안성 강화
• 📊파일 전송 시 진행 상황(progress bar) 표시 기능 추가
• 🧩파일을 조각 단위로 분리하여 병렬 다운로드 구현
• 📡에러 처리 로직을 강화하여 안정성 확보

이처럼 sendfile과 offset 기능은 파일 전송의 성능과 안정성을 크게 개선해 주며, 다양한 네트워크 애플리케이션에 응용할 수 있습니다.
실무에서는 반드시 보안, 성능, 사용자 경험까지 고려한 최적화가 함께 이루어져야 한다는 점을 기억하는 것이 좋습니다.

❓ 자주 묻는 질문 (FAQ)