环境变量

模板：源码 .env.example。本地与生产各一份 .env，不要提交。DEBUG=False 时未设 SECRET_KEY 会 ImproperlyConfigured。

Django 核心

变量	本地	生产	必填
SECRET_KEY	可随机	新生长串	生产必填
DEBUG	True	False	是
ALLOWED_HOSTS	localhost,127.0.0.1	portal.bucssa.org	是
CSRF_TRUSTED_ORIGINS	可空	https://portal.bucssa.org	生产必填
SECURE_SSL_REDIRECT	false	true（DEBUG=False 默认 true）	建议
SITE_URL	http://127.0.0.1:8000	https://portal.bucssa.org	是（邮件链接 / Site）
SECURE_HSTS_SECONDS 等	默认即可	见 settings	可选

数据库

变量	说明
DB_NAME / DB_USER / DB_PASSWORD / DB_HOST / DB_PORT	PostgreSQL 连接
DB_SSLMODE	本地留空；Neon 用 require
DB_CONN_MAX_AGE	本地 0；生产可 60

认证与激活码

变量	说明
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET	OAuth 客户端
FIRST_ADMIN_EMAIL	首次 Google 登录匹配则授予全局 admin
ACTIVATION_CODE_ENCRYPTION_KEY	Fernet key；空则从 SECRET_KEY 派生（生产应单独配）

邮件

见 Email。另：MAILING_ENABLED、EMAIL_BACKEND、SUPPORT_EMAIL、RESEND_API_KEY（可替代 EMAIL_HOST_PASSWORD）。

存储与外部服务

见 File Storage、External Services。

代码使用但未写入 .env.example

变量	用途	默认
OPENAI_API_KEY	部长端 AI 生成 JD	未配置则功能报错
OPENAI_MODEL	模型名	gpt-4o-mini
MAILING_INLINE	测试/排障：邮件同步发送	测试 argv 时自动 inline

子页按主题拆开，避免在一张表里混入运行时开关。安全相关另见 Security and Feature Flags。