系统配置

.env 环境变量

server/.env 是后端核心配置文件，安装向导会自动生成。以下是关键配置项说明。

数据库

txt

HOSTNAME = 127.0.0.1
HOSTPORT = 3306
DATABASE = yd_admin
USERNAME = root
PASSWORD = your_password

Redis

txt

CACHE_HOST = 127.0.0.1
CACHE_PORT = 6379
CACHE_PASSWORD =

Redis 用于缓存、Session、队列三个用途，分别使用不同的 DB：

用途	DB	说明
缓存	DB 0	TenantRedisDriver 自动按租户前缀隔离
Session	DB 1	前缀 `sess:`
队列	DB 2	ThinkPHP 队列驱动

JWT 认证

txt

# 两套独立密钥，必须不同
JWT_TENANT_SECRET = <openssl rand -base64 48>
JWT_PLATFORM_SECRET = <openssl rand -base64 48>
JWT_TENANT_ISSUER = ydadmin-saas-tenant
JWT_PLATFORM_ISSUER = ydadmin-saas-platform

安全提示

JWT_TENANT_SECRET 和 JWT_PLATFORM_SECRET 必须使用不同的随机字符串，否则跨 scope 的 token 可能意外生效。

SaaS 域名

txt

SAAS_ROOT_DOMAIN = example.com
SAAS_PLATFORM_DOMAIN = admin.example.com
SAAS_GRACE_DAYS = 7

支付配置

txt

# SaaS 级支付（平台收款）
SAAS_PAY_WECHAT_ENABLED = false
SAAS_PAY_ALIPAY_ENABLED = false
SAAS_PAY_NOTIFY_BASE_URL = https://admin.example.com

TIP

租户级支付配置在管理后台「系统配置」中设置，与 SaaS 级支付相互隔离。

管理后台配置

登录管理后台后，在「系统管理 → 系统配置」中可设置：

站点名称 — 显示在浏览器标题栏
站点网址 — 完整 URL 地址
上传配置 — 本地/阿里云 OSS/腾讯云 COS/七牛云
短信配置 — 阿里云短信签名和模板
微信配置 — 公众号/小程序 AppID 和密钥

.env 注意事项

.env 注释里不要写半角括号 ( )，ThinkPHP 的 env 解析器有已知 bug 会导致崩溃。

系统配置 ​

.env 环境变量 ​

数据库 ​

Redis ​

JWT 认证 ​

SaaS 域名 ​

支付配置 ​

管理后台配置 ​