【python】如何通过Python中的http.server搭建文件上传下载服务

已于 2024-08-26 10:57:09 修改
阅读量950 收藏 40
点赞数 48
分类专栏： python轻松入门，基础语法到高阶实战教学 文章标签： python http 开发语言 python文件上传下载 http.server
于 2024-08-26 10:53:16 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/littlefun591/article/details/141556104
版权

在这里插入图片描述

✨✨ 欢迎大家来到景天科技苑✨✨

🎈🎈 养成好习惯，先赞后看哦~🎈🎈

🏆 作者简介：景天科技苑
🏆《头衔》：大厂架构师，华为云开发者社区专家博主，阿里云开发者社区专家博主，CSDN全栈领域优质创作者，掘金优秀博主，51CTO博客专家等。
🏆《博客》：Python全栈，PyQt5和Tkinter桌面开发，小程序开发，人工智能，js逆向，App逆向，网络系统安全，数据分析，Django，fastapi，flask等框架，云原生K8S，linux，shell脚本等实操经验，网站搭建，数据库等分享。

所属的专栏：python综合应用，基础语法到高阶实战教学
景天的主页：景天科技苑

在这里插入图片描述

文章目录

Python搭建文件下载服务

在Web开发中，文件下载服务是一个常见且基础的功能。Python的http.server模块提供了一个简单而强大的方式来搭建HTTP服务器，进而实现文件下载服务。本文将结合实际案例，详细介绍如何使用Python的http.server模块来搭建文件下载服务。

一、概述

Python的http.server模块是Python标准库的一部分，它提供了一个基本的HTTP服务器类和请求处理器。通过这个模块，我们可以轻松地搭建一个HTTP服务器，用于处理客户端的HTTP请求，包括文件下载请求。

1.1 准备工作

在开始之前，请确保你的计算机上已安装Python环境。Python 3.x版本已经内置了http.server模块，因此你不需要额外安装任何库。

1.2 场景描述

假设我们有一个需求：需要搭建一个HTTP服务器，用于提供特定目录下的文件下载服务。客户端通过访问服务器上的特定URL，即可下载服务器上的文件。

二、搭建HTTP服务器

2.1 基础服务器搭建

首先，我们将使用http.server模块搭建一个基础的HTTP服务器。

2.1.1 示例代码
import http.server
import socketserver

# 设置端口号
PORT = 8000

# 创建一个TCP服务器
with socketserver.TCPServer(("", PORT), http.server.SimpleHTTPRequestHandler) as httpd:
    print("Serving at port", PORT)
    # 启动服务器，使其一直运行
    httpd.serve_forever()

在这里插入图片描述

在上述代码中，我们导入了http.server和socketserver模块，并设置了服务器监听的端口号为8000。然后，我们创建了一个TCPServer实例，并将http.server.SimpleHTTPRequestHandler作为请求处理器传入。最后，我们调用serve_forever()方法启动服务器，使其持续运行。

2.1.2 运行服务器

将上述代码保存为一个.py文件，例如server.py。然后，在命令行中导航到该文件所在的目录，并执行以下命令：

python server.py

执行后，你将在控制台看到“Serving at port 8000”的提示，表示服务器已成功启动。
在这里插入图片描述

2.2 自定义文件目录

默认情况下，SimpleHTTPRequestHandler会处理服务器当前工作目录下的文件。然而，我们可能希望服务器处理特定目录下的文件。为了实现这一需求，我们可以创建一个继承自SimpleHTTPRequestHandler的类，并重写translate_path方法。

2.2.1 示例代码
import http.server
import socketserver
import os

# 定义服务器端口
PORT = 8080
# 定义文件目录
DIRECTORY = "/path/to/your/directory"

# 创建一个处理请求的类
class MyHandler(http.server.SimpleHTTPRequestHandler):
    def translate_path(self, path):
        # 确保返回的路径在指定的目录内
        path = os.path.normpath(os.path.join(DIRECTORY, path.lstrip('/')))
        return path

# 创建服务器
with socketserver.TCPServer(("", PORT), MyHandler) as httpd:
    print(f"Serving at port {PORT}")
    # 启动服务器，使其一直运行
    httpd.serve_forever()

在上述代码中，我们定义了DIRECTORY变量来指定文件所在的目录，并创建了一个MyHandler类，该类继承自SimpleHTTPRequestHandler并重写了translate_path方法。在translate_path方法中，我们通过os.path.join和os.path.normpath函数将请求的路径与DIRECTORY变量拼接起来，并确保返回的路径在指定的目录内。

2.2.2 运行服务器

将上述代码保存为一个.py文件，并替换DIRECTORY变量的值为你希望服务器处理的文件目录。然后，按照2.1.2节中的步骤运行服务器。

