编辑“︁Django生产环境检查清单”︁（章节）

= Django生产环境检查清单 =

'''Django生产环境检查清单'''是一组关键配置和安全措施，用于确保Django应用程序在生产环境中高效、安全地运行。本清单涵盖部署前的必要步骤，帮助开发者避免常见问题，并优化性能。

== 介绍 ==
在生产环境中运行Django应用与开发环境有很大不同。生产环境需要更高的安全性、性能和稳定性。以下清单列出了部署前必须检查的项目，以确保应用符合生产标准。

== 检查清单 ==

=== 1. 关闭调试模式 ===
在开发环境中，`DEBUG = True` 会显示详细的错误信息，但在生产环境中必须关闭以避免泄露敏感信息。

<syntaxhighlight lang="python">
# settings.py
DEBUG = False  # 确保在生产环境中设置为 False
</syntaxhighlight>

=== 2. 设置正确的 `ALLOWED_HOSTS` ===
`ALLOWED_HOSTS` 是一个安全措施，用于限制Django应用可以服务的主机名。

<syntaxhighlight lang="python">
# settings.py
ALLOWED_HOSTS = ['yourdomain.com', 'www.yourdomain.com']  # 替换为实际域名
</syntaxhighlight>

=== 3. 配置静态文件和媒体文件 ===
在生产环境中，静态文件（CSS、JS）和媒体文件（用户上传的文件）应由Web服务器（如Nginx或Apache）直接处理，而不是Django。

<syntaxhighlight lang="python">
# settings.py
STATIC_URL = '/static/'
STATIC_ROOT = '/var/www/yourdomain.com/static/'  # 静态文件收集路径

MEDIA_URL = '/media/'
MEDIA_ROOT = '/var/www/yourdomain.com/media/'  # 媒体文件存储路径
</syntaxhighlight>

运行以下命令收集静态文件：
<syntaxhighlight lang="bash">
python manage.py collectstatic
</syntaxhighlight>

=== 4. 使用生产级数据库 ===
开发中常用的SQLite不适合生产环境。推荐使用PostgreSQL或MySQL。

<syntaxhighlight lang="python">
# settings.py
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'mydatabase',
        'USER': 'mydatabaseuser',
        'PASSWORD': 'mypassword',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}
</syntaxhighlight>

=== 5. 启用HTTPS ===
使用HTTPS加密数据传输，防止中间人攻击。可以通过Let's Encrypt免费获取SSL证书。

配置Django强制HTTPS：
<syntaxhighlight lang="python">
# settings.py
SECURE_SSL_REDIRECT = True  # 强制所有请求使用HTTPS
SESSION_COOKIE_SECURE = True  # 仅通过HTTPS传输会话Cookie
CSRF_COOKIE_SECURE = True  # 仅通过HTTPS传输CSRF Cookie
</syntaxhighlight>

=== 6. 配置安全的密钥 ===
`SECRET_KEY` 是Django的核心安全组件，必须保密且不应硬编码在代码中。推荐使用环境变量存储。

<syntaxhighlight lang="python">
# settings.py
import os
SECRET_KEY = os.environ.get('DJANGO_SECRET_KEY')
</syntaxhighlight>

=== 7. 设置适当的日志记录 ===
生产环境需要详细的日志记录以排查问题。

<syntaxhighlight lang="python">
# settings.py
LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'file': {
            'level': 'ERROR',
            'class': 'logging.FileHandler',
            'filename': '/var/log/django/error.log',
        },
    },
    'loggers': {
        'django': {
            'handlers': ['file'],
            'level': 'ERROR',
            'propagate': True,
        },
    },
}
</syntaxhighlight>

=== 8. 使用WSGI服务器 ===
开发服务器（`runserver`）不适合生产环境。推荐使用Gunicorn或uWSGI。

安装Gunicorn：
<syntaxhighlight lang="bash">
pip install gunicorn
</syntaxhighlight>

启动Gunicorn：
<syntaxhighlight lang="bash">
gunicorn --workers 3 myproject.wsgi:application
</syntaxhighlight>

=== 9. 配置缓存 ===
缓存可以显著提高性能。推荐使用Redis或Memcached。

<syntaxhighlight lang="python">
# settings.py
CACHES = {
    'default': {
        'BACKEND': 'django.core.cache.backends.redis.RedisCache',
        'LOCATION': 'redis://127.0.0.1:6379',
    }
}
</syntaxhighlight>

=== 10. 定期备份数据库 ===
定期备份数据库以防止数据丢失。可以使用`pg_dump`（PostgreSQL）或`mysqldump`（MySQL）。

PostgreSQL备份示例：
<syntaxhighlight lang="bash">
pg_dump -U mydatabaseuser -h localhost mydatabase > backup.sql
</syntaxhighlight>

=== 11. 监控和性能优化 ===
使用工具如Django Debug Toolbar（仅开发环境）、Sentry（错误监控）和Prometheus（性能监控）来优化应用。

== 实际案例 ==
以下是一个真实的生产环境配置示例：

1. **场景**：一个电商网站需要处理高流量和用户数据。
2. **解决方案**：
   - 使用PostgreSQL作为数据库。
   - 配置Nginx作为反向代理和静态文件服务器。
   - 使用Redis缓存热门产品数据。
   - 通过Sentry监控错误。

== 总结 ==
本清单提供了Django应用部署到生产环境的关键步骤。遵循这些最佳实践可以确保应用的安全性、性能和稳定性。定期审查和更新配置以适应新的需求和安全威胁。

== 参见 ==
* [[Django安全指南]]
* [[Django性能优化]]
* [[Django部署指南]]

[[Category:后端框架]]
[[Category:Django]]
[[Category:Django最佳实践]]