将Python程序部署到Ubuntu系统的完整流程
作者：大明者省
本文介绍了将Python程序部署到Ubuntu系统的完整流程,包括前期准备、上传程序、配置运行环境以及后台持久运行,还提供了解决常见问题的方法,推荐使用FileZilla上传程序及systemd实现开机自启,需要的朋友可以参考下
我给你整理一套最简单、最实用、新手零门槛的 Python 程序部署到 Ubuntu 系统的完整流程，覆盖普通脚本/桌面程序和Web 程序（Flask/Django），所有命令直接复制就能用！
一、前期准备：Ubuntu 基础环境配置
Ubuntu 系统默认自带 Python3，我们只需要安装依赖工具即可：
- 登录 Ubuntu 服务器/电脑，打开终端
- 执行命令更新系统、安装必备工具
Bash # 更新软件源（必做） sudo apt update && sudo apt upgrade -y # 安装 Python3 依赖、虚拟环境工具（Ubuntu20.04/22.04/24.04通用） sudo apt install python3-pip python3-venv -y
- 验证安装成功
Bash python3 --version # 查看Python版本 pip3 --version # 查看pip版本
二、上传你的 Python 程序到 Ubuntu
推荐2 种新手最常用的上传方式：
方式1：图形化工具（最简单，首选）
- 电脑下载 FileZilla
- 连接 Ubuntu：
- 主机：Ubuntu 的 IP 地址
- 用户名：Ubuntu 登录用户名
- 密码：Ubuntu 登录密码
- 端口：22
- 直接把本地 Python 代码文件夹拖拽上传到 Ubuntu（推荐上传到 /home/用户名/ 目录下）
方式2：终端命令上传（无图形界面）
本地电脑终端执行（把文件传到 Ubuntu 的 home 目录）：
Bash # 格式：scp -r 本地程序文件夹路径 Ubuntu用户名@UbuntuIP:/home/用户名/ scp -r /本地/我的Python程序 ubuntu@192.168.1.100:/home/ubuntu/
三、核心步骤：配置程序运行环境
1. 进入程序目录
假设程序上传到了 /home/ubuntu/my_python_app
Bash cd my_python_app
2. 创建虚拟环境（必做！隔离依赖，避免冲突）
Bash # 创建虚拟环境（文件夹名env，可自定义） python3 -m venv env # 激活虚拟环境（激活后终端前缀会变成 (env)） source env/bin/activate
3. 安装程序依赖
如果你的项目有 requirements.txt（推荐）：
Bash # 安装所有依赖 pip install -r requirements.txt
手动生成依赖文件（本地开发时执行，上传到Ubuntu）：
Bash # 本地电脑终端执行，生成依赖清单 pip freeze > requirements.txt
四、运行 Python 程序
分两种场景：临时前台运行、后台持久运行（关闭终端不退出）
场景1：测试运行（前台，关闭终端程序就停）
Bash # 普通Python脚本 python3 main.py # Web程序（Flask/Django） python3 app.py # Flask python3 manage.py runserver 0.0.0.0:5000 # Django
测试无报错后，按 Ctrl + C 停止，再配置后台运行
场景2：后台持久运行（生产环境必用）
方案1：nohup（最简单，临时部署）
适合临时运行，命令执行后关闭终端也不会停：
Bash # 普通脚本 nohup python3 main.py > app.log 2>&1 & # Web程序（指定端口） nohup python3 app.py --host=0.0.0.0 --port=5000 > app.log 2>&1 &
- 日志会保存到 app.log 文件
- 查看运行状态：ps -ef | grep python3
- 停止程序：kill -9 进程ID
方案2：systemd（Ubuntu 自带，生产级！开机自启）
最稳定的方式，推荐长期部署使用：
- 创建服务配置文件
Bash sudo nano /etc/systemd/system/myapp.service
- 粘贴以下配置（修改路径为你自己的程序路径）
TOML [Unit] Description=My Python App After=network.target [Service] User=ubuntu WorkingDirectory=/home/ubuntu/my_python_app # 程序目录 ExecStart=/home/ubuntu/my_python_app/env/bin/python3 main.py # 虚拟环境+启动命令 Restart=always # 程序崩溃自动重启 [Install] WantedBy=multi-user.target
- 保存退出：按 Ctrl+O → 回车 → Ctrl+X
- 启动服务并设置开机自启
Bash # 刷新配置 sudo systemctl daemon-reload # 启动程序 sudo systemctl start myapp # 设置开机自启 sudo systemctl enable myapp # 查看程序运行状态 sudo systemctl status myapp
- 常用命令
Bash sudo systemctl stop myapp # 停止 sudo systemctl restart myapp # 重启
五、Web 程序额外配置（Flask/Django）
如果你的程序是 Web 服务，需要开放端口才能访问：
- 开启 Ubuntu 防火墙
Bash sudo ufw allow 5000 # 开放你的程序端口 sudo ufw enable sudo ufw status
- 本地浏览器访问：http://Ubuntu的IP:5000
六、常见问题排查
- 权限不足：命令前加 sudo
- 依赖安装失败：确认虚拟环境已激活（前缀有 (env)）
- 端口被占用：sudo lsof -i:5000 查看占用进程，kill 掉
- 程序报错：查看日志 cat app.log 或 journalctl -u myapp
总结
- 核心流程：配置环境 → 上传程序 → 虚拟环境装依赖 → 后台运行
- 新手首选：FileZilla 上传 + systemd 开机自启
- 所有命令适配 Ubuntu 全版本，直接复制使用即可
以上就是将Python程序部署到Ubuntu系统的完整流程的详细内容，更多关于Python程序在Ubuntu部署的资料请关注脚本之家其它相关文章！