如何在linux上跑django项目
如何在linux上跑django项目详细介绍
在 Linux 上运行 Django 项目通常需要以下步骤,包含环境准备、依赖安装、服务启动等操作,以下是详细流程:
一、环境准备
确保 Linux 系统已安装 Python 3(Django 3.2+ 要求 Python 3.6+)和 pip。
若未安装,可通过以下命令安装(以 Ubuntu 为例):
bash
updatepython3 python3-pip
二、创建 / 获取项目
1. 新建项目(若没有现有项目)
bash
pip3 django
django-admin startproject myproject
myproject
2. 已有项目(从 Git 拉取或本地复制)
bash
clone https://github.com/your-username/your-django-project.git
your-django-project
三、安装依赖
若项目有 requirements.txt 文件(记录依赖包),需安装依赖:
bash
pip3 requirements.txt
四、配置数据库
Django 默认使用 SQLite(文件型数据库,无需额外服务)。若项目使用 MySQL/PostgreSQL 等数据库,需额外配置:
1. 以 MySQL 为例(需先安装 MySQL 服务)
bash
pip3 mysqlclient
DATABASES
,
,
,
,
,
,
五、运行数据库迁移
同步模型到数据库:
bash
python3 manage.py makemigrationspython3 manage.py migrate
六、收集静态文件(生产环境)
若项目使用静态文件(CSS/JS/ 图片等),需将静态文件收集到统一目录(需在 settings.py 中配置 STATIC_ROOT):
bash
python3 manage.py collectstatic
七、启动服务
1. 开发环境(仅本地测试)
使用 Django 内置的开发服务器(仅用于调试,生产环境不建议):
bash
python3 manage.py runserver .0.0:8000
访问 http://服务器IP:8000 即可查看项目。
2. 生产环境(推荐方案:Gunicorn + Nginx)
生产环境需使用 WSGI 服务器(如 Gunicorn)配合反向代理(如 Nginx)。
步骤 1:安装 Gunicorn
bash
pip3 gunicorn
步骤 2:启动 Gunicorn
bash
/path/to/your-project
gunicorn myproject.wsgi:application .0.0:8000
步骤 3:配置 Nginx 反向代理
编辑 Nginx 配置文件(通常在 /etc/nginx/sites-available/your-project):
nginx
your-domain.com
/
http://127.0.0.1:8000
Host
X-Real-IP
/static/
/path/to/your-project/static
启用配置并重启 Nginx:
bash
/etc/nginx/sites-available/your-project /etc/nginx/sites-enabled/nginx
systemctl restart nginx
八、常见问题
- 端口被占用:使用
lsof -i:8000查看占用进程,用kill -9 进程ID终止。 - 权限问题:若提示无文件访问权限,用
chmod -R 755 /path/to/your-project调整目录权限。 - 静态文件未加载:检查
STATIC_ROOT配置是否正确,或重新运行collectstatic。
通过以上步骤,即可在 Linux 上成功运行 Django 项目。生产环境需注意安全性(如关闭 DEBUG=True、配置 HTTPS 等)。