Linux 客户端安装

云空间客户端 Linux 版本以标准的 .deb 格式发布，主要适配基于 Debian/Ubuntu 体系的国产信创操作系统及通用 Linux 发行版。

一、 安装包命名规则

对外发布的安装包名称包含了架构与版本号等关键信息，例如：

at-xspace_linux_x86_64_6.16.12.common.deb

• x86_64：表示当前安装包是针对 x86_64 处理器架构编译。
• 6.16.12：表示安装包的软件版本号。

---

二、 终端硬件与架构支持

云空间客户端目前已深度适配以下硬件平台及架构：

• x86 架构：支持 Intel、AMD、兆芯 (Zhaoxin)、海光 (Hygon) 等 64 位处理器。
• ARM 架构：支持鲲鹏 (Kunpeng)、飞腾 (Phytium) 等 64 位处理器。
• LoongArch 架构：支持龙芯 (Loongson) 新一代 64 位指令集架构。

注意： 目前仅对外发布 .deb 格式安装包。因此，RedHat 系（使用 .rpm 包，如 CentOS、Rocky Linux）、ArchLinux 等非 Debian 系的 Linux 发行版暂未提供官方支持。

---

三、 使用命令行安装（推荐）

对于首次安装，推荐使用命令行方式。该方式能够通过包管理器自动解析并补全系统依赖项。

3.1 在线安装

在安装包所在目录打开终端，执行：

sudo apt install -y ./at-xspace_linux_x86_64_6.16.12.common.deb

执行此命令时，系统将自动从配置的软件源中下载并安装缺失的库文件（如 libgles2 等）。

3.2 离线安装

若目标机器无法访问外网，请先在同版本有网环境下下载依赖包（如 sudo apt download libgles2），随后将所有依赖包与客户端安装包放在同一文件夹内，执行：

sudo apt install -y ./*.deb

---

四、 使用图形界面安装

在 统信 (UOS)、麒麟 (Kylin)、方德 (NfsDesktop)、深度 (Deepin) 等系统上，确认系统依赖完整后，可通过图形化向导完成安装：

1. 启动安装向导：双击下载好的 .deb 软件包。系统将弹出安装窗口，显示当前版本信息，点击 “一键安装”（或“安装”）。

2. 安全身份认证：由于安装涉及系统底层驱动配置，系统会弹出认证对话框，提示需要认证。

3. 输入用户密码：请输入当前 Linux 本地用户的登录密码以授权安装。

4. 执行安装进度：系统开始正式执行安装过程，此时请耐心等待进度条完成。

5. 安装完成：提示安装成功后，可从桌面图标或“开始菜单”中点击启动 云空间客户端。

---

五、 配置云平台地址

首次运行客户端，需指向正确的管理服务器。

1. 进入设置界面：点击客户端登录窗口右上角的 “齿轮” 图标。

2. 配置接入信息：

   • 服务器地址：输入云空间管理端的公网 IP、内网 IP 或域名。
   • 端口号：默认为 44301。

   

3. 连通性检测：配置完成后，点击 “检测” 按钮。

   • 检测成功：界面提示正常，可返回登录。
   • 检测失败：请检查本地网络是否通畅，并在终端使用 ping 命令确认能否触达服务器地址。

---