Kilolink Server Pro保留所有配置进行更新

文档目的

本文档旨在帮助您快速解决 Kilolink Server Pro 固件更新的配置保留问题，实现覆盖安装时保留所有原有设备配置、账户密码、日志数据 的效果。
适用产品 / 版本：Kilolink Server Pro 管理平台（Docker 部署版本）

2. 问题现象与适用场景

   问题现象

   Kiloview 官方发布 Kilolink Server Pro 新版本固件后，需对服务器进行更新，但若直接重新安装有可能会导致原有设备配置、账户密码等信息丢失，需保留配置完成固件升级。

   适用场景

3. 按官方部署文档默认路径（/root/kilolink-server）安装的 Kilolink Server Pro；

4. 自定义部署路径安装，无法确认原部署路径的 Kilolink Server Pro。

解决方案
注意事项

1. 整个操作过程需保持root 最高权限，避免因权限不足导致 Docker 命令、目录操作执行失败；
2. 输入部署路径时，需严格保证路径拼写无误（Linux 系统路径区分大小写），否则会导致路径映射失败；
3. 拉取镜像前，确保服务器网络通畅，能正常访问 Docker 官方仓库 / Kiloview镜像仓库；
4. 安装过程中请勿中断终端操作，否则会导致安装失败、配置文件损坏。

**步骤一：切换 root 账户并获取最高权限

1. 进入 Ubuntu 系统终端，执行以下命令切换至 root 账户：
sudo su
2. 输入 root 账户密码并回车，终端用户名显示为root** ，即表示获取 root 最高权限。

步骤二：查询 Kilolink Server Pro 的容器名

1. 执行以下 Docker 命令，列出系统内所有运行的容器信息：
   docker ps
2. 在输出结果的CONTAINER ID列，找到 Kilolink Server Pro 对应的容器 ID，作为后续命令的核心参数。
   

**步骤三：查询容器的实际部署路径
**1. 执行以下命令，获取容器的完整挂载配置信息（替换为步骤二查询到的容器名 / 容器 ID）
docker inspect <容器名/容器ID>

2. 在 JSON 格式的输出结果中，下滑找到Mounts 目录挂载配置项（bind 类型，为宿主机与容器的目录映射）。
3. 忽略/var/run/avahi-daemon和/var/run/dbus两个系统服务挂载项，重点查看核心业务挂载项 ：Source对应的路径即为宿主机实际部署路径 （默认路径为 /root/kilolink-server）。
   核心挂载项示例：
   

步骤四：确认目标部署目录的有效性

1. 执行以下命令，进入步骤三查询到的宿主机部署路径：
   cd <查询到的部署路径>
2. 执行以下命令，列出目录下的所有文件
   ls
3. 若输出结果包含configs、container.conf、firmware、redis、serverinfo.conf等文件，即表示该路径为原有效部署路径。
   

步骤五：执行 Kilolink Server Pro 覆盖安装

1. 按照官方部署文档地址，重新拉取最新的 Kilolink Server Pro 镜像文件；
2. 拉取完成后，系统会提示「Where do you want to install KiloLink Server 」，并显示默认路径；

3. 路径校验与输入：

若默认路径与步骤三查询的部署路径一致，直接按Enter键继续安装；

若默认路径与查询路径不一致，输入步骤三查询到的实际部署路径，再按Enter键继续安装；

4. 按系统提示完成后续安装步骤，直至安装进度结束。
   步骤六：验证更新结果

安装完成后，登录 Kilolink Server Pro 管理平台，查看设备列表、账户信息、系统配置 均与更新前一致，即表示保留配置更新成功。

4、根因分析

1. Kilolink Server Pro（Docker 部署版）的所有配置文件、设备管理信息、账户密码、运行日志均持久化存储在宿主机的指定部署路径中，容器内/data目录仅为该路径的映射（bind 绑定挂载），容器本身不存储持久化数据；
2. 固件更新时，只要覆盖安装时复用原宿主机部署路径，新容器会自动映射并读取原有持久化数据，从而实现配置保留；
3. 若未确认原路径直接安装，系统会使用新路径创建新的持久化目录，原配置数据无法被新容器读取，导致配置丢失。