uWSGI systemd集成教程开机自启与自动重启的5分钟配置指南【免费下载链接】uwsgi-docsOfficial uWSGI docs, examples, tutorials, tips and tricks项目地址: https://gitcode.com/gh_mirrors/uw/uwsgi-docsuWSGI 的 systemd 集成是 Linux 服务器上部署应用的关键一步。本文带你用 5 分钟完成 uWSGI 的 systemd 服务配置实现开机自启、崩溃自动重启并进阶掌握 socket 激活的按需启动技巧。为什么 uWSGI 要集成 systemduWSGI 官方定位为 systemd 的新式守护进程new-style daemon它能主动向 systemd 报告启动状态与就绪时间配合Typenotify实现精确的启动判定。集成后你能获得三大收益 ✅开机自启服务器重启后应用自动恢复服务无需人工干预自动重启进程崩溃或被 kill 后systemd 秒级拉起状态可视化systemctl status直接显示 uWSGI 报告的状态如管理的 vassal 数量第1步安装 uWSGI 并准备配置文件最简单的安装方式是 pip会自动构建带 Python 支持的二进制pip install uwsgi⚠️最关键的一条规则配置中千万不要使用daemonizeuWSGI 的 systemd 服务文档反复强调除非你完全清楚自己在做什么否则不要给 Emperor 或 master 加 daemonize。systemd 需要 uWSGI 在前台运行才能正确管理进程。应用配置参考 Emperor.rst 与 Configuration.rst一个最简的emperor.ini如下[uwsgi] emperor /etc/uwsgi/vassals uid www-data gid www-data如果希望每个应用以不同权限运行请去掉 emperor 配置里的uid和gid选项。第2步创建 uWSGI systemd 服务文件最快配置方法服务文件是 uWSGI systemd 配置的核心。将以下内容保存为/etc/systemd/system/emperor.uwsgi.service官方完整示例见 Systemd.rst[Unit] DescriptionuWSGI Emperor [Service] ExecStart/root/uwsgi/uwsgi --ini /etc/uwsgi/emperor.ini RuntimeDirectoryuwsgi Restartalways KillSignalSIGQUIT Typenotify StandardErrorsyslog NotifyAccessall [Install] WantedBymulti-user.target关键配置项速查表配置项作用为什么重要Typenotify等待 uWSGI 主动通知就绪确保服务真正启动后才算启动成功Restartalways无条件自动重启uWSGI 崩溃后自动恢复实现自动重启KillSignalSIGQUIT用 SIGQUIT 停止进程触发 uWSGI 的优雅停止流程NotifyAccessall允许所有子进程发送通知master 派生的 worker 都能报告状态RuntimeDirectoryuwsgi自动创建/run/uwsgi目录socket、pidfile 放这里的最佳实践需 systemd ≥ 211第3步启用开机自启并验证自动重启三条命令完成启动、自启与验证systemctl daemon-reload # 重新加载服务文件 systemctl enable emperor.uwsgi.service # 设置开机自启 systemctl start emperor.uwsgi.service # 立即启动用下面命令查看状态注意Status一行——这是 uWSGI 向 systemd 汇报的状态systemctl status emperor.uwsgi.service一切正常时你会看到类似输出官方示例见 Systemd.rstemperor.uwsgi.service - uWSGI Emperor Loaded: loaded (/etc/systemd/system/emperor.uwsgi.service) Active: active (running) since Tue, 17 May 2011 08:51:31 0200; 5s ago Main PID: 30567 (uwsgi) Status: The Emperor is governing 1 vassals停止 Emperor及其管辖的全部应用只需systemctl stop emperor.uwsgi.service进阶配置 Socket 激活实现按需启动自 uWSGI 0.9.8.3 起支持 socket 激活由 systemd 持有 socket有连接才拉起进程空闲时零开销。创建/etc/systemd/system/emperor.uwsgi.socketsocket 文件名必须与 service 文件名一致见 Systemd.rst[Unit] DescriptionSocket for uWSGI Emperor [Socket] ListenStream/tmp/uwsgid.sock [Install] WantedBysockets.target然后禁用服务、启用 socketsystemctl disable emperor.uwsgi.service systemctl enable emperor.uwsgi.socket两点注意socket 激活模式下uWSGI 配置里不需要再声明 socket实例会继承 systemd 的 socket若要直接对外提供 HTTP而非二进制 uwsgi 协议在 ini 配置中加protocol http多应用部署systemd 模板单元 每应用独立用户如果你的服务器上跑着多个应用可以用 systemd 模板单元让每个应用独立成服务、各自运行在独立用户下模板写法见 Systemd.rstuwsgi-app.socket%i会替换为应用名每个应用一个独立 socketuwsgi-app.serviceRestarton-failureTypenotify失败自动重启新增一个应用只需三步创建专用用户 →systemctl enable uwsgi-app你的应用名.service→ 放置对应 ini 配置文件。uWSGI systemd 配置常见坑位与最佳实践旧版 systemd 的 SIGQUIT 问题部分老版本如 Debian Jessie 的 systemd 215中 SIGQUIT 会搞坏服务状态改用KillSignalSIGTERM并给 uWSGI 加die-on-term选项见 Systemd.rst 的官方提示。日志别丢若移除StandardErrorsyslog务必在 uWSGI 配置里设置--logto否则日志会凭空消失。socket 放 /run/现代系统上/run/是 tmpfssocket 和 pidfile 应放这里RuntimeDirectoryuwsgi可让 systemd 自动建目录并在停止时清理。老版本可用 tmpfiles 配置示例见 Systemd.rst。别用 daemonize再强调一次前台运行交给 systemd。管理命令速记日常运维建议阅读 Management.rst 掌握信号与优雅重载。相关文档本文所有配置出处Systemd.rst通过 Emperor 集中管理应用Emperor.rstuWSGI 安装与编译Install.rst其他 init 系统对比Upstart.rst、Circus.rst项目总览与文档目录README.rst照着上面的三步走你的 uWSGI 现在已经是一个开机自启、崩溃自动重启的托管服务了。【免费下载链接】uwsgi-docsOfficial uWSGI docs, examples, tutorials, tips and tricks项目地址: https://gitcode.com/gh_mirrors/uw/uwsgi-docs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考