Repository navigation
Expand file tree
/
Copy pathapp.env.example
More file actions
84 lines (70 loc) · 3.5 KB
/
Copy pathapp.env.example
File metadata and controls
84 lines (70 loc) · 3.5 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
# 博客系统环境变量示例。使用方法:复制本文件为 app.env,填入实际值
# cp app.env.example app.env (Windows: Copy-Item app.env.example app.env)
# app.env 已在 .gitignore 中忽略,不会入库
# 本文件为应用侧配置(裸机 / 本地运行,由 python-dotenv 加载);
# Docker 部署改用编排侧的 .env.docker(模板 .env.docker.example),两者互不影响
# 应用时间统一按 UTC 存储,页面时间在「系统设置」中按时区换算显示。
# 下列运行时参数可在「管理后台 → 系统设置」中覆盖,未覆盖时沿用本文件。
# 必填(生产环境):设为 production 后 BLOG_SECRET_KEY 必须显式提供
BLOG_ENV=production
# Session / CSRF 密钥,须使用随机长字符串
# 生成命令:python -c "import secrets;print(secrets.token_hex(32))"
BLOG_SECRET_KEY=
# 也可指向存放密钥的文件(BLOG_SECRET_KEY 优先)
#BLOG_SECRET_KEY_FILE=
# 站点固定外链域名(防 Host 头注入),用于邮件重置链接、RSS/Atom、sitemap
# 示例:https://blog.example.com;留空则回退到请求 Host,仅开发用
BLOG_CANONICAL_URL=
# Host 白名单(逗号分隔),非白名单 Host 的请求返回 400,留空表示不校验
# 示例:blog.example.com,www.blog.example.com
BLOG_TRUSTED_HOSTS=
# 调试
# 生产环境保持 False,避免 Werkzeug 调试器暴露导致 RCE
BLOG_DEBUG=False
# 生产环境默认 true;仅本地明文 HTTP 调试时设为 false
#BLOG_COOKIE_SECURE=false
# 数据库
# 数据库类型:sqlite 或 mysql
BLOG_DB_TYPE=sqlite
# MySQL 配置(BLOG_DB_TYPE=mysql 时生效)
# 若 HOST/USER/DB 等关键字段缺失,应用拒绝启动而不回退到 SQLite
BLOG_MYSQL_HOST=localhost
BLOG_MYSQL_USER=root
BLOG_MYSQL_PWD=
BLOG_MYSQL_DB=flask_blog
# SQLite 配置(BLOG_DB_TYPE=sqlite 时生效)
BLOG_SQLITE_PATH=data/blog.db
# 数据库结构迁移:true 启动时自动执行待迁移项;false 站点进入 503 维护状态,由后台手动执行
#BLOG_AUTO_MIGRATE=true
# 降级守卫:数据库版本高于程序版本时拒绝启动;true 放行仅告警
#BLOG_ALLOW_SCHEMA_AHEAD=false
# 业务参数
BLOG_PAGE_SIZE=10
# 静态文件缓存秒数(生产建议 43200)
BLOG_STATIC_MAX_AGE=0
# Session 有效期(秒,默认 86400 = 24 小时)
BLOG_SESSION_LIFETIME=86400
# 日志(应用日志同时写控制台和文件,默认 项目根/logs/app.log)
#BLOG_LOG_DIR=logs
# 单文件大小上限(字节,默认 10485760 = 10MB)与保留份数
#BLOG_LOG_MAX_BYTES=10485760
#BLOG_LOG_BACKUP_COUNT=5
# 日志格式:auto(生产单行 JSON / 开发测试文本)、json、text
#BLOG_LOG_FORMAT=auto
# 日志级别:auto(跟随 DEBUG)、DEBUG、INFO、WARNING、ERROR、CRITICAL
#BLOG_LOG_LEVEL=auto
# 慢请求阈值(毫秒,默认 500):超阈值请求日志升级为 WARNING
#BLOG_SLOW_REQUEST_MS=500
# 慢 SQL 阈值(毫秒,默认 200):超阈值语句记 slow_query WARNING
#BLOG_SLOW_QUERY_MS=200
# 反向代理:信任的层数,用于获取真实客户端 IP / 协议 / Host
#BLOG_PROXY_XFOR=1
#BLOG_PROXY_XPROTO=1
#BLOG_PROXY_XHOST=1
# 密码找回令牌有效期(秒,默认 1800 = 30 分钟)
#BLOG_RESET_TOKEN_MAX_AGE=1800
# SMTP 与管理员邮箱在「管理后台 → 系统设置」中填写,不从环境变量读取
# 初始管理员(仅 SQLite 首次建表写入一次,MySQL 请手动 INSERT)
BLOG_INIT_ADMIN_USER=admin
# 首次启动需要设置;建表后修改密码请走「后台 → 改密码」
BLOG_INIT_ADMIN_PWD=