全局设置

📅 2026-11-21 👁️ 1

全局设置

全局设置用于配置整站的基础信息、访问地址、运行状态、SEO 状态和自定义参数。这里的配置会被模板标签调用,并影响前台页面的地址生成、资源加载和访问方式。

入口路径

后台顶部菜单 → 「设置」→「全局设置」。

实际地址:/system/setting/system。需要管理员权限(canAdmin)。

功能说明

全局设置分为四个标签页:

  • 基础信息:网站名称、Logo、Ico 图标、备案号码、版权信息、默认语言包。
  • 访问地址:网站地址、前台地址、移动端地址、后台地址。
  • 运行与 SEO 状态:网站状态、对搜索引擎的可见性、站点模式。
  • 自定义参数:补充任意键值对,供模板按名称调用。

界面截图

「访问地址」标签页,用于配置整站的访问地址:

全局设置 - 访问地址

「运行与 SEO 状态」标签页,用于控制站点是否可访问、搜索引擎是否可抓取、站点模式:

全局设置 - 运行与SEO状态

设置项说明

基础信息

设置项 作用 取值 / 默认 怎么选 / 填写建议 影响 / 注意
网站名称 作为网站标题后缀附加到网页标题上 文本,必填,源码未注明默认值 [源码] 建议填写品牌名 修改后立即影响前台页面标题
网站 LOGO 上传站点 Logo 供模板调用 图片上传,无默认 [源码] 按模板尺寸上传 尺寸不符会拉伸变形
Ico 图标 生成 favicon.ico 到 public 目录 图片上传,支持 jpg/png/gif/webp/ico/bmp [源码] 上传方形图标 浏览器缓存旧图标需强刷
备案号码 供模板生成备案链接 文本,无默认 [源码] 如 渝ICP备00000000号,只填主体备案号、不加 -1 后缀 没有备案可留空
版权信息 页脚版权文字 文本域,支持 HTML [源码] 可填写 <p>...</p> 由模板调用输出
默认语言包 前端内置文字的显示语言 select 动态语言列表,无默认 [源码] 中文站选 zh 多语言站点需配合多语言功能

访问地址

设置项 作用 取值 / 默认 怎么选 / 填写建议 影响 / 注意
网站地址 生成整站**地址的基础 URL 文本,必填,无默认 [源码] 填完整可访问 URL,如 https://www.example.com 错误会导致前台 CSS/JS/图片无法加载
前台地址 前后端分离时单独指定前台域名 文本,留空则用网站地址 [源码] 仅前台独立域名(如 Next.js)时设置 —
移动端地址 PC+手机双模板模式的手机端域名 文本,无默认 [源码] 只有 PC+手机站模板需要 —
后台地址 后台入口路径 文本,后缀 /system/,默认 /system/ [源码+实测] 设置独立后台域名时需先解析绑定 不能填写本站域名,否则无法访问后台

运行与 SEO 状态

设置项 作用 取值 / 默认 怎么选 / 填写建议 影响 / 注意
网站状态 控制站点是否对外可访问 radio:0正常 / 1闭站 / 2仅蜘蛛可见 [源码] 维护用「闭站」;不希望用户看但保留收录用「仅蜘蛛可见」 Go 注释只写 0/1,前端多一个值 2,以界面为准
闭站提示 闭站时显示的提示内容 文本域,支持 HTML;仅网站状态为闭站或仅蜘蛛可见时显示 [源码] 写简短维护说明 条件显示,正常状态下不可见
对搜索引擎的可见性 是否允许搜索引擎抓取 radio:0可见 / 1禁止蜘蛛抓取 [源码] 通常保持「可见」 设为不可见时拦截 UA 含 spider/bot 的请求并返回 403
站点模式 控制是否启用商城功能 radio:0普通模式 / 1商城模式 [源码] 内容站保持普通;需要商城时切换 切换有二次确认;只影响入口与接口,不删数据

自定义参数

点击「添加参数」后逐条填写:

设置项 作用 取值 / 默认 怎么选 / 填写建议 影响 / 注意
参数名 模板调用时使用的名称 文本,动态行,无默认 [源码] 保存后自动转驼峰,模板按转换后名称调用 名称变化后模板调用同步改
参数值 该参数对应的内容 文本,无默认 [源码] 可为文字、链接或模板需要的小段内容 由 system 标签输出
备注 仅后台可见的说明 文本,无默认 [源码] 写清参数用途 不输出到前台

