Repository navigation
Quick Start
本文档介绍 FlecBlog 管理后台的登录认证、管理端结构以及常见页面布局，帮助你快速了解后台的基础使用方式和主要功能模块。
在浏览器中访问管理后台地址后，系统会先检查当前用户的登录状态。未登录的用户会自动跳转到登录页面；登录成功后，则可进入后台首页继续操作。
登录页面采用简洁的卡片式布局，页面主要包含以下元素：
整体设计偏向简洁和直接，便于用户快速完成登录。
用户登录后台时，整体流程如下： 输入邮箱和密码 点击“登录”按钮提交表单 系统对凭据进行校验 校验通过后返回 Token Token 自动存储到本地 页面跳转到管理后台首页 这个流程在大多数情况下是自动完成的，用户只需要输入正确的登录信息即可。
登录成功后，系统会在本地存储两种 Token，用于维持登录状态与后续接口认证。 其中，access_token 用于日常接口访问；当访问令牌失效时，系统会使用 refresh_token 获取新的访问令牌，从而避免用户频繁重新登录。
管理后台左侧菜单包含多个功能模块，用于内容管理、互动管理和系统管理。整体结构如下： 从结构上看，后台功能划分比较清晰：
管理后台整体采用“左侧导航 + 右侧内容区”的经典布局方式： 左侧为固定宽度的导航栏，支持折叠 右侧为主内容区，自适应页面宽度 顶部通常显示当前页面标题与面包屑导航 这种布局便于在后台功能较多时保持较高的可用性，也方便用户快速在不同模块之间切换。
为了适配不同终端设备，后台还支持响应式布局：
这意味着无论是在电脑还是移动设备上访问后台，都能获得相对清晰的操作体验。
管理后台首页的仪表盘主要用于展示系统的整体运行概况和核心统计信息，帮助管理员快速了解当前站点状态。
顶部区域通常包含以下内容：
这个区域主要用于增强首页的信息感和使用氛围，同时快速反馈系统的基础规模数据。
仪表盘中的概况卡片通常包含四个统计卡片，用于展示关键业务指标的增长情况，例如： 浏览量 访客量 评论数 用户数 每个卡片通常会显示： 总量 今日新增数量 增长率 通过这些指标，管理员可以快速了解站点的访问与互动变化趋势。
图表区域主要用于更加直观地展示数据分布和趋势，常见内容包括：
这些图表可以帮助管理员从趋势、分类、标签和活跃度等不同角度观察网站内容生态。
仪表盘中还提供常用链接入口，通常包括： 主页 博客 GitHub 文档 通过快捷访问区域，管理员可以快速跳转到常用页面，提高后台操作效率。
在“系统管理 → 系统信息”页面中，可以查看服务器与系统运行状态，用于辅助日常运维和问题排查。
系统信息页面中的数据分为动态信息和静态信息，两者刷新方式不同：
这种机制既能保证关键状态数据的实时性，又能避免不必要的重复请求。
服务器信息通常包括以下内容： 主机名 操作系统 IP 时区 运行时间 这些信息用于快速确认当前服务部署环境的基本状态。
CPU 信息通常展示： 核心数 使用率 型号 架构 系统负载 在界面表现上，系统负载通常会结合进度条颜色进行区分：
- 绿色：低于 50%
- 橙色：50%～80%
- 红色：高于 80% 这种可视化方式有助于管理员快速判断服务器是否处于高负载状态。
内存信息一般包括： 总容量 已用量 使用率 未使用容量 Swap 信息 通过这些指标，可以判断当前服务的内存使用情况是否稳定，是否存在资源紧张的风险。
磁盘信息通常包含： 总容量 使用率 已用空间 未使用空间 这部分数据主要用于监控磁盘剩余空间，避免因存储不足导致系统运行异常。
数据库信息通常包括： 数据库类型 当前状态 数据库大小 表数量 连接数 通过数据库状态页，管理员可以快速确认数据库运行是否正常，以及当前数据库规模情况。
系统还会展示一些外部服务的连通状态，例如： 文件存储 邮箱通知 飞书交互服务 这些状态信息有助于快速定位外部依赖是否可用，尤其在文件上传、通知发送或第三方交互异常时非常有帮助。
为了帮助你更快理解 FlecBlog 的整体页面结构，下面整理了博客端与管理端的主要路由信息，便于在使用、测试和配置时快速定位页面。
| Token 类型 | 说明 | 用途 |
|---|---|---|
| access_token | 访问令牌 | API 请求认证 |
| refresh_token | 刷新令牌 | access_token 过期后刷新 |
| 模块 | 说明 |
|---|---|
| 仪表盘 | 首页，展示系统概览数据 |
| 内容管理 > 文章管理 | 文章列表、新增、编辑、分类标签管理 |
| 内容管理 > 动态管理 | 动态说说管理 |
| 互动管理 > 友链管理 | 友情链接管理 |
| 互动管理 > 评论管理 | 评论审核、回复管理 |
| 互动管理 > RSS订阅 | RSS 订阅源管理 |
| 互动管理 > 反馈投诉 | 用户反馈和投诉管理 |
| 系统管理 > 用户管理 | 用户列表、新增、编辑、角色权限 |
| 系统管理 > 文件管理 | 上传文件管理 |
| 系统管理 > 菜单管理 | 前台菜单配置管理 |
| 系统管理 > 访问日志 | 系统访问日志查看 |
| 系统管理 > 系统信息 | 系统运行信息查看 |
| 系统管理 > 系统设置 | 基础设置、通知设置、博客设置、AI 设置、OAuth 设置、导入导出等 |
| 地址 | 标题 | 说明 |
|---|---|---|
| / | 首页 | 文章瀑布流列表，支持分页 |
| /posts/[slug] | 文章详情 | 文章正文、标签、评论、上一篇/下一篇导航 |
| /moment | 动态 | 瀑布流展示动态内容 |
| /friend | 友链 | 友链展示与申请 |
| /about | 关于 | 博主介绍、站点统计、联系方式 |
| 地址 | 标题 | 说明 |
|---|---|---|
| /posts | 文章列表 | 所有已发布文章 |
| /categories | 分类 | 所有文章分类 |
| /category/[slug] | 分类详情 | 某分类下的所有文章 |
| /tags | 标签 | 所有文章标签 |
| /tag/[slug] | 标签详情 | 某标签下的所有文章 |
| /archive | 归档 | 按年月归档文章 |
| /archive/[year]/[month] | 月度归档 | 某年月的文章列表 |
| 地址 | 标题 | 说明 |
|---|---|---|
| /message | 留言 | 信封式留言板 |
| /feedback | 反馈 | 问题反馈提交 |
| /notifications | 通知 | 用户通知消息 |
| 地址 | 标题 | 说明 |
|---|---|---|
| /login | 登录 | 用户登录入口 |
| /profile | 个人中心 | 用户个人信息管理 |
| /subscribe | 订阅 | RSS 订阅管理 |
| 地址 | 标题 | 说明 |
|---|---|---|
| /privacy | 隐私政策 | 站点隐私政策说明 |
| /cookies | Cookie 政策 | Cookie 使用说明 |
| /copyright | 版权声明 | 内容版权说明 |
| 地址 | 标题 | 说明 |
|---|---|---|
| /statistics | 统计 | 站点数据统计展示 |
| /ask | 提问 | 常见问题解答 |
| /oauth/callback | 第三方登录回调 | OAuth 登录回调页面 |
| /404 | 404 | 页面不存在 |
| 地址 | 标题 | 说明 |
|---|---|---|
| /admin | 仪表盘 | 数据概览、快捷入口 |
| /admin/login | 登录 | 后台登录入口 |
| 地址 | 标题 | 说明 |
|---|---|---|
| /admin/article | 文章管理 | 文章列表、新增、编辑、删除 |
| /admin/article/create | 新增文章 | 创建新文章 |
| /admin/article/[id] | 编辑文章 | 编辑已有文章 |
| 地址 | 标题 | 说明 |
|---|---|---|
| /admin/user | 用户管理 | 用户列表、编辑、删除 |
| /admin/comment | 评论管理 | 评论审核、编辑、删除 |
| /admin/feedback | 反馈管理 | 用户反馈列表与详情 |
| /admin/moment | 动态管理 | 动态列表、新增、编辑、删除 |
| 地址 | 标题 | 说明 |
|---|---|---|
| /admin/friend | 友链管理 | 友链列表、新增、编辑、删除 |
| /admin/links | 链接检测 | 友链可访问性检测 |
| 地址 | 标题 | 说明 |
|---|---|---|
| /admin/setting | 系统设置 | 基础、AI、博客、微信、OAuth 等配置 |
| /admin/menu | 菜单管理 | 聚合菜单、导航菜单、页脚菜单配置 |
| /admin/file | 文件管理 | 上传文件列表与管理 |
| /admin/rssfeed | RSS 订阅 | RSS 源管理与更新 |
| 地址 | 标题 | 说明 |
|---|---|---|
| /admin/visit | 访问记录 | 访客与访问统计记录 |
| /admin/system | 系统 | 系统配置信息 |
相关页面：