2.3 上传下载服务

有时，我们可能需要定制HTTP响应头，以满足特定的需求。

2.3.1 示例代码

为了定制响应头，我们继续上面的例子，通过重写do_GET方法来设置特定的HTTP响应头，比如Content-Disposition以支持文件下载。

import os
import cgi
from http.server import HTTPServer, BaseHTTPRequestHandler
from urllib.parse import unquote


class SimpleHTTPRequestHandler(BaseHTTPRequestHandler):
    def do_GET(self):
        # Parse the URL to get the file path
        file_path = unquote(self.path.strip("/"))

        if os.path.isfile(file_path):
            # If the requested path is a file, serve the file as an attachment
            self.send_response(200)
            self.send_header('Content-Type', 'application/octet-stream')
            # self.send_header('Content-Disposition', f'attachment; filename="{os.path.basename(file_path)}"')
            self.end_headers()
            with open(file_path, 'rb') as file:
                self.wfile.write(file.read())
        else:
            # Otherwise, show the upload form and file list
            self.send_response(200)
            self.send_header('Content-type', 'text/html')
            self.end_headers()

            # List files in the current directory
            file_list = os.listdir('.')
            file_list_html = ''.join(f'<li><a href="/{file}">{file}</a></li>' for file in file_list)

            self.wfile.write(f'''
                <html>
                <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
                <body>
                    <form enctype="multipart/form-data" method="post">
                        <input type="file" name="file">
                        <input type="submit" value="Upload">
                    </form>
                    <h2>Files in current directory:</h2>
                    <ul>
                        {file_list_html}
                    </ul>
                </body>
                </html>
            '''.encode())

    def do_POST(self):
        try:
            content_type = self.headers['Content-Type']
            if 'multipart/form-data' in content_type:
                form = cgi.FieldStorage(
                    fp=self.rfile,
                    headers=self.headers,
                    environ={'REQUEST_METHOD': 'POST'}
                )
                file_field = form['file']
                if file_field.filename:
                    # Save the file
                    with open(os.path.join('.', file_field.filename), 'wb') as f:
                        f.write(file_field.file.read())
                    self.send_response(200)
                    self.send_header('Content-type', 'text/html')
                    self.end_headers()
                    self.wfile.write(b'''
                        <html>
                        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
                        <body>
                            <p>File uploaded successfully.</p>
                            <script>
                                setTimeout(function() {
                                    window.location.href = "/";
                                }, 2000);
                            </script>
                        </body>
                        </html>
                    ''')
                else:
                    self.send_response(400)
                    self.send_header('Content-type', 'text/html')
                    self.end_headers()
                    self.wfile.write(b'''
                        <html>
                        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
                        <body>
                            <p>No file uploaded.</p>
                            <script>
                                setTimeout(function() {
                                    window.location.href = "/";
                                }, 2000);
                            </script>
                        </body>
                        </html>
                    ''')
            else:
                self.send_response(400)
                self.send_header('Content-type', 'text/html')
                self.end_headers()
                self.wfile.write(b'''
                    <html>
                    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
                    <body>
                        <p>Invalid content type.</p>
                        <script>
                            setTimeout(function() {
                                window.location.href = "/";
                            }, 2000);
                        </script>
                    </body>
                    </html>
                ''')
        except Exception as e:
            self.send_response(500)
            self.send_header('Content-type', 'text/html')
            self.end_headers()
            self.wfile.write(f'''
                <html>
                <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
                <body>
                    <p>Error occurred: {str(e)}</p>
                    <script>
                        setTimeout(function() {{
                            window.location.href = "/";
                        }}, 2000);
                    </script>
                </body>
                </html>
            '''.encode())


def run(server_class=HTTPServer, handler_class=SimpleHTTPRequestHandler, port=8000):
    server_address = ('', port)
    httpd = server_class(server_address, handler_class)

    # Uncomment the following lines if you need HTTPS support
    # httpd.socket = ssl.wrap_socket(httpd.socket,
    #                                keyfile="path/to/key.pem",
    #                                certfile='path/to/cert.pem', server_side=True)

    print(f'Starting httpd server on port {port}...')
    httpd.serve_forever()


if __name__ == '__main__':
    run()

在上述代码中，CustomFileHandler类继承自之前定义的MyHandler类（或直接从http.server.SimpleHTTPRequestHandler继承，如果你没有重写translate_path方法的话）。我们重写了do_GET方法，以处理GET请求并定制响应头。

  • 首先，我们通过translate_path方法获取请求文件的实际路径。
  • 然后，我们检查该文件是否存在。
  • 如果文件存在，我们使用mimetypes.guess_type函数猜测文件的MIME类型，并设置相应的Content-type响应头。
  • 最后，我们打开文件，并使用copyfile方法将文件内容发送给客户端。
    如果文件不存在，我们通过send_error方法返回404错误。

