Django Demo

这是一个使用 uv 包管理工具创建的 Django 4.2.24 项目，支持 uwsgi 和 Docker Compose 部署，支持宿主机 Nginx 反向代理和 HTTPS。

项目结构

django-demo/
├── demo/                           # Django 项目目录
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py                 # 项目设置（支持环境变量）
│   ├── urls.py
│   └── wsgi.py
├── .venv/                          # 虚拟环境（uv 管理）
├── static/                         # 静态文件目录
├── media/                          # 媒体文件目录
├── manage.py                       # Django 管理脚本
├── uwsgi.ini                       # uWSGI 配置文件
├── Dockerfile                      # Docker 镜像构建文件
├── docker-compose.yml              # Docker Compose 配置
├── entrypoint.sh                   # Docker 容器启动脚本
├── nginx-host.conf                 # 宿主机 Nginx 配置（支持 HTTPS）
├── nginx-docker.conf.example       # Docker 容器内 Nginx 配置示例
├── generate-self-signed-cert.sh    # 自签名证书生成脚本
├── SSL-SETUP.md                    # SSL/HTTPS 配置详细指南
├── Makefile                        # 快捷命令
├── .env.example                    # 环境变量示例
├── pyproject.toml                  # 项目依赖配置
└── uv.lock                         # 依赖锁定文件

本地开发

前提条件

Python 3.13+
uv 包管理工具

安装依赖

uv sync

运行开发服务器

uv run python manage.py runserver

访问 http://127.0.0.1:8000

数据库迁移

uv run python manage.py makemigrations
uv run python manage.py migrate

创建超级用户

uv run python manage.py createsuperuser

uWSGI 部署

本地测试 uWSGI

uv run uwsgi --ini uwsgi.ini

Docker Compose 部署

构建并启动服务

# 使用 Makefile 快捷命令
make docker-up

# 或使用 docker-compose 命令
docker-compose up -d --build

查看服务状态

docker-compose ps

查看日志

# 查看所有服务日志
docker-compose logs -f

# 查看 web 服务日志
docker-compose logs -f web

# 查看数据库日志
docker-compose logs -f db

执行数据库迁移

# 使用 Makefile
make docker-migrate

# 或使用 docker-compose
docker-compose exec web uv run python manage.py migrate

创建超级用户

make docker-createsuperuser
# 或
docker-compose exec web uv run python manage.py createsuperuser

收集静态文件

make docker-collectstatic
# 或
docker-compose exec web uv run python manage.py collectstatic --noinput

停止服务

make docker-down
# 或
docker-compose down

停止并删除数据卷

docker-compose down -v

宿主机 Nginx + HTTPS 部署

本项目配置为使用宿主机的 Nginx 作为反向代理，支持 HTTPS。

快速开始

启动 Docker 容器

docker-compose up -d --build

容器会在 127.0.0.1:8000 监听 uwsgi 请求。

配置 SSL 证书

开发环境（自签名证书）：

chmod +x generate-self-signed-cert.sh
sudo ./generate-self-signed-cert.sh your-domain.com

生产环境（Let's Encrypt）：

sudo certbot --nginx -d your-domain.com -d www.your-domain.com

详细的 SSL 配置说明请查看 SSL-SETUP.md

配置 Nginx

# 复制配置文件
sudo cp nginx-host.conf /etc/nginx/sites-available/django-demo

# 编辑配置文件，修改域名和路径
sudo nano /etc/nginx/sites-available/django-demo

# 需要修改的内容：
# - server_name: 修改为你的域名
# - ssl_certificate: SSL 证书路径
# - ssl_certificate_key: SSL 私钥路径
# - location /static/: 修改为实际的静态文件路径
# - location /media/: 修改为实际的媒体文件路径

# 启用配置
sudo ln -s /etc/nginx/sites-available/django-demo /etc/nginx/sites-enabled/

# 测试配置
sudo nginx -t

# 重载 Nginx
sudo systemctl reload nginx

配置防火墙

# Ubuntu/Debian
sudo ufw allow 'Nginx Full'

# CentOS/RHEL
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

访问应用

HTTPS: https://your-domain.com
Django Admin: https://your-domain.com/admin

Nginx 配置要点

nginx-host.conf 配置文件包含：

✅ HTTP 到 HTTPS 自动重定向
✅ SSL/TLS 安全配置
✅ uwsgi 协议代理到 Django
✅ 静态文件和媒体文件服务
✅ 安全头配置（HSTS, X-Frame-Options 等）
✅ Gzip 压缩
✅ 缓存控制
✅ 日志记录

服务访问

仅使用 Docker（无 Nginx）：

Django 应用: http://localhost:8000

使用宿主机 Nginx（推荐）：

HTTP（自动重定向到 HTTPS）: http://your-domain.com
HTTPS: https://your-domain.com
Django Admin: https://your-domain.com/admin

环境变量配置

项目使用 .env 文件管理环境变量。首次使用需要配置环境变量：

1. 创建 .env 文件

项目已经包含了默认的 .env 文件，但建议根据实际情况修改：

# 查看当前配置
cat .env

# 或复制示例文件并修改
cp .env.example .env
nano .env

2. 可配置的环境变量

Django 配置：

