位置：文档库 > Python > 分享在IIS上用CGI方式运行Python脚本的实例教程

分享在IIS上用CGI方式运行Python脚本的实例教程

星星听写本上传于 2023-04-28 19:01

YPE html>

《分享在IIS上用CGI方式运行Python脚本的实例教程》

在Windows服务器环境中，IIS（Internet Information Services）作为常用的Web服务器软件，支持通过CGI（Common Gateway Interface）接口运行动态脚本。Python作为一门高效易用的脚本语言，通过CGI方式与IIS集成，可实现Web端动态内容生成。本教程将详细介绍从环境配置到脚本运行的完整流程，帮助开发者快速掌握这一技术。

一、环境准备

1.1 安装IIS服务

在Windows服务器上，通过“服务器管理器”添加角色，勾选“Web服务器（IIS）”并确保包含以下功能：

CGI（位于“应用程序开发功能”下）
常见HTTP功能（如静态内容、默认文档）

或通过PowerShell命令快速安装：

Install-WindowsFeature Web-Server, Web-CGI, Web-Asp-Net45

1.2 安装Python解释器

从Python官网下载最新稳定版（如3.10+），安装时勾选“Add Python to PATH”选项，确保系统环境变量中包含Python路径。

验证安装：

python --version
# 应输出类似：Python 3.10.5

1.3 配置CGI执行权限

打开IIS管理器，选择目标网站→“处理程序映射”→添加模块映射：

请求路径：*.py
模块：CgiModule
可执行文件：C:\Python310\python.exe %s %s（根据实际路径调整）
名称：Python CGI

在网站根目录的“功能视图”中，双击“CGI”图标，确保已启用CGI支持。

二、创建Python CGI脚本

2.1 基础脚本结构

在网站根目录（如C:\inetpub\wwwroot）下创建test.py文件，内容如下：

#!/usr/bin/env python
# -*- coding: utf-8 -*-

print("Content-type: text/html\n\n")  # CGI必须输出的HTTP头
print("")
print("Hello from Python CGI!")
print("Current time:", __import__('datetime').datetime.now(), "")
print("")

关键点说明：

第一行指定Python解释器路径（Windows下可省略，但建议保留）
必须输出Content-type头，后跟两个换行符
所有输出内容需通过print语句发送

2.2 处理表单数据

创建form.html文件测试数据接收：


    Name:

对应的process.py脚本：

#!/usr/bin/env python
import cgi

print("Content-type: text/html\n\n")
form = cgi.FieldStorage()
username = form.getvalue('username', 'Guest')

print(f"""


    Welcome, {username}!
    Form data processed successfully.


""")

三、权限配置与调试

3.1 文件系统权限设置

右键网站根目录→属性→安全选项卡：

添加IIS_IUSRS用户组，赋予“读取和执行”权限
确保Python脚本文件（.py）未被阻止（右键文件→属性→解除锁定）

3.2 日志排查

在IIS中启用“详细错误”和“失败请求跟踪”：

网站→错误页→500状态码→编辑设置→选择“详细错误”
网站→失败请求跟踪规则→添加规则（跟踪所有内容）

常见错误及解决方案：

错误现象	可能原因	解决方法
500内部服务器错误	脚本无执行权限	检查文件权限和CGI模块配置
空白页面	未输出Content-type	确保首行打印HTTP头
404未找到	路径错误	检查IIS映射和物理路径对应关系

四、性能优化建议

4.1 使用FastCGI替代CGI

CGI模式每次请求都会启动新进程，性能较低。推荐改用wfastcgi模块：

安装wfastcgi：pip install wfastcgi
在IIS中注册：wfastcgi-enable
配置网站使用FastCGI处理程序

4.2 脚本缓存机制

对于不常修改的脚本，可在Python中实现缓存：

import os
import time

CACHE_FILE = "cache.html"
CACHE_EXPIRE = 3600  # 1小时

def get_cached_content():
    if os.path.exists(CACHE_FILE):
        mtime = os.path.getmtime(CACHE_FILE)
        if time.time() - mtime Cached Content at " + time.ctime() + ""
    with open(CACHE_FILE, 'w') as f:
        f.write(content)
    return content

print("Content-type: text/html\n\n")
print(get_cached_content())

五、安全实践

5.1 输入验证

防止XSS攻击的示例：

import html

def escape_html(text):
    return html.escape(text)

