主机禁用Flask时Python实现URL分发映射的方案咨询

共享虚拟主机环境限制多，禁Flask、不允许用户自行监听端口是常规操作，不用第三方框架，靠Python标准库就能完整实现URL路由分发，完全满足定制站点需求，不需要额外装依赖，也不会触发安全拦截。

方案1：基于标准库wsgiref实现（零依赖，适配支持WSGI的主机） #

wsgiref是Python官方内置的WSGI工具集，所有标准Python环境默认自带，不属于被管控的第三方框架范畴。核心实现逻辑是自己维护URL路径与处理函数的映射表，请求进入后匹配对应处理函数返回页面内容即可。

核心实现代码如下：

from wsgiref.simple_server import make_server

# 路由映射表：键为URL路径，值为对应页面的处理函数
ROUTE_TABLE = {}

# 路由注册装饰器，用来快速绑定路径和处理逻辑
def bind_route(path):
    def wrap(handler_func):
        ROUTE_TABLE[path] = handler_func
        return handler_func
    return wrap

# 绑定首页路由
@bind_route('/')
def page_index():
    resp_status = "200 OK"
    resp_headers = [("Content-Type", "text/html; charset=utf-8")]
    resp_content = b"""
    <!DOCTYPE html>
    <html>
        <head><title>首页</title></head>
        <body><h1>站点首页</h1><p>原生Python搭建的自定义站点</p></body>
    </html>
    """
    return resp_status, resp_headers, resp_content

# 绑定关于页路由
@bind_route('/about')
def page_about():
    resp_status = "200 OK"
    resp_headers = [("Content-Type", "text/html; charset=utf-8")]
    resp_content = b"<h1>关于我们</h1><p>自定义页面内容</p>"
    return resp_status, resp_headers, resp_content

# 404页面处理
def page_404():
    resp_status = "404 Not Found"
    resp_headers = [("Content-Type", "text/html; charset=utf-8")]
    resp_content = b"<h1>404 页面不存在</h1>"
    return resp_status, resp_headers, resp_content

# WSGI标准入口，虚拟主机会自动加载这个对象处理请求
def application(environ, start_response):
    # 获取当前请求的路径
    req_path = environ.get('PATH_INFO', '/')
    # 匹配对应路由的处理函数，匹配不到走404
    current_handler = ROUTE_TABLE.get(req_path, page_404)
    status, headers, content = current_handler()
    start_response(status, headers)
    return [content]

# 仅本地调试用，部署到虚拟主机时不要执行这部分代码
if __name__ == '__main__':
    with make_server('', 5000, application) as server:
        print("本地调试运行在 http://localhost:5000")
        server.serve_forever()

部署注意事项：

• 不要在虚拟主机上执行python init.py启动服务，共享主机基本都会拦截用户自定义的端口监听进程，这也是你之前访问5000一直超时的核心原因之一。
• 直接在主机面板找到WSGI配置项，将入口文件指向上述代码文件，加载application对象即可，请求会由主机自带的Nginx/Apache转发到Python程序，不需要自己监听端口。

方案2：基于CGI标准实现（适配仅支持CGI的老款共享主机） #

如果你的虚拟主机不支持WSGI，只提供CGI运行权限，可以用Python内置的cgi模块实现路由，同样零依赖：

#!/usr/bin/env python3
import os

# 路由表
ROUTE_TABLE = {}

def bind_route(path):
    def wrap(handler_func):
        ROUTE_TABLE[path] = handler_func
        return handler_func
    return wrap

@bind_route('/')
def page_index():
    return b"<h1>站点首页</h1><p>CGI模式运行的站点</p>"

@bind_route('/news')
def page_news():
    return b"<h1>新闻列表</h1>"

if __name__ == '__main__':
    # 获取请求路径，过滤GET参数
    req_path = os.environ.get('REQUEST_URI', '/').split('?')[0]
    # 输出HTTP响应头
    print("Content-Type: text/html; charset=utf-8\n")
    # 匹配路由输出内容
    handler = ROUTE_TABLE.get(req_path, lambda: b"<h1>404 Not Found</h1>")
    print(handler().decode('utf-8'))

部署注意事项：

• 将文件权限设置为755，放到主机指定的cgi-bin目录，或者在面板开启对应目录的CGI解析权限即可正常访问。

进阶优化方向 #

• 动态路由支持：如果需要匹配/article/<article_id>这类带参数的路径，不需要引入第三方库，给路由规则加正则匹配逻辑，提取路径中的参数传给处理函数即可，代码量不超过50行。
• 静态资源处理：将CSS、JS、图片等静态文件放到主机的静态资源目录，直接由Web服务器解析返回，不要走Python路由逻辑，性能和之前WordPress站点的静态资源访问速度一致。
• 功能扩展：如果需要请求参数解析、Cookie处理、会话管理这类功能，都可以基于Python标准库自己实现，核心逻辑很简单，不需要依赖被管控的第三方框架。

内容的提问来源于stack exchange，提问作者Herman