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

# Docker

# Docker

镜像只包含 `blockscope`，不包含任何 Minecraft 资产。客户端 jar、资源包和 job
目录通过挂载提供。

## 构建

```bash theme={null}
docker build -t blockscope .
```

## 容量检测

```bash theme={null}
docker run --rm --cpus=1 --memory=1g blockscope capacity --json
```

## 运行 worker

```bash theme={null}
docker run --rm -i \
  --cpus=2 --memory=2g \
  -v /host/client.jar:/assets/client.jar:ro \
  -v /host/jobs:/data \
  blockscope serve --client-jar /assets/client.jar
```

容器内工作目录是 `/data`。输入路径和 `outputDir` 需要使用容器内可见的绝对路径。

## 运行 supervisor

```bash theme={null}
docker run --rm -i \
  --cpus=4 --memory=4g \
  -v /host/client.jar:/assets/client.jar:ro \
  -v /host/jobs:/data \
  blockscope supervise \
    --workers 2 --threads 2 \
    --client-jar /assets/client.jar
```

## 烟雾测试

```bash theme={null}
printf '%s\n' '{"type":"shutdown"}' |
  docker run --rm -i blockscope serve
```

## 资源建议

`capacity` 会根据 cgroup 的 CPU/内存限制给出 worker、thread 和默认分辨率建议。
1 CPU / 1 GiB 环境建议使用单 worker、单线程和较低分辨率；更大机器再提高并发。

完整部署说明见 [部署文档](https://blockscope.linvin.net/deployment.md)。

## 相关文档

* [服务模式](https://blockscope.linvin.net/user/service.md)
* [限制与安全](https://blockscope.linvin.net/user/limits.md)
* [English](https://blockscope.linvin.net/user/en/docker.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.