设置

本节详细介绍后台设置页面中各设置项的作用。

基本信息

四项都展示在前台，长度按字符数计：

说明：

1. 数据库里没有值时，前三项分别回落到 site.config.ts 的 site.name、site.url、seo.description。备案号没有对应项，为空。
2. 站点名称用在导航栏的站名、页脚的版权行，以及各页面的标题（页面名 - 站点名，首页标题就是站名本身）；RSS 的频道标题也取它。
3. 站点地址用在页面的 canonical 与 og:url、站点地图、文章页的分享链接与二维码、RSS 的频道链接与自引用地址，以及登录用户发表评论时预填的「网站」一栏。
4. 站点描述目前只用在 RSS 的频道描述上，留空时改用「站点名称 - 最新文章」。
5. 更换域名时，需要同时修改 site.config.ts 并重新构建：防镜像跳转目标、/api/* 的 referer 白名单、CSP 与静态资源 CDN 前缀均取自构建期配置，仅修改后台设置会导致部分配置生效、部分配置仍保持原值。

评论设置

控制评论是否开放、如何显示，以及提交时要满足哪些条件：

说明：

1. 选「百度内容审核平台」后会展开 API Key、Secret Key 与「验证管理员评论」三项，评论在入库前先送审，此时「评论审核」不再参与判定。送审异常时按待审核处理，不会直接放行。百度内容审核平台的 API Key 与 Secret Key 请从 百度内容审核平台 获取。
2. 发布间隔由服务端按同一 IP 校验，不只是输入框旁的倒计时。
3. 头像服务决定评论头像使用哪个镜像站，更换服务不会影响已入库的评论，因为头像地址会根据邮箱实时计算。

外观设置

首页文字、页脚播放器的歌单与图片分类的位置，三项都是文本、都有长度上限：

说明：

1. 音乐来源可选 netease、tencent、xiami、kugou、baidu、kuwo。
2. 图片分类 Slug 填写分类在 URL 中的 slug（小写字母、数字、连字符）。首页图片瀑布流使用该分类，「查看全部图片」也链接至该分类；该分类页会使用宽版瀑布流。

附件上传

上传策略与腾讯云 COS 字段，前者二选一、后者七项，均为文本：

说明：

1. 本地存储会落到 public/uploads/{年}/{月}/，该路径已被 .gitignore 忽略；生产环境请随部署持久化或挂到持久卷，详细介绍请参照 附件 章节。
2. SecretId 与 SecretKey 都在腾讯云控制台 API 密钥管理 中获取，切勿在源码或前端任何位置硬编码。
3. 存储桶名称可在腾讯云 COS 控制台的存储桶列表里查看。
4. 上传后的图片后缀填 webp、avif、jpg 等，目标后缀的 MIME 由服务端按映射表重写；视频文件不受此项影响。

高级设置

用户会话、邮件通知与搜索缓存三类配置，共 16 项：

说明：

1. Session 存储三种行为：内存（重启丢失）、文件（落 .sessions/，重启保留）、数据库（支持多实例）；切换后所有用户需重新登录。
2. 搜索缓存依赖 Redis，需在 site.config.ts 内配置 build.redis.enabled=true 才能生效。
3. 邮件发送日志始终写入文件，不再有开关；日志格式、落点与归档方式见 日志系统。
4. 通知站长总开关默认关闭，错误日志、评论、友链三个子开关默认开启；总开关不开启时任何通知都不会发送。

本页还提供了数据备份与恢复：导出全站数据为 JSON 备份，导入会清空并覆盖现有数据且不可撤销，请先做好备份；备份包含文章、评论、分类标签、友链、旅行地点、订阅、站点设置等业务数据，不含用户账号与登录会话。

说明：

1. 备份里的所有密钥字段（smtpPassword、cosSecretId、cosSecretKey、baiduApiKey、baiduSecretKey）一律以明文落进 JSON，不做掩码，请妥善保存备份文件。
2. 导入备份会原样恢复这些密钥字段；唯一的例外是 sessionStoreType（Session 存储方式），它与部署环境绑定，会保留本机原值不被覆盖。
3. 保存设置时，所有密钥字段都按表单提交值写入；如需保留某个密钥的现有值，请不要清空对应输入框，否则保存后会被覆盖为空字符串。

其他设置

文章分页、订阅缓存与友情链接申请，三项配置：

说明：订阅信息更新间隔生效后会在后台定时刷新 RSS 订阅源；间隔越短越及时，但会加重源站请求压力。