DEBUG: 调试模式（True 或 False，生产环境必须为 False）
SECRET_KEY: Django 密钥（生产环境必须修改为随机字符串）
ALLOWED_HOSTS: 允许访问的主机列表（逗号分隔，如 localhost,127.0.0.1,example.com）
DATABASE_URL: 数据库连接 URL

PostgreSQL 配置：

POSTGRES_DB: 数据库名称（默认：demo）
POSTGRES_USER: 数据库用户（默认：demo）
POSTGRES_PASSWORD: 数据库密码（默认：demo123，生产环境必须修改）

3. 示例配置

.env 文件内容示例：

# 开发环境
DEBUG=True
SECRET_KEY=dev-secret-key-change-in-production
ALLOWED_HOSTS=localhost,127.0.0.1
DATABASE_URL=sqlite:///db.sqlite3

# 生产环境
# DEBUG=False
# SECRET_KEY=your-generated-secret-key-here
# ALLOWED_HOSTS=your-domain.com,www.your-domain.com
# DATABASE_URL=postgresql://demo:demo123@db:5432/demo
# POSTGRES_DB=demo
# POSTGRES_USER=demo
# POSTGRES_PASSWORD=your-secure-password-here

4. 生成安全的 SECRET_KEY

python -c 'from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())'

注意： .env 文件已被添加到 .gitignore，不会被提交到 Git 仓库，确保敏感信息安全。

生产环境注意事项

安全配置

修改 .env 文件
- 设置 DEBUG=False
- 生成并设置新的 SECRET_KEY（使用上面的生成命令）
- 配置正确的 ALLOWED_HOSTS
- 修改 PostgreSQL 数据库密码

Django HTTPS 安全设置（可选，编辑 demo/settings.py）

基本配置（DEBUG, SECRET_KEY, ALLOWED_HOSTS）已通过 .env 文件管理。

如需启用 HTTPS 强制重定向等安全特性，在 settings.py 末尾添加：

# HTTPS 安全设置（仅在启用 HTTPS 后使用）
SECURE_SSL_REDIRECT = True
SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True
SECURE_HSTS_SECONDS = 31536000
SECURE_HSTS_INCLUDE_SUBDOMAINS = True
SECURE_HSTS_PRELOAD = True

数据库
- 使用 PostgreSQL（已在 docker-compose.yml 中配置）
- 在 .env 中修改 POSTGRES_PASSWORD
- 定期备份数据库
SSL/HTTPS
- 使用 Let's Encrypt 免费证书（见 SSL-SETUP.md）
- 配置自动续期
- 启用 HSTS
日志和监控
- 配置日志轮转
- 设置错误监控（如 Sentry）
- 监控服务器资源使用
性能优化
- 启用 Nginx Gzip 压缩（已配置）
- 配置静态文件缓存（已配置）
- 使用 CDN 加速静态资源
- 优化数据库查询
防火墙
- 只开放必要端口（80, 443）
- 配置 fail2ban 防止暴力攻击
- 定期更新系统补丁

Makefile 快捷命令

make help              # 显示所有可用命令
make install           # 安装项目依赖
make run               # 运行开发服务器
make migrate           # 执行数据库迁移
make makemigrations    # 创建迁移文件
make createsuperuser   # 创建超级用户
make shell             # 进入 Django shell
make test              # 运行测试
make uwsgi             # 使用 uwsgi 启动
make docker-build      # 构建 Docker 镜像
make docker-up         # 启动服务
make docker-down       # 停止服务
make docker-logs       # 查看日志
make docker-migrate    # Docker 中执行迁移
make docker-shell      # 进入容器 shell

技术栈

语言: Python 3.13
框架: Django 4.2.24
WSGI 服务器: uWSGI 2.0.31
数据库: PostgreSQL 16
Web 服务器: Nginx（宿主机）
容器化: Docker & Docker Compose
包管理: uv 0.9.7
SSL: Let's Encrypt / 自签名证书
反向代理: Nginx (uwsgi 协议)

许可证

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
demo		demo
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
.python-version		.python-version
Dockerfile		Dockerfile
Makefile		Makefile
README.md		README.md
SSL-SETUP.md		SSL-SETUP.md
docker-compose.yml		docker-compose.yml
entrypoint.sh		entrypoint.sh
generate-self-signed-cert.sh		generate-self-signed-cert.sh
manage.py		manage.py
nginx-docker.conf.example		nginx-docker.conf.example
nginx-host.conf		nginx-host.conf
pyproject.toml		pyproject.toml
uv.lock		uv.lock
uwsgi.ini		uwsgi.ini

euynus/django-demo

Folders and files

Latest commit

History

Repository files navigation

Django Demo

项目结构

本地开发

前提条件

安装依赖

运行开发服务器

数据库迁移

创建超级用户

uWSGI 部署

本地测试 uWSGI

Docker Compose 部署

构建并启动服务

查看服务状态

查看日志

执行数据库迁移

创建超级用户

收集静态文件

停止服务

停止并删除数据卷

宿主机 Nginx + HTTPS 部署

快速开始

Nginx 配置要点

服务访问

环境变量配置

1. 创建 .env 文件

2. 可配置的环境变量

3. 示例配置

4. 生成安全的 SECRET_KEY

生产环境注意事项

安全配置

Makefile 快捷命令

技术栈

许可证

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages