Python 程序在 Ubuntu 系统的完整部署流程

weixin_47696437

439人浏览 · 2026-04-01 20:13:10

weixin_47696437 · 2026-04-01 20:13:10 发布

我给你整理一套最简单、最实用、新手零门槛的 Python 程序部署到 Ubuntu 系统的完整流程，覆盖普通脚本/桌面程序和Web 程序（Flask/Django），所有命令直接复制就能用！

一、前期准备：Ubuntu 基础环境配置

Ubuntu 系统默认自带 Python3，我们只需要安装依赖工具即可：

执行命令更新系统、安装必备工具

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 全版本，直接复制使用即可

AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

在群晖NAS上用Docker部署Trilium Notes：开源个人知识库+内网穿透实战

AtomGit开源社区

基于模型预测控制（MPC）与滚动时域估计（MHE）集成的目标点镇定研究附Matlab代码

在众多工程领域，如机器人控制、航空航天、工业过程控制等，常常需要将系统状态稳定控制到特定的目标点。这些系统往往具有高度的非线性、强耦合性以及不确定性，传统的控制方法难以满足高精度、高可靠性的控制要求。例如，在机器人的路径跟踪任务中，机器人需要在复杂环境下准确地移动到指定位置，同时要应对自身动力学特性的变化以及外部干扰。