宝塔面板部署Django/Flask需手动配置:一、尝试安装第三方Python项目管理插件;二、通过网站功能上传代码并手动建虚拟环境、装依赖;三、用Nginx反向代理对接Gunicorn/uWSGI;四、用Supervisor守护进程。

如果您希望在宝塔面板中部署 Django 或 Flask 应用,但发现缺少专用的 Python 项目管理功能,则需要手动安装或配置 Python 项目管理器。宝塔官方未内置独立的“Python项目管理器”插件,但可通过多种方式实现对 Python Web 应用的托管与管理。以下是具体操作方法:
一、通过宝塔应用商店安装 Python 项目管理插件(如存在)
部分第三方开发者曾发布兼容宝塔的 Python 管理插件,需确认当前版本宝塔是否支持。该方式依赖插件可用性及兼容性,适用于希望图形化操作的用户。
1、登录宝塔面板,在左侧菜单栏点击软件商店。
2、在搜索框中输入Python或Django,查看是否有名为“Python项目管理器”“Django管理器”或类似名称的插件。
立即学习“Python免费学习笔记(深入)”;
3、若插件显示为已适配当前面板版本且状态为“未安装”,点击安装按钮执行部署。
4、安装完成后,在左侧菜单栏检查是否新增Python项目管理入口。
二、使用宝塔网站功能 + 手动配置 Python 运行环境
此方法不依赖插件,直接利用宝塔的网站创建流程配合 Shell 命令完成部署,适用于所有宝塔版本,且对 Django 和 Flask 均有效。
1、在宝塔面板中点击网站 → 添加站点,填写域名并提交。
2、进入该站点设置页,点击PHP版本选项卡,将运行环境切换为纯静态或禁用PHP(避免干扰)。
3、点击根目录路径右侧的打开按钮,进入文件管理器,上传您的 Django 或 Flask 项目源码至该目录。
4、返回宝塔首页,点击终端,执行以下命令安装 Python 依赖:
5、进入项目目录:cd /www/wwwroot/your-domain.com。
6、创建虚拟环境:python3 -m venv venv。
7、激活虚拟环境:source venv/bin/activate。
8、安装项目依赖:pip install -r requirements.txt(确保项目根目录下存在该文件)。
三、配置 Nginx 反向代理对接 Gunicorn 或 uWSGI
宝塔默认使用 Nginx 提供 HTTP 服务,需将其请求转发至 Python 应用服务器(如 Gunicorn 或 uWSGI),这是部署 Django/Flask 的核心步骤。
1、在终端中安装 Gunicorn:pip install gunicorn(Django 推荐)或安装 uWSGI:pip install uwsgi(Flask 兼容性更广)。
2、测试启动应用:例如 Django 项目执行gunicorn myproject.wsgi:application --bind 127.0.0.1:8000 --workers 2。
3、返回站点设置页,点击反向代理 → 添加反向代理。
4、目标URL填写http://127.0.0.1:8000(需与上一步绑定端口一致)。
5、保存后,重启 Nginx 使配置生效:bt restart nginx。
四、使用 Supervisor 管理 Python 进程
为防止 Gunicorn/uWSGI 进程意外退出导致服务中断,需借助进程管理工具实现自动拉起和日志追踪。
1、在终端中安装 Supervisor:pip install supervisor。
2、生成默认配置:echo_supervisord_conf > /etc/supervisord.conf。
3、编辑配置文件:vi /etc/supervisord.conf,在末尾添加程序段:
4、写入如下内容(以 Django 为例):[program:django_app]。
5、指定命令路径:command=/www/wwwroot/your-domain.com/venv/bin/gunicorn myproject.wsgi:application --bind 127.0.0.1:8000。
6、设置工作目录:directory=/www/wwwroot/your-domain.com。
7、启用自动启动:autostart=true 和 autorestart=true。
8、启动 Supervisor:supervisord -c /etc/supervisord.conf,再加载配置:supervisorctl -c /etc/supervisord.conf reload。

