浏览器访问http://localhost:8000/
能看到下载列表
在这里插入图片描述

点击选择文件可以上传
在这里插入图片描述

2.3.2 运行服务器

将上述代码保存为一个.py文件，并替换DIRECTORY变量的值为你希望服务器处理的文件目录。然后，按照之前的步骤运行服务器。

现在，当你通过浏览器访问服务器上的文件时（例如，http://localhost:8080/example.pdf），浏览器将以下载的方式处理该文件，而不是尝试在浏览器中打开它。

三、安全性考虑

虽然http.server模块提供了一个快速搭建HTTP服务器的方法，但它在安全性方面存在一些局限性。例如，默认情况下，它会处理服务器上所有可读文件的请求，这可能会暴露敏感信息。

为了增强安全性，你可以：

  • 限制服务器的访问权限，例如，使用防火墙规则来限制只有特定的IP地址或网络才能访问服务器。
  • 创建一个白名单，仅允许访问白名单中指定的文件或目录。
  • 使用更安全的HTTP服务器框架，如Flask或Django，这些框架提供了更丰富的功能和更好的安全性支持。

四、总结

通过本教程，我们学习了如何使用Python的http.server模块搭建一个基本的HTTP服务器，并实现文件下载服务。我们介绍了如何设置服务器端口、自定义文件目录、定制HTTP响应头以及处理GET请求。最后，我们还讨论了使用http.server模块时需要注意的一些安全性问题。希望这些内容对你有所帮助！

景天科技苑
关注
  • 48
    点赞
  • 踩
  • 40
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 20
    评论
