> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 在国产系统内使用 Octop

这一页说明如何在国产操作系统上安装 Octop，目前覆盖统信 UOS 和银河麒麟。两者的桌面版都使用 `.deb` 安装包。从 [Octop v1.0.3b5 发布页](https://github.com/TencentCloud/Octop/releases/tag/v1.0.3b5)下载与本机架构匹配的包。

## 确认架构并选择安装包

先在终端确认当前架构：

```bash
dpkg --print-architecture
# 或者
uname -m
```

| 命令输出                | 常见平台            | 安装包                                     |
| ------------------- | --------------- | --------------------------------------- |
| `amd64` / `x86_64`  | 海光、兆芯、Intel、AMD | `Octop-desktop-linux-amd64-1.0.3b5.deb` |
| `arm64` / `aarch64` | 鲲鹏、飞腾           | `Octop-desktop-linux-arm64-1.0.3b5.deb` |

## 安装

### 用终端安装

优先用 `apt install ./<包名>.deb`。它会安装这个 deb，并从系统软件源补上缺少的依赖。

打开终端，进入安装包所在目录，例如 `~/Downloads`：

```bash
cd ~/Downloads
```

更新软件源再安装。文件名前面要写 `./`，apt 才会安装当前目录里的这个包。


**amd64 / x86_64**

```bash
sudo apt update
sudo apt install ./Octop-desktop-linux-amd64-*.deb
```


**arm64 / aarch64**

```bash
sudo apt update
sudo apt install ./Octop-desktop-linux-arm64-*.deb
```


如果改用 `dpkg -i`，缺少依赖时用下面的命令补上：


**amd64 / x86_64**

```bash
sudo dpkg -i Octop-desktop-linux-amd64-*.deb
# 若提示依赖未满足（dependency problems），运行：
sudo apt-get install -f -y
```


**arm64 / aarch64**

```bash
sudo dpkg -i Octop-desktop-linux-arm64-*.deb
# 若提示依赖未满足（dependency problems），运行：
sudo apt-get install -f -y
```


### 在文件管理器里双击

- **统信 UOS**：在文件管理器中找到 `.deb`，双击打开**软件包安装器**，点**安装**，输入当前管理员密码。
- **银河麒麟**：双击 `.deb`，打开**麒麟软件包安装器**或**软件商店**，点**一键安装**或**安装**，输入密码。

安装完成后，在**应用启动器**或**开始菜单**里搜索并打开 Octop。

## 常见问题

### 统信提示签名验证失败

统信桌面版默认开启应用签名策略，未经官方商店签名的第三方包会被拦住。


### 打开开发者模式

打开**控制中心 → 通用 → 开发者模式**。

### 激活

点**进入开发者模式**。按提示登录统信账号在线激活，或离线导入证书。

### 重启后再安装

按提示重启电脑，然后再安装外部 deb 包。

### 银河麒麟安全防护拦截

部分麒麟桌面版开启了执行保护或白名单。打开**麒麟安全中心**，在应用执行保护里把 Octop 加入白名单，或把安全等级调低一些。

### 点图标没有反应

从应用菜单点图标没有反应时，在终端里直接运行，看打印出来的错误：

```bash
octop
```

也可以到 `/opt` 或 `/usr/bin` 下找到实际的可执行文件再运行。日志里常见的是缺少某个 `.so`，或显卡硬件加速异常。老旧显卡渲染异常时，加上 `--disable-gpu` 再启动。