user_input = form.getvalue('input', '')
safe_output = escape_html(user_input)
print(f"{safe_output}
")

5.2 限制文件访问

在脚本开头添加路径检查：

import os
import sys

BASE_DIR = os.path.dirname(os.path.abspath(__file__))
ALLOWED_PATHS = [BASE_DIR, os.path.join(BASE_DIR, 'uploads')]

def is_safe_path(filepath):
    filepath = os.path.abspath(filepath)
    return any(filepath.startswith(p) for p in ALLOWED_PATHS)

# 使用示例
request_path = form.getvalue('file_path', '')
if not is_safe_path(request_path):
    print("Error: Access denied")
    sys.exit(1)

六、完整示例：用户登录系统

6.1 数据库配置（使用sqlite3）

创建db_init.py初始化数据库：

import sqlite3

conn = sqlite3.connect('users.db')
c = conn.cursor()
c.execute('''CREATE TABLE IF NOT EXISTS users
             (id INTEGER PRIMARY KEY, username TEXT, password TEXT)''')
# 添加测试用户
c.execute("INSERT INTO users VALUES (1, 'admin', 'admin123')")
conn.commit()
conn.close()

6.2 登录处理脚本（login.py）

#!/usr/bin/env python
import cgi
import sqlite3
import html

print("Content-type: text/html\n\n")

form = cgi.FieldStorage()
username = form.getvalue('username', '').strip()
password = form.getvalue('password', '').strip()

# 输入净化
username = html.escape(username)
password = html.escape(password)

# 数据库验证
try:
    conn = sqlite3.connect('users.db')
    c = conn.cursor()
    c.execute("SELECT * FROM users WHERE username=? AND password=?", 
              (username, password))
    user = c.fetchone()
    
    if user:
        print(f"""
        
        
            Login Successful!
            Welcome, {username}!
        
        
        """)
    else:
        print("""
        
        
            Login Failed
            Invalid credentials. Try again
        
        
        """)
except Exception as e:
    print(f"Database error: {html.escape(str(e))}")
finally:
    if 'conn' in locals():
        conn.close()

6.3 登录页面（login.html）


    Login


    
        Username: 

        Password:

七、常见问题解答

Q1: 修改脚本后需要重启IIS吗？
A: 不需要。IIS会自动检测脚本修改并重新加载。

Q2: 如何支持POST方法的大数据量？
A: 在IIS的CGI配置中调整“请求限制”设置，或改用FastCGI模式。

Q3: 能否同时运行Python 2和Python 3脚本？
A: 可以。为不同版本创建独立的处理程序映射，分别指向对应的python.exe路径。

Q4: 如何记录脚本执行日志？
A: 在Python脚本开头添加日志记录：

import logging
logging.basicConfig(filename='cgi.log', level=logging.INFO)
logging.info(f"Request received from {os.environ.get('REMOTE_ADDR')}")

八、进阶方向

8.1 与ASP.NET混合部署

在IIS中同时配置Python CGI和ASP.NET应用程序，通过URL重写规则实现路由分发。

8.2 使用WSGI替代CGI

通过isapi-wsgi模块将WSGI应用（如Flask/Django）集成到IIS中，获得更好的性能和功能支持。

8.3 自动化部署方案

使用PowerShell脚本自动化IIS配置：

$siteName = "PythonApp"
$physicalPath = "C:\inetpub\wwwroot\python"

# 创建应用程序池
New-WebAppPool -Name $siteName

# 创建网站
New-Website -Name $siteName -PhysicalPath $physicalPath -Port 8080 -ApplicationPool $siteName

# 添加CGI处理程序
Add-WebConfiguration -pspath "IIS:\Sites\$siteName" -filter "system.webServer/handlers" -value @{
    path="*.py"
    verb="*"
    modules="CgiModule"
    scriptProcessor="C:\Python310\python.exe|%s|%s"
    resourceType="File"
}

关键词：IIS配置、Python CGI、Windows服务器、Web开发、动态脚本、IIS权限管理、表单处理、安全实践、性能优化、FastCGI

简介：本文详细介绍了在Windows IIS服务器上通过CGI方式运行Python脚本的完整流程，涵盖环境搭建、脚本编写、权限配置、安全防护和性能优化等方面。通过实例演示了表单数据处理、数据库交互和用户认证等常见Web功能的实现方法，适合需要整合Python与IIS的开发者参考。

立即下载

Python相关