把Django项目传到简米云服务器,核心流程是:准备服务器环境、上传项目代码、配置Python运行环境、用Gunicorn或uWSGI启动服务、再通过Nginx反向代理并处理静态文件。整个过程不复杂,但从零到能通过浏览器访问,中间有几个坑需要提前避开,这篇文章直接按操作顺序走,把每一步的命令和配置讲清楚,照着做就能跑通。
部署前需要准备什么
动手之前,先确认三件事:服务器规格、操作系统版本、以及部署方式,这三样决定了后面所有命令的写法。
服务器配置与地域选择
简米云轻量应用服务器和ECS都可选,个人项目或学习Demo用轻量服务器就够了,2核2G内存的配置在2026年依然是入门主流,地域选择上,国内地域(如华北2北京、华东1杭州)访问延迟低,但域名需要备案;香港地域免备案,延迟略高,适合测试环境,据简米云官方文档,网站解析到国内服务器必须完成ICP备案,这一点没有商量余地。
系统镜像选择
推荐选Ubuntu 22.04 LTS或CentOS 7.9,Ubuntu的命令更简洁,Python环境也更容易维护,如果你之前没怎么接触过Linux运维,Ubuntu会友好一些。
远程连接工具
Windows用户用Xshell或FinalShell,macOS用户直接打开终端,后续所有操作都在这个终端里完成,连接命令是:
ssh root@你的服务器公网IP
第一步:安装Python环境和数据库
Django项目运行依赖Python解释器、数据库(多数场景用MySQL或PostgreSQL)、以及项目所需的第三方包,这部分是整个部署过程的基础,不能跳过,也别用太老实的版本,行业共识指出:Python 3.10及以上版本才适合搭配新版Django使用。
安装Python与虚拟环境工具
Ubuntu系统自带Python 3,但版本可能偏老,先检查一下:
python3 --version
如果低于3.10,就需要手动安装,推荐用deadsnakes PPA源安装,命令如下:
sudo apt update sudo apt install software-properties-common sudo add-apt-repository ppa:deadsnakes/ppa sudo apt install python3.10 python3.10-venv python3.10-dev
装好之后,用python3.10命令验证,这个版本管理方式在2026年依然是社区常用做法,稳定且不会污染系统环境。
安装MySQL或直接用SQLite
如果是小项目或没有并发压力,Django自带的SQLite足够用,但如果你的项目要跑在真实流量下,MySQL是更稳妥的选择:
sudo apt install mysql-server sudo systemctl start mysql sudo mysql_secure_installation
创建数据库和用户时,注意utf8mb4字符集,避免中文乱码:
CREATE DATABASE yourdbname CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'youruser'@'localhost' IDENTIFIED BY 'yourpassword'; GRANT ALL PRIVILEGES ON yourdbname. TO 'youruser'@'localhost'; FLUSH PRIVILEGES;
第二步:上传项目代码到服务器
代码上传有几种常见方式:git拉取、scp命令、或使用宝塔面板等可视化工具,这里分场景讲。
通过Git拉取(推荐)
如果项目托管在GitHub或Gitee上,直接在服务器上执行:
git clone https://github.com/你的用户名/你的项目.git
国内服务器拉GitHub仓库速度不稳定,建议借助Gitee或直接在服务器上用wget下载压缩包。
scp命令直接推文件
本地项目目录下执行:
scp -r ./你的项目 root@服务器IP:/opt/
这种方式适合代码量不大、没有版本管理习惯的场景,路径统一放在/opt/或/srv/下,不放/home目录,避免权限问题。
宝塔面板可视化上传
宝塔适合不会用命令行的朋友,但它在Django部署上有一些隐藏问题,比如Python版本管理和虚拟环境配置不如原生灵活,后面出现问题排查也更麻烦。建议优先学习命令行方式,实在搞不定再上宝塔。
第三步:配置Python虚拟环境并安装依赖
代码到位后,进入项目目录,创建虚拟环境:
cd /opt/你的项目 python3.10 -m venv venv source venv/bin/activate
接下来安装依赖包,如果你有requirements.txt,直接执行:
pip install -r requirements.txt
没有这个文件的话,手动安装Django、Gunicorn和数据库驱动:
pip install django gunicorn mysqlclient
安装完成后,先测试一下Django本身是否能正常启动:
python manage.py runserver 0.0.0.0:8000
浏览器访问http://服务器IP:8000,能看到Django欢迎页就说明代码没问题,测试完记得用Ctrl+C停掉。
第四步:用Gunicorn运行Django项目
runserver是开发服务器,扛不住真实请求,生产环境需要Gunicorn这类WSGI服务器来处理并发请求。
Gunicorn的基本用法
在虚拟环境激活状态下,执行:
gunicorn 你的项目名.wsgi:application --bind 0.0.0.0:8000 --workers 3
你的项目名是Django项目包名,即包含settings.py的那个目录名称。--workers建议设置为CPU核心数的2倍加1,查询CPU核数用:
nproc
使用systemd管理Gunicorn进程
直接跑Gunicorn的问题在于:断开SSH连接后进程就没了,解决方案是用systemd把Gunicorn注册为系统服务。
新建服务文件:
sudo nano /etc/systemd/system/gunicorn.service
如下:
[Unit] Description=gunicorn daemon After=network.target [Service] User=root Group=root WorkingDirectory=/opt/你的项目 ExecStart=/opt/你的项目/venv/bin/gunicorn --workers 3 --bind unix:/tmp/gunicorn.sock 你的项目名.wsgi:application [Install] WantedBy=multi-user.target
启用并启动服务:
sudo systemctl enable gunicorn sudo systemctl start gunicorn sudo systemctl status gunicorn
看到active (running)就成功了,之后每次修改代码,只需重启:
sudo systemctl restart gunicorn
第五步:配置Nginx反向代理与静态文件
Gunicorn跑起来了,但你还不应该直接把8000端口暴露给用户,Nginx放在Gunicorn前面,负责处理静态文件、负载均衡以及HTTPS证书。
安装并启动Nginx
sudo apt install nginx sudo systemctl start nginx
浏览器输入服务器IP,看到Nginx欢迎页说明安装成功。
配置反向代理
创建站点配置:
sudo nano /etc/nginx/sites-available/你的项目
写入以下配置:
server {
listen 80;
server_name 你的域名或服务器IP;
location /static/ {
alias /opt/你的项目/staticfiles/;
}
location /media/ {
alias /opt/你的项目/media/;
}
location / {
proxy_pass http://unix:/tmp/gunicorn.sock;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
启用配置并测试:
sudo ln -s /etc/nginx/sites-available/你的项目 /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl reload nginx
收集静态文件
Django的静态文件需要先收集到一个统一目录,才能被Nginx直接读取,在项目目录下:
python manage.py collectstatic
同时在settings.py里确认:
STATIC_URL = '/static/' STATIC_ROOT = BASE_DIR / 'staticfiles'
这样浏览器访问静态资源时走Nginx,动态请求才交给Gunicorn,效率高很多。
第六步:绑定域名并配置HTTPS
没有域名的话,到此已经可以通过http://服务器IP访问了,但有域名需求的人,这一步是必选项。
域名解析
在简米云控制台的DNS解析中添加一条A记录,将域名指向服务器IP,TTL默认值即可,通常几分钟内生效。
免费HTTPS证书
用Certbot申请Let’s Encrypt免费证书:
sudo apt install certbot python3-certbot-nginx sudo certbot --nginx -d 你的域名
Certbot会自动修改Nginx配置并启用HTTPS,证书有效期90天,Certbot会自动续期,不用手动干预。
HTTP强制跳转HTTPS
Certbot默认配置已经包含了跳转规则,确认一下Nginx配置里有这段:
if ($scheme != "https") {
return 301 https://$host$request_uri;
}
常见部署问题排查
页面能打开但CSS样式全丢了
多半是静态文件路径或collectstatic没执行,检查Nginx配置里的location /static/路径是否和STATIC_ROOT一致。
500 Internal Server Error
查看Django日志和Gunicorn状态:
journalctl -u gunicorn -n 50
绝大多数情况是settings.py里DEBUG = True没改,或者数据库连接参数错了。生产环境必须把DEBUG设为False,同时配置ALLOWED_HOSTS包含你的域名。
简米云服务器部署Django项目访问不了
先确认安全组规则是否放行80和443端口,简米云轻量服务器和ECS都需要在控制台的安全组里添加入方向规则,这一步最容易忽略,放行后再试。
Django项目怎么部署到服务器Q&A
问:Django项目部署到简米云服务器一定要用Gunicorn吗
不一定,uWSGI和Gunicorn都是主流选择,Gunicorn配置更简单,纯Python实现,对Django兼容性最好;uWSGI性能上限更高,但配置项复杂,学习成本较大,多数中小项目选Gunicorn足够。
问:服务器是Windows系统能部署Django吗
简米云服务器的Windows镜像可以装Python并运行Django,但Nginx在Windows下的性能和稳定性都不如Linux,行业共识认为,生产环境部署Django项目服务器选Linux是更优选择,Windows桌面版的WSL不算。
问:数据库在本地,Django代码在服务器,怎么连
本地数据库迁移到服务器,推荐先用Django的dumpdata导出数据,再在服务器上loaddata导入,如果一定要连接远程数据库,需要在数据库服务端开启公网访问,并在简米云安全组中放行3306端口,同时用复杂密码和IP白名单做防护。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/799255.html


