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证书、数据库连接等）。