> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/cherry-studio/installation/linux.md).

# Linux

## 1. 下载安装包

打开 [官方下载页](https://cherryai.com.cn/download/v2)，选择 **Linux**。官网会按系统和架构提供不同格式的安装包：

| 使用场景                     | 选择建议                    |
| ------------------------ | ----------------------- |
| Ubuntu、Debian、Linux Mint | 选择与架构匹配的 `.deb` 包。      |
| Fedora、RHEL、openSUSE     | 选择与架构匹配的 `.rpm` 包。      |
| 其他发行版或需要便携运行             | 选择与架构匹配的 `.AppImage` 包。 |

Intel / AMD 设备通常选择 x64（或 x86\_64）版本；ARM 设备选择 ARM64（或 aarch64）版本。不确定架构时，在终端运行 `uname -m`：`x86_64` 对应 x64，`aarch64` 或 `arm64` 对应 ARM64。

## 2. 安装并启动

* `.deb` 和 `.rpm`：优先使用发行版的软件安装器或包管理器打开安装包，再从应用菜单启动 Cherry Studio。
* `.AppImage`：为文件授予可执行权限后，双击运行；也可以在终端运行 `chmod +x 文件名.AppImage` 后启动。

## 无法启动

先确认安装包与系统架构匹配。AppImage 无法启动且提示 `FUSE` 或 `libfuse` 相关错误时，请按当前发行版的官方文档安装相应兼容组件。

仍无法启动时，请在反馈中附上发行版、桌面环境、设备架构、安装包名称和完整错误提示。

## 下一步

看到 Cherry Studio 主界面后，继续完成快速开始。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/cherry-studio/installation/linux.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.