全局设置
全局设置
全局设置用于配置整站的基础信息、访问地址、运行状态、SEO 状态和自定义参数。这里的配置会被模板标签调用,并影响前台页面的地址生成、资源加载和访问方式。
入口路径
后台顶部菜单 → 「设置」→「全局设置」。
实际地址:/system/setting/system。需要管理员权限(canAdmin)。
功能说明
全局设置分为四个标签页:
- 基础信息:网站名称、Logo、Ico 图标、备案号码、版权信息、默认语言包。
- 访问地址:网站地址、前台地址、移动端地址、后台地址。
- 运行与 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]。
填错后果:填成本站域名或未解析域名会导致后台无法访问,需要通过数据库或服务器配置恢复。
操作步骤
- 进入「设置 → 全局设置」。
- 在对应标签页修改需要调整的项。
- 点击页面底部「提交」保存。
- 清空站点缓存并访问前台,确认修改生效。
适用场景与建议
- 上线前:优先核对「网站地址」和「后台地址」,这两项直接决定前台能否正常打开。
- 临时维护:用「闭站」而不是修改站点文件;维护结束后改回「正常」。
- 只让搜索引擎抓取、不给普通用户看:使用「仅蜘蛛可见」,不要手动判断 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和搜索引擎站长平台的配置。 - 修改配置后前台未变化,先清理缓存,再确认模板是否使用了对应的标签调用。