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

# 如何用 Docker 部署 autClaw

> 按步骤在 Linux、飞牛 OS 或群晖 DSM 用 Docker bridge 网络部署 autClaw，映射 8200 端口并保留持久化目录。

本页说明如何用官方 Docker 镜像部署 autClaw。你会配置 `8200` 端口、持久化目录和常见 NAS 路径，避免后续升级或重建容器时丢失插件和数据。

## 准备

* 已安装 Docker。
* 确认宿主机 `8200` 端口未被占用。
* 准备一个持久化目录，用来保存数据、插件和运行时依赖。

## 选择部署方式

| 场景        | 推荐方式           | 默认目录                        |
| --------- | -------------- | --------------------------- |
| Linux 服务器 | Docker bridge  | `/opt/autclaw`              |
| 飞牛 OS     | Docker + 宿主机目录 | `/vol1/1000/docker/autclaw` |
| 群晖 DSM    | Docker + 宿主机目录 | `/volume1/docker/autclaw`   |

## Linux 通用部署

默认使用 Docker bridge 网络，并把容器 `8200` 端口映射到宿主机 `8200`。

```bash theme={null}
docker run -d \
  --name autclaw \
  --restart unless-stopped \
  --network bridge \
  -p 8200:8200 \
  -v /opt/autclaw:/opt/autclaw \
  nolan1121953/autclaw:latest
```

启动后访问：

```text theme={null}
http://服务器IP:8200
```

如果你在本机部署，也可以访问：

```text theme={null}
http://localhost:8200
```

## 飞牛 OS 部署

通过 SSH 登录飞牛 OS 后执行。飞牛 OS 常见 Docker 配置目录为 `/vol1/1000/docker`；如果你的存储空间或用户编号不同，请替换命令左侧的宿主机路径。

```bash theme={null}
sudo mkdir -p /vol1/1000/docker/autclaw
sudo docker run -d \
  --name autclaw \
  --restart unless-stopped \
  --network bridge \
  -p 8200:8200 \
  -v /vol1/1000/docker/autclaw:/opt/autclaw \
  nolan1121953/autclaw:latest
```

启动后访问：

```text theme={null}
http://飞牛OS_IP:8200
```

## 群晖 DSM / Container Manager 部署

通过 SSH 登录群晖后执行。常见持久化目录为 `/volume1/docker/autclaw`；如果你的共享文件夹在其他存储池，请替换为实际路径。

```bash theme={null}
sudo mkdir -p /volume1/docker/autclaw
sudo docker run -d \
  --name autclaw \
  --restart unless-stopped \
  --network bridge \
  -p 8200:8200 \
  -v /volume1/docker/autclaw:/opt/autclaw \
  nolan1121953/autclaw:latest
```

启动后访问：

```text theme={null}
http://群晖_IP:8200
```

<Note>
  如果你想换端口，例如宿主机 `18200` 映射到容器 `8200`，把 `-p 8200:8200` 改成 `-p 18200:8200`。
</Note>

## 查看日志

```bash theme={null}
docker logs -f autclaw
```

## 重新创建容器

```bash theme={null}
docker rm -f autclaw

docker run -d \
  --name autclaw \
  --restart unless-stopped \
  --network bridge \
  -p 8200:8200 \
  -v /opt/autclaw:/opt/autclaw \
  nolan1121953/autclaw:latest
```

<Warning>
  不要删除 `/opt/autclaw`、`/vol1/1000/docker/autclaw` 或 `/volume1/docker/autclaw`，除非你明确要清空数据、插件和运行时依赖。
</Warning>

## 常见问题

### 我能把端口改成别的值吗？

可以。把 `-p 8200:8200` 改成你想要的宿主机端口，例如 `-p 18200:8200`。

### 重建容器时要保留什么？

保留宿主机持久化目录，不要删除里面的数据库、插件和依赖。

### Windows 能直接部署吗？

当前文档面向 Linux 和 Docker 部署，Windows 不在支持范围内。

## 下一步

* 查看 [运行目录和持久化路径](/cn/getting-started/runtime-paths)，确认数据库、插件和依赖目录位置。
* 使用 [autClaw Docker 运维命令](/cn/operations/docker) 查看日志、更新镜像或重新创建容器。
* 需要升级应用版本时，按 [如何升级 autClaw](/cn/getting-started/upgrade) 使用 Web 控制台或 IM 命令。