腾讯云服务器怎么执行python脚本

唐可
唐可
发布时间:2026-11-18| 3人浏览过
原创

全面介绍在腾讯云服务器上执行Python脚本的完整操作流程,涵盖远程连接、Python3与虚拟环境搭建、脚本上传、直接前台调试、nohup后台脱机挂起、tmux会话保护、Systemd系统级守护及Crontab定时调度的实战配置。

系统运维 Python实战 腾讯云 CVM / 轻量服务器 阅读时长约 8 分钟
在腾讯云服务器上执行 Python 脚本,核心流程分为四个标准阶段:首先通过 SSH 终端或腾讯云控制台登录服务器实例;接着核对并配置 Python 3 解释器与虚拟环境;随后将本地编写好的脚本与依赖文件传输至服务器指定工作目录;最后根据脚本任务性质(单次调试、常驻服务、定时任务)选择前台运行、nohup 后台挂起、tmux 会话管理或 Systemd 系统服务进行执行。本文将依次拆解各个环节的具体命令、操作规范与排错要点。
腾讯云服务器怎么执行python脚本
图 0:腾讯云服务器 Python 脚本从本地接入到多场景执行的整体架构链路

一、准备工作:登录腾讯云服务器

执行脚本前,首先需要建立与腾讯云服务器的远程通信。腾讯云通常提供两类常用的服务器实例:云服务器 CVM 与 轻量应用服务器 Lighthouse。两者在系统层面的登录交互基本一致。

1. 获取服务器连接信息

登录腾讯云控制台,进入对应实例的管理页面,记录以下关键信息:

  • 公网 IP 地址:用于远程连接的入口地址(例如 118.24.xxx.xxx)。
  • 系统用户名:Ubuntu 镜像默认用户为 ubuntu;CentOS / TencentOS 默认用户为 root 或 centos。
  • 登录凭证:创建实例时设置的密码或绑定的 SSH 密钥对(.pem 私钥文件)。

2. 建立远程连接

方式一:本地终端通过 SSH 连接(推荐)

打开本地 macOS / Linux 终端或 Windows 的 PowerShell,输入以下标准 SSH 连接命令:

Local Terminal
# 使用密码验证登录
ssh ubuntu@118.24.xxx.xxx

# 或使用 SSH 私钥文件登录(需要对私钥授予 400 权限)
chmod 400 ~/.ssh/tencent_key.pem
ssh -i ~/.ssh/tencent_key.pem ubuntu@118.24.xxx.xxx

方式二:使用腾讯云控制台 OrcaTerm / WebShell

如果不方便在本地使用终端,可以在腾讯云实例列表右侧点击“登录”按钮,选用“OrcaTerm”或“标准登录”,在网页浏览器中直接开启远程终端窗口。

二、环境检查与依赖配置

登录服务器后,第一步切勿直接运行业务代码,必须核实 Python 环境是否完整,并建立项目级的依赖隔离。

腾讯云服务器怎么执行python脚本
图 1:腾讯云服务器执行 Python 脚本的四个阶段标准作业流程

1. 检查系统 Python 3 版本

现代主流 Linux 发行版普遍预装了 Python 3。在服务器终端中输入:

Remote Server Shell
python3 --version

控制台将输出当前版本,例如 Python 3.10.12。如果系统提示 command not found,可通过系统包管理器安装:

# Ubuntu / Debian
sudo apt update && sudo apt install -y python3 python3-pip python3-venv

# CentOS / TencentOS
sudo yum install -y python3 python3-pip

2. 创建虚拟环境隔离依赖(强烈建议)

直接向系统的全局环境安装三方库容易破坏操作系统自带工具的正常运行,且容易引发版本冲突。推荐为每个项目创建独立的 venv 虚拟环境:

# 创建专门存放脚本的项目目录
sudo mkdir -p /data/scripts && sudo chown -R $USER:$USER /data/scripts
cd /data/scripts

# 创建名为 venv 的虚拟环境
python3 -m venv venv

# 激活虚拟环境
source venv/bin/activate

激活成功后,命令行提示符前方会出现 (venv) 标识。在虚拟环境中,可以直接使用 python 与 pip,它们会自动指向当前虚拟环境内的可执行文件。

加速依赖安装:配置腾讯云内网/国内 PyPI 镜像源

在云服务器内下载第三方库时,使用官方源速度可能较慢。可以使用腾讯云内网 PyPI 镜像源加速下载:

# 单次安装使用腾讯云镜像
pip install requests flask -i https://mirrors.tencent.com/pypi/simple/

# 或全局配置该镜像源
pip config set global.index-url https://mirrors.tencent.com/pypi/simple/

