火山引擎云服务器怎么部署Python项目？-人工智能-PHP中文网

在火山引擎云服务器上部署python项目需完成环境配置、代码上传、依赖安装、服务启动与反向代理设置五个关键环节：先创建ubuntu 22.04或centos 7.9实例并开放22/80/443端口；再ssh登录执行系统更新及python3、pip、nginx等工具安装；接着用scp或git上传代码并创建venv虚拟环境；然后依requirements.txt安装依赖，配置gunicorn+uvicorn托管asgi服务；最后通过nginx反向代理指向本地8000端口，并用certbot申请ssl证书实现https自动跳转。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

火山引擎云服务器怎么部署python项目？

在火山引擎云服务器上部署Python项目，需完成环境配置、代码上传、依赖安装、服务启动与反向代理设置五个关键环节，缺一不可。

准备云服务器并配置基础环境

登录火山引擎控制台，创建一台Ubuntu 22.04 LTS或CentOS 7.9的ECS实例，确保安全组已放行22（SSH）、80（HTTP）、443（HTTPS）端口。实例创建后，用SSH连接：【务必使用root或具备sudo权限的用户登录】

执行以下命令更新系统并安装必要工具：

apt update && apt upgrade -y && apt install python3-pip python3-venv nginx curl wget git -y（Ubuntu）
或
yum update -y && yum install epel-release -y && yum install python3-pip python3-devel nginx curl wget git -y（CentOS）

验证Python版本：python3 --version，确认输出为3.8及以上。若低于该版本，需手动编译安装或使用pyenv管理——否则后续FastAPI或VeADK等现代框架将无法运行。

上传项目代码并创建虚拟环境

方法一：使用scp直接上传
本地终端执行：scp -r ./my_project user@your-server-ip:/home/user/

方法二：通过git克隆（推荐用于持续迭代项目）
在服务器/home/user目录下执行：git clone https://github.com/yourname/my_project.git

进入项目根目录，创建隔离的Python环境：
python3 -m venv venv
source venv/bin/activate

这一步必须做。不使用虚拟环境会导致系统Python包被污染，后续多个项目共存时极易因依赖冲突导致服务崩溃。

安装依赖并校验入口文件

检查项目中是否存在requirements.txt，若有，执行：
pip install -r requirements.txt

若项目使用VeADK-Python，需额外安装扩展：
pip install veadk-python[extensions]

若使用uv替代pip（速度更快、依赖更干净）：
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.cargo/env
uv pip install -r requirements.txt

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

下载

【关键检查】确认项目主程序文件（如main.py、app.py或server.py）中包含可执行的ASGI或WSGI入口，例如：
if __name__ == "__main__":
uvicorn.run("app:app", host="0.0.0.0:8000", reload=False)

配置Gunicorn + Uvicorn托管服务

对于FastAPI或Starlette类项目，不建议直接用Uvicorn裸跑。应使用Gunicorn作为进程管理器，Uvicorn作为工作进程：

第一步：安装Gunicorn
pip install gunicorn

第二步：在项目根目录创建gunicorn.conf.py，写入：

bind = "127.0.0.1:8000"
bind_ssl_certificate = ""
workers = 4
worker_class = "uvicorn.workers.UvicornWorker"
preload = True
timeout = 120
keepalive = 5

第三步：测试启动
gunicorn -c gunicorn.conf.py app:app

若返回“Booting worker with pid”且无报错，说明服务已在本地8000端口就绪。此时用curl http://127.0.0.1:8000测试应返回预期响应。

配置NGINX反向代理并启用HTTPS

编辑/etc/nginx/sites-available/myproject：
upstream myproject {
server 127.0.0.1:8000;
}

server {
  listen 80;
  server_name your-domain.com;
  location / {
    proxy_pass http://myproject;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

启用站点：
ln -sf /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled/
nginx -t && systemctl restart nginx

最后申请SSL证书：
apt install certbot python3-certbot-nginx -y（Ubuntu）
certbot --nginx -d your-domain.com

证书申请成功后，NGINX会自动重写配置启用HTTPS，访问http://your-domain.com将自动跳转至https。