在 64 位 Windows 设备上使用命令安装 iCerya Space

你可以在你的 Windows 台式机或笔记本中以虚拟机形式安装和运行 iCerya Space，以下步骤主要适用于缺少 OS X 或 Linux 设备平台的用户。

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

对于 Windows 操作系统

  • 64 位的 Windows 10（Windows 10 2004 或更高版本）
  • 64 位的 Windows 11

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

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

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

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

  • 设备的架构为 x86_64，且安装有 Windows 10 2004 或更高版本的 Windows 操作系统；
  • 设备 CPU 具有 2 个核心，并配备至少 4GB 内存；
  • 设备已安装 Hyper-V、VMware 或任意虚拟化环境；
  • Windows 可用存储空间为 8 GB 或更高（推荐为 16 GB）；
  • 设备能够访问网络。

iCerya Space Windows 依赖一个 Linux 虚拟机以完成安装和运行，因此你需要获取一份 Linux 镜像并安装到你的设备上后以继续安装 iCerya Space。

iCerya Space 将在你的虚拟机上占用 5500 网络端口，因此安装前请确保此端口处于空闲状态。你可以在浏览器的地址栏中输入 http://<虚拟机本地 IP>:5500，并按键盘上的 Return 键以访问你安装的 iCerya Space。

  • 你可以在 OpenCloudOS 终端中运行 hostname -I 查看虚拟机的本地 IP 地址。

下载虚拟机安装镜像

iCerya Space Windows 依赖一个 Linux 虚拟机以完成安装和运行，因此你需要获取一份 Linux 镜像并安装到你的设备上后以继续安装 iCerya Space。你可以使用你熟悉的任意受支持的 Linux 版本，此文档中以 OpenCloud OS 9.6 为示例。

  1. 前往 https://opencloudos.org/ospages/download/，并在渲染出的网页列表中选择 x86_64 中的 Containers，下载 Linux 根文件系统压缩包。
  2. 下载后检查系统压缩包的名称。系统压缩包该是一个名为“OpenCloudOS-Container-Minimal-[版本名].x86_64”的 ISO，例如“OpenCloudOS-Container-Minimal-9.6-20260514.2.x86_64.tar.xz”。如果系统压缩包是虚拟磁盘 (.vmdk) 或镜像 (.iso) 文件，请重新执行 1。如果你无法判断你下载的文件类型，请点击文件资源管理器中的“查看”，并点击“显示文件扩展名”为启用。
  3. 检查系统压缩包的位置。系统压缩包应该位于“下载”文件夹中，也就是当你从“此电脑”的菜单栏中选取“侧边栏”的“下载”时打开的文件夹。如有必要，请将系统压缩包移到这个文件夹中。

启用 WSL 虚拟机

使用鼠标左键轻点菜单栏中的搜索图标，在弹出的输入框中键入 PowerShell，并在右侧的搜索结果中找到 “Windows PowerShell”，轻点下方「以管理员身份运行」，等待弹出窗口并显示出 PS C:\User\<你的 Windows 用户名> 后，在后方依次键入：

wsl --install

轻点键盘中的 Return 键，等待 PowerShell 执行完毕，并重新出现 PS C:\User\<你的 Windows 用户名> 后，使用鼠标左键轻点菜单栏中的 Windows 图标，或轻按键盘上的 Windows 按键打开「开始」菜单，找到「电源」按钮，点击「重新启动」。

等待你的 Windows 设备重新启动之后再次执行：

wsl --status

输出中应当显示默认 WSL 版本为 2。若显示为 1，请依次键入：

wsl --set-default-version 2

轻点键盘中的 Return 键。若提示虚拟化未启用，需要在你的计算机 BIOS 或 UEFI 设置中开启虚拟化选项。相关开启方法请参考你的计算机制造商的使用说明文档。

在 Windows 使用 Linux 虚拟机

双击下载的 OpenCloud OS 系统压缩包，或使用鼠标对其右键，并点击“文件解压缩”以获取到一个以 .tar 为结尾的文件。如果你无法判断你下载的文件类型，请点击文件资源管理器中的“查看”，并点击“显示文件扩展名”为启用。

将下载系统压缩包的名称更改为 OpenCloudOS.tar（这是下文的“PowerShell”命令要使用的名称）

使用鼠标左键点击「开始」按钮，或轻按键盘上的「Windows 键」，并键入“PowerShell”，在搜索结果中找到 “Windows PowerShell” 并轻点“以管理员身份运行”。连按三下或拖移选中以下命令，然后按下 Ctrl-C 以将这个命令拷贝到剪贴板，并将其粘贴到“Windows PowerShell”中，然后按下 Return 键以输入这个命令。

New-Item -ItemType Directory -Force -Path "$HOME\Desktop\OpenCloudOS"; wsl --import OpenCloudOS "$HOME\Desktop\OpenCloudOS" "$HOME\Downloads\OpenCloudOS.tar"

等待“Windows PowerShell”执行完毕后，拷贝以下命令粘贴到“Windows PowerShell”中，并按下 Return 键以输入命令：

wsl -l -v

若看到 OpenCloudOS 且状态为 Stopped 或 Running 即表示导入成功。随后请在非必要情况下不要关闭“Windows PowerShell”。

在“终端”中输入命令

将以下命令拷贝后粘贴到“Windows PowerShell”中，按下 Return 键输入命令：

wsl -d OpenCloudOS

等待 Windows PowerShell 变为 [root@...]# 或包含 OpenCloudOS 的标识后，在终端中依次键入以下命令，轻点键盘中的 Return 键：

docker version

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

sudo systemctl start docker

再重新执行一次 docker version。

下载完整的 iCerya Space 安装器

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

打开 Windows 的 文件资源管理器，进入 下载（Downloads）文件夹，找到你下载的安装器并对其使用鼠标右键，在展开的菜单中点击“重命名”，将文件名修改为“ICSPACE-IMG_linux.tar”。

  • 请务必保留文件末尾的 .tar 后缀。若 Windows 隐藏了已知文件扩展名，请仅将文件名主体部分修改为 ICSPACE-IMG_linux，确保图标样式不发生改变。

在“PowerShell”中依次键入以下命令，然后轻点键盘中的 Return 键。你可以在下方的可滚动区域内连按三下或拖移以选中整个命令。然后按下 Ctrl-C 以将这个命令拷贝到剪贴板：

mkdir -p ~/Downloads && explorer.exe .

在打开的文件资源管理器中，双击进入 Downloads 文件夹，并将先前更名后的 ICSPACE-IMG_linux.tar 文件拖移入此文件夹中。

运行安装脚本

在“PowerShell”中依次键入以下命令，然后轻点键盘中的 Return 键。你可以在下方的可滚动区域内连按三下或拖移以选中整个命令。然后按下 Ctrl-C 以将这个命令拷贝到剪贴板：

mkdir -p ~/icerya-space-install && cd ~/icerya-space-install && tar -xf ~/Downloads/ICSPACE-IMG_linux.tar

tar 命令执行时，“Windows PowerShell”不会显示任何字符。等待命令执行完毕后，在同一个终端窗口中依次键入以下命令，轻点键盘中的 Return 键：

./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

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

其他问题

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

ICERYA_VERBOSE=1 ./install.sh

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

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

按下键盘上的 Ctrl-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 的输出
  • 发行版名称与版本号

发布日期：