# 获取位置

## 最新版本

{% hint style="warning" %}
虽然社区控制器在开发时已考虑与 Makera 固件兼容，但最新稳定版 2.1.0 与 Makera 固件 >= 1.0.4 不兼容。

目前正在进行恢复兼容性的工作： [PR #341](https://github.com/Carvera-Community/Carvera_Controller/pull/341)
{% endhint %}

请查看 [最新发布版本](https://github.com/carvera-community/carvera_controller/releases/latest) 的资源部分，获取适用于您系统的安装包。

* carveracontroller-community-\<version>-windows-x64.exe - 独立版 Windows 二进制文件，不含安装程序
* carveracontroller-community-\<version>-Intel.dmg - 适用于 Intel CPU 的 MacOS
* carveracontroller-community-\<version>-AppleSilicon.dmg - 适用于 Apple CPU（M1 等）的 MacOS
* carveracontroller-community-\<version>-x86\_64.appimage - 适用于 x64 系统的 Linux AppImage
* carveracontroller-community-\<version>-arm664.appimage - 适用于 aarch64/arm64 系统的 Linux AppImage
* carveracontroller-community-\<version>.apk - Android 可安装包
* carvera\_controller\_community-\<version>-py3-none-any.whl - Python wheel 包

## 最新开发版本

Carvera Controller Community 的开发版本会在每次提交到 `develop` 分支后自动编译。这意味着每个构建都包含最新的更改和改进。虽然这些构建能让您一窥 Carvera Controller 的持续开发过程，但请记住它们仍处于开发中，可能包含错误或不稳定功能。最新的开发构建文件始终可以在 [这里](https://github.com/Carvera-Community/Carvera_Controller/releases/tag/dev)找到。该页面上的发布说明部分会显示已添加哪些新功能。

## Python 包

最好使用预构建的软件包，因为它们冻结了经过测试的依赖项和 Python 解释器版本；不过，如果您愿意，也可以将该软件作为 Python 包安装。如果依赖项能够满足，这也许能让您在不受支持的平台上使用（例如 raspi 1）。

```
pip install carvera-controller-community
```

安装完成后，可以通过模块运行

```
python3 -m carveracontroller
```

## Linux 容器

该容器镜像可在 [GitHub 容器注册表](https://ghcr.io/carvera-community/carvera-controller) 上获取，标签格式如下：

* latest - 最新标记的发布版本
* dev - 最新开发构建
* x.y.z - 指定的标记版本

可使用以下命令拉取最新发布版本：

```
docker pull ghcr.io/carvera-community/carvera-controller-<arch>:latest
```

其中 `<arch>` 为 `x64` or `arm64` 取决于您的系统架构。要运行 docker 镜像，请使用以下命令：

```
docker run -p 5900:5900 -p 8080:8080 -v /path/to/config:/config ghcr.io/carvera-community/carvera-controller-<arch>:latest
```

然后可通过网页浏览器在以下地址访问该应用： `http://<host>:8080` 或者通过 VNC 客户端在以下地址访问： `<host>:5900`。VNC 连接不需要密码。详见 [通过网页浏览器控制器](/docs/stable/zh/kong-zhi-qi/features/controller-in-a-web-browser.md) 了解此功能的更多详情。

## iOS

Carvera 社区控制器的 iOS 版本可在以下位置获取： [Apple App Store](https://apps.apple.com/us/app/carvera-community-controller/id6743028299).


---

# Agent Instructions: 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:

```
GET https://carvera-community.gitbook.io/docs/stable/zh/kong-zhi-qi/where-to-get.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.