Datalayers 文档

简体中文

English

Appearance

Ubuntu ​

本文将介绍 Datalayers 在 Ubuntu 系统中的安装及使用。

Datalayers 支持的 Ubuntu 版本包括：

  • Ubuntu 20.04
  • Ubuntu 22.04
  • Ubuntu 24.04

通过 deb 包安装 ​

:::

升级 Datalayers ​

如果您需要升级 Datalayers，将上述安装命令中的 Datalayers 版本替换为更高版本，即可执行升级。 升级过程中，旧版本的 Datalayers 包会被卸载，但是会保留用户数据。

对于配置文件，我们优先保留您修改的配置，以确保升级不会导致您的自定义配置丢失。具体而言：

  1. 如果您没有修改默认的配置，则升级后会使用新版本的配置文件。
  2. 如果您修改了默认的配置，但是修改内容与新版本的配置文件不冲突，我们保留您所修改的配置，同时会加入新的配置。
  3. 如果您修改了默认的配置，且修改内容与新版本的配置文件冲突了，我们会弹出提示框，要求您采取某一种 dpkg 支持的冲突化解策略。示例如下：
bash
Configuration file '/etc/datalayers/datalayers.toml'
 ==> Modified (by you or by a script) since installation.
 ==> Package distributor has shipped an updated version.
   What would you like to do about it ?  Your options are:
    Y or I  : install the package maintainer's version
    N or O  : keep your currently-installed version
      D     : show the differences between the versions
      Z     : start a shell to examine the situation
 The default action is to keep your current version.
*** datalayers.toml (Y/I/N/O/D/Z) [default=N] ?

TIP

您可以使用 dpkg 的 --force-confold 选项来强制保留您的配置文件：

bash
sudo dpkg --force-confold -i ./datalayers-2.2.11-ubuntu22.04-amd64.deb

也可以使用 dpkg 的 --force-confnew 选项来强制使用新版本的配置文件：

bash
sudo dpkg --force-confnew -i ./datalayers-2.2.11-ubuntu22.04-amd64.deb

启动/停止 Datalayers ​

执行以下命令，将以 systemd 方式启动（单机模式）：

bash
sudo systemctl start datalayers

可通过以下命令查看其启动状态：

bash
systemctl status datalayers

可通过以下命令停止服务：

bash
sudo systemctl stop datalayers

可通过以下命令重启服务：

bash
sudo systemctl restart datalayers

卸载 Datalayers ​

如需卸载 Datalayers，可以通过以下两种方式：

  • 普通模式卸载（保留二进制文件、配置文件）：
bash
sudo dpkg -r datalayers

注意，普通模式会将 /usr/local/bin/ 目录下的二进制文件的软链接删除，而不会删除 /usr/lib/datalayers/bin/ 目录下的二进制文件。

  • 纯净模式卸载（不保留二进制文件、配置文件）：
bash
sudo dpkg -P datalayers

体验功能 ​

安装完成后，即可使用命令行工具快速体验 Datalayers 的各项功能。

© 2025 Datalayers All rights reserved