24 lines
2.7 KiB
Markdown
24 lines
2.7 KiB
Markdown
# 配置备份与资产文件恢复
|
|
|
|
从侧边栏「配置管理」的「配置备份」，点击「导出配置」，填写至少 12 字节的导出口令后点击「确认导出」。下载的 `linkport-backup.json` 固定为加密文件，包含当前目标服务、网关、代理出口、凭据和资产管理中的全部文件，包括尚未被引用的资产。
|
|
|
|
资产原始文件、上传文件名、备注和引用关系一并加密保存。恢复时填写导出时设置的口令，资产文件自动恢复至资产管理；引用同一资产的目标、账号和代理继续通过资产 ID 关联，无需另外逐个下载或上传文件。
|
|
|
|
导出只包含资产管理中实际保存的文件内容。Kubeconfig 资产必须内嵌 CA、客户端证书/密钥和 Token，不接受服务端外部文件引用或 `exec`/`auth-provider` 登录插件，因此其凭据会随加密备份完整保留。旧版本已保存的不安全 Kubeconfig 仍可原样导出，但恢复、预览或合并导入时会重新校验并拒绝，需先在原环境替换为自包含配置。其他配置中的外部文件不会被自动收集，迁移时需另行准备。
|
|
|
|
恢复步骤：
|
|
|
|
1. 停止所有网关，在「配置管理」选择导出的 JSON 文件，在「导入口令（加密文件必填）」中填写导出时设置的口令。
|
|
2. 点击「导入配置」查看预览。系统先校验资源及资产引用，预览显示新增、覆盖或未变更的资源，文件内容和凭据在字段差异中隐藏。
|
|
3. 点击「确认导入」。同 ID 资源覆盖现有配置，文件中的新资源被创建，其他现有资源保留；资产原文、文件名、凭据与引用一并恢复。
|
|
4. 导入的网关保持停止，核对目标地址和监听配置后按需启动。预览后配置发生变化时，需要重新预览再确认。
|
|
|
|
配置备份保留全部资产文件和凭据。配置模板独立用于复用配置结构，保存时仍然脱敏，不能替代完整备份；如果在模板编辑器中手动补入凭据，导出的当前 JSON 会包含这些手动填写的值。
|
|
|
|
配置备份不包含审计日志、个人登录凭据、API Token、历史记录或设备本地的主密钥。需要设备间持续同步时使用独立的「多端同步」菜单，详见 [WebDAV 多端同步](webdav-sync.md)。
|
|
|
|
API 对应关系：
|
|
|
|
- `POST /api/v1/configuration/backup`：请求包含 `passphrase`，返回包含全部资产文件和凭据的加密配置备份；仅个人会话可调用，要求 CSRF 校验，不接受 API Token，响应禁止缓存。
|
|
- `POST /api/v1/configuration/import/preview` 和 `POST /api/v1/configuration/import`：分别预览与提交 `{bundle}`，或 `{backup, passphrase}`；提交时可携带预览返回的 `expectedRevision`。
|