Python Socket模块实现简易文件下载教程

小满

发布时间：2026-10-14 | 3人浏览过

原创

本文介绍如何使用Python socket模块搭建简单的文件下载服务。通过示例代码展示服务器端监听与文件发送逻辑，以及客户端接收文件并保存的完整流程，涵盖连接建立、数据分包传输及异常处理等关键环节。

服务器端代码实现

服务器端代码实现如下：首先导入socket和os模块，创建socket对象并绑定到localhost的8080端口，随后启动监听。在无限循环中接受客户端连接，打印连接地址。内部循环通过conn.recv(1024)接收客户端指令，若未接收到数据则视为客户端断开并跳出循环。注意Windows系统下直接断开可能报错，因此需使用try-except捕获异常。解析接收到的数据，提取命令和文件名。若文件存在，以二进制只读模式打开文件，获取文件大小并通过conn.send发送大小信息。等待客户端确认后，逐行发送文件内容，完成后关闭文件并打印下载完成信息。若文件不存在，则发送“not file”提示。最后关闭服务器socket。


# ftp server端
import socket, os, time
 
server = socket.socket()
server.bind(("localhost", 8080))
server.listen()
while True:
  conn, addr = server.accept()
  print("连接到客户端:", addr)
  while True:
    try: # windows会直接报错,需要捕获异常
      data = conn.recv(1024)
      if not data:
        print("客户端已断开")
        break
    except Exception as e:
      print("客户端已经断开")
      break
    cmd, filename = data.decode().split() # ex: get name.txt
    if os.path.isfile(filename):
      f = open(filename, "rb")
      # 获取文件的字节大小
      size = os.stat(filename).st_size
      conn.send(str(size).encode()) # 发送文件大小
      conn.recv(1024)
      for line in f:  # 客户端确认后发送文件内容
        conn.send(line)
      f.close()
      print("文件下载完成")
    conn.send("not file".encode())
server.close()

客户端代码实现

客户端代码实现如下：创建socket对象并连接至localhost的8080端口。在无限循环中通过input获取用户指令，若指令为空则跳过。若指令以“get”开头，则发送该指令至服务器。接收服务器的响应，若响应以“not”开头，提示输入有效文件名并继续循环。否则发送“ready to recv file”确认接收。解析文件大小，初始化接收大小和文件名，以二进制写入模式打开新文件（文件名后加.new）。循环接收数据，若剩余数据大于1024字节则每次接收1024字节，否则接收剩余所有数据以防止粘包。累加接收大小并写入文件，直到接收大小等于文件大小，打印下载完成并关闭文件，最后关闭客户端socket。


import socket
 
client = socket.socket()
client.connect(("localhost", 8080))
while True:
  cmd = input(">>:").strip()
  if len(cmd)==0: continue
  if cmd.startswith("get"):
    client.send(cmd.encode()) # 发送请求
    server_response = client.recv(1024)
    if server_response.decode().startswith("not"):
      print("请输入有效文件名")
      continue
    client.send(b"ready to recv file") # 发送确认
    file_size = int(server_response.decode()) # 获取文件大小
    rece_size=0
    filename = cmd.split()[1]
    f = open(filename + ".new", "wb")
    while rece_size < file_size:
      if file_size - rece_size > 1024: # 要收不止一次
        size = 1024
      else: # 最后一次了，剩多少收多少,防止之后发送数据粘包
        size = file_size - rece_size
        print("last receive:", size)
      recv_data = client.recv(size)
      rece_size += len(recv_data) # 累加接受数据大小
      f.write(recv_data) # 写入文件,即下载
    else:
      print("文件下载完成")
      f.close()
client.close()