当前位置：首页 > news >正文

12 - Python项目打包部署

news 2026/7/8 4:56:36

Python 项目打包部署的流程会因项目类型（如命令行工具、Web应用等）和部署环境（本地服务器、云服务器等）而有所不同。下面详细讲讲通用的打包部署步骤，涵盖常见的打包方式和部署场景。

项目结构整理

确保项目结构清晰，包含必要的文件和目录，例如：

myproject/ ├── project/ # 项目代码包 │ ├── __init__.py │ ├── main.py │ └── ... ├── tests/ # 测试代码包 │ ├── __init__.py │ └── ... ├── requirements.txt # 项目依赖文件 ├── setup.py # 项目打包配置文件（可选） └── README.md # 项目说明文件

导出项目依赖

使用uv pip freeze命令将项目依赖的第三方库及其版本信息保存到requirements.txt文件中：

uv pip freeze > requirements.txt

选择打包方式

使用`setuptools`打包（适用于库或命令行工具）

setuptools是 Python 中常用的打包工具，可将项目打包成 Python 包进行分发。创建setup.py文件，示例如下：

from setuptools import setup, find_packages setup( name='myproject', version='1.0.0', packages=find_packages(), install_requires=open('requirements.txt').read().splitlines(), entry_points={ 'console_scripts': [ 'project_name = project.main:main', # 命令行入口 ], }, )

然后使用以下命令进行打包：

python setup.py sdist bdist_wheel

这会在dist目录下生成源码包（.tar.gz）和二进制包（.whl）。

使用`PyInstaller`打包（适用于独立可执行文件）

PyInstaller可以将 Python 项目打包成独立的可执行文件，无需安装 Python 环境即可运行。安装PyInstaller：

pip install pyinstaller

然后使用以下命令进行打包：

pyinstaller --onefile project/main.py

这会在dist目录下生成一个独立的可执行文件。

代码共享同步

将本地开发代码上传到服务器上，这里现在有很多的方式，如。

本地将代码传到git或者gitee 上，在服务器上再从git或者gitee上拉下来代码。
使用ftp、xftp工具将文件上传到服务器，例如使用winscp。

选择部署环境

服务器环境准备

在服务器上安装操作系统如Windows Server、Centos、Ubuntu等。
安装合适的Python 版本以及其他所需的第三方应用系统。
安装项目系统所需的依赖。
安装项目。

本地服务器部署

如果是 Web 应用，可使用专业的WSGI服务器系统（如Gunicorn、uWSGI）进行部署。以Gunicorn为例，安装并启动应用：

pip install gunicorn # 假设 app 是 Flask 或 Django 应用实例 gunicorn -w 4 -b 0.0.0.0:8000 project.main:app

云服务器部署

常见的云服务提供商有阿里云、腾讯云、AWS等。部署步骤如下：

创建云服务器实例：选择合适的操作系统（如Ubuntu、CentOS）和配置。
连接服务器：使用SSH工具（如PuTTY、OpenSSH）连接到服务器。
上传项目文件：可以使用scp命令或FTP、XFTP工具将项目文件上传到服务器。

安装依赖：在服务器上安装 Python 和项目依赖：

sudo apt-get update sudo apt-get install python3 python3-pip pip install -r requirements.txt

启动应用：根据项目类型选择合适的方式启动应用，如使用Gunicorn启动 Web 应用。

`Docker`容器化部署

Docker可以将项目及其依赖打包成一个独立的容器，实现跨环境的一致性部署。步骤如下：

安装Docker：根据操作系统选择合适的安装方式。
创建Dockerfile：在项目根目录下创建Dockerfile，示例如下：

# 使用基础镜像 FROM python:3.9 # 设置工作目录 WORKDIR /app # 复制项目文件 COPY . . # 安装项目依赖 RUN pip install -r requirements.txt # 暴露端口 EXPOSE 8000 # 启动应用 CMD ["gunicorn", "-w", "4", "-b", "0.0.0.0:8000", "project.main:app"]

构建Docker镜像：在项目根目录下执行以下命令：
```
docker build -t project_name .
```
运行Docker容器：
```
docker run -p 8000:8000 project_name
```

配置服务管理

为了确保应用在服务器重启后自动启动，可以使用系统服务管理工具（如systemd）来管理应用。以Gunicorn为例，创建一个systemd服务文件（如/etc/systemd/system/project_name.service）：

[Unit] Description=Project Name Gunicorn Server After=network.target [Service] User=your_username Group=your_groupname WorkingDirectory=/path/to/your/project ExecStart=/path/to/your/venv/bin/gunicorn -w 4 -b 0.0.0.0:8000 project.main:app Restart=always [Install] WantedBy=multi-user.target

然后使用以下命令启动并设置开机自启：

sudo systemctl start project_name sudo systemctl enable project_name

配置反向代理（可选）

如果是 Web 应用，可以使用Nginx或Apache作为反向代理服务器，将请求转发给应用服务器，提高性能和安全性。以Nginx为例，编辑配置文件（如/etc/nginx/sites-available/default）：

server { listen 80; server_name your_domain_or_ip; location / { proxy_pass http://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：