From 0f6ec0ee818c5c5a888d335632f1d2d45dce7fb9 Mon Sep 17 00:00:00 2001 From: pig6z2klp <431960330@qq.com> Date: Mon, 13 Oct 2025 16:17:45 +0800 Subject: [PATCH] Update config-en.md --- src/DjangoBlog-master/docs/config-en.md | 28 +++++++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/src/DjangoBlog-master/docs/config-en.md b/src/DjangoBlog-master/docs/config-en.md index b877efb..21820f6 100644 --- a/src/DjangoBlog-master/docs/config-en.md +++ b/src/DjangoBlog-master/docs/config-en.md @@ -2,22 +2,32 @@ ## Cache: Cache using `memcache` for default. If you don't have `memcache` environment, you can remove the `default` setting in `CACHES` and change `locmemcache` to `default`. -```python + ``` +# Django 缓存配置字典,用于定义不同的缓存后端及相关参数 CACHES = { + # 默认缓存配置,键名为'default' 'default': { + # 缓存后端类型:使用Memcached作为缓存服务器 'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache', + # Memcached服务器地址和端口,这里使用本地的11211端口(Memcached默认端口) 'LOCATION': '127.0.0.1:11211', + # 缓存键的前缀:如果处于测试环境(TESTING为True)则使用'django_test',否则使用'djangoblog' + # 用于区分不同环境或项目的缓存键,避免冲突 'KEY_PREFIX': 'django_test' if TESTING else 'djangoblog', + # 缓存超时时间(单位:秒),这里设置为10小时(60秒*60分*10小时) 'TIMEOUT': 60 * 60 * 10 }, + # 本地内存缓存配置,键名为'locmemcache' 'locmemcache': { + # 缓存后端类型:使用本地内存作为缓存(仅当前进程有效,多进程不共享) 'BACKEND': 'django.core.cache.backends.locmem.LocMemCache', + # 缓存超时时间(单位:秒),这里设置为3小时(10800秒 = 60*60*3) 'TIMEOUT': 10800, + # 本地内存缓存的唯一标识,用于在同一进程中区分不同的本地缓存实例 'LOCATION': 'unique-snowflake', } } ``` - ## OAuth Login: QQ, Weibo, Google, GitHub and Facebook are now supported for OAuth login. Fetch OAuth login permissions from the corresponding open platform, and save them with `appkey`, `appsecret` and callback address in **Backend->OAuth** configuration. @@ -32,11 +42,25 @@ owntracks is a location tracking application. It will send your locaiton to the ## Email feature: Same as before, Configure your own error msg recvie email information with`ADMINS = [('liangliang', 'liangliangyy@gmail.com')]` in `settings.py`. And modify: ```python +# 邮件发送服务器的SMTP地址,这里使用Zoho的SMTP服务器 EMAIL_HOST = 'smtp.zoho.com' + +# 邮件发送服务器的端口号,587是TLS加密的常用端口 EMAIL_PORT = 587 + +# 发送邮件的账号用户名,从环境变量中获取(避免硬编码敏感信息) +# 环境变量键为'DJANGO_EMAIL_USER' EMAIL_HOST_USER = os.environ.get('DJANGO_EMAIL_USER') + +# 发送邮件的账号密码(或授权码),从环境变量中获取(安全存储敏感信息) +# 环境变量键为'DJANGO_EMAIL_PASSWORD' EMAIL_HOST_PASSWORD = os.environ.get('DJANGO_EMAIL_PASSWORD') + +# 默认的发件人邮箱地址,这里直接使用上面配置的邮件账号 DEFAULT_FROM_EMAIL = EMAIL_HOST_USER + +# 服务器错误通知的发件人邮箱(例如500错误时发送给管理员的邮件) +# 这里同样使用环境变量中配置的邮件账号 SERVER_EMAIL = os.environ.get('DJANGO_EMAIL_USER') ``` with your email account information.