uwsgi自启动Windows服务如何配置实现？

adminZpd windows 2026-02-05 12:05:59

在Windows系统中实现uWSGI的自启动,可以确保应用程序在系统重启后能够自动恢复运行，提高服务的可用性和稳定性，本文将详细介绍如何在Windows环境下配置uWSGI自启动，包括准备工作、配置步骤、常见问题处理以及相关FAQs。

uwsgi自启动Windows服务如何配置实现？-第1张图片-99系统专家

准备工作

在开始配置uWSGI自启动之前,需要确保以下准备工作已完成：

安装Python和uWSGI：确保Python已正确安装，并通过pip安装了uWSGI，可以使用命令pip install uwsgi进行安装。
编写uWSGI配置文件：创建一个INI格式的uWSGI配置文件，定义应用程序的运行参数，如监听地址、端口、进程数、Python模块路径等。
```
[uwsgi]
http = :8000
chdir = C:/path/to/your/project
wsgi-file = yourproject/wsgi.py
callable = app
processes = 4
threads = 2
```
测试uWSGI运行：在命令行中运行uwsgi --ini your_config.ini，确保uWSGI能够正常启动并响应请求。

Windows服务是一种在后台运行的应用程序,非常适合用于实现uWSGI的自启动，以下是具体步骤：

安装uWSGI为Windows服务：
- 打开命令行（管理员权限），进入uWSGI的安装目录或Python的Scripts目录。
- 使用以下命令将uWSGI安装为服务：
```
uwsgi --ini your_config.ini --enable-threads --plugin python --http 0.0.0.0:8000 --master --processes 4 --threads 2 --py-autoreload 1 --die-on-term --http-timeout 120 --socket-timeout 120 --mule-timeout 120 --harakiri 120 --daemonize2 C:/path/to/uwsgi.log --pidfile C:/path/to/uwsgi.pid
```
  注意：上述命令需要根据实际配置调整参数。
- 更推荐使用nssm（Non-Sucking Service Manager）工具来管理服务，它提供了更友好的界面和更稳定的服务管理。
使用nssm安装服务：
- 下载nssm工具（官网：https://nssm.cc/），解压后将nssm.exe放到系统PATH或指定目录。
- 打开命令行（管理员权限），运行以下命令：
```
nssm install uwsgi_service "C:/Python39/python.exe" "C:/Python39/Scripts/uwsgi.exe" "--ini" "C:/path/to/your_config.ini"
```
  uwsgi_service是服务名称，后续可通过该名称管理服务。
- 启动服务：
```
net start uwsgi_service
```
- 停止服务：
```
net stop uwsgi_service
```

安装为Windows服务后,默认是手动启动，可以通过以下步骤配置为自动启动：

在配置uWSGI自启动过程中,可能会遇到以下问题：

服务启动失败：
- 检查uWSGI配置文件路径是否正确,确保文件存在且可读。
- 查看Windows事件查看器（事件查看器 > Windows日志 > 应用程序），获取uWSGI的错误日志。
- 确保Python和uWSGI的路径在系统PATH中,或使用绝对路径。
权限问题：
- 确保运行服务的账户有足够的权限访问项目文件和日志文件。
- 可以在服务属性中修改登录账户,例如使用LocalSystem或指定具有权限的用户账户。
端口占用：
- 如果uWSGI监听的端口已被占用,服务将无法启动，使用netstat -ano命令检查端口占用情况，并修改uWSGI配置中的端口。