在 64 位 Linux 操作系统中安装 iCerya Space

你可以在你的 Linux 计算平台中安装 iCerya Space，以下步骤主要适用于对 Linux 经验丰富的用户。

获取 iCerya Space 后，你将获得一个适用于 Docker 容器的预构建镜像安装器。此安装器针对不同架构和平台进行对应适配，对于 iCerya Space Linux，受支持的架构平台及兼容版本如下所示：

对于 64 位的 Linux 操作系统

Ubuntu 22.04 LTS 或更新版本
CentOS Stream 9 或更新版本
Red Hat RHEL 8 或更新版本
OpenCloud OS 9 或更新版本
Arch Linux

你需要使用 iCerya Space 安装器吗？

你不需要使用 iCerya Space 安装器来升级 iCerya Space 或还原 iCerya Space。如果你需要以全新安装的方式部署 iCerya Space，iCerya Space 安装器可能会很有用。

确保你的设备支持 iCerya Space 的最低需求

对于 iCerya Space Linux 的安装，请确保你的设备满足以下条件：

设备的架构为 x86_64；
设备 CPU 具有 2 个核心，并配备至少 2GB 内存；
设备已安装 Docker 与 Docker Compose v2；
可用存储空间为 2 GB 或更高（推荐为 4 GB）；
设备能够访问网络。

iCerya Space 将在你的设备上占用 5500 网络端口，因此安装前请确保此端口处于空闲状态。你可以在浏览器的地址栏中输入 http://localhost:5500 或 http://127.0.0.1:5500，并按键盘上的「回车（enter）」以访问你安装的 iCerya Space。

对于无 GUI 安装的 Linux，请在“终端”中输入命令以获取你的 IP 地址，然后在带有浏览器的设备上访问此 IP。根据你使用的具体 Linux，将以下任意命令输入到“终端”中。

Ubuntu

hostname -I

CentOS / Red Hat / OpenCloud OS / Arch Linux

ip addr show

你将获取到形如 XXX.XXX.XXX.XXX 的一段数字，其中每一个数字分段介于 0 至 255 之间。在你连接到同一局域网的设备的浏览器地址栏中输入 IP，在后面添加 :5500 并轻按“回车”。

在“终端”中输入命令

安装过程在终端中进行。如果你使用带有桌面环境的 Linux，打开“应用程序”列表中的“终端”，或者使用菜单栏中的”搜索“查找并打开“终端”。多数桌面环境也可以使用键盘直接打开：同时按住 Ctrl 与 Alt 键不放，再轻按 T 键，直到出现“终端”窗口。

终端窗口打开后，会显示一行命令提示符，形如 user@host:~$，末尾有一个光标等待输入。命令提示符出现，就表示终端已经可以使用。

在终端中依次键入以下命令，轻点键盘中的回车（enter）：

docker version

看到包含关键词 Server 的输出，即表示 Docker 引擎已经就绪。若只显示 Client 并提示无法连接，说明 Docker 服务未在运行，请在终端中依次键入以下命令启动服务，每行键入完成后轻点键盘中的回车（enter）：

sudo systemctl start docker

再重新执行一次 docker version。

使用安装器

iCerya Space 安装器的文件名形如 ICSPACE-IMG_preview_0-20-12_103_63_linux_x86-64.tar，位于你下载该文件时所用的目录中，默认为“下载”目录。文件名中除 x86-64 之外的数字值会随发布版本不同变化。

在“终端”中依次键入以下命令，然后轻点键盘中的回车（enter）。如果你使用图形化 Linux，你可以在下方的可滚动区域内连按三下或拖移以选中整个命令。然后按下 Command-C （或 Ctrl-C）以将这个命令拷贝到剪贴板。：

mkdir -p ~/icerya-space-install && cd ~/icerya-space-install && tar -xf ~/Downloads/ICSPACE-IMG_preview_0-20-12_103_63_linux_x86-64.tar

tar 命令执行时，“终端”不会显示任何字符。执行完成后终端再次出现形如 user@host:~$ 的命令提示符，即表示解包完成。

运行安装脚本

在同一个终端窗口中依次键入以下命令，轻点键盘中的回车（enter）：

./install.sh

以下示例展示了如何部署 iCerya Space：

Copying and installing: 0%... 10%... 20%... 30%... 40%... 50%... 60%... 70%... 80%... 90%... 100%
iCerya Space is now available at "http://192.168.1.20:5500"

访问 iCerya Space

在浏览器的地址栏中输入安装器打印的地址，并按键盘上的回车（enter），即可打开站点。首次打开会进入 iCerya Space 初始化向导。

其他问题

安装器在正常安装时只显示进度。需要查看每一步的详细结果时，在命令前加上 ICERYA_VERBOSE=1，安装器就会在进度之外打印每一步的状态：

ICERYA_VERBOSE=1 ./install.sh

安装过程中的输出会逐步打印在“终端”里。安装完成后需要查看运行日志时，在“终端”中依次键入以下命令，轻点键盘中的回车（enter）：

docker compose -f ~/icerya-space/docker-compose.install.yml logs -f app

同时按住键盘上的 Ctrl 与 C 键（或 Control-C）可以退出日志查看。

停止与启动 iCerya Space：

docker compose -f ~/icerya-space/docker-compose.install.yml stop

docker compose -f ~/icerya-space/docker-compose.install.yml start

卸载 iCerya Space：

~/icerya-space/uninstall.sh

以下示例展示了如何通过安装器卸载 iCerya Space：

To continue we need to erase the volume at iCerya Data <icerya-space-install-db-data>, <icerya-space-install-uploads>.
if you wish to continue type (Y) then press return: Y
Uninstalling iCerya Space: 0%... 20%... 40%... 60%... 80%... 100%
Finished!

反馈问题时，附上以下信息会让 iCerya 更好的为你定位问题：

安装器在终端中的完整输出
docker version 的输出
docker compose version 的输出
发行版名称与版本号

发布日期：2026年10月4日