在服务器上跑Python代码的核心流程是:通过SSH连接服务器、配置Python运行环境、上传脚本文件、在终端执行命令并配合进程管理工具保持程序持续运行。
服务器上跑python代码怎么配置环境
先搞清楚服务器是什么系统
绝大多数云服务器默认安装的是Linux系统,常见的有Ubuntu、CentOS、Debian,你要做的第一件事,就是通过SSH工具连上服务器,Windows用户可以用Xshell、PuTTY,macOS用户直接在终端里输入ssh 用户名@IP地址就能连上。
连上之后,先看一眼系统里有没有Python,输入python3 --version或者python --version,如果显示版本号,说明环境已经有了,很多国内的云服务器厂商,比如简米云、酷番云,默认镜像里都会预装Python 3,只是版本可能偏老。
用apt或yum安装Python
如果系统里没有Python,或者版本太低,就需要自己装,不同系统的包管理命令不一样:
- Ubuntu/Debian系:
sudo apt update && sudo apt install python3 python3-pip python3-venv - CentOS/RHEL系:
sudo yum install python3 python3-pip
装完之后,用python3 --version确认一下,行业共识认为,Python 3.8以上就能跑市面上绝大部分主流框架和脚本了,如果你的代码依赖了较新的语法特性,建议直接装Python 3.10或3.11。
虚拟环境必须建一个
直接在系统全局环境里装依赖包,时间一长就会乱套项目A需要Django 2.0,项目B需要Django 4.0,装来装去就把环境搞坏了,每个项目单独建一个虚拟环境是标准操作。
在项目目录下执行:
python3 -m venv venv source venv/bin/activate
激活之后,命令行前面会出现(venv)的提示符,这时候再用pip install装任何包,都只会装进这个项目的虚拟环境里,互不干扰。
linux服务器运行python脚本的上传与执行
把本地代码传到服务器,怎么传最快
写完的代码要传到服务器上,方法有很多,如果你的代码量不大,直接用scp命令最省事:
scp /本地路径/你的脚本.py 用户名@服务器IP:/远程目录/
如果你想用更直观的方式,可以装一个SFTP工具,比如WinSCP或者FileZilla,图形界面拖拽上传,对新手很友好,也不容易出错。
如果你的代码已经放在了Git仓库里,那在服务器上直接git clone就完事了,这也是多数团队最常用的方式,因为后续更新代码只需要git pull拉取最新版本。
直接运行python脚本的几种姿势
代码上传到了服务器,接下来就是执行,最简单的运行方式:
python3 你的脚本.py
如果你脚本里用到了第三方库,记得先激活虚拟环境再跑,否则会报ModuleNotFoundError,如果你想直接看脚本的输出结果,这个方式够用了,但如果你的脚本需要长期运行,比如爬虫程序、定时任务、Web服务,这样直接跑会有一个致命问题关掉SSH窗口,程序就没了。
日志输出重定向到文件
防止关掉终端就丢失程序状态的方法有两种思路,第一种是把日志写到文件里,方便排查问题:
nohup python3 你的脚本.py > 运行日志.log 2>&1 &
这个命令的意思是:后台运行脚本,把标准输出和错误输出都写到日志文件里,&让程序在后台跑,这样你关掉SSH窗口,程序照样运行。
服务器部署python项目怎么保持后台运行
nohup和systemd,谁更适合生产环境
很多第一次接触服务器的人,都会用nohup来挂后台进程,这种方式简单粗暴,对于临时跑个脚本、做个测试,完全够用,但它有个明显的短板:如果服务器重启了,进程不会自动拉起。
如果你部署的是一个正式的Web服务,或者一个需要7×24小时跑的业务脚本,业内专家建议用systemd来做进程守护,systemd是Linux系统的标准服务管理工具,它能做到:
- 开机自启,服务器重启后自动恢复运行
- 进程崩溃后自动重启
- 统一管理日志输出
创建一个systemd服务文件,路径在/etc/systemd/system/my-python-app.service大致如下:
[Unit] Description=My Python App After=network.target [Service] User=www-data WorkingDirectory=/var/www/myapp ExecStart=/var/www/myapp/venv/bin/python3 /var/www/myapp/main.py Restart=always RestartSec=3 [Install] WantedBy=multi-user.target
然后执行:
sudo systemctl daemon-reload sudo systemctl start my-python-app sudo systemctl enable my-python-app
这样一来,你的Python服务就变成了服务器上的一个标准服务,运行状态用systemctl status my-python-app随时查看,行业共识认为,production环境部署Python服务,systemd是最稳妥的基础方案。
用supervisor做进程管理行不行
除了systemd,老牌的supervisor也在很多服务器上服役,它的优势在于配置简单、跨发行版通用,同时提供一个Web管理界面,如果你对systemd的命令行不太熟悉,supervisor的配置方式可能会让你更舒服。
[program:myapp] command=/var/www/myapp/venv/bin/python3 /var/www/myapp/main.py directory=/var/www/myapp autostart=true autorestart=true stderr_logfile=/var/log/myapp-err.log stdout_logfile=/var/log/myapp-out.log
supervisor和systemd各有拥趸,没有绝对的优劣,如果你的服务器已经用了systemd,那就沿用systemd,少装一个组件就少一份维护负担。
服务器上运行Python代码最常踩的坑
端口号没开放导致的连接超时
写了一个Flask或FastAPI应用,启动成功了,但浏览器里访问不到,排查思路先看防火墙:云服务器的安全组规则里,是否放行了对应端口,简米云和酷番云的控制台都有安全组配置入口,默认只开放22、80、443等少数端口,你需要手动添加规则放行你的应用端口,比如8000或5000。
路径写死导致的找不到文件
本地开发时,代码里写的路径是/Users/你的名字/项目/data.txt,到了Linux服务器上,这个路径根本不存在,为了避免这种低级错误,建议在代码里使用相对路径,或者通过环境变量来指定文件路径,Python的os.path和pathlib模块能帮你做到跨平台兼容。
依赖包版本冲突
在本地开发环境跑得好好的,上了服务器就报错,多数情况是依赖包版本不一致,解决办法是,在本地项目里先执行pip freeze > requirements.txt,把当前环境的所有依赖包版本固定下来,上传到服务器后执行pip install -r requirements.txt,这样能最大程度保证两个环境的一致性。
中文乱码问题
Python脚本里如果有中文输出,在服务器终端显示乱码,通常是因为终端编码和系统语言环境不匹配,执行export LANG=en_US.UTF-8或者export LANG=C.UTF-8可以临时解决,更保险的方式是,写文件的时候显式指定encoding='utf-8'。
环境对比表
| 对比项 | 本地电脑 | 云服务器 |
|---|---|---|
| 系统环境 | Windows/macOS | 绝大多数为Linux |
| 路径格式 | 反斜杠或正斜杠 | 正斜杠 |
| 包管理 | pip/conda | pip/apt |
| 进程守护 | 无需关心 | systemd/supervisor |
| 网络访问 | localhost | 公网IP+安全组规则 |
python代码放服务器上跑常见的几个疑问
每次改代码都要重新上传吗
是的,代码改了就要把新版本同步到服务器,但如果用了Git,这个过程可以简化到一行命令,在服务器上执行git pull拉取最新代码,然后重启服务或者用supervisorctl restart重新加载即可,对于小项目,这比反复用FTP上传文件要高效得多。
服务器上跑Python会不会很耗资源
具体看你的代码复杂度,一个简单的数据处理脚本,512MB内存的轻量服务器完全跑得动,如果是训练机器学习模型或者处理海量数据,那就要上高配的独享服务器了,国内云厂商的轻量应用服务器价格,一年通常在几十到几百元之间,具体取决于配置,跑一般的小脚本和Web应用,2核4G的配置基本够用。
定时运行Python脚本怎么实现
Linux自带的crontab就是干这个的,比如每天凌晨两点执行一次爬虫脚本,在终端输入crontab -e编辑定时任务,添加一行:
0 2 cd /你的项目目录 && /你的虚拟环境路径/bin/python3 你的脚本.py >> 日志.log 2>&1
这样服务器就会自动定时执行脚本,不用你手动去盯。
服务器上跑Python代码,关键是先把运行环境理顺、把进程守护做好、把日志路径打通,这三件事搞定了,后面就能安安心心写业务逻辑,不用为基础设施操心。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/803342.html


