把 Python 项目放到阿里云服务器上,代码能上传只是第一步。Python 版本、依赖、网络端口和进程管理都要配置好,否则很容易遇到“本地能跑,服务器访问不了”。下面以 Ubuntu 云服务器和 FastAPI 应用为例,说明从准备 ECS 到上线排错的常见做法。Flask、Django 等项目也可以参考这套部署思路。
选择适合项目的部署方式
小型网站、接口服务或个人项目,通常可以从 ECS 开始:自行安装 Python、配置 Web 服务,再管理应用进程。这样调整空间较大,也方便排查运行问题。若希望减少服务器环境配置,也可以考虑容器服务或应用托管产品,但需要熟悉相应的构建和发布流程。
本文使用 Nginx 接收公网请求,再把请求转发给 Gunicorn 启动的 FastAPI 应用。开始前,准备好阿里云账号、已创建的 ECS 实例、服务器公网 IP,以及一份能在本地运行的项目代码。
准备 ECS 和网络
创建实例并连接服务器
创建 ECS 时,根据项目需求选择地域、操作系统和配置。测试项目可以从较低配置起步;正式环境则要结合并发量、内存占用和磁盘空间评估。以下命令以常见的 Ubuntu LTS 系统为例。
通过 SSH 连接服务器后,先更新软件包索引:
sudo apt update
日常操作不建议直接使用 root 账号。可以用 SSH 密钥登录,再创建普通用户;需要管理权限时通过 sudo 执行命令。密钥也要妥善保管,避免随意复制到多人共用的设备上。
按需开放安全组端口
在阿里云 ECS 安全组中配置入方向规则。网站通过 Nginx 对外提供服务时,通常需要开放 80 端口;启用 HTTPS 后还要开放 443 端口。SSH 使用的 22 端口应尽量限制来源 IP,不要为了省事长期向所有地址开放。
应用端口(例如 8000)一般只供本机的 Nginx 转发,不需要直接暴露公网。还要记住,安全组和服务器系统防火墙是两层配置:安全组已放行,不代表系统防火墙也允许访问。
安装 Python 环境并上传代码
先安装 Python、虚拟环境工具和 Nginx:
sudo apt install python3 python3-venv python3-pip nginx
进入项目目录后创建虚拟环境,再安装项目依赖:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
虚拟环境可以把项目依赖与系统 Python 分开,减少升级依赖时影响其他程序的风险。开发阶段应固定依赖版本,并将 requirements.txt 纳入版本管理。数据库密码和云服务密钥不要写进代码仓库;可以在服务器配置环境变量,或使用权限受限的配置文件。
代码可以通过 Git 克隆,也可以使用 SFTP 等安全方式上传。部署时只保留运行需要的代码和配置,开发环境文件、缓存目录以及虚拟环境目录通常不必提交到仓库。
启动 FastAPI 应用并本机验证
假设项目目录中有 main.py,内容如下:
from fastapi import FastAPI
app = FastAPI()
@app.get(“/”)
def home():
return {“message”: “Hello from Alibaba Cloud”}
安装 FastAPI 和 Gunicorn 相关依赖后,先在服务器本机启动应用:
gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 127.0.0.1:8000 main:app
其中,main:app 表示从 main.py 中加载名为 app 的应用对象。绑定到 127.0.0.1 后,应用只接受本机连接,不会直接通过公网开放 8000 端口。运行后,在服务器执行 curl http://127.0.0.1:8000;如果能收到 JSON 响应,再继续配置 Nginx。
配置 Nginx 和应用进程
为 Nginx 创建站点配置,把外部请求转发到本机的 8000 端口。核心配置可以写成这样:
server {
listen 80;
server_name 你的域名或公网IP;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
保存后先检查配置语法,再重新加载 Nginx:
sudo nginx -t
sudo systemctl reload nginx
Gunicorn 如果只在终端里运行,退出 SSH 会话或进程意外结束后,应用可能随之停止。正式使用时,可以用 systemd 管理进程,设置开机启动和自动重启,并通过日志排查问题。服务配置中要填写项目目录、虚拟环境里的 Gunicorn 路径和运行用户,应用通常不需要以 root 身份运行。
假设服务名称为 myapp,可以用 systemctl start myapp 启动服务,用 systemctl enable myapp 设置开机启动,再用 systemctl status myapp 查看状态。要实时查看日志,可执行 journalctl -u myapp -f。更新代码后,按项目需要重启服务,并从公网地址重新验证。
公网无法访问时,按请求链路排查
如果应用在服务器本机访问正常,但浏览器打开公网 IP 时无法连接,先确认请求卡在哪一层。执行 curl http://127.0.0.1:8000,检查应用进程是否正常;再用 nginx -t 检查配置,并查看 Nginx 状态和错误日志;之后确认阿里云安全组是否放行 80 端口,最后检查系统防火墙和域名解析。
公网 IP 能打开、域名却不行时,检查域名解析是否指向当前服务器公网 IP,以及 Nginx 的 server_name 是否匹配。页面返回 502 时,常见原因包括 Gunicorn 未运行、监听端口或地址不一致,或者 Nginx 无法连接上游应用。逐层验证比反复修改配置更容易找到问题,也能避免把网络故障误当成 Python 环境故障。
上线后要做的维护
- 启用 HTTPS:绑定域名后配置 TLS 证书,避免登录信息和业务数据以明文传输。
- 安排备份:代码可以通过版本管理恢复;数据库和用户上传文件需要单独制定备份策略,并定期验证是否能够恢复。
- 查看资源和日志:留意 CPU、内存、磁盘使用情况及访问日志。磁盘写满或内存不足,都可能影响服务稳定性。
- 收紧访问权限:及时更新系统与依赖,关闭不需要的端口,并妥善管理 SSH 密钥、数据库账号和应用密钥。
阿里云 Python 部署涉及代码、应用进程、反向代理和网络访问几个环节。上线时先确认服务器本机能访问应用,再接入 Nginx,随后检查安全组和域名;服务运行稳定后,再配置进程守护和备份。每一步都留出验证,后续出问题时也更容易判断该从哪里查起。