From 12284c46d38f2cddee8507a128c7ca5c883bb82c Mon Sep 17 00:00:00 2001
From: pooneyy <85266337+pooneyy@users.noreply.github.com>
Date: Thu, 8 Jan 2026 13:56:44 +0800
Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20feat(nezha-agent):=20add=20uuid=20c?=
 =?UTF-8?q?onfiguration=20and=20update=20documentation?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- add uuid field to data.yml form configuration with required text type
- include uuid environment variable in docker-compose.yml service environment
- restructure readme: move configuration section to bottom and add detailed uuid generation instructions for linux and windows
---
 apps/nezha-agent/1.14.3/data.yml           | 10 +++++++
 apps/nezha-agent/1.14.3/docker-compose.yml |  3 +-
 apps/nezha-agent/README.md                 | 34 +++++++++++++++++++---
 3 files changed, 42 insertions(+), 5 deletions(-)

diff --git a/apps/nezha-agent/1.14.3/data.yml b/apps/nezha-agent/1.14.3/data.yml
index d725954ec..00541d681 100644
--- a/apps/nezha-agent/1.14.3/data.yml
+++ b/apps/nezha-agent/1.14.3/data.yml
@@ -20,6 +20,16 @@ additionalProperties:
         zh: 哪吒客户端密钥
       required: true
       type: password
+    - default: ""
+      edit: true
+      envKey: UUID
+      labelEn: UUID
+      labelZh: UUID
+      label:
+        en: UUID
+        zh: UUID
+      required: true
+      type: text
     - default: "true"
       envKey: DISABLE_COMMAND_EXECUTE
       labelZh: 命令执行
diff --git a/apps/nezha-agent/1.14.3/docker-compose.yml b/apps/nezha-agent/1.14.3/docker-compose.yml
index d617511f0..c41b79328 100644
--- a/apps/nezha-agent/1.14.3/docker-compose.yml
+++ b/apps/nezha-agent/1.14.3/docker-compose.yml
@@ -1,11 +1,12 @@
 services:
   nezha-agent:
     image: kanggle/nezha-agent:v1.14.3
-    container_name: ${CONTAINER_NAME} 
+    container_name: ${CONTAINER_NAME}
     restart: always
     environment:
       - CLIENT_SECRET=${NZ_CLENT_SECRET}
       - SERVER=${NZ_GRPC_URL}
+      - UUID=${UUID}
       - GPU=${GPU}
       - DISABLE_COMMAND_EXECUTE=${DISABLE_COMMAND_EXECUTE}
       - DISABLE_AUTO_UPDATE=true
diff --git a/apps/nezha-agent/README.md b/apps/nezha-agent/README.md
index 4267c5bee..64c744ce8 100644
--- a/apps/nezha-agent/README.md
+++ b/apps/nezha-agent/README.md
@@ -1,7 +1,3 @@
-## 配置和使用说明
-
-哪吒监控添加服务器时，从复制的安装命令里找到 `NZ_CLIENT_SECRET=xxx`，此为客户端密钥。
-
 ## 产品介绍
 
 哪吒监控 Agent 端的容器化部署方案，快速、轻松地启动和管理哪吒监控系统的 Agent 组件。
@@ -10,3 +6,33 @@
 
 - **容器化部署**：简化 Nezha Agent 的部署和配置过程，确保环境一致性。
 - **环境变量配置**：通过环境变量灵活配置，确保配置的安全性和灵活性。
+
+## 配置和使用说明
+
+- 哪吒监控添加服务器时，从复制的安装命令里找到 `NZ_CLIENT_SECRET=xxx`，此为客户端密钥。
+
+- `UUID` 是 agent 的唯一标识，使用以下方法生成：
+  
+  - Linux
+  
+    - Linux 内核
+      ```ba
+      cat /proc/sys/kernel/random/uuid
+      ```
+  
+    - uuidgen
+      ```ba
+      uuidgen
+      ```
+    
+      - 高级用法：基于命名空间生成唯一的 UUID
+  
+          ```bash
+          uuidgen -s -n @url -N "www.example.com/machine-001"
+          ```
+    
+  - PowerShell（Windows）
+  
+    - ```powershell
+      New-Guid
+      ```