|
|
|
@ -13,331 +13,371 @@ import os
|
|
|
|
import sys
|
|
|
|
import sys
|
|
|
|
from pathlib import Path
|
|
|
|
from pathlib import Path
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 导入 Django 国际化工具：用于多语言文本翻译
|
|
|
|
from django.utils.translation import gettext_lazy as _
|
|
|
|
from django.utils.translation import gettext_lazy as _
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 自定义工具函数：将环境变量转为布尔值（处理配置的灵活性）
|
|
|
|
def env_to_bool(env, default):
|
|
|
|
def env_to_bool(env, default):
|
|
|
|
str_val = os.environ.get(env)
|
|
|
|
str_val = os.environ.get(env) # 从环境变量获取值
|
|
|
|
|
|
|
|
# 若环境变量未设置则返回默认值，否则判断字符串是否为'True'
|
|
|
|
return default if str_val is None else str_val == 'True'
|
|
|
|
return default if str_val is None else str_val == 'True'
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Build paths inside the project like this: BASE_DIR / 'subdir'.
|
|
|
|
# 项目根目录：定位到 settings.py 所在目录的父目录（项目根路径）
|
|
|
|
BASE_DIR = Path(__file__).resolve().parent.parent
|
|
|
|
BASE_DIR = Path(__file__).resolve().parent.parent
|
|
|
|
|
|
|
|
|
|
|
|
# Quick-start development settings - unsuitable for production
|
|
|
|
# Quick-start development settings - unsuitable for production
|
|
|
|
# See https://docs.djangoproject.com/en/1.10/howto/deployment/checklist/
|
|
|
|
# See https://docs.djangoproject.com/en/1.10/howto/deployment/checklist/
|
|
|
|
|
|
|
|
|
|
|
|
# SECURITY WARNING: keep the secret key used in production secret!
|
|
|
|
# 安全密钥：用于加密会话、CSRF 令牌等敏感数据（生产环境需通过环境变量设置，避免硬编码）
|
|
|
|
SECRET_KEY = os.environ.get(
|
|
|
|
SECRET_KEY = os.environ.get(
|
|
|
|
'DJANGO_SECRET_KEY') or 'n9ceqv38)#&mwuat@(mjb_p%em$e8$qyr#fw9ot!=ba6lijx-6'
|
|
|
|
'DJANGO_SECRET_KEY') or 'n9ceqv38)#&mwuat@(mjb_p%em$e8$qyr#fw9ot!=ba6lijx-6'
|
|
|
|
# SECURITY WARNING: don't run with debug turned on in production!
|
|
|
|
# 调试模式：开发环境开启（便于调试），生产环境必须关闭（避免暴露敏感信息）
|
|
|
|
DEBUG = env_to_bool('DJANGO_DEBUG', True)
|
|
|
|
DEBUG = env_to_bool('DJANGO_DEBUG', True)
|
|
|
|
# DEBUG = False
|
|
|
|
# DEBUG = False # 生产环境手动关闭调试的示例
|
|
|
|
|
|
|
|
# 测试模式标识：判断是否正在执行测试命令（如 python manage.py test）
|
|
|
|
TESTING = len(sys.argv) > 1 and sys.argv[1] == 'test'
|
|
|
|
TESTING = len(sys.argv) > 1 and sys.argv[1] == 'test'
|
|
|
|
|
|
|
|
|
|
|
|
# ALLOWED_HOSTS = []
|
|
|
|
# 允许访问的主机：生产环境需指定具体域名，开发环境用'*'允许所有主机（存在安全风险，生产禁用）
|
|
|
|
|
|
|
|
# ALLOWED_HOSTS = [] # 生产环境初始空配置（需补充具体域名）
|
|
|
|
ALLOWED_HOSTS = ['*', '127.0.0.1', 'example.com']
|
|
|
|
ALLOWED_HOSTS = ['*', '127.0.0.1', 'example.com']
|
|
|
|
# django 4.0新增配置
|
|
|
|
# Django 4.0+ 新增配置：信任的 CSRF 来源（避免跨域 CSRF 验证失败，生产环境需指定真实域名）
|
|
|
|
CSRF_TRUSTED_ORIGINS = ['http://example.com']
|
|
|
|
CSRF_TRUSTED_ORIGINS = ['http://example.com']
|
|
|
|
# Application definition
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Application definition（已安装的应用：Django 内置应用 + 第三方应用 + 自定义应用）
|
|
|
|
INSTALLED_APPS = [
|
|
|
|
INSTALLED_APPS = [
|
|
|
|
# 'django.contrib.admin',
|
|
|
|
# Django 内置 Admin 应用：使用精简版配置（SimpleAdminConfig），减少不必要功能
|
|
|
|
|
|
|
|
# 'django.contrib.admin', # 完整版 Admin 配置（此处注释，使用精简版）
|
|
|
|
'django.contrib.admin.apps.SimpleAdminConfig',
|
|
|
|
'django.contrib.admin.apps.SimpleAdminConfig',
|
|
|
|
'django.contrib.auth',
|
|
|
|
'django.contrib.auth', # 认证与授权系统
|
|
|
|
'django.contrib.contenttypes',
|
|
|
|
'django.contrib.contenttypes', # 内容类型框架（关联模型与权限）
|
|
|
|
'django.contrib.sessions',
|
|
|
|
'django.contrib.sessions', # 会话管理（用户登录状态保持）
|
|
|
|
'django.contrib.messages',
|
|
|
|
'django.contrib.messages', # 消息提示系统（如登录成功提示）
|
|
|
|
'django.contrib.staticfiles',
|
|
|
|
'django.contrib.staticfiles', # 静态文件管理（CSS/JS/图片）
|
|
|
|
'django.contrib.sites',
|
|
|
|
'django.contrib.sites', # 多站点支持（用于 RSS、OAuth 等功能）
|
|
|
|
'django.contrib.sitemaps',
|
|
|
|
'django.contrib.sitemaps', # 站点地图生成（利于 SEO）
|
|
|
|
'mdeditor',
|
|
|
|
'mdeditor', # 第三方应用：Markdown 编辑器（用于文章编写）
|
|
|
|
'haystack',
|
|
|
|
'haystack', # 第三方应用：搜索框架（对接 Whoosh/Elasticsearch）
|
|
|
|
'blog',
|
|
|
|
'blog', # 自定义应用：博客核心功能（文章、分类等）
|
|
|
|
'accounts',
|
|
|
|
'accounts', # 自定义应用：用户账户管理（登录、注册等）
|
|
|
|
'comments',
|
|
|
|
'comments', # 自定义应用：评论功能
|
|
|
|
'oauth',
|
|
|
|
'oauth', # 自定义应用：第三方登录（如 GitHub、微博）
|
|
|
|
'servermanager',
|
|
|
|
'servermanager', # 自定义应用：服务器管理（命令执行、日志记录）
|
|
|
|
'owntracks',
|
|
|
|
'owntracks', # 自定义应用：位置追踪（OwnTracks 数据管理）
|
|
|
|
'compressor',
|
|
|
|
'compressor', # 第三方应用：静态文件压缩（CSS/JS 压缩，提升加载速度）
|
|
|
|
'djangoblog'
|
|
|
|
'djangoblog' # 自定义应用：项目核心配置（如信号、插件）
|
|
|
|
]
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 中间件：处理请求/响应的钩子（按顺序执行，影响请求流程）
|
|
|
|
MIDDLEWARE = [
|
|
|
|
MIDDLEWARE = [
|
|
|
|
|
|
|
|
'django.middleware.security.SecurityMiddleware', # 安全相关中间件（HTTPS、XSS 防护等）
|
|
|
|
'django.middleware.security.SecurityMiddleware',
|
|
|
|
'django.contrib.sessions.middleware.SessionMiddleware', # 会话管理中间件
|
|
|
|
'django.contrib.sessions.middleware.SessionMiddleware',
|
|
|
|
'django.middleware.locale.LocaleMiddleware', # 国际化中间件（处理多语言切换）
|
|
|
|
'django.middleware.locale.LocaleMiddleware',
|
|
|
|
'django.middleware.gzip.GZipMiddleware', # GZip 压缩中间件（减少响应体积）
|
|
|
|
'django.middleware.gzip.GZipMiddleware',
|
|
|
|
# 'django.middleware.cache.UpdateCacheMiddleware', # 缓存更新中间件（注释：按需启用）
|
|
|
|
# 'django.middleware.cache.UpdateCacheMiddleware',
|
|
|
|
'django.middleware.common.CommonMiddleware', # 通用中间件（处理 URL 重定向、404 等）
|
|
|
|
'django.middleware.common.CommonMiddleware',
|
|
|
|
# 'django.middleware.cache.FetchFromCacheMiddleware', # 缓存读取中间件（注释：按需启用）
|
|
|
|
# 'django.middleware.cache.FetchFromCacheMiddleware',
|
|
|
|
'django.middleware.csrf.CsrfViewMiddleware', # CSRF 防护中间件（防止跨站请求伪造）
|
|
|
|
'django.middleware.csrf.CsrfViewMiddleware',
|
|
|
|
'django.contrib.auth.middleware.AuthenticationMiddleware', # 认证中间件（绑定用户到请求）
|
|
|
|
'django.contrib.auth.middleware.AuthenticationMiddleware',
|
|
|
|
'django.contrib.messages.middleware.MessageMiddleware', # 消息中间件（传递提示信息）
|
|
|
|
'django.contrib.messages.middleware.MessageMiddleware',
|
|
|
|
'django.middleware.clickjacking.XFrameOptionsMiddleware', # 点击劫持防护中间件
|
|
|
|
'django.middleware.clickjacking.XFrameOptionsMiddleware',
|
|
|
|
'django.middleware.http.ConditionalGetMiddleware', # 条件请求中间件（缓存协商，减少重复请求）
|
|
|
|
'django.middleware.http.ConditionalGetMiddleware',
|
|
|
|
'blog.middleware.OnlineMiddleware' # 自定义中间件：用户在线状态管理
|
|
|
|
'blog.middleware.OnlineMiddleware'
|
|
|
|
|
|
|
|
]
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 根 URL 配置：指定项目的主 URL 路由文件
|
|
|
|
ROOT_URLCONF = 'djangoblog.urls'
|
|
|
|
ROOT_URLCONF = 'djangoblog.urls'
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 模板配置：定义模板引擎、路径及上下文处理器
|
|
|
|
TEMPLATES = [
|
|
|
|
TEMPLATES = [
|
|
|
|
{
|
|
|
|
{
|
|
|
|
'BACKEND': 'django.template.backends.django.DjangoTemplates',
|
|
|
|
'BACKEND': 'django.template.backends.django.DjangoTemplates', # 使用 Django 内置模板引擎
|
|
|
|
'DIRS': [os.path.join(BASE_DIR, 'templates')],
|
|
|
|
'DIRS': [os.path.join(BASE_DIR, 'templates')], # 全局模板目录（项目根目录下的 templates）
|
|
|
|
'APP_DIRS': True,
|
|
|
|
'APP_DIRS': True, # 允许从各应用的 templates 目录加载模板
|
|
|
|
'OPTIONS': {
|
|
|
|
'OPTIONS': {
|
|
|
|
|
|
|
|
# 上下文处理器：向所有模板注入全局变量（如用户信息、请求对象）
|
|
|
|
'context_processors': [
|
|
|
|
'context_processors': [
|
|
|
|
'django.template.context_processors.debug',
|
|
|
|
'django.template.context_processors.debug', # 调试模式变量（如 DEBUG）
|
|
|
|
'django.template.context_processors.request',
|
|
|
|
'django.template.context_processors.request', # 请求对象（request）
|
|
|
|
'django.contrib.auth.context_processors.auth',
|
|
|
|
'django.contrib.auth.context_processors.auth', # 认证相关变量（如 user）
|
|
|
|
'django.contrib.messages.context_processors.messages',
|
|
|
|
'django.contrib.messages.context_processors.messages', # 消息变量（如 messages）
|
|
|
|
'blog.context_processors.seo_processor'
|
|
|
|
'blog.context_processors.seo_processor' # 自定义上下文处理器：注入 SEO 相关数据
|
|
|
|
],
|
|
|
|
],
|
|
|
|
},
|
|
|
|
},
|
|
|
|
},
|
|
|
|
},
|
|
|
|
]
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# WSGI 应用：指定项目的 WSGI 入口文件（用于部署，如 Gunicorn、uWSGI）
|
|
|
|
WSGI_APPLICATION = 'djangoblog.wsgi.application'
|
|
|
|
WSGI_APPLICATION = 'djangoblog.wsgi.application'
|
|
|
|
|
|
|
|
|
|
|
|
# Database
|
|
|
|
|
|
|
|
# https://docs.djangoproject.com/en/1.10/ref/settings/#databases
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Database（数据库配置：使用 MySQL 数据库）
|
|
|
|
|
|
|
|
# https://docs.djangoproject.com/en/1.10/ref/settings/#databases
|
|
|
|
DATABASES = {
|
|
|
|
DATABASES = {
|
|
|
|
'default': {
|
|
|
|
'default': {
|
|
|
|
'ENGINE': 'django.db.backends.mysql',
|
|
|
|
'ENGINE': 'django.db.backends.mysql', # 数据库引擎（MySQL）
|
|
|
|
'NAME': os.environ.get('DJANGO_MYSQL_DATABASE') or 'djangoblog',
|
|
|
|
'NAME': os.environ.get('DJANGO_MYSQL_DATABASE') or 'djangoblog', # 数据库名（优先从环境变量获取）
|
|
|
|
'USER': os.environ.get('DJANGO_MYSQL_USER') or 'root',
|
|
|
|
'USER': os.environ.get('DJANGO_MYSQL_USER') or 'root', # 数据库用户名
|
|
|
|
'PASSWORD': os.environ.get('DJANGO_MYSQL_PASSWORD') or 'root',
|
|
|
|
'PASSWORD': os.environ.get('DJANGO_MYSQL_PASSWORD') or 'root', # 数据库密码
|
|
|
|
'HOST': os.environ.get('DJANGO_MYSQL_HOST') or '127.0.0.1',
|
|
|
|
'HOST': os.environ.get('DJANGO_MYSQL_HOST') or '127.0.0.1', # 数据库主机（默认本地）
|
|
|
|
'PORT': int(
|
|
|
|
'PORT': int(os.environ.get('DJANGO_MYSQL_PORT') or 3306), # 数据库端口（默认 3306）
|
|
|
|
os.environ.get('DJANGO_MYSQL_PORT') or 3306),
|
|
|
|
|
|
|
|
'OPTIONS': {
|
|
|
|
'OPTIONS': {
|
|
|
|
'charset': 'utf8mb4'},
|
|
|
|
'charset': 'utf8mb4'}, # 数据库字符集（支持 emoji 表情）
|
|
|
|
}}
|
|
|
|
}}
|
|
|
|
|
|
|
|
|
|
|
|
# Password validation
|
|
|
|
|
|
|
|
# https://docs.djangoproject.com/en/1.10/ref/settings/#auth-password-validators
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Password validation（密码验证规则：确保用户密码强度）
|
|
|
|
|
|
|
|
# https://docs.djangoproject.com/en/1.10/ref/settings/#auth-password-validators
|
|
|
|
AUTH_PASSWORD_VALIDATORS = [
|
|
|
|
AUTH_PASSWORD_VALIDATORS = [
|
|
|
|
{
|
|
|
|
{
|
|
|
|
|
|
|
|
# 验证密码与用户属性（如用户名、邮箱）的相似度
|
|
|
|
'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
|
|
|
|
'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
|
|
|
|
},
|
|
|
|
},
|
|
|
|
{
|
|
|
|
{
|
|
|
|
|
|
|
|
# 验证密码最小长度（默认 8 位）
|
|
|
|
'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
|
|
|
|
'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
|
|
|
|
},
|
|
|
|
},
|
|
|
|
{
|
|
|
|
{
|
|
|
|
|
|
|
|
# 验证密码是否在常见弱密码列表中
|
|
|
|
'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
|
|
|
|
'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
|
|
|
|
},
|
|
|
|
},
|
|
|
|
{
|
|
|
|
{
|
|
|
|
|
|
|
|
# 验证密码是否纯数字
|
|
|
|
'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
|
|
|
|
'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
|
|
|
|
},
|
|
|
|
},
|
|
|
|
]
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Internationalization（国际化配置：多语言支持）
|
|
|
|
|
|
|
|
# https://docs.djangoproject.com/en/1.10/topics/i18n/
|
|
|
|
LANGUAGES = (
|
|
|
|
LANGUAGES = (
|
|
|
|
('en', _('English')),
|
|
|
|
('en', _('English')), # 英语
|
|
|
|
('zh-hans', _('Simplified Chinese')),
|
|
|
|
('zh-hans', _('Simplified Chinese')), # 简体中文
|
|
|
|
('zh-hant', _('Traditional Chinese')),
|
|
|
|
('zh-hant', _('Traditional Chinese')), # 繁体中文
|
|
|
|
)
|
|
|
|
)
|
|
|
|
|
|
|
|
# 翻译文件目录：指定多语言翻译文件（.po/.mo）的存放路径
|
|
|
|
LOCALE_PATHS = (
|
|
|
|
LOCALE_PATHS = (
|
|
|
|
os.path.join(BASE_DIR, 'locale'),
|
|
|
|
os.path.join(BASE_DIR, 'locale'),
|
|
|
|
)
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
LANGUAGE_CODE = 'zh-hans'
|
|
|
|
LANGUAGE_CODE = 'zh-hans' # 默认语言：简体中文
|
|
|
|
|
|
|
|
TIME_ZONE = 'Asia/Shanghai' # 时区：上海（中国时区）
|
|
|
|
TIME_ZONE = 'Asia/Shanghai'
|
|
|
|
USE_I18N = True # 启用国际化（支持多语言）
|
|
|
|
|
|
|
|
USE_L10N = True # 启用本地化（支持区域化日期、数字格式）
|
|
|
|
USE_I18N = True
|
|
|
|
USE_TZ = False # 禁用 UTC 时间（使用本地时区存储时间，避免时区转换问题）
|
|
|
|
|
|
|
|
|
|
|
|
USE_L10N = True
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
USE_TZ = False
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Static files (CSS, JavaScript, Images)
|
|
|
|
|
|
|
|
# https://docs.djangoproject.com/en/1.10/howto/static-files/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Search（搜索框架配置：Haystack + Whoosh/Elasticsearch）
|
|
|
|
HAYSTACK_CONNECTIONS = {
|
|
|
|
HAYSTACK_CONNECTIONS = {
|
|
|
|
'default': {
|
|
|
|
'default': {
|
|
|
|
|
|
|
|
# 搜索引擎：默认使用 Whoosh（轻量级全文搜索引擎，适合中小项目）
|
|
|
|
'ENGINE': 'djangoblog.whoosh_cn_backend.WhooshEngine',
|
|
|
|
'ENGINE': 'djangoblog.whoosh_cn_backend.WhooshEngine',
|
|
|
|
|
|
|
|
# 索引文件路径：Whoosh 索引文件存储位置
|
|
|
|
'PATH': os.path.join(os.path.dirname(__file__), 'whoosh_index'),
|
|
|
|
'PATH': os.path.join(os.path.dirname(__file__), 'whoosh_index'),
|
|
|
|
},
|
|
|
|
},
|
|
|
|
}
|
|
|
|
}
|
|
|
|
# Automatically update searching index
|
|
|
|
# 实时更新索引：当模型数据（如文章）新增/修改/删除时，自动更新搜索索引
|
|
|
|
HAYSTACK_SIGNAL_PROCESSOR = 'haystack.signals.RealtimeSignalProcessor'
|
|
|
|
HAYSTACK_SIGNAL_PROCESSOR = 'haystack.signals.RealtimeSignalProcessor'
|
|
|
|
# Allow user login with username and password
|
|
|
|
|
|
|
|
AUTHENTICATION_BACKENDS = [
|
|
|
|
|
|
|
|
'accounts.user_login_backend.EmailOrUsernameModelBackend']
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
STATIC_ROOT = os.path.join(BASE_DIR, 'collectedstatic')
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
STATIC_URL = '/static/'
|
|
|
|
|
|
|
|
STATICFILES = os.path.join(BASE_DIR, 'static')
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Authentication（认证配置：自定义登录逻辑）
|
|
|
|
|
|
|
|
# 允许用户通过“用户名”或“邮箱”登录（默认仅支持用户名）
|
|
|
|
|
|
|
|
AUTHENTICATION_BACKENDS = [
|
|
|
|
|
|
|
|
'accounts.user_login_backend.EmailOrUsernameModelBackend']
|
|
|
|
|
|
|
|
# 自定义用户模型：使用 accounts 应用的 BlogUser 模型（替代 Django 内置 User 模型）
|
|
|
|
AUTH_USER_MODEL = 'accounts.BlogUser'
|
|
|
|
AUTH_USER_MODEL = 'accounts.BlogUser'
|
|
|
|
|
|
|
|
# 登录 URL：未登录用户访问需认证页面时，重定向到该 URL
|
|
|
|
LOGIN_URL = '/login/'
|
|
|
|
LOGIN_URL = '/login/'
|
|
|
|
|
|
|
|
|
|
|
|
TIME_FORMAT = '%Y-%m-%d %H:%M:%S'
|
|
|
|
|
|
|
|
DATE_TIME_FORMAT = '%Y-%m-%d'
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# bootstrap color styles
|
|
|
|
# Custom Settings（自定义业务配置）
|
|
|
|
BOOTSTRAP_COLOR_TYPES = [
|
|
|
|
TIME_FORMAT = '%Y-%m-%d %H:%M:%S' # 时间显示格式（如 2024-05-20 14:30:00）
|
|
|
|
|
|
|
|
DATE_TIME_FORMAT = '%Y-%m-%d' # 日期显示格式（如 2024-05-20）
|
|
|
|
|
|
|
|
BOOTSTRAP_COLOR_TYPES = [ # Bootstrap 颜色样式（用于前端组件，如标签、按钮）
|
|
|
|
'default', 'primary', 'success', 'info', 'warning', 'danger'
|
|
|
|
'default', 'primary', 'success', 'info', 'warning', 'danger'
|
|
|
|
]
|
|
|
|
]
|
|
|
|
|
|
|
|
PAGINATE_BY = 10 # 分页大小：每页显示 10 条数据（如文章列表、评论列表）
|
|
|
|
|
|
|
|
CACHE_CONTROL_MAX_AGE = 2592000 # HTTP 缓存有效期：30 天（单位：秒）
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# paginate
|
|
|
|
# Cache（缓存配置：默认本地内存缓存，支持 Redis 扩展）
|
|
|
|
PAGINATE_BY = 10
|
|
|
|
|
|
|
|
# http cache timeout
|
|
|
|
|
|
|
|
CACHE_CONTROL_MAX_AGE = 2592000
|
|
|
|
|
|
|
|
# cache setting
|
|
|
|
|
|
|
|
CACHES = {
|
|
|
|
CACHES = {
|
|
|
|
'default': {
|
|
|
|
'default': {
|
|
|
|
|
|
|
|
# 本地内存缓存（适合开发环境，生产环境建议用 Redis/Memcached）
|
|
|
|
'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',
|
|
|
|
'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',
|
|
|
|
'TIMEOUT': 10800,
|
|
|
|
'TIMEOUT': 10800, # 缓存有效期：3 小时（单位：秒）
|
|
|
|
'LOCATION': 'unique-snowflake',
|
|
|
|
'LOCATION': 'unique-snowflake', # 缓存实例标识（避免多实例冲突）
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
# 使用redis作为缓存
|
|
|
|
# 若环境变量指定 Redis 地址，则使用 Redis 作为缓存（生产环境推荐）
|
|
|
|
if os.environ.get("DJANGO_REDIS_URL"):
|
|
|
|
if os.environ.get("DJANGO_REDIS_URL"):
|
|
|
|
CACHES = {
|
|
|
|
CACHES = {
|
|
|
|
'default': {
|
|
|
|
'default': {
|
|
|
|
'BACKEND': 'django.core.cache.backends.redis.RedisCache',
|
|
|
|
'BACKEND': 'django.core.cache.backends.redis.RedisCache',
|
|
|
|
'LOCATION': f'redis://{os.environ.get("DJANGO_REDIS_URL")}',
|
|
|
|
'LOCATION': f'redis://{os.environ.get("DJANGO_REDIS_URL")}', # Redis 连接地址
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
SITE_ID = 1
|
|
|
|
|
|
|
|
|
|
|
|
# Site & SEO（站点与 SEO 配置）
|
|
|
|
|
|
|
|
SITE_ID = 1 # 站点 ID（多站点配置时区分不同站点，单站点固定为 1）
|
|
|
|
|
|
|
|
# 百度主动推送 URL：用于文章发布后主动通知百度收录（提升 SEO 效率）
|
|
|
|
BAIDU_NOTIFY_URL = os.environ.get('DJANGO_BAIDU_NOTIFY_URL') \
|
|
|
|
BAIDU_NOTIFY_URL = os.environ.get('DJANGO_BAIDU_NOTIFY_URL') \
|
|
|
|
or 'http://data.zz.baidu.com/urls?site=https://www.lylinux.net&token=1uAOGrMsUm5syDGn'
|
|
|
|
or 'http://data.zz.baidu.com/urls?site=https://www.lylinux.net&token=1uAOGrMsUm5syDGn'
|
|
|
|
|
|
|
|
|
|
|
|
# Email:
|
|
|
|
|
|
|
|
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
|
|
|
|
# Email（邮件配置：用于发送验证码、评论通知等）
|
|
|
|
EMAIL_USE_TLS = env_to_bool('DJANGO_EMAIL_TLS', False)
|
|
|
|
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend' # SMTP 邮件后端
|
|
|
|
EMAIL_USE_SSL = env_to_bool('DJANGO_EMAIL_SSL', True)
|
|
|
|
EMAIL_USE_TLS = env_to_bool('DJANGO_EMAIL_TLS', False) # 是否启用 TLS 加密（与 SSL 二选一）
|
|
|
|
EMAIL_HOST = os.environ.get('DJANGO_EMAIL_HOST') or 'smtp.mxhichina.com'
|
|
|
|
EMAIL_USE_SSL = env_to_bool('DJANGO_EMAIL_SSL', True) # 是否启用 SSL 加密（默认启用，端口通常为 465）
|
|
|
|
EMAIL_PORT = int(os.environ.get('DJANGO_EMAIL_PORT') or 465)
|
|
|
|
EMAIL_HOST = os.environ.get('DJANGO_EMAIL_HOST') or 'smtp.mxhichina.com' # SMTP 服务器地址（默认阿里云）
|
|
|
|
EMAIL_HOST_USER = os.environ.get('DJANGO_EMAIL_USER')
|
|
|
|
EMAIL_PORT = int(os.environ.get('DJANGO_EMAIL_PORT') or 465) # SMTP 端口（SSL 通常为 465，TLS 通常为 587）
|
|
|
|
EMAIL_HOST_PASSWORD = os.environ.get('DJANGO_EMAIL_PASSWORD')
|
|
|
|
EMAIL_HOST_USER = os.environ.get('DJANGO_EMAIL_USER') # 发送邮件的邮箱账号（优先环境变量）
|
|
|
|
DEFAULT_FROM_EMAIL = EMAIL_HOST_USER
|
|
|
|
EMAIL_HOST_PASSWORD = os.environ.get('DJANGO_EMAIL_PASSWORD') # 邮箱密码/授权码
|
|
|
|
SERVER_EMAIL = EMAIL_HOST_USER
|
|
|
|
DEFAULT_FROM_EMAIL = EMAIL_HOST_USER # 默认发件人邮箱
|
|
|
|
# Setting debug=false did NOT handle except email notifications
|
|
|
|
SERVER_EMAIL = EMAIL_HOST_USER # 服务器错误通知发件人邮箱
|
|
|
|
|
|
|
|
# 管理员邮箱：生产环境错误（如 500 异常）会发送到此邮箱
|
|
|
|
ADMINS = [('admin', os.environ.get('DJANGO_ADMIN_EMAIL') or 'admin@admin.com')]
|
|
|
|
ADMINS = [('admin', os.environ.get('DJANGO_ADMIN_EMAIL') or 'admin@admin.com')]
|
|
|
|
# WX ADMIN password(Two times md5)
|
|
|
|
# 微信管理员密码：二次 MD5 加密（用于微信后台管理验证，具体业务自定义）
|
|
|
|
WXADMIN = os.environ.get(
|
|
|
|
WXADMIN = os.environ.get(
|
|
|
|
'DJANGO_WXADMIN_PASSWORD') or '995F03AC401D6CABABAEF756FC4D43C7'
|
|
|
|
'DJANGO_WXADMIN_PASSWORD') or '995F03AC401D6CABABAEF756FC4D43C7'
|
|
|
|
|
|
|
|
|
|
|
|
LOG_PATH = os.path.join(BASE_DIR, 'logs')
|
|
|
|
|
|
|
|
|
|
|
|
# Logging（日志配置：记录系统操作、错误信息）
|
|
|
|
|
|
|
|
LOG_PATH = os.path.join(BASE_DIR, 'logs') # 日志文件目录
|
|
|
|
|
|
|
|
# 若日志目录不存在，则创建（确保日志能正常写入）
|
|
|
|
if not os.path.exists(LOG_PATH):
|
|
|
|
if not os.path.exists(LOG_PATH):
|
|
|
|
os.makedirs(LOG_PATH, exist_ok=True)
|
|
|
|
os.makedirs(LOG_PATH, exist_ok=True)
|
|
|
|
|
|
|
|
|
|
|
|
LOGGING = {
|
|
|
|
LOGGING = {
|
|
|
|
'version': 1,
|
|
|
|
'version': 1, # 日志配置版本（固定为 1）
|
|
|
|
'disable_existing_loggers': False,
|
|
|
|
'disable_existing_loggers': False, # 不禁用已存在的日志器
|
|
|
|
'root': {
|
|
|
|
'root': { # 根日志器（所有未指定日志器的日志都会走这里）
|
|
|
|
'level': 'INFO',
|
|
|
|
'level': 'INFO', # 日志级别（INFO：记录普通信息及以上级别）
|
|
|
|
'handlers': ['console', 'log_file'],
|
|
|
|
'handlers': ['console', 'log_file'], # 日志处理器（控制台 + 文件）
|
|
|
|
},
|
|
|
|
},
|
|
|
|
'formatters': {
|
|
|
|
'formatters': { # 日志格式：定义日志的输出结构
|
|
|
|
'verbose': {
|
|
|
|
'verbose': {
|
|
|
|
|
|
|
|
# 日志格式：时间 + 级别 + 调用位置 + 消息（便于问题定位）
|
|
|
|
'format': '[%(asctime)s] %(levelname)s [%(name)s.%(funcName)s:%(lineno)d %(module)s] %(message)s',
|
|
|
|
'format': '[%(asctime)s] %(levelname)s [%(name)s.%(funcName)s:%(lineno)d %(module)s] %(message)s',
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
},
|
|
|
|
'filters': {
|
|
|
|
'filters': { # 日志过滤器：按条件过滤日志
|
|
|
|
'require_debug_false': {
|
|
|
|
'require_debug_false': { # 仅当 DEBUG=False 时生效（生产环境）
|
|
|
|
'()': 'django.utils.log.RequireDebugFalse',
|
|
|
|
'()': 'django.utils.log.RequireDebugFalse',
|
|
|
|
},
|
|
|
|
},
|
|
|
|
'require_debug_true': {
|
|
|
|
'require_debug_true': { # 仅当 DEBUG=True 时生效（开发环境）
|
|
|
|
'()': 'django.utils.log.RequireDebugTrue',
|
|
|
|
'()': 'django.utils.log.RequireDebugTrue',
|
|
|
|
},
|
|
|
|
},
|
|
|
|
},
|
|
|
|
},
|
|
|
|
'handlers': {
|
|
|
|
'handlers': { # 日志处理器：定义日志的输出方式
|
|
|
|
'log_file': {
|
|
|
|
'log_file': { # 文件处理器：按时间轮转切割日志
|
|
|
|
'level': 'INFO',
|
|
|
|
'level': 'INFO',
|
|
|
|
'class': 'logging.handlers.TimedRotatingFileHandler',
|
|
|
|
'class': 'logging.handlers.TimedRotatingFileHandler', # 按时间轮转的处理器
|
|
|
|
'filename': os.path.join(LOG_PATH, 'djangoblog.log'),
|
|
|
|
'filename': os.path.join(LOG_PATH, 'djangoblog.log'), # 日志文件路径
|
|
|
|
'when': 'D',
|
|
|
|
'when': 'D', # 轮转周期：每天（Day）
|
|
|
|
'formatter': 'verbose',
|
|
|
|
'formatter': 'verbose', # 使用 verbose 格式
|
|
|
|
'interval': 1,
|
|
|
|
'interval': 1, # 轮转间隔：1 个周期（1 天）
|
|
|
|
'delay': True,
|
|
|
|
'delay': True, # 延迟创建文件（直到有日志才创建）
|
|
|
|
'backupCount': 5,
|
|
|
|
'backupCount': 5, # 保留日志备份数：5 天
|
|
|
|
'encoding': 'utf-8'
|
|
|
|
'encoding': 'utf-8' # 日志文件编码
|
|
|
|
},
|
|
|
|
},
|
|
|
|
'console': {
|
|
|
|
'console': { # 控制台处理器：开发环境输出到终端
|
|
|
|
'level': 'DEBUG',
|
|
|
|
'level': 'DEBUG',
|
|
|
|
'filters': ['require_debug_true'],
|
|
|
|
'filters': ['require_debug_true'], # 仅开发环境生效
|
|
|
|
'class': 'logging.StreamHandler',
|
|
|
|
'class': 'logging.StreamHandler',
|
|
|
|
'formatter': 'verbose'
|
|
|
|
'formatter': 'verbose'
|
|
|
|
},
|
|
|
|
},
|
|
|
|
'null': {
|
|
|
|
'null': { # 空处理器：用于屏蔽不需要的日志
|
|
|
|
'class': 'logging.NullHandler',
|
|
|
|
'class': 'logging.NullHandler',
|
|
|
|
},
|
|
|
|
},
|
|
|
|
'mail_admins': {
|
|
|
|
'mail_admins': { # 邮件处理器：生产环境错误发送到管理员邮箱
|
|
|
|
'level': 'ERROR',
|
|
|
|
'level': 'ERROR', # 仅 ERROR 级别日志触发
|
|
|
|
'filters': ['require_debug_false'],
|
|
|
|
'filters': ['require_debug_false'], # 仅生产环境生效
|
|
|
|
'class': 'django.utils.log.AdminEmailHandler'
|
|
|
|
'class': 'django.utils.log.AdminEmailHandler'
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
},
|
|
|
|
'loggers': {
|
|
|
|
'loggers': { # 自定义日志器：针对特定模块配置日志
|
|
|
|
'djangoblog': {
|
|
|
|
'djangoblog': { # 项目核心模块日志器
|
|
|
|
'handlers': ['log_file', 'console'],
|
|
|
|
'handlers': ['log_file', 'console'], # 输出到文件和控制台
|
|
|
|
'level': 'INFO',
|
|
|
|
'level': 'INFO',
|
|
|
|
'propagate': True,
|
|
|
|
'propagate': True, # 是否向上传递到根日志器（此处开启）
|
|
|
|
},
|
|
|
|
},
|
|
|
|
'django.request': {
|
|
|
|
'django.request': { # Django 请求模块日志器（记录请求相关错误）
|
|
|
|
'handlers': ['mail_admins'],
|
|
|
|
'handlers': ['mail_admins'], # 错误发送到管理员邮箱
|
|
|
|
'level': 'ERROR',
|
|
|
|
'level': 'ERROR',
|
|
|
|
'propagate': False,
|
|
|
|
'propagate': False, # 不向上传递（避免重复记录）
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Static Files（静态文件配置：CSS/JS/图片等）
|
|
|
|
|
|
|
|
# 静态文件收集目录：执行 collectstatic 命令后，静态文件会汇总到此处（生产环境使用）
|
|
|
|
|
|
|
|
STATIC_ROOT = os.path.join(BASE_DIR, 'collectedstatic')
|
|
|
|
|
|
|
|
# 静态文件 URL 前缀：前端通过 /static/ 访问静态文件
|
|
|
|
|
|
|
|
STATIC_URL = '/static/'
|
|
|
|
|
|
|
|
# 全局静态文件目录：项目根目录下的 static 目录（存放全局静态文件）
|
|
|
|
|
|
|
|
STATICFILES = os.path.join(BASE_DIR, 'static')
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 静态文件查找器：指定 Django 查找静态文件的路径（内置 + 第三方）
|
|
|
|
STATICFILES_FINDERS = (
|
|
|
|
STATICFILES_FINDERS = (
|
|
|
|
'django.contrib.staticfiles.finders.FileSystemFinder',
|
|
|
|
'django.contrib.staticfiles.finders.FileSystemFinder', # 查找全局 STATICFILES 目录
|
|
|
|
'django.contrib.staticfiles.finders.AppDirectoriesFinder',
|
|
|
|
'django.contrib.staticfiles.finders.AppDirectoriesFinder', # 查找各应用的 static 目录
|
|
|
|
# other
|
|
|
|
'compressor.finders.CompressorFinder', # 查找压缩后的静态文件（第三方 compressor 应用）
|
|
|
|
'compressor.finders.CompressorFinder',
|
|
|
|
|
|
|
|
)
|
|
|
|
)
|
|
|
|
COMPRESS_ENABLED = True
|
|
|
|
|
|
|
|
# COMPRESS_OFFLINE = True
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 静态文件压缩配置（compressor 应用）
|
|
|
|
|
|
|
|
COMPRESS_ENABLED = True # 启用压缩（生产环境建议开启，提升加载速度）
|
|
|
|
|
|
|
|
# COMPRESS_OFFLINE = True # 离线压缩（预先生成压缩文件，生产环境推荐，此处注释按需启用）
|
|
|
|
|
|
|
|
# CSS 压缩过滤器：绝对路径处理 + 代码压缩
|
|
|
|
COMPRESS_CSS_FILTERS = [
|
|
|
|
COMPRESS_CSS_FILTERS = [
|
|
|
|
# creates absolute urls from relative ones
|
|
|
|
|
|
|
|
'compressor.filters.css_default.CssAbsoluteFilter',
|
|
|
|
'compressor.filters.css_default.CssAbsoluteFilter',
|
|
|
|
# css minimizer
|
|
|
|
|
|
|
|
'compressor.filters.cssmin.CSSMinFilter'
|
|
|
|
'compressor.filters.cssmin.CSSMinFilter'
|
|
|
|
]
|
|
|
|
]
|
|
|
|
|
|
|
|
# JS 压缩过滤器：代码压缩
|
|
|
|
COMPRESS_JS_FILTERS = [
|
|
|
|
COMPRESS_JS_FILTERS = [
|
|
|
|
'compressor.filters.jsmin.JSMinFilter'
|
|
|
|
'compressor.filters.jsmin.JSMinFilter'
|
|
|
|
]
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Media Files（媒体文件配置：用户上传的文件，如文章图片、头像）
|
|
|
|
|
|
|
|
# 媒体文件存储目录：项目根目录下的 uploads 目录
|
|
|
|
MEDIA_ROOT = os.path.join(BASE_DIR, 'uploads')
|
|
|
|
MEDIA_ROOT = os.path.join(BASE_DIR, 'uploads')
|
|
|
|
|
|
|
|
# 媒体文件 URL 前缀：前端通过 /media/ 访问上传的文件
|
|
|
|
MEDIA_URL = '/media/'
|
|
|
|
MEDIA_URL = '/media/'
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# X-Frame-Options：防止点击劫持（SAMEORIGIN：仅允许同域页面嵌入当前页面）
|
|
|
|
X_FRAME_OPTIONS = 'SAMEORIGIN'
|
|
|
|
X_FRAME_OPTIONS = 'SAMEORIGIN'
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 默认模型主键类型：Django 3.2+ 新增，指定模型默认主键为 BigAutoField（64 位自增整数）
|
|
|
|
DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
|
|
|
|
DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Elasticsearch 配置（按需启用：若环境变量指定 Elasticsearch 地址，则使用 Elasticsearch 替代 Whoosh）
|
|
|
|
if os.environ.get('DJANGO_ELASTICSEARCH_HOST'):
|
|
|
|
if os.environ.get('DJANGO_ELASTICSEARCH_HOST'):
|
|
|
|
ELASTICSEARCH_DSL = {
|
|
|
|
ELASTICSEARCH_DSL = {
|
|
|
|
'default': {
|
|
|
|
'default': {
|
|
|
|
'hosts': os.environ.get('DJANGO_ELASTICSEARCH_HOST')
|
|
|
|
'hosts': os.environ.get('DJANGO_ELASTICSEARCH_HOST') # Elasticsearch 连接地址
|
|
|
|
},
|
|
|
|
},
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
# 替换 Haystack 搜索引擎为自定义的 Elasticsearch 引擎
|
|
|
|
HAYSTACK_CONNECTIONS = {
|
|
|
|
HAYSTACK_CONNECTIONS = {
|
|
|
|
'default': {
|
|
|
|
'default': {
|
|
|
|
'ENGINE': 'djangoblog.elasticsearch_backend.ElasticSearchEngine',
|
|
|
|
'ENGINE': 'djangoblog.elasticsearch_backend.ElasticSearchEngine',
|
|
|
|
},
|
|
|
|
},
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
# Plugin System
|
|
|
|
|
|
|
|
PLUGINS_DIR = BASE_DIR / 'plugins'
|
|
|
|
# Plugin System（插件系统配置：自定义插件功能）
|
|
|
|
|
|
|
|
PLUGINS_DIR = BASE_DIR / 'plugins' # 插件目录：项目根目录下的 plugins 目录
|
|
|
|
|
|
|
|
# 激活的插件列表：指定需要加载的插件（如文章版权、阅读时长统计等）
|
|
|
|
ACTIVE_PLUGINS = [
|
|
|
|
ACTIVE_PLUGINS = [
|
|
|
|
'article_copyright',
|
|
|
|
'article_copyright', # 文章版权插件
|
|
|
|
'reading_time',
|
|
|
|
'reading_time', # 阅读时长统计插件
|
|
|
|
'external_links',
|
|
|
|
'external_links', # 外部链接处理插件
|
|
|
|
'view_count',
|
|
|
|
'view_count', # 文章阅读量统计插件
|
|
|
|
'seo_optimizer'
|
|
|
|
'seo_optimizer' # SEO 优化插件
|
|
|
|
]
|
|
|
|
]
|