专栏目录
Python通过命令开启http.server服务器的方法
09-21
### Python通过命令开启http.server服务器的方法 #### 前言 在某些情况下，我们可能需要一个简单的Web服务器来快速分享文件或测试Web应用，而无需安装像Apache或Nginx这样的完整Web服务器软件。这时，Python自带的...
详解用python -m http.server搭一个简易的本地局域网
09-27
主要介绍了详解用python -m http.server搭一个简易的本地局域网，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
文件上传/下载接口（超简单的教程来了）
m0_70618214的博客
05-19 1万+
前言 文件上传/下载接口与普通接口类似，但是有细微的区别。 如果需要发送文件到服务器，例如：上传文档、图片、视频等，就需要发送二进制数据，上传文件一般使用的都是 Content-Type: multipart/form-data 数据类型，可以发送文件，也可以发送相关的消息体数据。 反之，文件下载就是将二进制格式的响应内容存储到本地，并根据需要下载的文件的格式来写文件名，例如：F:/合同文件.pdf。 一、文件上传接口 1. 接口文档 Request URL： /createbyfile...
利用Python开发一个上传文件的服务
duzm200542901104的专栏
04-26 341
1、安装uvicorn，利用其来作为web服务器2、安装Starlette，利用其来作为web开发框架3、安装python-multipart，让其支持form表达形式的文件上传4、postman：文件上传的发起者，这样我们就不用写前端界面了。
[Python http.server] 搭建http服务器用于下载/上传文件
热门推荐
Norths_的博客
05-17 1万+
动机：笔者需测试bs架构下的文件上传与下载性能，故想通过Python搭建http服务器并实现客户端与服务器之间的文件上传和下载需求 难点：这应该是很基础的东西，不过笔者之前未接触过http编程，谨在此记录下学习的过程，可能不是最优解 方法：在服务器端部署html页面，并执行监听的Python代码，在客户端操作实现文件的上传与下载
基于python -m http.server的文件共享服务器搭建
图灵追幕者博客录
05-06 1398
使用python构建文件共享服务器
如何使用Python快速建立一个http.server文件共享服务器并实现远程访问
等风来
07-11 964
本文主要介绍如何在Windows系统电脑上使用python这样的简单程序语言，在自己的电脑上搭建一个共享文件服务器，并通过cpolar创建的公网地址，打造一个可以随时随地远程访问的私人云盘。数据共享作为和连接作为互联网的基础应用，不仅在商业和办公场景有广泛的应用，对于个人用户也有很强的实用意义。也正因如此，大量数据共享软件被开发出来，云存储的概念也被重复炒作。对于爱好折腾的笔者来说，用最简单的工具找寻私人共享和存储解决方案，也是件很有趣的事。
Python http.server服务搭建
你的指尖有改变世界的力量
07-01 1424
介绍了如何使用python自带的http.server模块开发简单的web应用
【跟着暴躁哥学 Python】 http.server：快速搭建你的本地服务器
babybin的博客
01-24 2415
这样太简单了，我要自定义！” 没问题！来自定义一个：比如我们加上一个"/hello"路由。")else:super().do_GET() # 其他请求就用默认的处理方式再复杂点儿，需要加上简单的POST请求。import cgi")else:super().do_GET() # 其他请求就用默认的处理方式else:POST数据到/submit，服务器就会回你一条信息。
python HTTPServer 实现文件上传下载
xiekch的博客
08-07 4003
最近用ipad和windows互传文件时没有发现简单的工具，就用python的HTTPServer写个简单的网页应用用于互传文件吧。
python 搭建简单的http server,可直接post文件的实例
09-19
通过本文的学习，我们不仅掌握了如何使用Python快速搭建HTTP服务器，还学会了如何处理POST请求中的文件上传操作。此外，我们还可以进一步探索以下主题： - 使用更现代的库（如Flask或Django）来搭建Web服务器。 - ...
如何在Python中使用IP代理
IPIPGO的博客
08-23 485
通过以上步骤，你应该已经学会了如何在Python中使用IP代理。无论是单个代理IP、带认证的代理IP，还是批量使用代理IP，这些方法都能帮助你在实际项目中灵活应用。希望这篇文章对你有所帮助，如果你有任何问题或建议，欢迎在评论区留言，我们会尽力为你解答。t=N7T8。
python 实现convolution neural network卷积神经网络算法
luthane的博客
08-26 1761
卷积神经网络（Convolutional Neural Networks, CNN）是一种包含卷积计算且具有深度结构的前馈神经网络（Feedforward Neural Networks, FNN），是深度学习的代表算法之一。基本原理CNN的核心思想是通过模拟人类视觉系统的工作方式，自动提取图像中的特征，并将其用于分类、检测、分割等任务。它主要受到了生物学上感知机制的启发，模拟了人类视觉系统中的感知细胞和复杂细胞的工作方式。
centos7 安装 superset4.0.2 教程
最新发布
m0_37759590的博客
08-27 513
centos7 安装 superset4.0.2 教程
【python计算机视觉编程——1.基本的图像操作和处理】
m0_53694086的博客
08-26 899
参数sigma为标准差（σ），是高斯滤波器的一个重要参数，它控制滤波器的平滑程度。标准差越大，高斯函数的曲线越宽，滤波器的影响范围就越大。标准差较大: 高斯滤波器会在更大范围内进行平滑，使得图像变得更加模糊，细节和边缘特征会被更强地平滑掉。标准差较小: 高斯滤波器会产生较小范围的平滑效果，图像的细节保留更多。还可以给定转换矩阵，将RGB图像转换为CIE XYZ色彩空间。图像像素值被分成128个区间，用于计算每个区间的像素值频率。可以返回目录中所有jpg图像的列表。
python12 中，No module named‘distutils‘错误
qq_43557600的博客
08-27 104
python12 “ No module named'distutils' ”,​ 安装 pip install setuptools ，解决 ​
Python优化算法09——黏菌优化算法(SMA)
weixin_46277779的博客
08-24 858
python黏菌优化算法代码和使用
【Python】Pydantic：快速上手
2303_80346267的博客
08-22 1127
Pydantic 是一个用于数据验证和设置管理的 Python 库，基于 Python 类型提示构建。它通过创建数据模型类并使用类型提示进行数据验证，使得数据的验证和解析变得简单而可靠，广泛应用于数据模型的定义和验证，特别是在构建 API 时。
python -m http.server 8000
08-26
"python -m http.server 8000"是一个命令，用于在本地启动一个简单的HTTP服务器。这个命令将会在端口号8000上监听HTTP请求，并将当前目录作为根目录。这意味着，如果你在命令执行时位于某个目录下，那么这个目录就会成为服务器的根目录，你可以通过浏览器访问"http://localhost:8000"来查看目录下的文件或者进行文件下载。如果你希望指定其他目录作为根目录，可以使用"--directory"选项来指定。例如，"python -m http.server 8000 --directory /path/to/directory"会把"/path/to/directory"作为根目录。你也可以通过命令行参数来指定不同的端口号。希望这些信息对你有所帮助。<span class="em">1</span><span class="em">2</span><span class="em">3</span> #### 引用[.reference_title] - *1* *3* [python -m http.server 8000](https://blog.csdn.net/sandalphon4869/article/details/118517965)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] - *2* [python -m http.server 迅速搭建本地任意目录http.server服务器](https://blog.csdn.net/zaf0516/article/details/122703231)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] [ .reference_list ]
评论 20
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

景天科技苑

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值