{% hint style="info" %}
如果你不使用 Zigbee，请删除 `--device /dev/ttyUSB0:/dev/ttyUSB0`.
如果你不使用 Matter Hub 或 eWeLink Remote，也可以删除 D-Bus 挂载。
{% endhint %}
{% endstep %}
{% step %}
**了解主要参数**
* `--privileged` — 需要硬件访问权限
* `--net=host` — 需要用于局域网发现和 MQTT
* `-v ~/cubeos-data:/data` — 在容器重启后保留你的数据
* `--device /dev/ttyUSB0:/dev/ttyUSB0` — 传递 Zigbee 适配器
* `-v /run/dbus/system_bus_socket:/host_dbus/system_bus_socket:ro` — 为受支持的功能启用 D-Bus 访问
{% endstep %}
{% endstepper %}
### 4. 访问 CUBE OS
{% stepper %}
{% step %}
**确认容器正在运行**
```bash
docker ps
```
容器状态应显示 `运行中`.
{% endstep %}
{% step %}
**打开 Web 界面**
在同一网络中的浏览器中访问以下地址之一：
* `http:///`
*
将 `` 替换为 Linux 主机的 IP 地址。
{% endstep %}
{% step %}
**之后可使用简短的本地地址**
设置完成后，你可以在设置页面找到简短 ID。
然后你可以使用 `cube-{short-id}.local` 来在你的局域网中识别这个 CUBE OS 实例。
{% endstep %}
{% endstepper %}
### 5. 更新 CUBE OS
Docker 部署不支持通过 Web 界面进行 OTA 更新。
要手动更新：
```bash
docker stop cubeos
docker rm cubeos
docker pull ghcr.io/ewelinkcube/cube-os:latest
docker run -d \\
--name cubeos \\
--privileged \\
--net=host \\
-v ~/cubeos-data:/data \\
--device /dev/ttyUSB0:/dev/ttyUSB0 \\
-v /run/dbus/system_bus_socket:/host_dbus/system_bus_socket:ro \\
ghcr.io/ewelinkcube/cube-os:latest
```
你的数据保存在 `~/cubeos-data`中，因此更新后设备、场景和设置都会保留。
### 6. 限制
由于容器隔离，以下功能在 Docker 部署中不可用：
* **附加组件** — 无法安装或管理附加组件
* **蓝牙扬声器** — 不支持蓝牙透传
* **系统更新** — 已禁用 Web 界面中的 OTA 更新
* **重启 / 关机** — 无法使用系统级电源控制
### 7. 树莓派说明
如果你在树莓派上运行 Docker，请确保页大小为 `4096`:
```bash
getconf PAGE_SIZE
# 如果结果不是 4096，请添加此行并重启
echo "kernel=kernel8.img" | sudo tee -a /boot/firmware/config.txt
sudo reboot
```
---
# 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://cube.ewelink.cc/english-zh/kuai-su-kai-shi/quickstart/docker.md?ask=&goal=
```
`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.