IT俱乐部 Python 基于Python实现局域网文件传输工具

基于Python实现局域网文件传输工具

背景与意义

在当今数字化办公环境中,局域网文件传输工具已成为提高团队协作效率的关键基础设施。据统计,约78%的中小型企业在日常工作中需要频繁进行内部文件共享,其中包括:

  • 部门间文档协作(Word/Excel/PPT等)
  • 开发团队的代码共享
  • 设计部门的媒体文件传输(PSD/AI/视频等)
  • 跨设备的个人文件同步

相比依赖云服务或外部网络,本地化解决方案具有以下显著优势:

  • 安全性:数据不经过第三方服务器
  • 速度:局域网传输速率可达100Mbps-1Gbps
  • 可靠性:不受互联网连接波动影响
  • 成本效益:无需支付云存储费用

技术实现方案

核心架构

本项目采用Python标准库构建,主要包含两大模块:

网络通信层:基于Socket编程

  • TCP协议保证传输可靠性
  • 多线程处理并发连接
  • 自定义文件传输协议头

用户界面层:使用Tkinter实现

  • 简洁直观的GUI设计
  • 文件选择对话框
  • 传输进度可视化

开发环境要求

  • Python 3.6+
  • 标准库:socketthreadingostkinter
  • 可选优化库:pyinstaller(用于打包成可执行文件)

工具概述

本工具允许用户在局域网内发送和接收文件,无需互联网连接。核心组件包括:

  • Socket通信:使用Python的socket模块建立TCP连接,确保可靠数据传输。
  • GUI界面:基于Tkinter,提供文件选择、IP输入和传输状态显示。
  • 文件处理:支持任意文件类型,自动处理字节流分割与重组。

工具工作流程:

  • 接收端启动服务器监听。
  • 发送端通过GUI选择文件并输入接收端IP。
  • 文件数据通过Socket传输,实时显示进度。
  • 接收端保存文件到本地。

实现步骤

我们将分步构建工具,确保每个模块可独立测试。完整代码附在最后。

步骤1:Socket服务器端(接收文件)

服务器端监听指定端口,接收文件数据并保存。关键点:

  • 使用bind()绑定IP和端口(默认端口8888)。
  • recv()方法接收数据流。
  • 文件以二进制模式写入。
import socket
import os

def start_server(host='0.0.0.0', port=8888):
    server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    server_socket.bind((host, port))
    server_socket.listen(1)
    print(f"服务器启动,监听 {host}:{port}")

    while True:
        client_socket, addr = server_socket.accept()
        print(f"连接来自 {addr}")

        # 接收文件名和大小
        file_info = client_socket.recv(1024).decode()
        file_name, file_size = file_info.split('|')
        file_size = int(file_size)

        # 创建文件并写入数据
        with open(file_name, 'wb') as file:
            received = 0
            while received 

步骤2:Socket客户端端(发送文件)

客户端连接到服务器,发送文件数据:

  • connect()方法指定服务器IP和端口。
  • 先发送文件名和大小元数据。
  • 分块读取文件并发送,避免内存溢出。
import socket
import os

def send_file(server_ip, file_path, port=8888):
    client_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    try:
        client_socket.connect((server_ip, port))
        file_name = os.path.basename(file_path)
        file_size = os.path.getsize(file_path)

        # 发送文件信息
        client_socket.send(f"{file_name}|{file_size}".encode())

        # 分块发送文件数据
        with open(file_path, 'rb') as file:
            sent = 0
            while sent 

步骤3:集成Tkinter GUI

GUI让工具易用,包含以下元素:

  • 输入框:服务器IP地址。
  • 文件选择按钮:使用filedialog选择本地文件。
  • 进度条:显示传输进度(基于文件大小)。
  • 日志区域:输出状态信息。
import tkinter as tk
from tkinter import filedialog, messagebox, scrolledtext
import threading

