备份 / 远程存储 / 从节点 / Webhook / 序列号规则
适用角色：系统管理员（admin）
本节涉及的所有功能都集中在左侧主菜单 设置（config） 中。进入「设置」后会看到一面「卡片墙」，每张卡片是一个设置模块，点一下卡片就进入对应页面。本节讲解其中与数据安全、基础设施和系统维护相关的几张卡片：存储设置、系统备份、被控设置、Webhook、资产序列号规则、版本信息。
卡片墙顶部有一个搜索框，输入关键字（如"备份""存储"）可快速过滤出对应卡片。
一、先搞懂几个名词（小白必读）
| 名词 | 一句话解释（生活类比） |
|---|---|
| 系统备份 | 给整套管理系统的数据拍一张"照片"存起来。万一系统出故障、数据被误删，可以用这张"照片"还原到当时的状态。就像手机定期把通讯录、照片备份到云盘。 |
| 存储设置 / 远程存储 | 备份文件、录屏文件不放在本机硬盘，而是上传到另一台远程的存储服务器或云盘保管。好比你不把重要文件只锁在自己抽屉里，而是另存一份到银行保险柜，本机坏了也不怕。 |
| 被控 / 从节点（Slave / 节点 Agent） | 这套管理系统的"主控大脑"通常装在一台中心服务器上；但真正去机房里给客户的服务器"装系统、开关机、采集数据"的活，要靠分布在各个机房的小助手程序来干，这个小助手就叫"被控"或"从节点"。主控发命令，被控在机房现场执行。一个机房（数据中心）一般部署一个被控。 |
| Webhook（网络回调通知） | 当系统里发生某件事（比如某个事件触发），系统会自动往你指定的一个网址（URL）"打个电话"，把这件事的信息推送过去。常用于对接企业微信、钉钉机器人、自建的告警平台。好比"事件一发生就自动通知你"。 |
| 序列号规则（资产序列号） | 给每一台服务器、每一批配件自动起一个**唯一编号（资产编号）**的命名模板。就像快递单号、身份证号的生成规则，按你定的格式自动拼出来。 |
| 版本信息 / 系统更新 | 给管理系统本身（以及各机房被控程序）升级到新版本，类似手机系统的"检查更新"。 |
| 数据中心（机房） | 放服务器、交换机的机房。被控按数据中心划分。 |
| SSL 证书 / 域名 | 让浏览器、主控与被控之间的通信加密、显示"安全小锁"的凭证。（详见《IDC 术语速查表》） |
| Cron（定时任务时间表） | 一种"每隔多久执行一次"的时间表达方式，例如"每天 03:00 执行"。（详见《IDC 术语速查表》） |
提示：本节多个模块互相有关联——例如先配好"存储设置"，才能在"系统备份"里选存储位置。建议按本节顺序阅读。
二、存储设置——所有备份与录屏的"保险柜"
2.1 列表能看到什么
| 列名 | 含义 |
|---|---|
| 名称 | 你给这个存储位置起的名字，例如"阿里云备份桶""机房 A 的 FTP" |
| 存储用途 | 这个存储用来放哪几类文件，可同时勾选多个：系统备份 / 交换机备份 / 会话录制 |
| 连接协议 | 用什么方式连到远程存储（见下表） |
| 操作 | 修改、删除 |
系统内置一个 ID 为 1 的默认存储，列表里它不显示删除按钮，不能被删除，只能修改。
📷 （界面截图待补 充：存储设置列表页，展示名称、存储用途、连接协议、操作列，以及右上角的「添加」按钮）
2.2 支持的连接协议（存储类型）
| 协议 | 通俗解释 |
|---|---|
| FTP | 最常见的文件传输方式，连到一台 FTP 文件服务器。 |
| SFTP | 加密版的 FTP，通过 SSH 安全通道传输，更安全。 |
| AliyunOSS | 阿里云对象存储（云盘）。 |
| S3OSS | 兼容 Amazon S3 协议的对象存储（很多云厂商/私有云都兼容此协议）。 |
| TencentOSS | 腾讯云对象存储。 |
2.3 新增一个存储位置（操作步骤）
1.
2.
3.
4.
5.
6.
7.
8.
重要：用途只能加不能减。 修改已有存储时，"存储用途"这一项会被锁定为只读，无法在原有基础上去掉已勾选的用途（系统会以 409 错误拦截并提示）；这是为了避免还有文件存在该用途下却被切走导致丢失。
删除存储的注意事项： 如果这个存储下还存着备份或录屏文件，直接删除会被拦截，系统会弹出二次确认（提示"需要强制删除？"）。确认强制删除后，该存储下关联的备份文件、录屏文件会被一并删除，请务必谨慎。
三、系统备份——给数据拍快照
备份分两类： 系统备份：备份整套管理系统的数据库数据。 交换机备份：备份网络交换机的配置。 两类都需要先在"存储设置"里建好对应用途的存储位置。
3.1 备份列表（手动备份 + 历史记录）
| 列名 | 含义 |
|---|---|
| 文件名 | 备份文件的名称 |
| 文件大小 | 备份文件大小；如果这条记录正在生成中，这里会显示"备份中" |
| 存储名称 | 这份备份存放在哪个存储位置 |
| 备份类型 | 系统备份 / 交换机备份 |
| 时间 | 备份生成的时间 |
| 操作按钮 | 作用 |
|---|---|
| 还原备份（撤销箭头图标） | 用这份备份把系统数据还原回当时的状态 |
| 下载备份（云下载图标） | 把这份备份文件下载到本地电脑保存 |
| 删除（垃圾桶图标） | 删除这份备份文件 |
立即做一次手动备份
1.
2.
3.
4.
5.
📷 （界面截图待补充：手动备份弹窗，展示存储位置下拉和备份类型多选（系统备份/交换机备份），底部取消/确定按钮）
注意事项： 同一类备份不能并发：如果系统里已经有一个同类型备份正在排队或执行中，再次发起会被拦截并提示"正 在备份中"。 还原操作只支持"系统备份"，交换机备份不支持一键自动还原（系统会拦截并提示）。点还原前会二次确认"确定要还原数据库?"，请务必慎重；还原成功后会提示"还原数据库成功"。
还原是高危操作： 还原会改写当前数据库数据。执行还原（以及第七节的系统更新）期间，请勿同时执行"重装系统""重置密码"等任务。
3.2 自动备份（按计划定时备份）
| 列名 | 含义 |
|---|---|
| 名称 | 你给这条计划起的名字 |
| Cron表达式 | 这条计划的定时规则（系统会把它翻译成可读的执行周期展示） |
| 下次执行时间 | 系统算出的下一次将要执行的时间 |
| 存储名称 | 备份要存到哪个存储 |
| 备份类型 | 系统备份 / 交换机备份 |
新增一条自动备份计划
1.
2.
3.
4.
5.
6.
📷 （界面截图待补充：新增自动备份计划弹窗，展示存储位置、计划任务名称、Cron 可视化周期配置器、备份类型下拉）
四、被控设置——把机房里 的"执行小助手"纳管进来
"纳管"是什么意思？= 把一台已经在机房装好的被控程序，登记到主控系统里，让主控认识它、能向它下发命令。纳管的过程就是下面的"添加被控"。
4.1 列表能看到什么
| 列名 | 含义 |
|---|---|
| 名称 | 被控的名字 |
| 数据中心 | 这个被控所属的机房 |
| IP地址 | 被控对外的 IP（主控通过它连接被控） |
| 内网IP | 重装系统时被控在内网的监听地址 |
| 证书 | 绑定的 SSL 证书名称（用于 加密通信） |
| 域名 | 被控使用的域名 |
| 域名过期时间 | 绑定证书的到期时间 |
| 已安装 | 该被控是否已成功安装/接入（是/否） |
| 创建时间 | 纳管登记的时间 |
| 操作 | 修改、删除 |
4.2 添加（纳管）一个被控
前置条件：机房里那台被控程序已经装好并在运行；你需要拿到它的 key 和 password（接入凭据，由部署被控时设定）。
1.
2.
3.
4.
5.
6.
7.
8.
9.
修改与删除： 修改被控信息时同样会做连通性校验。 新增时填的 key / password 出于安全考虑不会在列表或表单里回显。 删除被控前会二次确认" 确定要删除 N 个被控?"。
关于被控程序自身的升级： 被控 Agent 程序也会出新版本，但升级被控不在"被控设置"页面里操作，而是和主控一起放在第七节的「版本信息」页面统一管理（那里会把主控和所有被控逐个列出，各自检查/下载/更新）。
五、Webhook——事件自动外推通知
5.1 列表能看到什么
| 列名 | 含义 |
|---|---|
| 名称 | 这条 Webhook 的名字 |
| Url | 事件发生时系统要推送到的目标网址 |
| 事件 | 这条 Webhook 监听了哪些事件 |
| 操作 | 修改、删除 |
5.2 新增一条 Webhook
1.
2.
3.
https://...；填错格式系统会校验拦截）。4.
5.
说明： "事件"下拉里的可选项由系统自动汇总得出，只列出支持回调的事件，列表内容随版本可能不同（具体可选事件视部署版本而定）。 目标 URL 需要能从主控服务器访问到；接收方需自行解析推送过来的事件数据。 删除 Webhook 前会二次确认。
六、资产序列号规则——自动给资产编号
6.1 列表能看到什么
| 列名 | 含义 |
|---|---|
| ID | 规则编号 |
| 序列号名称 | 规则的名字 |
| 序列号组成 | 这条规则的格式模板（原始规则字符串） |
| 操作 | 修改、删除 |
📷 （界面截图待补充：序列号规则列表页，展示 ID、序列号名称、序列号组成、操作列与右上角「添加」按钮）
6.2 规则怎么写（占位符说明）
| 占位符 | 替换成什么 | 示例 |
|---|---|---|
{#TYPE#} | 类型编号（按资产类型自动生成的编号） | 例如某类型 → 001 |
{#NUMBER#} | 随机 4 位数字 | 例如 4821 |
{#FLAT_DATE#} | 当天日期，格式 YYYYMMDD | 例如 20230109 |
SRV-{#FLAT_DATE#}-{#NUMBER#}，生成的序列号可能是 SRV-20230109-4821。1.
2.
3.
4.
注意事项： 生成出来的序列号总长度不能超过 27 个字符，否则保存会被拒绝（提示序列号过 长）。请控制固定前缀的长度。 如果某条规则已经被某个配件批次或服务器使用，则不能删除（系统会拦截并提示该规则已被使用）。
七、版本信息 / 系统更新——给主控与被控统一升级
7.1 当前版本与更新通道
📷 （界面截图待补充：版本信息页左右两张卡片：左「当前版本」展示当前通道、当前版本号、切换/检查更新按钮，下方按主控与各被控折叠展示版本日志；右「新版本」卡片）
7.2 检查、下载与更新
📷 （界面截图待补充：右侧「新版本」卡片检测到新版本后的状态，展示新版本号、更新日志、立即下载/立即更新按钮，以及主控、各被控逐节点的下载/更新进度）
重要警告： 更新（应用新版本）会重启相关服务、终止正在执行的系统任务。请在更新前确保没有重要任务在跑。 更新和下载期间，请勿执行"重装系统""重置密码"等任务；如有需要，待更新完成后再执行。 被控的下载/更新在机房本地进行，更新时被控会短暂重启；建议错峰、逐个进行。
八、常见问题与排错
| 现象 | 可能原因 / 解决思路 |
|---|---|
| 手动备份时存储位置下拉为空 | 还没在「存储设置」里建好"系统备份/交换机备份"用途的存储，先去配置存储。 |
| 备份提示"正在备份中" | 已有同类型备份在排队或执行，等它跑完再发起。 |
| 交换机备份不能还原 | 设计如此，自动一键还原仅支持"系统备份"。 |
| 修改存储时去不掉已选用途 | 设计如此，用途只能加不能减；如确需调整请新建存储。 |
| 删除存储被拦截、要求强制删除 | 该存储下还存有备份/录屏文件；强制删除会连同这些文件一并删除，请谨慎。 |
| 添加被控失败（连接失败/凭据错误） | 检查被控 IP、key、password 是否正确，机房被控程序是否在运行、网络是否放通。 |
| Webhook 保存失败（Url 不合法） | Url 必须是合法网址（如 https://...）；名称长度需在 1～200 字之间。 |
| Webhook 收不到通知 | 确认 URL 合法且主控能访问到该地址；确认选对了事件。 |
| 序列号规则保存失败（过长） | 生成结果超过 27 字符，缩短固定前缀。 |
| 序列号规则删不掉 | 规则已被某批次或服务器使用，需先解除占用。 |
| 版本"检查更新"后无反应 | 若提示"已是最新版本"即为正常；否则检查主控与被控的网络是否能访问更新源。 |
关联阅读：「存储设置」也是**远程会话录制（录屏）**文件的存放地；录屏相关使用见对应章节。被控（从节点）在重装系统、远程控制台、检测工具等功能里都会用到，详见相关章节。
修改于 2026-06-26 08:26:04