文档目录

11.1 站点设置

站点设置是系统的基本配置中心,用于配置站点名称、Logo、域名、时区等基础信息,并支持运行时配置动态调整与变更留痕,确保系统上线即就绪。

  • 支持站点名称、Logo、时区等基础配置
  • 实现Portal与Website双域名管理
  • 运行时配置动态生效,无需重启
  • 配置变更自动留痕,可追溯回滚

一句话定位:系统的基本配置中心——站点名称、Logo、域名、时区,一切从"设置"开始。

站点设置是基座的"总开关"——系统长什么样、叫什么名、在哪里运行,都从这里配起。

您现在的问题

场景一:上线后才发现细节没配好。 系统上线了,邮件里的公司名还是默认的"Primefire"、Logo 还是系统的默认图标——给客户的第一印象就打了折扣。72% 的用户会通过"品牌细节"判断一家公司是否专业。

场景二:配置改了不知道谁改的。 域名配置、邮件服务器、系统参数——这些关键配置被改了,但不知道是谁改的、什么时候改的、改之前是什么值。关键配置误改导致的系统故障,平均排查时间超过 2 小时。

场景三:多环境配置混乱。 开发环境和生产环境的配置不一样,但有时候开发环境的配置被意外带到生产——导致邮件发不出去、域名解析错误。环境配置混淆是部署事故的前三大原因。

场景四:功能开关散落各处。 想关掉某个功能、想开启某个实验特性——但不知道在哪里操作,得找开发改代码。配置不集中,每次调整都是"开发任务"。

功能全景

站点设置让"系统上线"变成"系统上线且一切就绪":

基础配置(站点名称/Logo/Favicon/默认语言/时区)
        ↓
域名管理(Portal域名/Website域名 → 双域名模式/端口模式)
        ↓
运行时配置(功能开关/集成配置/API密钥 → 动态生效无需重启)
        ↓
配置版本化(每次变更 → 自动留痕 → 可追溯可回滚)
  • 基础配置。 站点名称、Logo、Favicon、默认语言、时区——系统的基本身份信息,一次配好。
  • 域名管理。 Portal 管理后台和 Website 官网的域名配置——支持双域名模式。
  • 运行时配置。 系统运行参数的动态调整(功能开关、集成配置)——不用重启就能生效。
  • 配置版本化。 每次配置变更自动留痕——谁在什么时间改了什么配置,可追溯可回滚。

操作指南

  1. 基础设置 → 系统 → 站点设置 → 基本信息:修改名称/上传 Logo/选时区;
  2. 域名配置 → 域名管理 → 填写 Portal 域名和 Website 域名 → 保存(nginx 自动重载);
  3. 功能开关 → 运行时配置 → 功能开关列表 → 开启/关闭(即时生效);
  4. 查看变更历史 → 配置变更 → 时间线展示所有变更 → 可一键回滚到任意版本;
  5. 环境隔离 → 开发/生产环境配置独立管理,互不影响。

关键配置项:

  • 站点标识:名称/Logo/Favicon/版权信息
  • 域名:portalDomain/websiteDomain(空则回退端口模式)
  • 功能开关:按模块/按功能独立控制
  • 变更审批:关键配置(域名/密钥)变更需超管确认

最佳实践

  1. 上线前走一遍"配置清单"。 名称、Logo、域名、邮件签名、版权信息——列个清单逐项确认,别等客户发现了再改。
  2. 关键配置"双人确认"。 域名、API 密钥、邮件服务器——这类配置改错了影响全局。设"超管确认"门槛。
  3. 功能开关用于"灰度发布"。 新功能先对 10% 用户开放——确认无问题再全量。开关就是"安全阀"。
  4. 每月检查一次"配置健康"。 有没有过期的 API 密钥?有没有该关但没关的实验功能?

常见误区

误区一:配好了就再也不看。 域名证书会过期、API 密钥会失效、功能开关会遗忘——配置不是"一次性的",是"需要维护的"。

误区二:所有人都能改配置。 站点设置是"系统级配置"——应该只有管理员能改。权限管控从配置入口开始。

与其他能力的配合

  • 域名配置影响 棱镜(第六章)官网的访问;
  • 运行时配置被 灵枢(第十章)的 AI 引擎调用链路读取;
  • 配置变更日志汇入 11.4 审计日志
  • 11.2 邮件短信 的发件人名称和签名在这里配置;
  • 功能开关影响所有模块的可见性。

关键指标

指标健康值说明
配置完整度100%必填项上线前所有必填配置已完成
变更可追溯率100%每次变更都有操作人和时间记录
配置回滚时效<5min发现问题到回滚完成的时间
功能开关清理率季度100%过期实验开关及时清理

常见问题

站点设置主要包含哪些配置项?

站点设置是系统的基本配置中心,主要包含以下配置项:

  • 基础配置:站点名称、Logo、Favicon、默认语言、时区等系统基本身份信息。
  • 域名管理:Portal管理后台和Website官网的域名配置,支持双域名模式。
  • 运行时配置:功能开关、集成配置、API密钥等系统运行参数,可动态调整无需重启。
  • 配置版本化:每次配置变更自动留存记录,支持追溯和回滚。
如何管理多环境(开发、生产)的配置?

站点设置支持针对不同环境(如开发、测试、生产)进行独立的配置管理。通过双域名模式和运行时配置的动态调整,可以有效隔离各环境的配置:

  • 开发环境的配置(如测试域名、调试开关)不会被意外带到生产环境
  • 生产环境的域名、邮件服务器等关键参数独立配置,避免因环境混用导致邮件发不出、域名解析错误等问题。

配置版本化功能还可以帮助识别环境间的配置差异,便于同步和排查问题。

如何确保系统配置变更可追溯?

站点设置通过配置版本化功能实现变更追溯。每次配置变更(如域名、邮件服务器、系统参数等)都会被自动记录,包括:

  • 修改了配置
  • 什么时间修改的
  • 改之前的值和改之后的值

管理员可以随时查看变更历史,并在需要时对配置进行回滚。该功能的变更日志还会汇入 11.4 审计日志,形成完整的审计链。

站点设置如何与其他系统(如棱镜、灵枢)配合?

站点设置是系统的基础配置中心,与其他能力有紧密配合:

  • 域名配置影响棱镜(第六章)官网的访问,确保官网域名与系统域名一致。
  • 运行时配置会被灵枢(第十章)的AI引擎调用链路读取,使AI服务能获取正确的系统参数(如API密钥、功能开关)。
  • 配置变更日志汇入 11.4 审计日志,实现统一审计。
  • 发件人名称和签名在站点设置中配置后,供 11.2 邮件短信 使用。