登录
首页 >  文章 >  python教程

Python 快速搭建简单 HTTP 服务器方法

时间:2026-03-31 09:05:58 165浏览 收藏

Python 内置的 `http.server` 模块提供了一种零依赖、秒级启动静态文件服务器的极简方案——只需一条命令 `python -m http.server 8000`,就能在本地快速预览网页、调试前端或临时共享文件;它还支持通过自定义处理器轻松扩展功能(如添加 `/health` 健康检查接口),虽仅限开发测试使用(不支持 HTTPS、高并发或生产级安全特性),却以“够用、够快、够轻”的特质成为开发者手边最趁手的临时工具,真正实现“想看即看,改完即测”。

Python 如何实现一个简单 HTTP 服务器?

Python 自带 http.server 模块,无需安装第三方库,几行命令就能启动一个基础 HTTP 服务器,适合快速预览静态文件、本地调试或临时共享资源。

用命令行一键启动(最简单)

在终端中进入目标目录,执行对应命令即可:

  • Python 3.x:python -m http.server 8000(默认端口 8000,可改)
  • Python 2.x(已停用):python -m SimpleHTTPServer 8000

启动后访问 http://localhost:8000 就能看到当前目录的文件列表,点击即可下载或查看 HTML/CSS/JS 等静态内容。

用脚本自定义服务器行为

如果需要控制响应头、处理特定路径或添加日志,可写一个 Python 脚本:

from http.server import HTTPServer, SimpleHTTPRequestHandler

class MyHandler(SimpleHTTPRequestHandler):
    def do_GET(self):
        if self.path == '/health':
            self.send_response(200)
            self.send_header('Content-type', 'text/plain')
            self.end_headers()
            self.wfile.write(b'OK')
        else:
            super().do_GET()

if __name__ == '__main__':
    server = HTTPServer(('localhost', 8000), MyHandler)
    print("Serving on http://localhost:8000")
    server.serve_forever()

这段代码让 /health 返回纯文本 "OK",其余路径仍按默认方式提供文件服务。

注意事项和常见问题

这个服务器仅用于开发和测试,不适用于生产环境:

  • 不支持 HTTPS、并发连接少、无身份验证、无缓存控制
  • 默认只服务当前工作目录及子目录,无法跨目录访问(安全限制)
  • 若端口被占用,会报错 Address already in use,换端口重试即可,如 8001
  • Windows 用户注意关闭防火墙提示,Mac/Linux 用户可能需授权终端访问网络

想支持更多功能怎么办?

如需路由、模板、表单处理或 REST 接口,推荐使用成熟框架:

  • Flask:轻量易上手,适合小项目和 API
  • FastAPI:高性能,自动生文档,适合现代 Web 服务
  • httpx + uvicorn(搭配 FastAPI):异步支持好,启动快

但对“立刻看个 HTML 页面”这种需求,http.server 已经足够快、够稳、够简单。

今天带大家了解了的相关知识,希望对你有所帮助;关于文章的技术知识我们会一点点深入介绍,欢迎大家关注golang学习网公众号,一起学习编程~

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>