三、将 Python 脚本放置到服务器

脚本代码可以通过以下两种常见方式部署到云服务器:

1. 本地代码上传(SCP / SFTP)

在本地电脑的终端中,使用 scp 命令将本地写好的脚本和依赖清单直接传输至云服务器:

Local Terminal
# 将本地 app.py 与 requirements.txt 上传至腾讯云服务器 /data/scripts/ 目录
scp -i ~/.ssh/tencent_key.pem app.py requirements.txt ubuntu@118.24.xxx.xxx:/data/scripts/

2. 在服务器上直接编写脚本

若为测试或单文件脚本,也可直接在服务器终端中使用 nano 或 vim 新建文件:

Remote Server Shell
cd /data/scripts
nano app.py

输入测试代码并保存(在 nano 中按 Ctrl + O 回车保存,Ctrl + X 退出):

import time
import sys

print(f"Python 脚本启动成功,当前解释器路径: {sys.executable}")
counter = 1
while counter <= 5:
    print(f"正在执行批处理任务... 当前计数: {counter}")
    time.sleep(2)
    counter += 1
print("任务执行完毕。")

四、执行 Python 脚本的五种常用方式

在云服务器环境中,执行脚本不仅是敲入一行命令,更重要的是决定进程何时结束、断开 SSH 后是否继续工作,以及出现异常后是否自动恢复。下表梳理了不同场景的执行策略:

腾讯云服务器怎么执行python脚本
图 2:不同运行需求下的 Python 脚本执行模式对比与技术指标

方式一:直接前台执行(适用于开发与即时调试)

这是最基础的执行方式。激活虚拟环境后直接调用脚本:

# 激活虚拟环境后运行
python app.py

# 或使用绝对路径直接调用虚拟环境解释器(免激活)
/data/scripts/venv/bin/python /data/scripts/app.py

特点与限制:执行过程完全占用当前命令行终端,控制台会实时输出打印信息。一旦关闭 SSH 窗口或网络偶发中断,操作系统会向会话发送 SIGHUP 挂断信号,该 Python 进程将立即随之中断退出。因此,该方式仅适合几秒至几分钟的简短调试或单次任务。

方式二:使用 nohup 挂起后台运行(轻量长期任务)

nohup(no hang up)用于阻断终端关闭产生的挂断信号,配合末尾的 & 符号,可以让 Python 脚本脱离终端持续在后台运行。

# 规范的 nohup 执行命令(建议携带 -u 参数)
nohup /data/scripts/venv/bin/python -u /data/scripts/app.py > /data/scripts/app.log 2>&1 &

关键参数解析:

  • -u:强制 Python 标准输出和错误输出处于无缓冲状态,确保 print 语句产生的内容第一时间刷入日志文件,避免因系统缓冲造成日志迟迟不写盘。
  • > /data/scripts/app.log:将标准输出(stdout)重定向写入指定的日志文件中。
  • 2>&1:将标准错误输出(stderr,文件描述符 2)合并重定向到标准输出(文件描述符 1),实现错误堆栈一并记录。
  • &:将程序送入后台运行,终端会立即返回一个进程号(PID)并释放提示符。

方式三:使用 tmux 会话复用(适合多阶段交互与长时监控)

对于数据处理、模型训练等需要观察进度、随时可能恢复终端界面的场景,使用 tmux 是比 nohup 更友好的方式:

# 1. 安装并创建名为 pyjob 的会话窗口
sudo apt install -y tmux   # CentOS: sudo yum install -y tmux
tmux new -s pyjob

# 2. 在 tmux 窗口中正常执行 Python
source /data/scripts/venv/bin/activate
python /data/scripts/app.py

# 3. 离开会话(脱离):按 Ctrl + B,然后松开按 D 键
# 此时终端返回宿主环境,但 pyjob 窗口仍在后台完整保留运行

# 4. 后续随时重新接入会话
tmux attach -t pyjob

方式四:使用 Systemd 注册为系统级守护服务(生产推荐)

对于对外提供 API 的 Web 服务(如 FastAPI、Flask、Django)或关键队列消费脚本,应当使用 Linux 标准的 Systemd 进行监管。Systemd 能在脚本崩溃时自动重启,并在云服务器开机或故障重启后自动恢复拉起。

腾讯云服务器怎么执行python脚本
图 3:Systemd 守护进程运行机制、生命周期流转与运维命令

步骤 1:创建服务配置文件

sudo nano /etc/systemd/system/myapp.service

填入以下配置内容:

[Unit]
Description=My TencentCloud Python Worker
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/data/scripts
# 注意:使用虚拟环境的完整 Python 绝对路径
ExecStart=/data/scripts/venv/bin/python -u /data/scripts/app.py
Restart=always
RestartSec=5s
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

