萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python 建立簡易 HTTP 伺服器:http.server / SimpleHTTPRequestHandler 一鍵啟動

Python 內建 http.server (Python 3) / SimpleHTTPServer (Python 2) 可一行指令或短腳本啟動靜態檔案 HTTP 伺服器,適合前端開發測試、檔案分享、Webhook 接收測試。

一行指令啟動 (最快)

# Python 3
python -m http.server 8000
# 預設綁定 0.0.0.0:8000,服務當前目錄

# 指定綁定 IP 與埠口
python -m http.server 8080 --bind 127.0.0.1

# Python 2
python -m SimpleHTTPServer 8000

腳本版:自訂處理邏輯

#!/usr/bin/env python3
import sys
from http.server import HTTPServer, SimpleHTTPRequestHandler

# 可自訂 Handler 覆寫 do_GET/do_POST 等
class MyHandler(SimpleHTTPRequestHandler):
    def do_GET(self):
        if self.path == '/health':
            self.send_response(200)
            self.send_header('Content-type', 'application/json')
            self.end_headers()
            self.wfile.write(b'{"status":"ok"}')
        else:
            super().do_GET()

if __name__ == '__main__':
    port = int(sys.argv[1]) if len(sys.argv) > 1 else 8000
    host = '127.0.0.1'
    server = HTTPServer((host, port), MyHandler)
    print(f"Serving HTTP on {host}:{port} ...")
    try:
        server.serve_forever()
    except KeyboardInterrupt:
        print("\nShutting down")
        server.shutdown()

常用 Handler 覆寫點

方法用途
do_GET()處理 GET 請求
do_POST()處理 POST 請求
do_HEAD()處理 HEAD 請求
send_response(code)發送狀態碼
send_header(k, v)發送標頭
end_headers()結束標頭區
wfile.write(bytes)寫入回應主體
rfile.read(size)讀取請求主體

安全性警告

  • 僅供開發/測試環境使用,無任何認證、授權、HTTPS、速率限制。
  • 預設服務當前工作目錄,可能洩露敏感檔案 (如 .git, .env, id_rsa)。
  • 生產環境請使用 Nginx、Apache、Caddy 或應用框架 (FastAPI, Flask, Django) 部署。

進階:支援 CGI 執行腳本

# 啟用 CGI 目錄
class CGIHandler(SimpleHTTPRequestHandler):
    def do_GET(self):
        if self.path.startswith('/cgi-bin/'):
            self.run_cgi()
        else:
            super().do_GET()

# 需將可執行腳本放在 cgi-bin/ 目錄,且有執行權限

總結

一行指令 `python -m http.server` 即可秒啟動靜態檔案伺服器;需自訂邏輯時繼承 SimpleHTTPRequestHandler 覆寫 do_GET/POST。切記僅限開發測試用途。

copyright © 萬盛學電腦網 all rights reserved