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

Python 自带 http.server 模块可快速启动静态文件服务器:命令行执行 python -m http.server 8000 即可访问目录列表;支持自定义处理器添加路由(如 /health);仅限开发测试,不适用于生产环境。

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 已经足够快、够稳、够简单。