Ubuntu中Python项目怎么部署

Ubuntu环境下Python项目部署全流程

1. 准备基础环境

在部署前需确保系统具备Python运行环境和必要的工具：

安装Python及pip：Ubuntu 20.04及以上版本默认安装Python 3.8+，通过以下命令确认及安装pip：
```
sudo apt update sudo apt install python3 python3-pip python3-venv -y 
```

验证安装：

python3 --version # 确认Python版本（如3.8.10） pip3 --version # 确认pip版本（如21.1.2）

2. 创建并激活虚拟环境

使用虚拟环境隔离项目依赖，避免全局污染：

创建虚拟环境：在项目根目录下执行：

python3 -m venv myenv # 创建名为myenv的虚拟环境

激活虚拟环境：

source myenv/bin/activate # 激活后终端提示符前缀变为(myenv)

3. 安装项目依赖

通过requirements.txt文件批量安装项目所需依赖（需提前在本地生成该文件）：

cd /path/to/your_project # 进入项目根目录 pip install -r requirements.txt # 安装所有依赖

4. 运行项目

根据项目类型选择运行方式：

普通Python脚本：直接执行入口文件：
```
python main.py 
```

Flask应用：若入口文件为app.py且包含app实例，可使用：

flask run --host=0.0.0.0 --port=5000 # 需设置FLASK_APP=app.py环境变量

Django应用：执行开发服务器：

python manage.py runserver 0.0.0.0:8000

5. 配置生产级WSGI服务器（可选但推荐）

开发服务器不适合生产环境，需使用Gunicorn（同步框架）或Uvicorn（异步框架）提升性能：

安装Gunicorn：
```
pip install gunicorn 
```

运行Gunicorn：以Flask应用为例（入口文件app.py，app为实例）：

gunicorn -w 4 -b 127.0.0.1:8000 app:app # 4个工作进程，绑定本地8000端口

安装Uvicorn（适用于FastAPI/Starlette）：

pip install uvicorn uvicorn app:app --host 0.0.0.0 --port 8000 # 异步框架推荐

6. 配置Nginx反向代理（可选但推荐）

Nginx作为前端服务器，负责处理静态文件、负载均衡及SSL终止，提升应用性能和安全性：

安装Nginx：
```
sudo apt install nginx -y 
```

配置Nginx：创建新的配置文件（如/etc/nginx/sites-available/myapp），内容如下：

server { listen 80; server_name your_domain_or_ip; # 替换为域名或IP location / { proxy_pass http://127.0.0.1:8000; # 转发到Gunicorn/Uvicorn端口 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; } location /static/ { # 处理静态文件（可选） alias /path/to/your/static/files/; } }

启用配置：

sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/ sudo nginx -t # 测试配置语法 sudo systemctl reload nginx # 重新加载Nginx

7. 设置开机自启（可选但推荐）

通过systemd服务确保应用在系统重启后自动启动：

创建systemd服务文件：

sudo nano /etc/systemd/system/myapp.service

添加以下内容（以Gunicorn为例）：

[Unit] Description=Gunicorn Server for My Python App After=network.target [Service] User=your_username # 替换为实际用户名 Group=www-data # 通常使用www-data组 WorkingDirectory=/path/to/your/project Environment="PATH=/path/to/your/project/myenv/bin" # 虚拟环境路径 ExecStart=/path/to/your/project/myenv/bin/gunicorn --workers 3 --bind unix:/run/myapp.sock -m eventlet myproject.wsgi # Django示例 Restart=always RestartSec=10 [Install] WantedBy=multi-user.target

启动并启用服务：

sudo systemctl daemon-reload sudo systemctl start myapp.service sudo systemctl enable myapp.service # 开机自启 sudo systemctl status myapp.service # 检查状态

8. 配置防火墙（可选）

若服务器启用了UFW防火墙，需允许HTTP（80端口）和应用端口（如8000）通过：

sudo ufw allow 80/tcp # 允许HTTP sudo ufw allow 8000/tcp # 允许应用端口 sudo ufw enable # 启用防火墙

9. 测试部署

本地测试：在浏览器访问http://your_domain_or_ip，确认应用是否正常响应。

查看日志：若出现问题，通过以下命令查看实时日志：

tail -f /var/log/nginx/error.log # Nginx错误日志 journalctl -u myapp.service -f # systemd服务日志

以上步骤覆盖了Ubuntu环境下Python项目部署的核心流程，可根据项目类型（如Flask/Django/FastAPI）和需求调整配置（如SSL证书、数据库连接等）。