Python项目快速部署到Linux服务器基础教程-优快云博客

本文链接：https://blog.youkuaiyun.com/logic1001/article/details/149193175

Python项目快速部署到Linux服务器基础教程

Linux系统因其稳定性、安全性和性能优化，成为Python项目部署的首选平台。无论是使用flask构建Web应用、FastAPI创建微服务，还是利用Pandas开发数据分析系统，在Linux上部署都能获得最高的运行效率。更重要的是，Linux的开源特性和强大的命令行工具使得部署流程高度自动化，可重复性强。本文将详细介绍如何从零开始快速部署Python项目到Linux服务器。

一、环境准备与基础配置

1.1 操作系统选择与服务器连接

推荐使用Ubuntu LTS或CentOS等主流Linux发行版
通过SSH连接服务器：
```
ssh username@your_server_ip
```

1.2 系统更新与基础工具安装

sudo apt update && sudo apt upgrade -y  # Ubuntu
sudo yum update -y && sudo yum upgrade # CentOS
sudo apt install git curl wget tmux vim -y

1.3 Python环境安装

大多数Linux发行版预装Python，但建议安装最新版本并配置虚拟环境：

sudo apt install python3-pip python3-venv -y
python3 -m venv /opt/myproject-env
source /opt/myproject-env/bin/activate

二、项目部署核心步骤

2.1 代码传输到服务器

方案1：Git直接克隆

git clone https://github.com/yourusername/yourproject.git
cd yourproject

方案2：SCP传输

scp -r /local/path username@server_ip:/remote/path

2.2 安装项目依赖

pip install -r requirements.txt

关键提示：对于生产环境，建议固定依赖版本：

pip freeze > requirements.txt

2.3 配置环境变量

推荐使用.env文件管理配置：

# 创建.env文件
touch .env
echo "DATABASE_URL=postgres://user:pass@localhost/dbname" >> .env
echo "SECRET_KEY=your_secret_key" >> .env

2.4 配置数据库（以PostgreSQL为例）

sudo apt install postgresql postgresql-contrib -y
sudo -u postgres psql
CREATE DATABASE mydb;
CREATE USER myuser WITH PASSWORD 'mypass';
GRANT ALL PRIVILEGES ON DATABASE mydb TO myuser;

三、运行与优化配置

3.1 选择应用服务器

选项1：Gunicorn（推荐）

pip install gunicorn
gunicorn -w 4 myproject.wsgi:application

选项2：uWSGI

pip install uwsgi
uwsgi --http :8000 --module myproject.wsgi

3.2 配置Nginx反向代理

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

创建配置文件：

sudo nano /etc/nginx/sites-available/myproject

添加配置内容：

server {
    listen 80;
    server_name yourdomain.com;

    location /static/ {
        alias /path/to/project/staticfiles/;
    }

    location / {
        include proxy_params;
        proxy_pass http://localhost:8000;
    }
}

生效配置：

sudo ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled
sudo nginx -t && sudo systemctl reload nginx

四、生产环境最佳实践

4.1 进程守护与管理

systemd服务配置

sudo nano /etc/systemd/system/myproject.service
[Unit]
Description=My Python Project
After=network.target

[Service]
User=ubuntu
Group=www-data
WorkingDirectory=/opt/myproject
Environment="PATH=/opt/myproject-env/bin"
ExecStart=/opt/myproject-env/bin/gunicorn --access-logfile - --workers 3 --bind unix:/tmp/myproject.sock myproject.wsgi:application

[Install]
WantedBy=multi-user.target

启动服务：

sudo systemctl start myproject
sudo systemctl enable myproject

4.2 HTTPS安全配置

使用Let’s Encrypt免费证书：

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d yourdomain.com

4.3 自动化部署脚本

创建部署脚本deploy.sh：

#!/bin/bash
# 拉取最新代码
git pull origin main

# 激活虚拟环境
source /opt/myproject-env/bin/activate

# 安装依赖
pip install -r requirements.txt

# 执行数据库迁移
python manage.py migrate

# 收集静态文件
python manage.py collectstatic --noinput

# 重启服务
sudo systemctl restart myproject

五、监控与维护策略

5.1 日志管理与分析

# 实时查看日志
journalctl -u myproject -f

# 配置日志轮转
sudo nano /etc/logrotate.d/myproject

添加：

/opt/myproject/logs/*.log {
    weekly
    missingok
    rotate 12
    compress
    delaycompress
    notifempty
    create 0640 ubuntu www-data
}

5.2 性能监控与调优

# 安装监控工具
sudo apt install htop glances -y

# 查看资源使用
glances
htop

# 分析慢查询（使用Django Debug Toolbar或Sentry）

5.3 备份策略

# 数据库备份脚本
pg_dump mydb | gzip > /backups/mydb_$(date +%F).sql.gz

# 项目全量备份
tar -zcvf /backups/project_$(date +%F).tar.gz /opt/myproject

六、进阶技巧与优化

6.1 Docker容器化部署

# Dockerfile 示例
FROM python:3.9-slim

RUN apt-get update \
    && apt-get -y install libpq-dev gcc \
    && pip install psycopg2

WORKDIR /app
COPY . .
RUN pip install -r requirements.txt

CMD ["gunicorn", "myproject.wsgi", "--bind", "0.0.0.0:8000"]

构建与运行：

docker build -t my-python-app .
docker run -d -p 8000:8000 my-python-app

6.2 使用Redis缓存提升性能

sudo apt install redis-server -y
sudo systemctl start redis

在Django中配置：

CACHES = {
    "default": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/1",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        }
    }
}

6.3 Celery任务队列实现异步处理

安装：

pip install celery redis

创建celery.py配置文件：

from __future__ import absolute_import
import os
from celery import Celery

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
app = Celery('myproject')
app.config_from_object('django.conf:settings', namespace='CELERY')
app.autodiscover_tasks()