跳到主要内容

控制面使用指南

本指南面向日常使用 Cirrus CDN 控制面的运营、运维与支持人员，帮助你熟悉仪表盘、站点管理、监控与凭证功能。所有步骤均基于默认的 Web 控制台界面。

1. 快速入门​

登录​

  1. 打开浏览器访问登录页 /login。
  2. 输入 Cirrus CDN 用户名与密码，点击 登录。
  3. 表单显示旋转图标时表示正在验证。成功后页面会跳转到 站点 概览。
  4. 如遇错误提示，请确认凭证或联系管理员重置密码。

小贴士：点击输入框右侧的眼睛图标即可切换密码可见性。

设置语言与主题​

  • 登录后可在右上角使用语言切换器，在英文 EN 与中文 ZH 之间切换；选择会保留在本地浏览器中。
  • 主题切换器支持浅色、深色与跟随系统三种模式，可随时调整界面风格。

认识导航框架​

  • 页面顶部：包含“状态控制台”按钮（打开 Grafana）、语言与主题切换、通知入口以及账户下拉菜单（显示用户名、快捷入口、退出登录）。
  • 主导航：站点、用户管理、服务令牌、修改密码四大模块，在移动端会折叠成标签按钮。
  • 右侧信息栏（桌面端可见）：展示平台健康状态、所选域名的上下文信息，以及返回站点列表的快捷操作。
  • 内容区域：展示当前功能页的详细视图。

2. 站点管理​

点击导航栏中的 站点 进入域名总览。

概览页​

  • 顶部指标卡汇总站点总数、缓存覆盖率、平均源站数量以及开启 ACME 自动化的站点数。
  • 搜索框支持模糊过滤，快速定位目标域名。
  • 站点列表展示域名、缓存状态、源站数量、ACME 模式等信息，点击任意行即可进入详情。
  • 点击 添加站点 打开创建向导。

添加站点​

  1. 输入域名（无需协议前缀）。
  2. 填写至少一个源站地址、端口与协议（默认端口 80，权重 1）。
  3. 点击 添加 保存。成功后会出现提示，并自动跳转到该站点的 访问 页签。

站点子页签​

每个域名拥有多个标签页，可通过顶部面包屑或链接 ?tab= 访问，名称与界面保持一致（概览 / 访问 / 源站 / 规则 / 请求头 / 证书 / 删除）：

  1. 概览：当未选择域名时显示站点清单。
  2. 访问：展示 CDN 访问域名、当前 TTL、路由到的边缘节点列表，并提供复制按钮与刷新操作。如 CNAME 功能未启用会给出说明。
    • 如复制按钮无法写入剪贴板，请在浏览器提示中允许访问权限。
  3. 源站：管理上游池。支持添加、编辑、删除源站，设置协议、端口、权重。右上角的 保存更改 提交修改；指标卡同时统计 TLS 覆盖和权重预算。
  4. 规则：控制缓存策略。可切换全局缓存与分片下载，添加自定义路径 TTL、请求方法、分片设置，并通过 快速清缓存 表单输入路径（需以 / 开头）执行清除。
  5. 请求头：定义发送到源站的自定义请求头。表格支持逐行新增、编辑、删除；保存前会校验必填项。
  6. 证书：管理 TLS。可开启或关闭 ACME DNS-01 自动化，查看 _acme-challenge 主机和目标 CNAME，手动触发证书申请，或上传 PEM 格式的证书链与私钥。状态徽章会实时显示“排队中”“运行中”“已签发”“失败”等信息。
  7. 删除：下线域名。需重新输入域名以启用删除按钮，并在二次确认对话框中最终确认。

建议在每次修改后等待成功提示或绿色状态徽章出现，再切换到其他页面，避免丢失未保存的草稿。

3. 运营常用操作​

快速清除缓存​

  • 打开 站点 -> 规则 标签页。
  • 在 快速清缓存 输入框中填写路径（例如 /images/logo.png）。
  • 点击按钮提交，成功后会在右上角显示提示。边缘节点通常在数秒内完成刷新。

跟踪 ACME 申请​

  • 在 证书 标签页观察状态徽章。如状态长时间停留在“排队中”或“运行中”，请确认 _acme-challenge CNAME 已指向面板所示的目标值。
  • 使用复制按钮快速拷贝 DNS 主机或目标，方便在域名注册商界面粘贴。

