当前位置: 首页 > news >正文

我的第一个开源小项目:内网文件传输工具技术解析

内网文件传输工具

为什么开发?

  1. 单个大文件分发速度慢。一份大文件如果存在U盘里想要同时分发给多个人节省拷贝时间,我能想到的除了网盘和共享文件夹就没有其他的方法(可能是我见识太少了没啥思路。我也不喜欢用网盘传文件,问就是0充豹子头)
  2. 不同U盘拷贝速度不一样,况且需要同时给多个用户分发或者拷贝,还需要各种设备都需要能够访问到这个需求。说到这里我想到了把资源做种,但还是嫌麻烦,有些普通用户和电脑小白可能不大会使用一些磁力链接下载软件,主要是想即开即用,作为一个临时需求工具而不是长期使用的工具
  3. 为什么不做公网的文件分发?第一个是本来我也不太了解安全技术,公网想要传输超大文件还是比较吃硬件资源的,建议在公网传输一些大文件还是走端到端、网盘和磁力链接,避免被中间人劫持和篡改文件。当然内网传输也不是说在不可信网络的情况下去随便传文件啊,只是说大部分时候在内网传输都是可信网络,所以安全问题没怎么考虑过。项目里可能存在一些技术隐患比如XSS、SQL注入之类的,不过考虑到只是普通人在内网传输一般也都是熟人所以就没做这些预防工作😅

项目简介

这款工具基于Python开发,旨在提供一个简单、快速、安全的局域网文件共享方案。它拥有直观的Web界面,支持大文件分块上传、实时同步、跨平台运行,非常适合家庭和办公室环境。

GitHub仓库: https://github.com/MagicCD/Transfer (欢迎大家Star和Fork!)

核心功能

  • 文件传输核心功能
    • 大文件分块上传:当文件大于50MB时,自动启用分块上传,默认每个分块5MB,临时分块存储在.temp_chunks目录,上传完成后自动合并。
    • 实时同步:使用Socket.IO实现双向通信,文件列表实时更新,上传进度实时显示。
    • 文件管理:支持批量删除和清空操作,文件类型自动匹配图标。
  • 安全与优化
    • 临时文件清理:自动清理超过2小时的临时分块。
    • 安全配置:限制最大上传文件5GB。
  • 界面交互
    • 拖拽上传:支持直接拖拽文件到网页上传区域。
    • 进度控制:提供上传进度条、暂停/恢复按钮。
    • 文件管理:支持单文件删除和清空所有文件。
  • 系统特性
    • 跨平台支持:使用PyWebView封装浏览器窗口,支持所有Python支持的平台。
    • 自动清理:定时任务每2小时清理过期临时文件。
    • 大文件支持:分块上传+断点续传机制,支持5GB以内文件。
    • 实时性:WebSocket实现实时文件列表更新(延迟<1秒)。

技术栈

  • 后端
    • Flask (2.3.3):Web框架,处理HTTP请求。
    • Flask-SocketIO (5.3.4):实时通信,推送文件列表更新。
    • PyWebView (4.3):封装为桌面应用,提供窗口管理。
    • Werkzeug (2.3.7):请求处理。
    • schedule (1.2.0):定时任务。
  • 前端
    • HTML5
    • CSS3
    • JavaScript
    • Font Awesome:图标库。

运行环境

  • Python版本:3.8 - 3.13
  • 依赖库:见requirements.txt

快速上手

  1. 安装依赖

    pip install -r requirements.txt
    
  2. 启动服务

    python main.py
    
  3. 访问界面

    • 自动打开桌面窗口,显示类似http://192.168.1.100:5000的内网地址。
    • 支持拖拽上传和文件管理操作。

目录结构

├── static/
│   ├── js/           # 存放JavaScript文件
│   ├── app_icon.svg  # 应用图标
│   └── style.css     # 样式文件
│
├── templates/
│   └── index.html    # Web界面模板
│
├── main.py           # 应用入口文件
├── app.py            # Flask应用核心逻辑
├── resource_path.py  # 资源路径处理工具
└── README.md         # 项目文档

