使用宝塔面板搭建Python项目环境:从虚拟环境到反向代理配置

面板工具 2026-10-07

  Python项目部署是很多新手卡住的地方。写代码在本地跑得好好的,一到服务器上就各种ModuleNotFoundError、端口冲突、依赖版本不对。宝塔面板虽然主打PHP环境,但跑Python项目也完全能胜任,关键是把虚拟环境和反向代理这两件事弄明白。

  先说为什么要用虚拟环境。Python项目依赖各种第三方库,不同项目可能需要同一个库的不同版本。如果全装在系统Python里,版本冲突是必然的。虚拟环境就是给每个项目建一个独立的Python运行空间,互相隔离,各用各的依赖版本。

  宝塔里操作。先确认服务器装了Python,大部分Linux发行版自带Python3,终端敲python3 --version看版本。如果版本太老需要新版本,宝塔软件商店里可以直接装Python项目管理器插件,里面能选版本安装。或者手动编译安装。

  进终端,切到你的项目目录:

  cd /var/www/myproject

  创建虚拟环境:

  python3 -m venv venv

  这会在当前目录建一个venv文件夹,里面是独立的Python解释器和pip。激活虚拟环境:

  source venv/bin/activate

  激活后命令行前面会多一个(venv)标记,表示你现在在这个虚拟环境里操作。接下来装项目依赖:

  pip install -r requirements.txt

  如果项目没有requirements.txt,就手动pip install一个个装。装完后可以pip list看看都装了什么。测试项目能不能跑起来:

  python app.py

  或者gunicorn、uwsgi启动,取决于你的项目用什么方式。Flask和Django项目通常用gunicorn做WSGI服务器。装gunicorn:

  pip install gunicorn

  启动:

  gunicorn -w 4 -b 127.0.0.1:8000 app:app

  -w是worker进程数,一般设CPU核心数乘2加1。-b绑定地址和端口,绑定127.0.0.1表示只监听本机,外部不能直接访问,后面靠Nginx反代进来。app:app意思是模块名:Flask/Django实例名。

  这时候项目已经在8000端口跑起来了,但浏览器直接访问服务器IP加8000端口是打不开的,因为绑定的是127.0.0.1。需要用Nginx做反向代理。宝塔里建一个站点,域名填好,根目录可以指向项目目录。然后进站点设置,配置文件里加反代规则:

  location / {

  proxy_passhttp://127.0.0.1:8000;

  proxy_set_header Host $host;

  proxy_set_header X-Real-IP $remote_addr;

  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

  proxy_set_header X-Forwarded-Proto $scheme;

  }

  保存后Nginx重载配置。这时候浏览器访问域名就能看到Python项目了。

  但还有个问题,终端关了项目就停了。需要让项目在后台持续运行。几种方式。最简单用nohup:

  nohup gunicorn -w 4 -b 127.0.0.1:8000 app:app > /var/log/myproject.log 2>&1 &

  但这样不够稳,服务器重启就没了。正经做法用systemd管。建一个service文件:

  nano /etc/systemd/system/myproject.service

  写入:

  [Unit]

  Description=My Python Project

  After=network.target

  [Service]

  User=www-data

  Group=www-data

  WorkingDirectory=/var/www/myproject

  ExecStart=/var/www/myproject/venv/bin/gunicorn -w 4 -b 127.0.0.1:8000 app:app

  Restart=always

  [Install]

  WantedBy=multi-user.target

  然后:

  systemctl daemon-reload

  systemctl start myproject

  systemctl enable myproject

  这样项目会随系统启动自动运行,挂了也会自动重启。

  宝塔里还有个Python项目管理器插件,图形化操作,能创建项目、装依赖、设启动方式、看日志。对新手来说比纯命令行友好,但底层还是上面那套逻辑。用插件的好处是启动命令和端口都帮你配好了,坏处是定制性不如自己写systemd。

  Django项目部署额外注意。settings.py里ALLOWED_HOSTS要加你的域名,DEBUG要设False,STATIC_ROOT要设好,然后执行python manage.py collectstatic收集静态文件。Nginx里要单独配静态文件location,让Nginx直接处理CSS和JS,不走反代:

  location /static/ {

  alias /var/www/myproject/static/;

  }

  FastAPI项目用uvicorn代替gunicorn,或者gunicorn加uvicorn worker。思路一样,都是绑定本机端口然后Nginx反代。

  常见坑。虚拟环境没激活就装依赖,装到系统Python里了,项目跑的时候找不到。端口被占用,换个端口或者查谁在占。权限问题,项目目录属主不是运行用户,日志写不进去。SELinux开着导致端口被拦,关掉或者加策略。宝塔防火墙没放行端口,但反代场景不需要对外开端口,只开80和443就行。

  Python项目部署的核心就三件事:虚拟环境隔离依赖、WSGI服务器跑应用、Nginx反代接外网。这三件事弄明白,不管Flask、Django、FastAPI还是其他框架,套路都一样。

相关文章

发表评论