chore(i18n): refresh zh-CN translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
ec0fa06d14
commit
cdd6edb89c
@ -1,37 +1,37 @@
|
||||
---
|
||||
read_when:
|
||||
- 你正在使用 Docker 在云 VM 上部署 OpenClaw
|
||||
- 你需要共享二进制文件的构建、持久化和更新流程
|
||||
- 你需要共享二进制文件构建、持久化和更新流程
|
||||
summary: 长期运行的 OpenClaw Gateway 网关主机的共享 Docker VM 运行时步骤
|
||||
title: Docker 虚拟机运行时
|
||||
title: Docker VM 运行时
|
||||
x-i18n:
|
||||
generated_at: "2026-04-28T11:56:00Z"
|
||||
generated_at: "2026-04-29T02:46:06Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: c1561022cea1e8534f55942186def31d2cb11ab554351b0bf1d9b5940ad6458b
|
||||
source_hash: 01ce5a7e58619da9c9ec97eb1e4f88323ab26f42f40e0a3d655b18019de798dd
|
||||
source_path: install/docker-vm-runtime.md
|
||||
workflow: 16
|
||||
---
|
||||
|
||||
基于 VM 的 Docker 安装（例如 GCP、Hetzner 和类似 VPS 提供商）的共享运行时步骤。
|
||||
基于 VM 的 Docker 安装（如 GCP、Hetzner 和类似 VPS 提供商）的共享运行时步骤。
|
||||
|
||||
## 将必需二进制文件烘焙到镜像中
|
||||
## 将所需二进制文件烘焙进镜像
|
||||
|
||||
在运行中的容器内安装二进制文件是一个陷阱。
|
||||
任何在运行时安装的内容都会在重启后丢失。
|
||||
任何在运行时安装的内容都会在重启时丢失。
|
||||
|
||||
Skills 所需的所有外部二进制文件都必须在镜像构建时安装。
|
||||
|
||||
下面的示例仅展示三个常见二进制文件：
|
||||
|
||||
- 用于 Gmail 访问的 `gog`
|
||||
- 用于 Gmail 访问的 `gog`（来自 `gogcli`）
|
||||
- 用于 Google Places 的 `goplaces`
|
||||
- 用于 WhatsApp 的 `wacli`
|
||||
|
||||
这些只是示例，不是完整列表。
|
||||
你可以用相同模式安装所需的任意数量二进制文件。
|
||||
这些只是示例，并不是完整列表。
|
||||
你可以使用相同模式按需安装任意数量的二进制文件。
|
||||
|
||||
如果之后添加依赖其他二进制文件的新 Skills，你必须：
|
||||
如果你之后添加了依赖其他二进制文件的新 Skills，必须：
|
||||
|
||||
1. 更新 Dockerfile
|
||||
2. 重新构建镜像
|
||||
@ -44,17 +44,23 @@ FROM node:24-bookworm
|
||||
|
||||
RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/*
|
||||
|
||||
# Example binary 1: Gmail CLI
|
||||
RUN curl -L https://github.com/steipete/gog/releases/latest/download/gog_Linux_x86_64.tar.gz \
|
||||
| tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/gog
|
||||
# Example binary 1: Gmail CLI (gogcli — installs as `gog`)
|
||||
# Copy the current Linux asset URL from https://github.com/steipete/gogcli/releases
|
||||
RUN curl -L https://github.com/steipete/gogcli/releases/latest/download/gogcli_linux_amd64.tar.gz \
|
||||
| tar -xzO gog > /usr/local/bin/gog; \
|
||||
chmod +x /usr/local/bin/gog
|
||||
|
||||
# Example binary 2: Google Places CLI
|
||||
RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_Linux_x86_64.tar.gz \
|
||||
| tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/goplaces
|
||||
# Copy the current Linux asset URL from https://github.com/steipete/goplaces/releases
|
||||
RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_linux_amd64.tar.gz \
|
||||
| tar -xzO goplaces > /usr/local/bin/goplaces; \
|
||||
chmod +x /usr/local/bin/goplaces
|
||||
|
||||
# Example binary 3: WhatsApp CLI
|
||||
RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli_Linux_x86_64.tar.gz \
|
||||
| tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/wacli
|
||||
# Copy the current Linux asset URL from https://github.com/steipete/wacli/releases
|
||||
RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli-linux-amd64.tar.gz \
|
||||
| tar -xzO wacli > /usr/local/bin/wacli; \
|
||||
chmod +x /usr/local/bin/wacli
|
||||
|
||||
# Add more binaries below using the same pattern
|
||||
|
||||
@ -77,7 +83,7 @@ CMD ["node","dist/index.js"]
|
||||
```
|
||||
|
||||
<Note>
|
||||
上面的下载 URL 适用于 x86_64 (amd64)。对于基于 ARM 的 VM（例如 Hetzner ARM、GCP Tau T2A），请将下载 URL 替换为每个工具发布页面中的相应 ARM64 变体。
|
||||
上面的 URL 是示例。对于基于 ARM 的 VM，请选择 `arm64` 资源。为了构建可复现，请固定带版本的发布 URL。
|
||||
</Note>
|
||||
|
||||
## 构建并启动
|
||||
@ -88,7 +94,7 @@ docker compose up -d openclaw-gateway
|
||||
```
|
||||
|
||||
如果构建在 `pnpm install --frozen-lockfile` 期间因 `Killed` 或 `exit code 137` 失败，说明 VM 内存不足。
|
||||
请先使用更大的机器规格，再重试。
|
||||
请先使用更大的机器规格再重试。
|
||||
|
||||
验证二进制文件：
|
||||
|
||||
@ -118,23 +124,23 @@ docker compose logs -f openclaw-gateway
|
||||
[gateway] listening on ws://0.0.0.0:18789
|
||||
```
|
||||
|
||||
## 持久化内容的位置
|
||||
## 哪些内容持久化在哪里
|
||||
|
||||
OpenClaw 在 Docker 中运行，但 Docker 不是事实来源。
|
||||
所有长期状态都必须能在重启、重建和重新开机后保留下来。
|
||||
OpenClaw 在 Docker 中运行，但 Docker 不是真实数据源。
|
||||
所有长期状态都必须在重启、重建和重新开机后保留。
|
||||
|
||||
| 组件 | 位置 | 持久化机制 | 备注 |
|
||||
| ------------------- | ---------------------------------------- | ---------------------- | ------------------------------------------------------------- |
|
||||
| Gateway 网关配置 | `/home/node/.openclaw/` | 主机卷挂载 | 包含 `openclaw.json`、`.env` |
|
||||
| 模型认证配置文件 | `/home/node/.openclaw/agents/` | 主机卷挂载 | `agents/<agentId>/agent/auth-profiles.json`（OAuth、API 密钥） |
|
||||
| Skills 配置 | `/home/node/.openclaw/skills/` | 主机卷挂载 | Skill 级状态 |
|
||||
| Agent 工作区 | `/home/node/.openclaw/workspace/` | 主机卷挂载 | 代码和智能体制品 |
|
||||
| Skill 配置 | `/home/node/.openclaw/skills/` | 主机卷挂载 | Skill 级状态 |
|
||||
| Agent 工作区 | `/home/node/.openclaw/workspace/` | 主机卷挂载 | 代码和 agent 工件 |
|
||||
| WhatsApp 会话 | `/home/node/.openclaw/` | 主机卷挂载 | 保留二维码登录 |
|
||||
| Gmail 密钥环 | `/home/node/.openclaw/` | 主机卷 + 密码 | 需要 `GOG_KEYRING_PASSWORD` |
|
||||
| 插件运行时依赖 | `/var/lib/openclaw/plugin-runtime-deps/` | Docker 命名卷 | 生成的内置插件依赖和运行时镜像 |
|
||||
| 外部二进制文件 | `/usr/local/bin/` | Docker 镜像 | 必须在构建时烘焙 |
|
||||
| 外部二进制文件 | `/usr/local/bin/` | Docker 镜像 | 必须在构建时烘焙进去 |
|
||||
| Node 运行时 | 容器文件系统 | Docker 镜像 | 每次镜像构建都会重建 |
|
||||
| OS 包 | 容器文件系统 | Docker 镜像 | 不要在运行时安装 |
|
||||
| OS 软件包 | 容器文件系统 | Docker 镜像 | 不要在运行时安装 |
|
||||
| Docker 容器 | 临时 | 可重启 | 可以安全销毁 |
|
||||
|
||||
## 更新
|
||||
@ -147,7 +153,7 @@ docker compose build
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
## 相关
|
||||
## 相关内容
|
||||
|
||||
- [Docker](/zh-CN/install/docker)
|
||||
- [Podman](/zh-CN/install/podman)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user