核心代码片段

  • 资源路径处理 (resource_path.py)

    # filepath: e:\AI_Project\trae_AIproject\resource_path.py
    import os
    import sys
    
    def resource_path(relative_path):
        """获取资源的绝对路径,兼容开发环境和PyInstaller打包后的环境"""
        if hasattr(sys, '_MEIPASS'):
            # PyInstaller打包后的临时目录路径
            base_path = sys._MEIPASS
        else:
            # 开发环境下的当前目录
            base_path = os.path.abspath(".")
    
        return os.path.join(base_path, relative_path)
    

    这个函数用于在开发环境和打包后的环境中都能正确找到资源文件。

  • 文件图标映射 (app.py)

    # filepath: e:\AI_Project\trae_AIproject\app.py
    icon_map = {
        '.mp4': 'fa-video',
        '.pdf': 'fa-file-pdf',
        '.py': 'fa-file-code',
        '.zip': 'fa-file-archive'
    }
    

    通过文件后缀名匹配对应的Font Awesome图标。

  • 分块上传处理 (app.py)

    # filepath: e:\AI_Project\trae_AIproject\app.py
    @app.route('/upload/chunk', methods=['POST'])
    def upload_chunk():
        # ...
        # 保存当前块
        chunk_path = os.path.join(file_temp_dir, f"chunk_{chunk_number}")
        chunk.save(chunk_path)
    
        # 如果这是最后一个块,合并所有块
        if chunk_number == total_chunks - 1:
            # 合并块 - 优化版本:流式写入,减少内存占用
            final_path = os.path.join(app.config['UPLOAD_FOLDER'], filename)
            with open(final_path, 'ab') as outfile:  # 使用追加二进制模式
                for i in range(total_chunks):
                    chunk_file_path = os.path.join(file_temp_dir, f"chunk_{i}")
                    if os.path.exists(chunk_file_path):
                        with open(chunk_file_path, 'rb') as infile:
                            # 逐块读写,减少内存占用
                            while True:
                                data = infile.read(1024*1024)  # 每次读取1MB
                                if not data:
                                    break
                                outfile.write(data)
        # ...
    

    这段代码实现了大文件分块上传的核心逻辑,包括分块的保存和合并。

打包发布

项目支持通过PyInstaller打包为单文件可执行程序:

pyinstaller --onefile --windowed \
--add-data "templates;templates" \
--add-data "static;static" \
main.py

总结

项目目前处于开发阶段,距离完全可用可能还有一段时间,但基本上给小团体传传文件应该没什么问题🥲

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.dtcms.com/a/120419.html

相关文章:

  • Android设置adjustResize时无法生效 解决办法
  • Go 错误处理
  • 单轨小车悬挂输送机安全规程
  • 通过学习opencv图像库编程借助第三方库函数完成一个综合程序设计
  • moviepy学习使用笔记
  • 浅层神经网络:全面解析(扩展)
  • 【OSG学习笔记】Day 1: OSG初探——环境搭建与第一个3D窗口
  • 【SpringCloud】构建分布式系统的利器
  • 超详解glusterfs部署
  • 【Java设计模式】第8章 单列模式讲解
  • 初学STM32之编码器测速以及测频法的实现
  • 【Java设计模式】第9章 原型模式讲解
  • linux下的进程线程管理
  • JavaWeb 课堂笔记 —— 03 Vue
  • 2023年-全国大学生数学建模竞赛(CUMCM)试题速浏、分类及浅析
  • 解决Spring Boot启动时YAML配置占位符导致的ScannerException(yml占位符动态替换)
  • android 14.0 工厂模式 测试音频的一些问题(高通)
  • 【AGI-Eval行业动态】OpenAI 语音模型三连发,AI 语音进入“声优”时代
  • Redisson 实现分布式锁
  • Flask返回文件方法详解
  • 急速实现Anaconda/Miniforge虚拟环境的克隆和迁移
  • SpringCloud微服务(一)Eureka+Nacos
  • ADGaussian:用于自动驾驶的多模态输入泛化GS方法
  • AI与大数据融合:技术全景、行业实践与前沿趋势(2025版)
  • Python监控网站更新则推送到企业微信
  • 生产事故:Undertow容器的xnio线程引发CPU100%的方案验证后续(二)
  • Spring MVC与Spring Boot文件上传配置差异对比及文件上传关键类详细说明与对比
  • 【小沐杂货铺】基于Three.JS绘制太阳系Solar System(GIS 、WebGL、vue、react,提供全部源代码)
  • 谈Linux之磁盘管理——万字详解
  • CMDB平台(进阶篇):机房拓扑功能深度解析