Skip to main content

Module settings

Module settings 

Source
Expand description

站点配置页面模块(页脚 GitHub 链接等公开配置)。 后台「站点配置」页面(滚动联动分区布局)。

左侧分类导航 + 右侧滚动内容的布局(2026 admin UX 最佳实践),将全部站点级 配置集中到一处。分区按功能域组织:

  • 站点:页脚 GitHub 链接等公开配置(前台可见)
  • 安全:CSRF 可信源、cookie Secure、代理层数、并发会话上限(即时生效)
  • 缓存:图片磁盘缓存容量与保留策略(即时生效)
  • 素材清理:无引用图片自动清理开关与保留天数(即时生效)
  • 备份:自动备份调度与保留份数(即时生效,备份操作仍在 /admin/system)
  • 回收站:自动清理开关与保留天数(即时生效)
  • 上传:素材上传弹窗并发数(即时生效)
  • 系统:只读展示启动时配置(数据库、日志、Docker 等,需重启生效)

与 tab 切换不同,全部分区常驻挂载、纵向堆叠在同一个滚动容器里:

  • 点击左侧导航 → 容器 scroll-smooth + scrollIntoView 平滑滚动到对应分区;
  • 手动滚动 → scroll-spy(复用 changelog.rs 的 getBoundingClientRect 判定线 模式)实时同步左侧高亮;
  • 点击触发的平滑滚动期间用「世代锁」抑制 spy,避免途经分区依次闪过高亮。

各分区拆分为独立子模块,状态完全独立、互不共享,全部挂载后各自存活。

仅 WASM 前端交互(照 mcp.rs / friends.rs 的 #[cfg(target_arch = "wasm32")] 门控模式)。

Re-exports§

pub use SiteSettingsPage_completions::Component::SiteSettingsPage;

Modules§

backup_section 🔒
自动备份调度分区(调度开关、执行时间、保留份数、是否含 uploads)。
cache_section 🔒
图片磁盘缓存配置分区。
image_section 🔒
图片处理配置分区(WebP 编码 + 尺寸上限 + 尺寸缓存 TTL)。
purge_section 🔒
孤儿素材自动清理分区(启用开关 + 保留天数)。
ratelimit_section 🔒
限流配置分区(各接口速率限制)。
runner_section 🔒
代码运行器配置分区(沙箱资源限制)。
security_section 🔒
安全配置分区(CSRF 可信源、cookie Secure、代理层数、并发会话上限)。
site_section 🔒
站点公开配置分区(页脚 GitHub 链接)。
system_section 🔒
系统启动配置分区(只读展示)。
trash_section 🔒
回收站自动清理分区(启用开关 + 保留天数)。
upload_section 🔒
素材上传并发数分区(从原 settings.rs 提取)。

Enums§

SettingsSection
设置页面的分区枚举。

Functions§

SiteSettingsPage
管理后台站点配置页面(滚动联动分区布局)。
render_section 🔒
渲染单个分区组件。全部分区常驻挂载,各分区状态独立、互不共享。