将 Python Web 应用程序从 Windows 打包为适用于 Linux 的 `.deb` 安装包，涉及多个步骤，包括项目依赖项管理、构建 Debian 包结构以及打包工具的使用。以下是完整的流程说明： ### 项目准备 确保项目在 Linux 环境下可以正常运行，包括数据库连接、文件路径、依赖库等。由于 Windows 和 Linux 文件系统差异较大，建议在 Linux 或 WSL（Windows Subsystem for Linux）环境下进行打包操作。 创建一个用于构建 deb 包的目录结构，例如： ``` myapp/ ├── DEBIAN/ │ └── control ├── usr/ │ └── local/ │ └── myapp/ └── etc/ └── systemd/ └── system/ ``` 其中 `DEBIAN/control` 文件是必须的元数据描述文件，内容如下示例： ``` Package: myapp Version: 1.0.0 Section: base Priority: optional Architecture: all Depends: python3, python3-pip, nginx, gunicorn Maintainer: Your Name <your.email@example.com> Description: My Python Web Application This is a web application written in Python. ``` ### 构建依赖环境 将项目的依赖写入 `requirements.txt` 文件，并在目标 Linux 系统上安装这些依赖： ```bash pip freeze > requirements.txt ``` 使用 `pip install -r requirements.txt` 在目标系统或容器中安装依赖[^3]。 ### 使用 setuptools + stdeb 打包 Python 社区提供了便捷的打包方式。可以使用 `setuptools` 配合 `stdeb` 工具将项目打包为 `.deb` 文件。 安装 `stdeb`： ```bash pip install stdeb ``` 在项目根目录创建 `setup.py` 文件，内容如下： ```python from setuptools import setup setup( name='myapp', version='1.0.0', packages=['myapp'], include_package_data=True, install_requires=[ 'Flask>=2.0.0', # 其他依赖 ], entry_points={ 'console_scripts': [ 'start-myapp=myapp.run:main' ] }, ) ``` 执行打包命令： ```bash python setup.py --command-packages=stdeb.command bdist_deb ``` 该命令将在 `dist/` 目录下生成 `.deb` 安装包。 ### 使用 Docker 容器化部署（可选） 如果直接打包存在兼容性问题，也可以考虑先将应用容器化，再通过脚本部署到 Linux 系统中。Docker 可以帮助测试应用在 Linux 环境下的行为，并作为中间步骤验证是否可以正常运行[^3]。 ### 安装与调试 将生成的 `.deb` 文件复制到目标 Linux 系统并安装： ```bash sudo dpkg -i myapp-1.0.0.deb ``` 若依赖未满足，执行： ```bash sudo apt-get install -f ``` 启动服务后检查日志确认应用是否正常运行： ```bash journalctl -u myapp.service ``` ---