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

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学习网公众号,一起学习编程~
相关阅读
更多>
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
最新阅读
更多>
-
394 收藏
-
301 收藏
-
143 收藏
-
200 收藏
-
284 收藏
-
234 收藏
-
350 收藏
-
294 收藏
-
328 收藏
-
157 收藏
-
373 收藏
-
474 收藏
课程推荐
更多>
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习