从 0 到 1:Python 项目部署到 Ubuntu 服务器完整指南
·
以下是一份可直接部署到 Ubuntu 服务器的项目部署教程,包含环境准备、依赖安装、服务配置与启动命令。
一、项目环境与初始化
假设你要部署的项目为一个 Python / Django / FastAPI / 爬虫类 项目。
选择阿里云 Ubuntu 22.04 LTS服务器,公网 IP:8.136.33.128。初始化操作:
- 登录阿里云 ECS 控制台,重置服务器密码,开放 SSH 端口(22)。
- 本地通过 PowerShell/CMD 连接服务器:


1. 登录服务器
ssh root@你的服务器IP

2. 更新系统并安装基础依赖
apt update
apt install -y python3 python3-pip python3-venv unzip nginx
3. 创建项目目录
mkdir -p /var/www/myproject
cd /var/www/myproject

二、项目上传与准备
如果你有项目本地文件,需要上传到服务器,可以直接用:
scp 本地路径 root@服务器IP:/var/www/myproject/

如果你项目是从 git 拉取:
git clone https://github.com/xxx/myproject.git .
三、创建 Python 虚拟环境(推荐)
python3 -m venv venv
source venv/bin/activate
进入虚拟环境后提示符会变为:
(venv) root@...:/var/www/myproject#
四、安装项目依赖
假设项目有 requirements.txt:
pip install -r requirements.txt
如果没有 requirements.txt,可直接安装主要库:
pip install django fastapi uvicorn gunicorn
五、项目配置与测试
1. 检查项目是否能运行
python main.py
或对于 Django:
python manage.py runserver 0.0.0.0:8000

2. 开放端口
在阿里云 / 腾讯云安全组中开放 8000 端口(协议 TCP)。
六、使用 Gunicorn + Nginx 部署(正式环境)
1. 编写 Gunicorn 配置
创建:/var/www/myproject/gunicorn_config.py
内容如下:
bind = "127.0.0.1:8000"
workers = 2
threads = 4
timeout = 60
chdir = "/var/www/myproject"
wsgi_app = "main:app" # 根据你的项目修改
accesslog = "/var/log/gunicorn/access.log"
errorlog = "/var/log/gunicorn/error.log"
2. 启动 Gunicorn
source venv/bin/activate
gunicorn -c gunicorn_config.py main:app
3. Nginx 配置
创建:/etc/nginx/sites-available/myproject
内容:
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;
}
}
启用站点:
ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled/
systemctl restart nginx
七、最终验证
访问:
http://你的服务器IP


即可看到项目已部署。
更多推荐



所有评论(0)