站点与界面设置

平台的品牌、文案、导航和界面开关都存放在数据库系统设置里，在后台「系统设置」中修改。本页汇总常用的展示类设置项。运行参数（端口、数据库、JWT 等）见环境变量。

品牌与文案

设置键	默认	说明
`site_name`	`flai`	站点名称
`base_url`	空	站点对外基础地址，用于拼接支付回调等，务必设为对外 HTTPS 域名
`icon_url`	空	站点图标地址
`footer_text`	空	页脚文案
`about_html`	空	「关于」页 HTML 内容
`home_iframe_url`	空	首页可嵌入的外部页面地址
`privacy_policy`	空	隐私政策
`terms`	空	服务条款
`announcement`	空	站点级横幅公告

设置键	默认	说明
`top_nav_enabled`	`false`	是否启用自定义顶部导航
`top_nav_items`	空	顶部导航项（JSON）

控制后台侧边栏各入口的显隐，便于按需裁剪界面：

设置键	默认
`sidebar_dashboard_enabled`	`true`
`sidebar_usage_enabled`	`true`
`sidebar_wallet_enabled`	`true`
`sidebar_data_board_enabled`	`true`
`sidebar_api_keys_enabled`	`true`
`sidebar_chat_enabled`	`true`
`sidebar_images_enabled`	`true`
`sidebar_settings_enabled`	`true`
`sidebar_system_enabled`	`true`
`sidebar_admin_overview_enabled`	`true`
`sidebar_channels_enabled`	`true`
`sidebar_models_enabled`	`true`
`sidebar_users_enabled`	`true`

关闭某项只是隐藏入口，不代表关闭后端能力——真正关闭功能要用对应的功能开关（如 payment_enabled、checkin_enabled）。

设置键	控制的功能
`payment_enabled`	支付与充值
`checkin_enabled`	签到
`referral_enabled`	邀请返佣
`status_monitor_enabled`	状态监控页
`pricing_endpoint_enabled`	公开定价端点 `GET /api/pricing`
`rate_limit_enabled`	限流
`sensitive_filter_enabled`	敏感词过滤
`ssrf_protection_enabled`	SSRF 防护
`oidc_enabled` / `passkey_enabled` / `password_login_enabled`	登录方式

公开 vs 管理设置

GET /api/public/settings 只返回展示类、非敏感设置；OIDC 密钥、SMTP 密码、支付密钥等仅在管理员的 GET /api/settings 中返回。修改时通过 PUT /api/settings 提交。

用于发送注册/改密验证码等邮件：

启用邮箱验证（email_verification_required）前，请先配置好 SMTP，否则验证码无法送达。