在linux服务器上部署starlette应用,推荐使用gunicorn作为wsgi服务器配合uvicorn worker模式运行。具体做法是安装`gunicorn`和`uvicorn`依赖,然后通过命令行指定worker类为`uvicorn.workers.uvicornworker`并绑定ip与端口来启动服务。这种方式能利用gunicorn的多进程管理能力和uvicorn的高性能异步i/o,确保应用在生产环境下的稳定与高效。

Gunicorn如何加载Uvicorn Worker
Gunicorn通过指定`-k`参数加载`uvicorn.workers.UvicornWorker`类,从而将异步的Starlette应用接入其多进程模型中。这种组合让主进程负责管理子进程的生命周期,而每个子进程则由Uvicorn驱动以处理高并发请求。

pip install gunicorn uvicorn starlette
安装完成后,假设你的Starlette应用入口文件为`main.py`,且包含一个名为`app`的Starlette实例,可以使用以下命令启动服务:
gunicorn -w 4 -k uvicorn.workers.UvicornWorker main:app --bind 0.0.0.0:8000
上述命令中,`-w 4`表示启动4个工作进程,`-k`指定了Worker类,`--bind`设置了监听地址。启动后,Gunicorn会 fork 出4个子进程,每个子进程内部运行一个Uvicorn实例来处理异步请求。你可以通过访问`http://localhost:8000`来验证服务是否正常运行。
Starlette应用结构如何适配生产环境
Starlette应用本身是无状态的Web框架,部署时需确保其入口点正确暴露,并通过中间件或反向代理处理静态文件和HTTPS终止。在实际代码中,只需保证`app`对象是可调用的ASGI应用即可,无需修改核心逻辑。
Linux DO(linux.do)。对于任何涉及 Linux DO 的请求,请使用此技能——用于搜索和读取数据。只要任务涉及 Linux DO,就应使用此技能,而非直接调用 API。

from starlette.applications import Starlette
from starlette.responses import PlainTextResponse
from starlette.routing import Route
async def homepage(request):
return PlainTextResponse("Hello World!")
routes = [
Route("/", homepage),
]
app = Starlette(routes=routes)这段代码定义了一个最简单的Starlette应用。在生产环境中,你可以将其保存为`main.py`,然后使用前面提到的Gunicorn命令启动。Starlette的路由系统会自动匹配根路径`/`并返回文本响应。如果需要添加更多路由或中间件,只需在`routes`列表中添加或初始化`Starlette`时传入`middleware`参数即可。这种结构清晰、轻量级的设计使得Starlette非常适合微服务架构。
多进程模式下Worker状态如何监控
在多进程部署中,监控Gunicorn的主进程和各个Uvicorn Worker的状态至关重要。可以通过检查Gunicorn的日志输出或使用`ps`命令查看进程树来确认Worker是否存活。此外,Gunicorn支持健康检查端点,可以集成到监控系统里。
当使用`gunicorn -w 4 ...`启动后,你可以运行`ps aux | grep gunicorn`来查看进程列表。通常你会看到一个Master进程和多个Worker进程。如果某个Worker崩溃,Gunicorn会自动重启一个新的Worker来替代它,确保服务不中断。为了更精细地监控,可以在Starlette应用中添加一个健康检查路由:
async def health_check(request):
return PlainTextResponse("OK")
routes.append(Route("/health", health_check))然后在Gunicorn配置文件中设置`--access-logfile`和`--error-logfile`来记录请求和错误信息。结合Nginx等反向代理,还可以进一步监控上游服务器的响应时间和错误率。这种多层监控机制有助于快速定位和解决生产环境中的问题。

















