从零到跑通，把你的第一个 Python 项目送上云服务器

你有没有遇见这样的情况买了台云服务器然后发现自己对它毫无概念。钱付了控制台里躺着一串公网 IP 和一串初始密码光标停在命令行窗口里不知道从哪下手。折腾了一整天从完全不懂到把 Python 项目跑起来回头看这条路的每一步其实都不难难的是没人把这些步骤串起来讲。这篇就是从零到跑通的完整链路买机器、远程连接、传文件、装环境一次讲完。云服务器到底是个什么东西简单说云服务器就是一台插着固定公网 IP、放在机房、永不关机的电脑。它和你桌上的机器没有任何本质区别。CPU、内存、硬盘、网卡一样不少。差别在三件事上。你摸不到它。你的电脑在你眼前服务器在几百公里外的机架里你只能通过网络给它下指令。它有一个全世界都能访问的门牌号。公网 IP 是它在互联网上的唯一地址任何地方的人都能顺着这个地址找到它。你家宽带其实也有 IP但那是运营商动态分配的别人从外面找不到你。很多人第一次想开个网站给朋友看时发现别人访问不了你的电脑就是这个原因。想有一个稳定入口就得买这种带固定公网 IP 的机器。它不休息。机房有电力、有空调、有多线带宽机器常年开机待命。笔记本合上盖就睡服务器要对 24 小时在线的请求负责。这个认识先立住。后面所有操作都是从这台「摸不到的电脑」上长出来的。购买时你只需要想清楚四件事打开腾讯云控制台首页有两个入口轻量应用服务器和云服务器 CVM。新手选轻量应用服务器就好它是面向个人和中小项目的简化版价格便宜、该有的都有。云服务器 CVM 配置自由度更高等你有明确需求了再换不迟。下单时真正需要拿主意的只有四件事地域。选离你的目标用户近的节点。跑国内业务就选北京、上海、广州跟你在哪里没关系。这一点特别重要因为地域下单后改不了想换只能重买一台别图便宜选个冷门节点回头延迟全算在你头上。镜像。装在机器上的操作系统。Ubuntu、Debian、CentOS 任选跟你在旧电脑上重装系统时选 Windows 还是 Linux 是一个道理。新手统一选 Ubuntu 22.04 就行资料多、坑少本文所有命令都以它为基准。规格。新手从 2 核 2G 起步足够跑脚本、挂服务、学手艺都够用以后不够再升配。密码。设一个你能记住的初始密码这是接下来登录用的重要凭据。腾讯云也支持密钥登录但生成密钥是进系统之后的事购买这一步先设密码即可。买完之后控制台上会多出一个实例条目。界面上按钮一大堆新手最容易慌其实绝大多数点击都是在改这台机器的硬件配置真正进去操作靠的是后面讲的 SSH。控制台里唯一要特别留心的是安全组规则它是服务器前的一道防火墙决定哪些网络流量允许进来。新机器默认只放行 22 端口也就是只允许 SSH 远程连接其他口子全关着。遇到「连不上」先查安全组这条能省半天时间。怎么判断本地敲一条telnet 你的IP 22通了是机器的事不通就是安全组的事。SSH你进入这台机器的正门现在你手里有三样东西公网 IP、用户名ubuntu 或 root、密码。怎么用SSHSecure Shell是一条加密的远程登录通道你本地敲命令命令通过这条通道发到服务器上执行结果再传回来全程加密别人在中间截获了也只能看到一堆乱码。你可能会想腾讯云的网页控制台不是也能登录吗其实这两种入口用起来感觉差不多差别在细节上。网页控制台是云厂商在浏览器里给你模拟的一个终端偶尔会有延迟和断连。本地 SSH 才是正路你所有自动化操作、文件传输都建立在它上面而且更快更稳。Windows 用户直接打开 PowerShellMac 和 Linux 打开终端输入sshubuntu你的服务器IP回车后提示输入密码输入时屏幕上不会有任何显示这是正常的输完直接回车。看到类似这样的欢迎信息就说明你成功进入了服务器Welcome to Ubuntu 22.04 LTS从这一刻起你敲的每一条命令都运行在几千公里外的那台机器上。新手最常撞见两条报错先说结论。Connection refused连不上多半是安全组没放行 22 端口。Permission denied拒绝登录要么密码错了要么用户名对不上用户名里拼写错一个字母也会这样别问我怎么知道的。排查有一个基本顺序从「网络通不通」到「认证对不对」逐层确认网络层看安全组认证层看用户名和密码这个顺序覆盖了九成登录失败。密码登录能用但不该长期用。原因很现实你的公网 IP 全世界可见自动扫描工具天天在猜各种用户名和密码组合密码简单点的机器几个小时就可能被爆破。解决方式是用密钥登录它像一把配对的钥匙和锁私钥留在你本地公钥放到服务器上。服务器验证时不是比密码而是验证你是否持有那把私钥没有私钥的人猜一万年也进不来。配置分两步。第一步在本地生成一对钥匙Windows 的 PowerShell 直接执行ssh-keygen-ted25519一路回车即可会生成一对文件默认在~/.ssh/目录下id_ed25519.pub是公钥id_ed25519是私钥。私钥不要发给任何人。第二步把公钥放到服务器上最省事的方式如下注意替换成你的 IPssh-copy-id ubuntu你的服务器IP它会把本地公钥自动追加到服务器上完成后你再ssh登录就不需要输密码了。密钥登录测试通过后就该把密码登录彻底关掉编辑服务器上的 SSH 配置sudonano/etc/ssh/sshd_config找到PasswordAuthentication这一行改成no保存退出重启服务sudosystemctl restart sshd这一步做完密码爆破这条路就断了只留密钥这一把钥匙。到这里你已经能自由进出这台机器了。把项目文件搬上服务器你写好的 Python 脚本在本地电脑里服务器是一台全新的机器怎么把代码弄过去服务器不是网盘没有图形界面让你拖拽你能用的通道就是之前那一条 SSH。scp 正好是走这条通道的「文件版 SSH」语法几乎就是 cp 的远程版区别只在多了一个目标地址。scp本地文件路径 ubuntu服务器IP:目标目录例如把main.py传到家目录scpmain.py ubuntu你的IP:~/~是当前用户的家目录等价于/home/ubuntu/。如果是整个项目文件夹就不一样了scp 直接复制目录效率很低。标准做法是先用 tar 打包把一个目录变成一个文件。tar 本身不带压缩只是把目录打包成单一文件加-z参数才会用 gzip 压缩两个参数配合是传项目前的标准动作tar-czf项目名.tar.gz 项目目录更常用的是带排除参数把.git、日志、虚拟环境这些不需要带上服务器的目录跳过去体积能小一个量级tar-czf项目名.tar.gz--exclude.git--excludelogs项目目录然后一条 scp 传过去到服务器上解压项目文件就位了scp项目名.tar.gz ubuntu你的IP:~/tar-xzf项目名.tar.gz打包和传输本身不难难的是细节。说真的这三个坑我是一次性踩全过的。No such file or directory不一定是你文件不存在也可能是目标目录写错了scp 不会给你建不存在的目录先在本地确认路径再到服务器确认目标目录。另外如果代码是 Windows 上写的传上去后脚本可能报莫名其妙的错先怀疑换行符问题用 dos2unix 处理一下。其实把文件搞上服务器有三条路各有适用场景。scp 适合一次性的小项目git clone 适合长期维护、多台机器需要先把代码推到 GitHub 等托管平台服务器直接下载适合文件已在公网的情况比如 GitHub release但依赖服务器网络容易被墙。如果你在用 git 管理代码直接推到托管平台再在服务器上 clone 更省事但大部分小脚本场景tar scp 足够。环境隔离让项目真的跑起来文件传上去了你兴冲冲敲python main.py结果报错满屏。再进服务器一看Python 确实装着的为什么跑不起来因为服务器上的 Python 是系统共用的直接安装依赖会污染系统环境。更麻烦的是两个项目一个要 aiohttp 1.x、一个要 2.x装来装去互相覆盖某天系统组件悄悄坏掉你都不知道是谁干的。一个项目一个环境依赖互不干扰这是 Python 项目部署的第一原则。解决方案是虚拟环境为每个项目隔离出一套独立的 Python 环境。创建并激活python3-mvenv .venvsource.venv/bin/activate.venv是环境目录名激活后在提示符最前面会多一个(.venv)标记此时敲的python和pip都指向这个环境自身和系统互不影响。正规项目都会带一份requirements.txt列出全部依赖。有了它在服务器上安装就一行pipinstall-rrequirements.txt安装慢、卡住、超时是国内服务器装依赖的高频事故。原因不在你在默认的 Python 官方源 PyPI 架在境外服务器访问经常是龟速甚至断连。解决方式是换国内镜像源一条命令永久生效pip configsetglobal.index-url https://pypi.tuna.tsinghua.edu.cn/simple换成清华源之后同样的安装往往从十几分钟缩到几秒。腾讯云上也可以用https://mirrors.cloud.tencent.com/pypi/simple就近原则哪个快用哪个。注意换源要写在安装依赖之前。如果某个依赖的安装仍然失败先看报错尾部多数情况是网络超时重试或换另一个镜像即可很少是依赖本身的问题。启动前还有一件小事很多人栽在这。项目里如果带了部署脚本比如deploy.sh直接执行会报 Permission denied因为新上传的文件默认没有「可执行」权限chmodx deploy.shchmod是改文件权限的命令x表示加上可执行权限。另外需要执行系统级操作比如安装软件时命令开头加sudo它表示用管理员权限运行。一切就绪进入项目目录启动source.venv/bin/activate python main.py看到程序输出正常运行说明环境搭建成功。如果启动报错遵循一条原则先看日志再在网上搜报错原文多数报错的答案早就在那里了。回头看看这条链路从买机器到程序跑通一共五步买、连、传、装、跑每一步都解决一个问题。云服务器是永远在线、有公网 IP 的电脑控制台管硬件安全组管网络SSH 是进出这台机器的唯一正门密钥登录配好后记得关掉密码登录tar scp 是文件传输的标准组合拳排除目录参数能省大量时间venv 隔离依赖requirements.txt 一键安装国内服务器先换镜像源权限和路径是新手两大报错源chmod x 和 dos2unix 是两颗定心丸程序在终端里跑起来了但事情还没完。等会儿关掉 SSH 窗口它会直接消失跑挂了你也只能干瞪眼。下一篇解决的就是这件事怎么查程序的病怎么让它 7x24 不掉线。