**哪吒监控 V1
开源、轻量、易用的服务器监控与运维工具**

准备工作

搭建哪吒监控的 Dashboard，你需要：

**一台可以连接公网的服务器。防火墙和安全策略需放行 8008 端口，否则无法访问或接收数据。单核 512MB 内存的服务器即可满足大多数使用场景。
一个已设置好 A 记录，指向 Dashboard 服务器 IP 的域名。**

如果你想使用 CDN，请准备两个域名：

一个配置好 CDN，用作公开访问，CDN 需支持 WebSocket 协议； 另一个域名不使用 CDN，用作 Agent 与
Dashboard 的通信。 尽管 V1 版本不再区分访问端口和通信端口，但由于不同厂商的 CDN
配置可能导致通信异常，仅建议按上述方式准备域名（非强制要求）。

在服务器中安装 Dashboard

在面板服务器中，运行以下安装脚本：

curl -L https://raw.githubusercontent.com/nezhahq/scripts/refs/heads/main/install.sh -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh

如果你的服务器位于中国大陆，可以使用镜像：

curl -L https://gitee.com/naibahq/scripts/raw/main/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh

以 Docker 安装为例(建议不要docker安装），安装完成后按提示输入以下信息：
请输入站点标题: - 自定义站点标题。
请输入暴露端口: - 公开访问端口（默认 8008，可自定义）。
请指定后台语言: - 选择语言偏好。

输入完成后，等待拉取 Docker 镜像。安装结束后，如果一切正常，你可以通过域名和端口号访问 Dashboard，例如：
http://dashboard.example.com:8008

如果需要再次运行安装脚本，可输入以下命令：

./nezha.sh

打开管理脚本。
登录到 Dashboard 配置界面
后台管理界面的路径为 /dashboard，你只需访问：
http://域名/IP:端口/dashboard

首次登录的默认用户名和密码均为 admin。

WARNING
默认密码为弱密码，对于高权限的面板来说，使用弱密码非常危险！
建议安装后立即进入管理页面：点击头像 → “个人信息” → “更新个人资料”修改密码。
建议密码长度至少 18 位，并混合大小写字母、数字及符号。

安装 Agent

哪吒监控的被控端服务被称为 Agent，本文档将介绍如何在被控端服务器上安装 Agent，并与 Dashboard 连接
一键安装 Agent
哪吒监控支持在 Windows、macOS 和 Linux 上一键安装 Agent。遵循本文档的步骤，你可以轻松地在服务器上部署它。

准备工作

在安装前，需要提前在管理面板中设置通信域名，该域名不建议接入 CDN。本文档以示例通信域名 “data.example.com” 为例。
在后台管理面板点击头像，进入“系统设置”页。
在“Agent 对接地址【域名/IP:端口】”项中填入通信域名和端口 “data.example.com:8008”。
点击“确认”保存设置。
一键安装步骤
在 服务器 页面中，点击 安装命令 并选择对应操作系统，安装命令将自动复制到你的剪贴板。
在被控端服务器中运行安装命令，等待安装完成后返回到 服务器 页面查看是否上线。
如果安装成功，页面中将自动弹出新的服务器，你可以点击编辑按钮为其设置名称。
平台特有说明
Windows 特殊说明
在 Windows 服务器中，运行 PowerShell。
在 PowerShell 中粘贴并运行安装命令。
如遇到「执行策略变更」确认提示，输入 Y 并回车。

在 Windows 系统中手动安装 Agent

Windows 系统除了一键脚本，也可以下载对应的二进制文件并手动配置，以下是详细步骤：

  1. 准备工作
    确保管理员权限
    使用管理员账户登录 Windows 系统。

安装必要工具

确保有解压工具（如 7-Zip 或 WinRAR）。

  1. 下载 Nezha Agent
    确认系统架构

Windows 系统一般为 amd64 架构，可直接下载对应的二进制文件。
下载 Nezha Agent 文件

访问 Nezha Agent Releases，下载适用于 Windows 的版本，例如：

nezha-agent_windows_amd64.zip

解压文件

将下载的压缩包解压到指定目录，例如：C:\nezha。

  1. 创建配置文件
    创建并编辑配置文件
    在解压目录中创建 config.yml 文件，内容如下：

    client_secret: your_agent_secret
    debug: false
    disable_auto_update: false
    disable_command_execute: false
    disable_force_update: false
    disable_nat: false
    disable_send_query: false
    gpu: false
    insecure_tls: false
    ip_report_period: 1800
    report_delay: 1
    server: data.example.com:8008
    skip_connection_count: false
    skip_procs_count: false
    temperature: false
    tls: false
    use_gitee_to_upgrade: false
    use_ipv6_country_code: false
    uuid: your_uuid

字段说明：
server：替换为您的 Dashboard 地址和端口，例如 data.example.com:8008 1.1.1.1:8008 "[2606:4700:4700::1111]:8008"。
client_secret：替换为 Dashboard 的 agentsecretkey，通常位于 /opt/nezha/dashboard/data/config.yaml 文件中。
uuid：可以通过在线工具生成。
保存文件
将文件保存为 config.yml，存放在 Agent 的目录中。

  1. 运行 Agent
    以管理员权限运行 Agent
    打开命令提示符，进入 Agent 的目录并运行以下命令：

    nezha-agent.exe -c config.yml

验证连接

登录 Dashboard，查看是否有新设备上线。
如果日志中没有报错信息，说明安装成功。

  1. 设置为服务运行
    安装为服务

进入 Agent 的目录，在命令提示符中运行：

nezha-agent.exe service install

启动服务

安装成功后，Agent 会自动以服务形式启动，重启系统时也会自动运行。
卸载服务

如需卸载服务，运行以下命令：

nezha-agent.exe service uninstall