在阿里云服务器上运行 Python 程序,常见用途有网站接口、定时任务、数据处理脚本和内部工具。部署时需要处理好服务器配置、Python 环境、网络访问和进程管理。本文以 Ubuntu 云服务器为例,按 7 个步骤介绍基本流程,并用一个 Flask 小项目说明如何排查外网无法访问的问题。
一、确认服务器和网络条件
准备好阿里云账号、已创建的云服务器 ECS 和服务器公网 IP。实例可以使用 Ubuntu 或 Alibaba Cloud Linux 等常见 Linux 发行版;不同系统的包管理命令有所区别,本文使用 Ubuntu 命令示例。
先确认实例已分配公网 IP,再检查安全组入站规则。SSH 通常使用 22 端口;网站对外提供服务时,通常需要开放 80 或 443 端口。不要为了测试一次就开放所有端口,数据库和管理后台等服务也不应直接暴露到公网。
二、登录服务器并更新系统
在本地终端输入服务器公网 IP 和登录用户名。Ubuntu 镜像的初始用户名可能是 root 或 ubuntu,具体以创建实例时选择的镜像和控制台提示为准。
ssh 用户名@服务器公网IP
首次连接时,终端会要求确认主机指纹。确认信息无误后,可输入密码或使用已配置的 SSH 密钥登录。连接成功后更新系统软件包:
sudo apt update
sudo apt upgrade -y
部署应用时尽量使用权限较小的普通用户,不要长期以 root 身份运行程序。也可以顺手查看磁盘空间、内存和系统版本,确认实例资源能满足应用的运行需求。
三、安装 Python 并创建虚拟环境
先检查系统是否已有 Python 3:
python3 --version
如果没有安装,可使用 Ubuntu 的包管理器安装 Python、pip 和虚拟环境组件:
sudo apt install -y python3 python3-pip python3-venv
项目依赖不要直接装进系统 Python。为应用单独创建虚拟环境,可以减少多个项目之间的依赖冲突:
mkdir -p ~/apps/demo
cd ~/apps/demo
python3 -m venv .venv
source .venv/bin/activate
激活后,命令行通常会显示 .venv 标识。在这个状态下安装的 Python 包会进入当前项目的环境。要退出虚拟环境,运行 deactivate。
四、上传项目并安装依赖
代码可以通过 Git 克隆,也可以用 SCP 从本地上传。正式项目建议使用版本库管理代码,并部署明确的版本,避免线上代码和本地代码不一致。
git clone 项目仓库地址 .
source .venv/bin/activate
pip install -r requirements.txt
如果只是验证部署流程,可以先写一个简单的 Flask 应用。在项目目录中创建 app.py:
from flask import Flask
app = Flask(__name__)
@app.route("/")
def index():
return "Hello from Python on ECS!"
if __name__ == "__main__":
app.run(host="0.0.0.0", port=8000)
安装 Flask 并启动应用:
pip install flask
python app.py
0.0.0.0 表示应用监听服务器的网络接口;如果只绑定本机地址,外部设备就无法直接连接。测试时可以临时在安全组中开放 8000 端口,再访问 http://公网IP:8000。验证完成后关闭这条临时规则。Flask 自带的开发服务器适合测试,不建议长期用来承载公网流量。
五、排查 Flask 接口无法从外网访问
例如,一个团队要部署查询内部任务状态的小接口,开发者把代码上传到 ~/apps/demo 并启动服务后,发现服务器本机能访问,外网却打不开。遇到这种情况,可以先在服务器上运行:
curl http://127.0.0.1:8000
如果命令能返回内容,说明应用已在本机响应;如果也访问失败,就先检查程序是否启动、日志里有没有报错,以及端口配置是否正确。
本机能访问而外网不能访问时,检查应用是否绑定了 0.0.0.0,再看阿里云安全组是否放行对应端口。服务器若启用了操作系统防火墙,也需要核对其规则。这个案例中,程序监听地址没有问题,原因是安全组未开放测试端口。添加临时入站规则后,外网访问恢复正常;验证结束后关闭该规则,后续改用 Nginx 提供 80/443 入口。
六、配置进程管理和访问入口
直接在终端运行 python app.py,SSH 会话断开或终端关闭后,程序可能停止。正式部署时,可以使用 systemd 管理应用进程,方便在后台运行、查看状态和按配置重启。
Web 应用通常由 Gunicorn 等 WSGI 服务器运行,再通过 Nginx 反向代理接收外部请求。生产环境可以让应用监听本机地址和内部端口,由 Nginx 对外提供 HTTP/HTTPS 服务。这样既能避免直接暴露应用进程,也方便配置域名、TLS 证书和访问日志。配置时要根据项目入口、运行用户和文件路径调整,并先在测试环境验证。
数据库密码、密钥等敏感信息不要写进源码,也不要提交到公开仓库。可以通过环境变量或合适的密钥管理方式提供,并限制相关配置文件的访问权限。
七、按症状检查常见问题
- 提示权限不足:检查当前用户是否有项目目录的读写权限;只有安装系统软件时才使用
sudo。 - 找不到依赖:确认已激活项目虚拟环境,再运行
pip install,并检查依赖文件是否包含所需包。 - 端口无法访问:按顺序检查应用监听地址、进程状态、安全组入站规则和系统防火墙。
- 重启服务器后程序停止:使用 systemd 等服务管理工具,并核对服务的工作目录和启动命令。
- 响应变慢或资源不足:查看 CPU、内存、磁盘使用情况和应用日志,再判断是优化程序还是调整实例规格,不要仅凭一次卡顿就扩容。
阿里云服务器部署 Python 时,环境、代码、网络和进程管理都要逐项检查。个人测试可以从虚拟环境和简单 Flask 应用开始;面向用户提供服务时,还要配置反向代理、HTTPS、日志、权限和备份。每次上线改动都保留验证步骤和回滚方案,后续排查会更有依据。