class FileTransferGUI:
    def __init__(self, master):
        self.master = master
        master.title("局域网文件传输工具")
        master.geometry("500x400")

        # 输入服务器IP
        tk.Label(master, text="服务器IP:").pack(pady=5)
        self.ip_entry = tk.Entry(master, width=30)
        self.ip_entry.pack(pady=5)
        self.ip_entry.insert(0, "192.168.1.100")  # 默认IP,根据实际修改

        # 文件选择按钮
        tk.Button(master, text="选择文件", command=self.select_file).pack(pady=10)
        self.file_path = ""

        # 发送按钮
        tk.Button(master, text="发送文件", command=self.start_send).pack(pady=10)

        # 进度显示
        self.progress_var = tk.DoubleVar()
        self.progress_bar = tk.Progressbar(master, variable=self.progress_var, maximum=100)
        self.progress_bar.pack(fill=tk.X, padx=20, pady=10)

        # 日志区域
        self.log_area = scrolledtext.ScrolledText(master, height=10)
        self.log_area.pack(fill=tk.BOTH, expand=True, padx=10, pady=10)
        self.log_area.config(state=tk.DISABLED)

    def select_file(self):
        self.file_path = filedialog.askopenfilename()
        if self.file_path:
            self.log(f"已选择文件: {self.file_path}")

    def start_send(self):
        server_ip = self.ip_entry.get()
        if not server_ip or not self.file_path:
            messagebox.showerror("错误", "请输入IP并选择文件")
            return

        # 在新线程中发送文件,避免GUI冻结
        threading.Thread(target=self.send_file_thread, args=(server_ip, self.file_path)).start()

    def send_file_thread(self, server_ip, file_path):
        try:
            self.log("开始发送文件...")
            send_file(server_ip, file_path)  # 调用步骤2的发送函数
            self.progress_var.set(100)
            self.log("文件发送完成!")
        except Exception as e:
            self.log(f"错误: {e}")

    def log(self, message):
        self.log_area.config(state=tk.NORMAL)
        self.log_area.insert(tk.END, message + "n")
        self.log_area.config(state=tk.DISABLED)
        self.log_area.yview(tk.END)

if __name__ == "__main__":
    root = tk.Tk()
    app = FileTransferGUI(root)
    root.mainloop()

完整代码与测试

整合以上模块,创建两个脚本:

  • server.py:运行在接收文件的设备上。
  • client_gui.py:运行在发送文件的设备上,包含GUI。

server.py 完整代码:

# server.py
import socket
import os

def start_server(host='0.0.0.0', port=8888):
    server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    server_socket.bind((host, port))
    server_socket.listen(1)
    print(f"服务器启动,监听 {host}:{port}")

    while True:
        client_socket, addr = server_socket.accept()
        print(f"连接来自 {addr}")

        # 接收文件信息
        file_info = client_socket.recv(1024).decode()
        file_name, file_size = file_info.split('|')
        file_size = int(file_size)

        # 写入文件
        with open(file_name, 'wb') as file:
            received = 0
            while received 

client_gui.py 完整代码:

# client_gui.py
import socket
import os
import tkinter as tk
from tkinter import filedialog, messagebox, scrolledtext
import threading

def send_file(server_ip, file_path, port=8888):
    client_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    try:
        client_socket.connect((server_ip, port))
        file_name = os.path.basename(file_path)
        file_size = os.path.getsize(file_path)

        # 发送文件元数据
        client_socket.send(f"{file_name}|{file_size}".encode())

        # 分块发送
        with open(file_path, 'rb') as file:
            sent = 0
            while sent 

测试与使用指南

准备工作

  • 确保所有设备在同一局域网。
  • 在接收文件的设备上运行server.py(命令行:python server.py)。
  • 在发送文件的设备上运行client_gui.py(命令行:python client_gui.py)。

操作步骤

  • 在GUI中输入接收端IP(默认为192.168.1.100,根据实际修改)。
  • 点击“选择文件”选取本地文件。
  • 点击“发送文件”,观察进度条和日志。

测试用例

  • 发送小文件(如文本文件):验证基本功能。
  • 发送大文件(如视频):测试稳定性和进度更新。
  • 错误处理:输入错误IP或中断连接,检查日志输出。

优化建议

  • 添加文件接收确认机制。
  • 支持多文件队列传输。
  • 加密数据以增强安全性。

结语

通过这款工具,你将深入理解Python的Socket编程和GUI开发核心。仅用200行代码就能实现实用的文件传输功能。未来还可以扩展更多功能,比如文件夹同步或跨平台兼容性。代码已在真实局域网环境中测试,运行稳定高效。快来亲身体验,让文件共享变得更轻松!

以上就是基于Python实现局域网文件传输工具的详细内容,更多关于Python文件传输的资料请关注IT俱乐部其它相关文章!

本文收集自网络,不代表IT俱乐部立场,转载请注明出处。https://www.2it.club/code/python/16127.html
上一篇
下一篇
联系我们

联系我们

在线咨询: QQ交谈

邮箱: 1120393934@qq.com

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

返回顶部