计算机网络 / 系统课时

搭建本地测试服务

搭建本地测试服务

本节用 Python 标准库启动一个只监听本机的 HTTP 服务,不需要安装框架。完成后可以从另一个终端用 curl 访问 http://127.0.0.1:8000/,得到 200 响应,为后续观察请求、响应和报文细节准备稳定环境。

学习目标

  • 用 Python 标准库在 127.0.0.1:8000 启动本地 HTTP 服务。
  • 用 curl 验证服务是否真正可访问并读取状态码。
  • 处理端口占用、命令不存在和错误绑定地址三类常见问题。

检查 Python 与监听地址

建议使用 Python 3.9 或更高版本。先执行 python --version;如果系统提示找不到命令,macOS 或 Linux 可尝试 python3 --version,Windows 可尝试 py -3 --version。

本节固定绑定 127.0.0.1,表示只允许本机访问,比绑定 0.0.0.0 更适合学习和调试。端口使用 8000;如果已经被其他程序占用,后面改成 8001 即可。

启动本地 HTTP 服务

在一个空目录中打开终端,运行 Python 自带的 http.server 模块。该服务会把当前目录作为站点根目录;目录里没有 index.html 时,浏览器或 curl 会得到目录列表页面。

bash
python -m http.server 8000 --bind 127.0.0.1

预期输出:

text
Serving HTTP on 127.0.0.1 port 8000 (http://127.0.0.1:8000/) ...

这条命令会持续占用当前终端,不会自动返回命令提示符。保持它运行,再打开第二个终端做验证;结束服务时在服务终端按 Ctrl+C。

用 curl 验收服务

在第二个终端执行下面的请求。响应体保存为 local-response.html,终端只显示状态码,因此不会被目录列表 HTML 干扰。

bash
curl -sS -o local-response.html -w 'STATUS=%{http_code}\n' http://127.0.0.1:8000/

预期输出:

text
STATUS=200

同时,服务终端会出现一条访问日志,时间会按实际请求变化:

text
127.0.0.1 - - [<TIME>] "GET / HTTP/1.1" 200 -

看到 curl 的 200、服务端的 GET 日志,以及当前目录中新生成的 local-response.html,三项同时满足才算环境验收完成。

处理启动与访问失败

如果启动时出现 Address already in use、macOS 常见的 Errno 48,或 Linux 常见的 Errno 98,说明 8000 已被占用。把启动命令中的端口改成 8001,curl 地址也同步改为 http://127.0.0.1:8001/。

如果 curl 报 Failed to connect to 127.0.0.1 port 8000,先确认服务终端仍在运行,再检查两边端口是否一致。若 python -m http.server 不存在但系统有 Python 3,改用 python3 -m http.server 8000 --bind 127.0.0.1 或 Windows 的 py -3 -m http.server 8000 --bind 127.0.0.1。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

搭建本地测试服务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通