python怎么实现一个简单的Web服务器_python搭建简易Web服务器教程-Python教程-PHP中文网

python怎么实现一个简单的Web服务器_python搭建简易Web服务器教程

冰火之心

发布： 2025-09-11 22:04:01

原创

662人浏览过

使用Python内置http.server模块可快速搭建Web服务器，通过python -m http.server启动，默认端口8000，可指定端口如8080；通过自定义BaseHTTPRequestHandler处理GET、POST请求，支持返回HTML内容或静态文件；可添加异常处理返回404或500页面，并通过检查client_address实现IP访问限制，结合nohup命令可在后台运行服务。

python怎么实现一个简单的web服务器_python搭建简易web服务器教程

搭建一个简单的Python Web服务器，核心在于利用Python内置的

http.server

登录后复制

模块，几行代码就能搞定，无需额外安装。关键在于理解如何启动服务、指定端口，以及处理简单的HTTP请求。

解决方案：

最简启动： 打开终端，导航到你希望作为Web服务器根目录的文件夹。然后输入
```
python -m http.server
```
登录后复制
。默认情况下，它会在8000端口启动一个服务器。你可以通过浏览器访问
```
http://localhost:8000
```
登录后复制
来查看效果。
指定端口： 如果8000端口被占用或者你想用其他端口，可以使用
```
python -m http.server 8080
```
登录后复制
来在8080端口启动服务器。

立即学习“Python免费学习笔记（深入）”；
自定义处理器： 如果你需要更高级的功能，比如处理POST请求或者自定义响应，就需要编写一个自定义的HTTP请求处理器类。这个类需要继承自
```
http.server.BaseHTTPRequestHandler
```
登录后复制
，并重写
```
do_GET
```
登录后复制
和
```
do_POST
```
登录后复制
方法。

处理GET请求示例：

import http.server
import socketserver

class MyHandler(http.server.BaseHTTPRequestHandler):
    def do_GET(self):
        self.send_response(200)
        self.send_header('Content-type', 'text/html')
        self.end_headers()
        message = &quot;<html><body><h1>Hello, World!</h1></body></html>&quot;
        self.wfile.write(bytes(message, &quot;utf8&quot;))

PORT = 8000
Handler = MyHandler

with socketserver.TCPServer((&quot;&quot;, PORT), Handler) as httpd:
    print(&quot;serving at port&quot;, PORT)
    httpd.serve_forever()

登录后复制

这段代码创建了一个简单的服务器，当收到GET请求时，会返回一个包含 "Hello, World!" 的HTML页面。

处理POST请求： 处理POST请求稍微复杂一些，你需要读取请求体，解析数据，然后生成响应。

Giiso写作机器人
Giiso写作机器人，让写作更简单

56

查看详情

如何选择合适的端口号？

选择端口号其实没什么特别的规则，只要确保它没有被其他程序占用就行。通常，大于1024的端口号是比较安全的，因为小于1024的端口号通常需要root权限才能使用。你可以使用

netstat -an

登录后复制

(Linux/macOS) 或者

netstat -ano

登录后复制

(Windows) 命令来查看当前系统正在使用的端口号。避免使用常见的服务端口，比如80（HTTP）、443（HTTPS）等。

如何让这个简易Web服务器在后台运行？

在Linux/macOS下，你可以使用

nohup

登录后复制

命令将服务器放到后台运行。例如：

nohup python -m http.server 8080 &amp;

登录后复制

。这样，即使你关闭终端，服务器也会继续运行。

登录后复制

符号表示将命令放到后台执行。

nohup

登录后复制

会将输出重定向到

nohup.out

登录后复制

文件。

如何处理静态文件（HTML、CSS、JavaScript）？

http.server

登录后复制

模块默认就能处理静态文件。只要将你的HTML、CSS、JavaScript文件放到服务器的根目录下，就可以通过浏览器访问它们了。例如，如果你的HTML文件名为

index.html

登录后复制

，并且位于服务器根目录下，那么你可以通过

http://localhost:8000/index.html

登录后复制

来访问它。如果用户访问

http://localhost:8000/

登录后复制

，并且根目录下存在

index.html

登录后复制

文件，那么服务器会自动返回

index.html

登录后复制

的内容。

如何添加基本的错误处理？

在自定义的请求处理器类中，你可以通过捕获异常来处理错误。例如，如果用户请求的文件不存在，你可以返回一个404错误页面。

import http.server
import socketserver
import os

class MyHandler(http.server.BaseHTTPRequestHandler):
    def do_GET(self):
        try:
            filepath = self.path[1:]  # Remove leading '/'
            if filepath == "":
                filepath = "index.html" # Default file

            with open(filepath, 'rb') as f:
                content = f.read()
                self.send_response(200)
                self.send_header('Content-type', 'text/html')
                self.end_headers()
                self.wfile.write(content)
        except FileNotFoundError:
            self.send_response(404)
            self.send_header('Content-type', 'text/html')
            self.end_headers()
            self.wfile.write(bytes("<html><body><h1>404 Not Found</h1></body></html>", "utf8"))
        except Exception as e:
            self.send_response(500)
            self.send_header('Content-type', 'text/html')
            self.end_headers()
            self.wfile.write(bytes(f"<html><body><h1>500 Internal Server Error</h1><p>{e}</p></body></html>", "utf8"))


PORT = 8000
Handler = MyHandler

with socketserver.TCPServer(("", PORT), Handler) as httpd:
    print("serving at port", PORT)
    httpd.serve_forever()

登录后复制

这个例子中，如果文件不存在，服务器会返回一个404错误页面；如果发生其他错误，会返回一个500错误页面。

如何限制访问IP？

http.server

登录后复制

模块本身没有提供直接的IP限制功能。但是，你可以通过修改代码，在请求处理器中检查客户端的IP地址，并拒绝来自特定IP地址的请求。

import http.server
import socketserver

ALLOWED_IPS = ['127.0.0.1', '::1']  # 允许的IP地址列表

class MyHandler(http.server.BaseHTTPRequestHandler):
    def do_GET(self):
        client_ip = self.client_address[0]
        if client_ip not in ALLOWED_IPS:
            self.send_response(403)  # Forbidden
            self.send_header('Content-type', 'text/html')
            self.end_headers()
            self.wfile.write(bytes("<html><body><h1>403 Forbidden</h1></body></html>", "utf8"))
            return

        self.send_response(200)
        self.send_header('Content-type', 'text/html')
        self.end_headers()
        message = "<html><body><h1>Hello, World!</h1></body></html>"
        self.wfile.write(bytes(message, "utf8"))


PORT = 8000
Handler = MyHandler

with socketserver.TCPServer(("", PORT), Handler) as httpd:
    print("serving at port", PORT)
    httpd.serve_forever()

登录后复制

这个例子中，只有来自