From f03718ce8c25a99e561f8a5fc189685e44ab6839 Mon Sep 17 00:00:00 2001
From: ryan <ryan@arctel.net>
Date: Sat, 30 May 2026 16:08:43 +0800
Subject: [PATCH] =?UTF-8?q?[=E4=BC=98=E5=8C=96]=20=E6=9B=B4=E6=96=B0=20Doc?=
 =?UTF-8?q?ker=20=E9=83=A8=E7=BD=B2=E6=8C=87=E4=BB=A4=EF=BC=8C=E6=B7=BB?=
 =?UTF-8?q?=E5=8A=A0=E9=95=9C=E5=83=8F=E6=8B=89=E5=8F=96=E5=92=8C=E5=AE=B9?=
 =?UTF-8?q?=E5=99=A8=E7=A7=BB=E9=99=A4=E5=91=BD=E4=BB=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                    | 2 ++
 docs/en/guide/agent.md                       | 2 ++
 docs/guide/agent.md                          | 2 ++
 docs/guide/deployment.md                     | 4 ++++
 openflare_server/web/features/nodes/utils.ts | 6 +++++-
 5 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a1dc3baa..6c59c6e3 100644
--- a/README.md
+++ b/README.md
@@ -103,6 +103,8 @@ docker compose up -d
 Docker 部署可直接运行 Agent 镜像：
 
 ```bash
+docker pull ghcr.io/rain-kl/openflare-agent:latest
+docker rm -f openflare-agent 2>/dev/null || true
 docker run -d --name openflare-agent --restart unless-stopped \
   -p 80:80 -p 443:443 \
   -e OPENFLARE_SERVER_URL=http://your-server:3000 \
diff --git a/docs/en/guide/agent.md b/docs/en/guide/agent.md
index 37526925..d7dc9852 100644
--- a/docs/en/guide/agent.md
+++ b/docs/en/guide/agent.md
@@ -49,6 +49,8 @@ Agent self-update requires the GitHub Release to include both the target binary
 ## Docker
 
 ```bash
+docker pull ghcr.io/rain-kl/openflare-agent:latest
+docker rm -f openflare-agent 2>/dev/null || true
 docker run -d --name openflare-agent --restart unless-stopped \
   -p 80:80 -p 443:443 \
   -e OPENFLARE_SERVER_URL=http://your-server:3000 \
diff --git a/docs/guide/agent.md b/docs/guide/agent.md
index a826aaec..407f547c 100644
--- a/docs/guide/agent.md
+++ b/docs/guide/agent.md
@@ -96,6 +96,8 @@ curl -fsSL https://raw.githubusercontent.com/Rain-kl/OpenFlare/main/scripts/inst
 Docker 部署时直接运行内置 OpenResty 的 Agent 镜像：
 
 ```bash
+docker pull ghcr.io/rain-kl/openflare-agent:latest
+docker rm -f openflare-agent 2>/dev/null || true
 docker run -d --name openflare-agent --restart unless-stopped \
   -p 80:80 -p 443:443 \
   -e OPENFLARE_SERVER_URL=http://your-server:3000 \
diff --git a/docs/guide/deployment.md b/docs/guide/deployment.md
index ccc5a430..1c13bad2 100644
--- a/docs/guide/deployment.md
+++ b/docs/guide/deployment.md
@@ -173,6 +173,8 @@ Docker 部署时直接运行 Agent 镜像。该镜像基于 OpenResty 镜像制
 挂载配置文件：
 
 ```bash
+docker pull ghcr.io/rain-kl/openflare-agent:latest
+docker rm -f openflare-agent 2>/dev/null || true
 docker run -d --name openflare-agent --restart unless-stopped \
   -p 80:80 -p 443:443 \
   -v openflare-agent-data:/data \
@@ -183,6 +185,8 @@ docker run -d --name openflare-agent --restart unless-stopped \
 使用环境变量：
 
 ```bash
+docker pull ghcr.io/rain-kl/openflare-agent:latest
+docker rm -f openflare-agent 2>/dev/null || true
 docker run -d --name openflare-agent --restart unless-stopped \
   -p 80:80 -p 443:443 \
   -e OPENFLARE_SERVER_URL=http://your-server:3000 \
diff --git a/openflare_server/web/features/nodes/utils.ts b/openflare_server/web/features/nodes/utils.ts
index b3d04ac4..6533eb90 100644
--- a/openflare_server/web/features/nodes/utils.ts
+++ b/openflare_server/web/features/nodes/utils.ts
@@ -184,11 +184,15 @@ export function buildNodeDockerInstallCommand(
   serverUrl: string,
   agentToken: string,
 ) {
+  const image = 'ghcr.io/rain-kl/openflare-agent:latest';
+
   return [
+    `docker pull ${image}`,
+    `docker rm -f openflare-agent 2>/dev/null || true`,
     `docker run -d --name openflare-agent --restart unless-stopped \\`,
     `  -p 80:80 -p 443:443 \\`,
     `  -e OPENFLARE_SERVER_URL=${serverUrl} \\`,
     `  -e OPENFLARE_AGENT_TOKEN=${agentToken} \\`,
-    `  ghcr.io/rain-kl/openflare-agent:latest`,
+    `  ${image}`,
   ].join('\n');
 }