查看访问路由​

  • 访问 标签页实时展示当前分配的边缘节点。修改节点配置后可点击 刷新 获取最新映射。

4. 监控与健康检查​

平台状态卡片​

  • 右侧栏展示控制面与边缘状态。正常时标记为绿色，异常时会显示错误信息摘要。
  • 点击卡片内的 刷新 图标可手动获取最新数据。

状态控制台​

  • 顶部的 状态控制台 按钮会在新标签页打开 Grafana 仪表盘（地址由部署配置决定）。
  • 在 Grafana 中可以查看请求量、缓存命中率、节点健康度以及自定义告警。

Prometheus 与告警​

  • 控制面已内置 Prometheus 与告警配置。若需要直接访问或订阅，请联系运维团队协助开通。

5. 账户与团队协作​

用户管理​

  • 用户管理 页面列出所有账号及其邮箱、状态、最近登录时间。
  • 支持操作：
    • 点击 添加用户 创建新账号，设置用户名、邮箱、密码以及启用状态。
    • 使用行内的铅笔图标编辑邮箱或状态。
    • 使用垃圾桶图标删除账号。若未来可能恢复，建议改为切换状态为“已禁用”。

服务令牌​

  • 在 服务令牌 页面粘贴管理员提供的主令牌并点击 保存，系统会将其存入浏览器 localStorage 用于后续 API 请求。
  • 令牌表格显示标签、创建时间、最近使用时间和掩码后缀。
  • 点击 创建令牌 输入标签生成新的服务令牌。页面仅在生成时显示完整密钥，请立即使用复制按钮保存到安全位置。
  • 通过垃圾桶图标可撤销不再使用的令牌。

修改密码​

  • 进入 修改密码 页面，填写当前密码、新密码与确认密码。表单会实时给出强度提示（长度、大小写、数字、特殊字符等要求）。
  • 保存成功后系统会自动退出当前会话，需要使用新密码重新登录。

退出登录​

  • 点击右上角账户菜单中的 退出登录，即可清除会话并返回登录页。

6. 无障碍与效率提示​

  • 表格行支持键盘导航，聚焦后按 Enter 或空格即可进入详情。
  • 所有复制按钮都包含语义化的无障碍说明，协助屏幕阅读器识别操作意义。
  • 主题切换默认跟随系统，适用于在暗光环境下使用。

7. 常见问题速查​

问题排查建议
无法登录核对用户名和密码，如账号被禁用请联系管理员解锁或重置。
列表中找不到域名使用搜索框刷新结果，若仍不存在请确认是否已由管理员创建。
访问页显示 CNAME 未启用当前部署未开启 CNAME 服务，请联系运维确认环境变量配置。
源站修改后无效果确认已点击 保存更改 并收到成功提示，必要时刷新页面再次检查。
缓存清除后资源仍旧旧版本等待约 30 秒，确认输入的路径正确且域名已启用缓存。
ACME 状态长时间停留在“排队中”或“失败”检查 _acme-challenge CNAME 是否指向面板显示的目标，若已正确仍失败请联系运维查看任务日志。
创建服务令牌失败确认顶部主令牌填写正确，可重新保存后再次尝试。
修改密码后被登出系统安全策略要求重新登录，使用新密码即可。

8. 快速索引​

操作位置备注
添加域名站点 -> 添加站点需提供至少一个源站。
查看边缘节点站点 -> 访问支持复制 IP。
更新源站池站点 -> 源站修改后需保存。
调整缓存策略或清缓存站点 -> 规则通配符需由边缘清缓存策略支持。
上传证书或触发 ACME站点 -> 证书ACME 开启后显示 DNS 指南。
删除域名站点 -> 删除需输入完整域名确认。
查看平台健康度右侧状态卡片可手动刷新。
打开监控大屏顶部“状态控制台”在新标签页打开 Grafana。
管理用户用户管理仅对具备权限的账号可见。
管理服务令牌服务令牌生成后立即复制保存。
修改个人密码修改密码成功后需重新登录。

如需部署、系统架构或 API 的深入信息，请查阅 docs/technical.md 或联系运维团队。此文档主要帮助终端用户高效地操作 Cirrus CDN 控制面。***