配置项详解

网站状态(三值)

出现条件:运行与 SEO 状态标签页始终显示 [实测]。

三个取值:0 正常、1 闭站、2 仅蜘蛛可见(源码 SystemConfig 注释只写 0/1,前端多一个值 2)[COMPUTED]。

推荐值:日常保持「正常」;临时维护用「闭站」;不希望普通用户访问但保留搜索引擎抓取时用「仅蜘蛛可见」。

联动:选择「闭站」或「仅蜘蛛可见」后,「闭站提示」输入框才显示。

填错后果:误选闭站会导致所有访客看到维护页。

站点模式(二次确认)

出现条件:运行与 SEO 状态标签页始终显示 [实测]。

源码中切换商城模式会触发二次确认弹窗(system.tsx)[源码],提示切换只影响入口展示、不删除数据。

选择建议:纯内容站保持「普通模式」;需要商品、订单、支付功能时切「商城模式」。

填错后果:普通模式下商城菜单与前台商城接口全部关闭,误切会影响业务。

后台地址

出现条件:访问地址标签页始终显示 [实测]。

源码与界面明确提示「不能填写本站域名」——设置独立后台域名前必须先解析并绑定域名 [源码+i18n]。

填错后果:填成本站域名或未解析域名会导致后台无法访问,需要通过数据库或服务器配置恢复。

操作步骤

  1. 进入「设置 → 全局设置」。
  2. 在对应标签页修改需要调整的项。
  3. 点击页面底部「提交」保存。
  4. 清空站点缓存并访问前台,确认修改生效。

适用场景与建议

  • 上线前:优先核对「网站地址」和「后台地址」,这两项直接决定前台能否正常打开。
  • 临时维护:用「闭站」而不是修改站点文件;维护结束后改回「正常」。
  • 只让搜索引擎抓取、不给普通用户看:使用「仅蜘蛛可见」,不要手动判断 UA。
  • 内容站切换为商城:在「运行与 SEO 状态」切到「商城模式」,已有文档数据不会丢失。
  • 模板需要全局配置:用「自定义参数」维护电话号码、统计代码等,避免写死在模板里。

前台调用示例

全局设置中的字段通过 system 标签调用,语法为 {% system 变量名 with name="字段名" %}。变量名可以省略,省略时直接输出结果。

{# 直接输出网站名称 #}
{% system with name="SiteName" %}

{# 赋值给变量后使用 #}
{% system siteName with name="SiteName" %}
<div>{{ siteName }}</div>

{# 网站 Logo 与备案号 #}
<img src="{% system with name="SiteLogo" %}" alt="{% system with name="SiteName" %}" />
<a href="https://beian.miit.gov.cn/" rel="nofollow">{% system with name="SiteIcp" %}</a>

{# 首页地址与版权信息 #}
<a href="{% system with name="BaseUrl" %}">首页</a>
<div>{% system with name="SiteCopyright" %}</div>

常用字段名:网站名称 SiteName、网站 Logo SiteLogo、备案号 SiteIcp、版权内容 SiteCopyright、首页地址 BaseUrl、手机端地址 MobileUrl、模板静态文件地址 TemplateUrl、模板目录名 TemplateName、闭站提示内容 SiteCloseTips、站点语言 Language。

自定义参数用保存后的驼峰名称调用。例如后台参数名填写 SitePhone,模板中写:

{% system with name="SitePhone" %}

注意事项

  • 网站地址必须是完整、可访问的 URL。填写错误会导致前台页面加载不到 CSS、JS 和图片。
  • 后台地址不要填写本站域名。修改后如果无法访问后台,需要通过数据库或服务器配置文件恢复。
  • 切换商城模式会改变前台可用的功能与菜单,但不会删除已有数据。
  • 「禁止蜘蛛抓取」通过拦截 UA 实现,不能替代 robots.txt 和搜索引擎站长平台的配置。
  • 修改配置后前台未变化,先清理缓存,再确认模板是否使用了对应的标签调用。

相关文档