利用Python CGIHTTPServer快速构建内部交互服务

半杯拿铁

发布时间：2026-10-12 | 3人浏览过

原创

本文详解如何使用Python内置的CGIHTTPServer快速搭建简易Web服务。通过启动后台服务、编写HTML交互页面及实现后端CGI脚本，实现参数提交与结果返回。该方法开发便捷，适合内部使用，但需注意纯CGI协议的安全风险，不建议对外暴露。

介绍

针对服务器后端开发人员，有时需将部分服务直接开放给产品经理（PM）或其他研发人员（RD）使用。此时，搭建一套能与前端用户进行简单交互的Web服务成为必要。常规做法是采用Apache或Nginx作为Web服务器后端，配合CGI或FCGI程序/脚本处理请求，这种方式虽安全且规范，但配置相对复杂。

个人更倾向于一种更为简化的方案：利用Python自带的CGIHTTPServer模块作为服务器基础，配合一个简单的HTML页面进行交互。用户通过POST请求直接调用总控脚本，即可实现与用户的简单交互流程。

使用方法和示例

启动服务

Python的CGIHTTPServer模块通常随Python环境一同安装。可使用如下命令启动服务。为了便于目录管理，建议先创建一个专用目录（例如命名为web），随后在该目录下执行启动命令。

nohup python -m CGIHTTPServer 8088 &

上述命令将使CGIHTTPServer以非中断的后台模式运行。运行日志可通过当前目录下的nohup.out文件进行查看。

编写交互页面

在启动Server的当前目录下，新建一个index.html文件，其内容编写如下。

<!DOCTYPE html>
<html>
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=gbk">
  <title> Python-CGIHTTPServer使用示例 </title>
  <meta name="author" content="Haiyu">
  <center><h1> Python-CGIHTTPServer使用示例 </h1></center>
 </head>
 <hr style="height:5px;border:none;border-top:5px ridge green;" />
 <body>
  <br/>
  <center><h2>计算圆的周长</h2></center>
  <center>
  <p>请输入圆的半径长度.</p>
  <br/>
  <form action="cgi-bin/c_length.sh" method="post" enctype="text/plain" target="_blank">
   radius:<input type="text" id="radius" name="radius" value=""/>
   <input type="submit" id="c_length" name="c_length" value="计算周长">
  </form>
  </center>
  <br/>
  <br/>
  <br/>
 </body>
 <hr style="height:5px;border:none;border-top:5px ridge green;" />
 <br/>
 <br/>
</html>

该界面功能简洁，主要利用一个form表单接收用户提交的半径参数，计算周长后通过POST请求返回结果。

CGI脚本

这是后端开发人员最为关注的部分。该脚本负责执行核心逻辑并返回结果。后端开发者的关注点通常不在于交互界面的华丽程度，而在于逻辑处理的正确性与严谨性。根据经验，无论后端处理流程多么复杂，最终均可封装为一个脚本，通过接收输入参数并返回处理结果来实现功能。此处输入即为用户提交的参数，输出即为经过处理后的返回内容。建议将此脚本放置在Server运行目录下新建的cgi-bin目录中。

#!/bin/bash

mysql_bin=/home/work/mysql/bin/mysql

echo "Content-Type:text/html; Charset=gbk"
echo ""

echo "<br/>"
radius=0
c_length=0
if [[ "$REQUEST_METHOD" == "POST" ]];then
 read vars
 echo "$vars" | awk -F "=" '{print $2}' > temp
 dos2unix temp
 radius=`cat temp`
 c_length=$(echo "scale=2;2*3.14*$radius" | bc)

 echo "<br/>"
 echo "<table border="5" cellpadding="10">"
 echo "Userid Info:"
 echo "<tr>"
 echo "<td>半径</td><td>周长</td>"
 echo "</tr>"
 echo "<tr>"
 echo "<td>"$radius"</td><td>"$c_length"</td>"
 echo "</tr>"
 echo "</table>"
fi

总结

以上介绍了使用Python CGIHTTPServer进行用户交互的核心内容。其优势在于开发便捷、使用简单，使后端开发人员能更专注于业务逻辑的处理。不足之处在于规范性稍弱，且存在一定安全风险。由于采用纯CGI协议进行交互，此前曾排查出涉及bash的CGI漏洞，因此使用时需警惕潜在风险。这种方式更适合开发对内使用的简易工具，不建议向外部用户公开暴露。