步骤 2:重载配置并启动服务

# 重新加载 Systemd 配置
sudo systemctl daemon-reload

# 启动服务
sudo systemctl start myapp

# 设置开机自启
sudo systemctl enable myapp

# 检查当前运行状态
sudo systemctl status myapp

当输出中出现绿色的 active (running) 时,说明服务已经成功在后台受控托管。查看实时输出可以使用:

journalctl -u myapp -f

方式五:使用 Crontab 定时调度(周期性执行)

如果脚本属于每天定时同步数据、夜间生成报表等周期性任务,可以使用系统内置的 crontab:

crontab -e

在编辑器末尾追加定时规则。例如每天凌晨 2 点整执行一次:

# 格式:分 时 日 月 周 解释器路径 脚本路径 >> 日志路径 2>&1
0 2 * * * /data/scripts/venv/bin/python /data/scripts/app.py >> /data/scripts/cron.log 2>&1
Crontab 执行避坑提示

Crontab 触发执行时使用的是极其精简的环境变量(PATH 往往仅包含 /usr/bin),因此必须全部使用绝对路径(包含 Python 解释器、脚本路径以及输出日志路径),避免因为相对路径无法寻址而静默失败。

五、运行状态监控与进程管理

将脚本转入后台运行后,需要掌握基本的监控与关闭方法:

1. 查看 Python 进程状态

# 查看当前正在运行的 Python 进程列表及 PID
ps -ef | grep python

# 示例返回:
# ubuntu  14852  1  0 10:20 ?  00:00:02 /data/scripts/venv/bin/python -u app.py

2. 动态监控资源占用

# 查看特定进程的 CPU 与内存消耗
top -p 14852

3. 查看实时执行日志

# 动态刷新追踪日志追加内容
tail -f -n 50 /data/scripts/app.log

4. 停止或重启后台进程

# 针对 nohup 启动的进程:发送正常退出信号
kill 14852

# 若进程无响应,使用强制退出
kill -9 14852

# 针对 Systemd 托管的服务:使用标准指令管理
sudo systemctl restart myapp
sudo systemctl stop myapp

六、常见问题与排错指引

在腾讯云环境部署与运行脚本时,初学者常会遇到以下几类典型报错,可对照下述树状图与清单进行针对性处理:

腾讯云服务器怎么执行python脚本
图 4:腾讯云环境 Python 脚本常见故障分类定位与处置方案

1. ModuleNotFoundError: No module named 'xxx'

成因:脚本在执行时调用的不是安装了依赖的 Python 解释器,或者在多环境机器上混淆了系统环境与项目环境。
处理方法:在脚本第一行加入 import sys; print(sys.executable),核对打印的解释器路径是否为虚拟环境路径 /data/scripts/venv/bin/python。执行时始终指定虚拟环境的绝对路径。

2. 脚本对外提供 Web 访问时无法打开

成因:这是腾讯云新手最容易遇到的问题,通常由两个层面的原因导致:

  • 代码绑定地址:代码中监听地址写成了 127.0.0.1,这仅允许服务器本机回环访问。应修改为 0.0.0.0(例如 FastAPI 中的 uvicorn.run(app, host="0.0.0.0", port=8000))。
  • 腾讯云安全组未放通:腾讯云默认的安全组策略可能拦截了自定义端口。需进入腾讯云控制台实例详情页的“安全组”标签,添加入站规则,放通相应端口(如 TCP: 8000)。

3. nohup 运行后查看日志文件为空

成因:由于 Python 在非交互式终端下会自动开启输出缓存区(I/O Buffer),在未累积满缓冲块前不会写入硬盘,因此 tail -f 看起来像没有运行一样。
处理方法:执行时务必追加 -u 命令行标志(即 python -u app.py),或在 Python 代码中对关键输出添加 print(..., flush=True)。

七、总结

在腾讯云服务器上执行 Python 脚本的技术路线可清晰划分为三个层级:

  • 测试排错层:直接在 SSH 终端前台调用 python app.py,所见即所得,快速定位代码逻辑与语法错误。
  • 轻量脱机层:使用 nohup python -u app.py & 或 tmux,以低成本方式实现断开远程连接后的持续运行。
  • 生产治理层:通过 Systemd 编写 .service 配置文件,交付具有开机启动、崩溃自愈、集中日志收集能力的工业级常驻服务;辅以 Crontab 管理周期性离线计算。

掌握这套方法,不仅能保障 Python 脚本在云端的平稳运行,也能在出现故障时迅速定位根因,构建稳健可靠的云端运行环境。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。