> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ipmideck.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装

> 使用 Docker 或 pip 安装 ipmideck，并理解 --network host 要求。

## Docker（推荐）

```bash theme={null}
docker run --network host ipmideck/ipmideck:latest
```

`--network host` 是必需的，这样容器才能通过 UDP 端口 623（IPMI/RMCP+ 端口）
在你的本地网络上直接访问你的 BMC。没有主机网络，容器会
处于 Docker 的 NAT 之后，无法与你的硬件完成 IPMI 会话。

容器启动后，打开 `http://<your-ip>:3000` 并按照设置向导操作。

<Note>
  已发布的镜像位于 Docker Hub
  [hub.docker.com/r/ipmideck/ipmideck](https://hub.docker.com/r/ipmideck/ipmideck)。
  镜像即将推出，上面的命令正是它发布后你将运行的确切命令。
</Note>

## pip

```bash theme={null}
pip install ipmideck
```

pip 包要求主机上已安装 `ipmitool`，ipmideck 在每次 IPMI 操作时都会调用
`ipmitool`。请先从你发行版的包管理器安装它
（例如 `apt install ipmitool` 或 `dnf install ipmitool`）。

## ipmideck 在哪里存储数据

ipmideck 将其配置和数据库写入一个数据目录：

* **Docker：** 容器内的 `/data`（镜像设置 `IPMIDECK_DATA_DIR=/data`；
  使用卷使其持久化）。
* **Linux 上的 pip：** 默认 `/data`：设置 `IPMIDECK_DATA_DIR` 以重新定位。
* **Windows 上的 pip：** `./data`，相对于你运行 `ipmideck` 的目录。

你可以在任意平台用环境变量 `IPMIDECK_DATA_DIR` 覆盖此位置。
该目录包含 `config.yaml`、SQLite 数据库，以及用于保护你存储的 BMC
凭据的加密密钥文件。详情请参阅 [配置](/zh-Hans/configuration) 和
[运行 ipmideck](/zh-Hans/running)。

## 后续步骤

* [配置](/zh-Hans/configuration)：调整端口、轮询间隔和保留时间。
* [支持的硬件](/zh-Hans/supported-hardware)：确认你的 BMC 已被覆盖。
* [故障排除](/zh-Hans/troubleshooting)：连接和 IPMI 错误。