1. 项目概述一个现代化的服务器监控与运维面板如果你和我一样管理着几台甚至几十台分布在不同地方的服务器那么“如何高效地监控它们”绝对是个绕不开的痛点。传统的方案比如 Zabbix 或者 Prometheus Grafana功能强大但配置复杂对于中小型团队或个人开发者来说学习成本和维护负担都不小。我们需要的是一个开箱即用、界面直观、能快速部署的“一站式”解决方案。今天要聊的这个项目hanshuaikang/nezha就是这样一个让我眼前一亮的工具。它本质上是一个基于 Go 语言开发的服务器监控与管理面板名字“哪吒”也很有意思寓意着三头六臂能同时照看多个“阵地”。我最初是在 GitHub 上发现它的经过一段时间的部署和使用它已经成为了我日常运维工作中不可或缺的助手。它不仅能实时监控服务器的 CPU、内存、磁盘、网络等基础指标还提供了进程守护、计划任务、反向代理、文件管理等实用功能几乎把单台服务器运维的常见需求都打包进了一个清爽的 Web 界面里。对于谁适合使用它我认为主要是以下几类人独立开发者或小团队拥有多台 VPS 或云服务器希望有一个统一的监控入口对 Linux 运维有一定了解但不想在监控系统上投入过多学习时间需要轻量级的进程保活和任务调度工具。接下来我会结合我的实际部署和使用经验详细拆解这个项目的核心功能、部署要点以及那些官方文档可能没写的“坑”和技巧。2. 核心架构与设计思路拆解2.1 为什么选择 Agent/Server 架构Nezha 采用了经典的 Agent/Server 架构这是其设计精妙之处。简单来说你需要在一台中心服务器可以是你的某台 VPS甚至是一台家里的树莓派上部署nezha-dashboard服务端/面板然后在所有需要被监控的服务器上部署nezha-agent客户端/探针。这种架构的优势非常明显集中化管理所有被监控服务器的状态都汇聚到一个统一的 Web 面板上你无需分别登录每台机器去查看。这对于管理分散在全球或不同云厂商的服务器尤其方便。数据安全与隔离Agent 只负责采集本机数据并通过加密通道上报给 ServerServer 本身不直接暴露在公网访问被监控服务器的端口减少了攻击面。同时监控数据存储在 Server 端即使某台被监控服务器宕机历史数据依然可查。资源消耗低Agent 由 Go 语言编译而成是静态二进制文件无需额外的运行时环境体积小通常几 MB内存占用极低约 10-20 MB对生产服务器的影响微乎其微。扩展性强要新增一台监控只需要在新机器上安装并启动 Agent在 Server 面板上添加即可几乎是无感的横向扩展。这个设计思路决定了 Nezha 的轻量和高效它没有选择去集成所有可能的监控项而是聚焦于服务器运维最核心的指标和功能这也是它能保持简洁易用的关键。2.2 核心功能模块全景在部署之前理解 Nezha 的各个功能模块能帮助你更好地利用它。我们可以把它的功能分为四大块1. 监控告警模块这是基石。Agent 会定时默认间隔采集以下数据并上报资源监控CPU 使用率、负载1m, 5m, 15m、内存使用率、Swap 使用率、磁盘使用率分区级别、网络流量上行/下行。状态监控服务器在线/离线状态、系统启动时间。自定义监控通过 HTTP、TCP、Ping 等方式监控任意服务的端口或可用性。告警通知当任何监控项触发预设的阈值如 CPU 持续 90% 达 5 分钟或服务器离线时可以通过多种渠道发送告警目前支持 Telegram Bot、钉钉、飞书、微信通过 Server 酱等、邮件等。这是保障业务稳定的重要防线。2. 运维管理模块这是让它从“监控工具”升级为“运维面板”的部分。进程守护类似于systemd或supervisor你可以将你的应用如博客、机器人、API 服务交给 Nezha 守护。如果进程意外退出Nezha 会自动将其重启。管理完全在网页上进行比写服务文件更直观。计划任务内置了 Cron 任务管理器。你可以添加定时执行的 Shell 脚本比如定时备份数据库、清理日志、拉取代码等。所有任务的执行日志都可以在面板上查看非常清晰。反向代理一个简易的 HTTP/HTTPS 反向代理功能。你可以为内网的服务比如跑在 8080 端口的应用快速创建一个对外访问的域名需要配合域名解析并自动申请和续签 Let‘s Encrypt SSL 证书。对于快速暴露测试服务或管理内部工具非常有用。文件管理器一个基本的在线文件浏览器支持上传、下载、编辑、删除文件。虽然功能不如专业的 FTP 或网盘但在紧急情况下查看日志或修改配置时能省去 SSH 连接的步骤。3. 安全与通信模块加密通信Agent 与 Server 之间的通信使用 TLS 加密确保监控数据在传输过程中的安全。访问控制Dashboard 支持设置登录用户名和密码。你可以为不同的被监控服务器Agent设置不同的备注和分组便于管理。数据存储默认使用 SQLite 数据库所有配置、监控数据、任务日志都存储在一个文件里备份和迁移非常简单。也支持切换到 MySQL 等数据库以适应更大规模部署。4. 可观测性与报表模块实时图表所有监控指标都以平滑的曲线图展示支持自定义时间范围如最近1小时、24小时、7天。状态总览面板首页以卡片形式展示所有服务器一眼就能看出哪些在线、哪些异常颜色区分非常直观。历史数据监控数据会保留一段时间可配置用于回顾性分析和故障排查。理解了这套功能矩阵你就能明白Nezha 的目标不是替代 Zabbix 或 Prometheus 在超大规模、自定义指标方面的能力而是在易用性、功能集成度和“开箱即用”体验上做到了一个极佳的平衡点。3. 从零开始的部署与配置实战理论说得再多不如动手装一遍。这里我以最常用的场景为例在一台 CentOS 7 的 VPS 上部署 DashboardServer并在另一台 Ubuntu 20.04 的服务器上安装 Agent。我会涵盖过程中的所有关键步骤和决策点。3.1 服务端Dashboard部署详解首先我们需要准备一台服务器作为监控中心。假设它的 IP 是your-server-ip并且已经安装了 Docker 和 Docker Compose。使用 Docker 部署是最推荐的方式能避免环境依赖问题。步骤一准备部署目录与配置文件# 登录到你的中心服务器 ssh rootyour-server-ip # 创建一个专用目录 mkdir -p /opt/nezha-dashboard cd /opt/nezha-dashboard步骤二创建 Docker Compose 配置文件这里我们使用docker-compose.yml来定义服务。Nezha 的 Dashboard 运行需要两个容器一个是应用本身另一个是作为数据库的 SQLite实际上通过卷挂载但为了管理方便我们通常单独声明。version: 3.8 services: nezha-dashboard: image: ghcr.io/naiba/nezha-dashboard:latest container_name: nezha-dashboard restart: always ports: - 8008:8008 # 面板访问端口外部通过8008访问 - 5555:5555 # Agent 上报数据的端口必须对外开放 volumes: - ./data:/app/data # 挂载数据目录持久化配置和数据库 environment: - TZAsia/Shanghai # 设置时区 - SECRET_KEYyour_very_strong_secret_key_here # 必须修改用于加密会话 # 注意官方镜像的默认端口是8008和5555环境变量名可能随版本更新以官方文档为准。关键提示 1端口暴露5555端口是 Agent 连接 Server 的端口必须在服务器的防火墙如 firewalld、ufw和安全组云厂商控制台中放行否则 Agent 无法连接。8008是 Web 面板端口按需放行。关键提示 2SECRET_KEY这是一个至关重要的安全参数。绝对不能使用示例中的值。请使用一个足够长且复杂的随机字符串。你可以用命令openssl rand -base64 32来生成一个。这个密钥一旦设定后续所有 Agent 的添加都需要使用与之匹配的密钥。步骤三启动服务# 在 /opt/nezha-dashboard 目录下执行 docker-compose up -d执行后使用docker-compose logs -f可以查看实时日志确认没有错误。如果一切正常访问http://your-server-ip:8008就能看到 Nezha 的安装引导页面了。步骤四完成网页初始化首次访问会提示你创建管理员账号用户名和密码。设置站点标题等基本信息。在“设置”或“概览”页面找到“添加监控”或“Agent 管理”部分。这里会显示你的“通信密钥Secret”和“服务器地址Server”。记下它们格式通常是your-server-ip:5555和一段长字符串。这是下一步配置 Agent 所必需的。至此服务端就部署完成了。整个过程如果网络通畅5分钟内就能搞定。3.2 客户端Agent安装与连接现在我们去到需要被监控的服务器假设是 Ubuntu 20.04上安装 Agent。方法一使用一键安装脚本推荐Nezha 社区提供了非常方便的一键安装脚本它会自动检测系统架构并下载对应的二进制文件。# 在目标被监控服务器上执行 curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install.sh -o nezha.sh chmod x nezha.sh sudo ./nezha.sh运行脚本后它会以交互式的方式询问你几个关键信息面板地址填写上一步记下的your-server-ip:5555。客户端密钥填写上一步记下的通信密钥Secret。客户端别名给你的这台服务器起个名字比如Web-Server-01。客户端分组可以按用途分组如production,development。填写完毕后脚本会自动下载nezha-agent配置为系统服务使用 systemd并启动。你可以通过systemctl status nezha-agent来检查运行状态。方法二手动安装与配置如果你想更清晰地了解过程或者系统比较特殊可以手动安装。# 1. 根据你的架构下载对应的 Agent 二进制文件以 AMD64 Linux 为例 wget https://github.com/naiba/nezha/releases/latest/download/nezha-agent_linux_amd64.zip unzip nezha-agent_linux_amd64.zip sudo mv nezha-agent /usr/local/bin/ sudo chmod x /usr/local/bin/nezha-agent # 2. 创建 systemd 服务文件 sudo vi /etc/systemd/system/nezha-agent.service将以下内容写入服务文件注意替换YOUR_SERVER和YOUR_SECRET[Unit] DescriptionNezha Agent Afternetwork.target [Service] Typesimple Userroot ExecStart/usr/local/bin/nezha-agent -s YOUR_SERVER:5555 -p YOUR_SECRET Restartalways RestartSec30 [Install] WantedBymulti-user.target然后启动并启用服务sudo systemctl daemon-reload sudo systemctl enable nezha-agent sudo systemctl start nezha-agent sudo systemctl status nezha-agent # 查看状态连接验证 完成 Agent 安装并启动后等待一两分钟刷新 Dashboard 的页面。你应该能在服务器列表里看到新添加的服务器并且其状态显示为“在线”通常是绿色。点击进去就能看到实时的 CPU、内存等监控图表了。实操心得在一键脚本和手动安装中我强烈推荐使用一键脚本尤其是在批量部署时。它不仅省事而且自动处理了服务注册、日志轮转等细节。手动安装的优势在于你对整个流程有完全的控制便于调试和自定义。4. 核心功能深度使用与配置指南部署成功只是第一步真正发挥 Nezha 的威力在于对其功能的深入使用。下面我挑几个最常用也最容易出彩的功能详细说说。4.1 配置告警让监控真正“活”起来监控如果不告警就像汽车没有仪表盘警报灯等发现问题可能就晚了。Nezha 的告警配置非常灵活。1. 配置通知方式首先在 Dashboard 的“设置” - “通知设置”里添加你的告警接收渠道。以最通用的 Telegram Bot 为例在 Telegram 上找BotFather创建一个新的 Bot获得Bot Token。将 Bot 添加到你想要接收消息的群组或频道并发送一条消息。在浏览器中访问https://api.telegram.org/botYourBotToken/getUpdates找到群组的chat_id。在 Nezha 面板中选择通知方式为 Telegram填入Bot Token和Chat ID保存并测试。2. 设置告警规则在服务器详情页或监控项管理页面可以针对具体指标设置规则。例如为“CPU 使用率”添加规则规则名称CPU 过高告警触发条件avg(cpu_usage) 85过去1分钟内平均 CPU 使用率大于85%持续时间5m持续5分钟才触发避免瞬时高峰误报告警间隔30m触发后每隔30分钟重复告警一次直到恢复通知方式选择你刚配置好的 Telegram。这样当某台服务器的 CPU 持续高负荷运行时你的 Telegram 就会收到消息可以立即介入排查。注意事项告警规则不宜设置得过细或过于敏感否则容易产生“告警疲劳”导致真正的告警被忽略。建议从核心指标如离线、CPU、内存、磁盘开始根据业务重要性逐步增加。对于磁盘告警阈值建议设置在85%左右为清理和扩容留出缓冲时间。4.2 进程守护告别 nohup 和 screen这是我最喜欢的功能之一。以前跑个 Python 脚本或 Go 程序得用nohup或screen管理起来很不方便。现在只需要在 Nezha 面板上操作。在服务器管理页面找到“进程守护”标签点击添加名称你的应用名如my-blog。启动命令填写完整的启动命令例如/usr/bin/python3 /opt/app/main.py。关键点必须使用绝对路径因为守护进程的运行环境可能与你的 Shell 环境不同。工作目录命令执行的工作目录如/opt/app。运行用户建议以非 root 用户运行如www-data或appuser更安全。日志文件路径可选指定后可以在面板上直接查看该进程的标准输出和错误日志极其方便。保存后点击“启动”。Nezha 会负责拉起进程并在进程退出时自动重启。你可以在面板上看到进程的 PID、运行时间、内存占用并能随时执行重启、停止操作。踩坑记录我曾经遇到守护的进程启动后秒退但日志里看不到任何错误。后来发现是环境变量问题。比如一个 Python 程序依赖虚拟环境中的包。解决方案是在“启动命令”中通过source命令加载环境或者更稳妥地将完整的解释器路径和依赖路径写进命令例如/opt/venv/bin/python /opt/app/main.py。对于复杂应用建议写一个启动脚本shell script在脚本里设置好所有环境然后让 Nezha 守护这个脚本。4.3 反向代理与 SSL 证书管理这个功能对于快速搭建临时测试环境或管理内部工具非常有用。假设你在服务器192.168.1.100上运行了一个内部服务端口是8080。准备域名假设你有一个域名example.com将其子域名tool.example.com的 A 记录解析到你的 Nezha Dashboard 所在服务器的公网 IP。配置反向代理在 Dashboard 的“反向代理”页面点击添加代理名称内部工具监听域名tool.example.com目标地址http://192.168.1.100:8080如果目标服务在本地可以是http://127.0.0.1:8080启用 SSL勾选。Nezha 会自动通过 Let‘s Encrypt 为你申请并续签免费的 HTTPS 证书。防火墙设置确保你的服务器防火墙和安全组允许80和443端口的入站流量这是 Let’s Encrypt 验证域名和后续 HTTPS 访问所必需的。保存后Nezha 会尝试申请证书。成功后访问https://tool.example.com就会被代理到内网的8080端口服务并且连接是加密的。重要提醒Nezha 的反向代理功能相对简单适用于低频、内部或测试用途。对于高并发、生产级的流量代理建议还是使用专业的 Nginx 或 Caddy。另外Let‘s Encrypt 有速率限制频繁地添加/删除域名可能会导致临时被限。5. 高级技巧、问题排查与维护心得经过一段时间的深度使用我积累了一些超出基础文档的经验和解决问题的方法。5.1 性能优化与数据清理Nezha 默认使用 SQLite对于监控几十台服务器、保留数周数据来说完全没问题。但如果你监控的服务器很多或者希望保留更长时间的历史数据就需要做一些优化。调整数据保留策略在docker-compose.yml的环境变量中可以设置DATA_RETENTION_DAYS来控制监控数据保留的天数。默认可能是30天。根据你的磁盘空间和需求调整。environment: - DATA_RETENTION_DAYS90监控 Dashboard 本身别忘了运行 Dashboard 的服务器本身也是一台需要被监控的机器。你可以在它上面也安装 Agent连接到另一个 Nezha 实例或者就它自己虽然有点自指监控其资源使用情况确保监控系统自身健康。定期备份/opt/nezha-dashboard/data目录下的nezha.db文件包含了所有配置和监控数据。定期备份这个目录是良好的习惯。可以写一个简单的 Cron 任务用tar打包后传到异地存储。5.2 常见问题与排查实录问题一Agent 显示“离线”或“超时”这是最常见的问题。检查网络连通性在 Agent 服务器上执行telnet your-dashboard-ip 5555或curl -v http://your-dashboard-ip:5555。如果连接失败说明网络不通。排查防火墙确认 Dashboard 服务器的5555端口在防火墙firewall-cmd/ufw和云服务商安全组中已放行。检查 Agent 配置确认nezha-agent.service文件或一键脚本填写的 Server 地址和 Secret 完全正确没有多余的空格。检查 Agent 进程状态在 Agent 服务器上执行systemctl status nezha-agent查看是否在运行以及日志 (journalctl -u nezha-agent -f) 是否有错误信息。检查 Dashboard 日志在 Dashboard 服务器上执行docker-compose logs nezha-dashboard查看是否有连接错误。问题二监控数据不更新或延迟很大检查服务器时间确保 Dashboard 服务器和所有 Agent 服务器的系统时间同步使用 NTP。时间不同步会导致数据时间戳错乱。检查资源负载可能是 Agent 或 Dashboard 服务器负载过高导致数据处理延迟。通过面板本身监控它们的资源使用情况。调整上报间隔谨慎Agent 默认的上报间隔是合理的。非必要不建议调整会增加双方负载。问题三进程守护失败不断重启查看进程日志在 Nezha 面板的进程守护页面直接查看该进程的日志输出通常错误信息会直接显示在这里。检查命令路径和权限确保“启动命令”中的每一个二进制文件或脚本都存在且可执行。确保“运行用户”有权限访问工作目录和相关的文件。模拟环境执行切换到指定的“运行用户”在“工作目录”下手动执行“启动命令”看是否能成功运行。这是最直接的调试方法。5.3 安全加固建议强化 Dashboard 访问修改默认端口将8008端口改为一个不常见的端口。设置强密码管理员账户使用高强度、唯一的密码。使用 HTTPS强烈建议在 Dashboard 前放置一个 Nginx 或 Caddy 反向代理配置 SSL 证书强制 HTTPS 访问。不要将 HTTP 版本的 Dashboard 直接暴露在公网。IP 白名单如果可能在反向代理或服务器防火墙层面只允许特定的管理 IP 访问 Dashboard 端口。保护通信密钥SECRET_KEY和每个 Agent 的Secret是核心机密不要泄露。最小化 Agent 权限如果可能不要让 Agent 以 root 身份运行。可以创建一个专用用户并给予其读取系统状态如/proc,/sys的必要权限。不过监控某些信息如所有进程可能需要 root 权限需权衡。我个人在实际使用中的体会是Nezha 完美地填补了简单脚本监控和重型企业监控系统之间的空白。它降低了一线开发者和运维人员实施有效监控的门槛。它的“All-in-One”设计理念让维护成本大大降低——你只需要维护一个 Docker 容器和一堆轻量级的 Agent。对于中小项目和个人服务器集群来说它的功能已经绰绰有余甚至有些富余。最后分享一个小技巧你可以利用它的“计划任务”功能定期执行docker system prune -a来清理无用的 Docker 镜像和容器或者执行备份脚本让这个监控面板同时也成为一个轻量级的自动化运维中心。 Nezha：轻量级服务器监控与运维面板的架构解析与实践指南
1. 项目概述一个现代化的服务器监控与运维面板如果你和我一样管理着几台甚至几十台分布在不同地方的服务器那么“如何高效地监控它们”绝对是个绕不开的痛点。传统的方案比如 Zabbix 或者 Prometheus Grafana功能强大但配置复杂对于中小型团队或个人开发者来说学习成本和维护负担都不小。我们需要的是一个开箱即用、界面直观、能快速部署的“一站式”解决方案。今天要聊的这个项目hanshuaikang/nezha就是这样一个让我眼前一亮的工具。它本质上是一个基于 Go 语言开发的服务器监控与管理面板名字“哪吒”也很有意思寓意着三头六臂能同时照看多个“阵地”。我最初是在 GitHub 上发现它的经过一段时间的部署和使用它已经成为了我日常运维工作中不可或缺的助手。它不仅能实时监控服务器的 CPU、内存、磁盘、网络等基础指标还提供了进程守护、计划任务、反向代理、文件管理等实用功能几乎把单台服务器运维的常见需求都打包进了一个清爽的 Web 界面里。对于谁适合使用它我认为主要是以下几类人独立开发者或小团队拥有多台 VPS 或云服务器希望有一个统一的监控入口对 Linux 运维有一定了解但不想在监控系统上投入过多学习时间需要轻量级的进程保活和任务调度工具。接下来我会结合我的实际部署和使用经验详细拆解这个项目的核心功能、部署要点以及那些官方文档可能没写的“坑”和技巧。2. 核心架构与设计思路拆解2.1 为什么选择 Agent/Server 架构Nezha 采用了经典的 Agent/Server 架构这是其设计精妙之处。简单来说你需要在一台中心服务器可以是你的某台 VPS甚至是一台家里的树莓派上部署nezha-dashboard服务端/面板然后在所有需要被监控的服务器上部署nezha-agent客户端/探针。这种架构的优势非常明显集中化管理所有被监控服务器的状态都汇聚到一个统一的 Web 面板上你无需分别登录每台机器去查看。这对于管理分散在全球或不同云厂商的服务器尤其方便。数据安全与隔离Agent 只负责采集本机数据并通过加密通道上报给 ServerServer 本身不直接暴露在公网访问被监控服务器的端口减少了攻击面。同时监控数据存储在 Server 端即使某台被监控服务器宕机历史数据依然可查。资源消耗低Agent 由 Go 语言编译而成是静态二进制文件无需额外的运行时环境体积小通常几 MB内存占用极低约 10-20 MB对生产服务器的影响微乎其微。扩展性强要新增一台监控只需要在新机器上安装并启动 Agent在 Server 面板上添加即可几乎是无感的横向扩展。这个设计思路决定了 Nezha 的轻量和高效它没有选择去集成所有可能的监控项而是聚焦于服务器运维最核心的指标和功能这也是它能保持简洁易用的关键。2.2 核心功能模块全景在部署之前理解 Nezha 的各个功能模块能帮助你更好地利用它。我们可以把它的功能分为四大块1. 监控告警模块这是基石。Agent 会定时默认间隔采集以下数据并上报资源监控CPU 使用率、负载1m, 5m, 15m、内存使用率、Swap 使用率、磁盘使用率分区级别、网络流量上行/下行。状态监控服务器在线/离线状态、系统启动时间。自定义监控通过 HTTP、TCP、Ping 等方式监控任意服务的端口或可用性。告警通知当任何监控项触发预设的阈值如 CPU 持续 90% 达 5 分钟或服务器离线时可以通过多种渠道发送告警目前支持 Telegram Bot、钉钉、飞书、微信通过 Server 酱等、邮件等。这是保障业务稳定的重要防线。2. 运维管理模块这是让它从“监控工具”升级为“运维面板”的部分。进程守护类似于systemd或supervisor你可以将你的应用如博客、机器人、API 服务交给 Nezha 守护。如果进程意外退出Nezha 会自动将其重启。管理完全在网页上进行比写服务文件更直观。计划任务内置了 Cron 任务管理器。你可以添加定时执行的 Shell 脚本比如定时备份数据库、清理日志、拉取代码等。所有任务的执行日志都可以在面板上查看非常清晰。反向代理一个简易的 HTTP/HTTPS 反向代理功能。你可以为内网的服务比如跑在 8080 端口的应用快速创建一个对外访问的域名需要配合域名解析并自动申请和续签 Let‘s Encrypt SSL 证书。对于快速暴露测试服务或管理内部工具非常有用。文件管理器一个基本的在线文件浏览器支持上传、下载、编辑、删除文件。虽然功能不如专业的 FTP 或网盘但在紧急情况下查看日志或修改配置时能省去 SSH 连接的步骤。3. 安全与通信模块加密通信Agent 与 Server 之间的通信使用 TLS 加密确保监控数据在传输过程中的安全。访问控制Dashboard 支持设置登录用户名和密码。你可以为不同的被监控服务器Agent设置不同的备注和分组便于管理。数据存储默认使用 SQLite 数据库所有配置、监控数据、任务日志都存储在一个文件里备份和迁移非常简单。也支持切换到 MySQL 等数据库以适应更大规模部署。4. 可观测性与报表模块实时图表所有监控指标都以平滑的曲线图展示支持自定义时间范围如最近1小时、24小时、7天。状态总览面板首页以卡片形式展示所有服务器一眼就能看出哪些在线、哪些异常颜色区分非常直观。历史数据监控数据会保留一段时间可配置用于回顾性分析和故障排查。理解了这套功能矩阵你就能明白Nezha 的目标不是替代 Zabbix 或 Prometheus 在超大规模、自定义指标方面的能力而是在易用性、功能集成度和“开箱即用”体验上做到了一个极佳的平衡点。3. 从零开始的部署与配置实战理论说得再多不如动手装一遍。这里我以最常用的场景为例在一台 CentOS 7 的 VPS 上部署 DashboardServer并在另一台 Ubuntu 20.04 的服务器上安装 Agent。我会涵盖过程中的所有关键步骤和决策点。3.1 服务端Dashboard部署详解首先我们需要准备一台服务器作为监控中心。假设它的 IP 是your-server-ip并且已经安装了 Docker 和 Docker Compose。使用 Docker 部署是最推荐的方式能避免环境依赖问题。步骤一准备部署目录与配置文件# 登录到你的中心服务器 ssh rootyour-server-ip # 创建一个专用目录 mkdir -p /opt/nezha-dashboard cd /opt/nezha-dashboard步骤二创建 Docker Compose 配置文件这里我们使用docker-compose.yml来定义服务。Nezha 的 Dashboard 运行需要两个容器一个是应用本身另一个是作为数据库的 SQLite实际上通过卷挂载但为了管理方便我们通常单独声明。version: 3.8 services: nezha-dashboard: image: ghcr.io/naiba/nezha-dashboard:latest container_name: nezha-dashboard restart: always ports: - 8008:8008 # 面板访问端口外部通过8008访问 - 5555:5555 # Agent 上报数据的端口必须对外开放 volumes: - ./data:/app/data # 挂载数据目录持久化配置和数据库 environment: - TZAsia/Shanghai # 设置时区 - SECRET_KEYyour_very_strong_secret_key_here # 必须修改用于加密会话 # 注意官方镜像的默认端口是8008和5555环境变量名可能随版本更新以官方文档为准。关键提示 1端口暴露5555端口是 Agent 连接 Server 的端口必须在服务器的防火墙如 firewalld、ufw和安全组云厂商控制台中放行否则 Agent 无法连接。8008是 Web 面板端口按需放行。关键提示 2SECRET_KEY这是一个至关重要的安全参数。绝对不能使用示例中的值。请使用一个足够长且复杂的随机字符串。你可以用命令openssl rand -base64 32来生成一个。这个密钥一旦设定后续所有 Agent 的添加都需要使用与之匹配的密钥。步骤三启动服务# 在 /opt/nezha-dashboard 目录下执行 docker-compose up -d执行后使用docker-compose logs -f可以查看实时日志确认没有错误。如果一切正常访问http://your-server-ip:8008就能看到 Nezha 的安装引导页面了。步骤四完成网页初始化首次访问会提示你创建管理员账号用户名和密码。设置站点标题等基本信息。在“设置”或“概览”页面找到“添加监控”或“Agent 管理”部分。这里会显示你的“通信密钥Secret”和“服务器地址Server”。记下它们格式通常是your-server-ip:5555和一段长字符串。这是下一步配置 Agent 所必需的。至此服务端就部署完成了。整个过程如果网络通畅5分钟内就能搞定。3.2 客户端Agent安装与连接现在我们去到需要被监控的服务器假设是 Ubuntu 20.04上安装 Agent。方法一使用一键安装脚本推荐Nezha 社区提供了非常方便的一键安装脚本它会自动检测系统架构并下载对应的二进制文件。# 在目标被监控服务器上执行 curl -L https://raw.githubusercontent.com/naiba/nezha/master/script/install.sh -o nezha.sh chmod x nezha.sh sudo ./nezha.sh运行脚本后它会以交互式的方式询问你几个关键信息面板地址填写上一步记下的your-server-ip:5555。客户端密钥填写上一步记下的通信密钥Secret。客户端别名给你的这台服务器起个名字比如Web-Server-01。客户端分组可以按用途分组如production,development。填写完毕后脚本会自动下载nezha-agent配置为系统服务使用 systemd并启动。你可以通过systemctl status nezha-agent来检查运行状态。方法二手动安装与配置如果你想更清晰地了解过程或者系统比较特殊可以手动安装。# 1. 根据你的架构下载对应的 Agent 二进制文件以 AMD64 Linux 为例 wget https://github.com/naiba/nezha/releases/latest/download/nezha-agent_linux_amd64.zip unzip nezha-agent_linux_amd64.zip sudo mv nezha-agent /usr/local/bin/ sudo chmod x /usr/local/bin/nezha-agent # 2. 创建 systemd 服务文件 sudo vi /etc/systemd/system/nezha-agent.service将以下内容写入服务文件注意替换YOUR_SERVER和YOUR_SECRET[Unit] DescriptionNezha Agent Afternetwork.target [Service] Typesimple Userroot ExecStart/usr/local/bin/nezha-agent -s YOUR_SERVER:5555 -p YOUR_SECRET Restartalways RestartSec30 [Install] WantedBymulti-user.target然后启动并启用服务sudo systemctl daemon-reload sudo systemctl enable nezha-agent sudo systemctl start nezha-agent sudo systemctl status nezha-agent # 查看状态连接验证 完成 Agent 安装并启动后等待一两分钟刷新 Dashboard 的页面。你应该能在服务器列表里看到新添加的服务器并且其状态显示为“在线”通常是绿色。点击进去就能看到实时的 CPU、内存等监控图表了。实操心得在一键脚本和手动安装中我强烈推荐使用一键脚本尤其是在批量部署时。它不仅省事而且自动处理了服务注册、日志轮转等细节。手动安装的优势在于你对整个流程有完全的控制便于调试和自定义。4. 核心功能深度使用与配置指南部署成功只是第一步真正发挥 Nezha 的威力在于对其功能的深入使用。下面我挑几个最常用也最容易出彩的功能详细说说。4.1 配置告警让监控真正“活”起来监控如果不告警就像汽车没有仪表盘警报灯等发现问题可能就晚了。Nezha 的告警配置非常灵活。1. 配置通知方式首先在 Dashboard 的“设置” - “通知设置”里添加你的告警接收渠道。以最通用的 Telegram Bot 为例在 Telegram 上找BotFather创建一个新的 Bot获得Bot Token。将 Bot 添加到你想要接收消息的群组或频道并发送一条消息。在浏览器中访问https://api.telegram.org/botYourBotToken/getUpdates找到群组的chat_id。在 Nezha 面板中选择通知方式为 Telegram填入Bot Token和Chat ID保存并测试。2. 设置告警规则在服务器详情页或监控项管理页面可以针对具体指标设置规则。例如为“CPU 使用率”添加规则规则名称CPU 过高告警触发条件avg(cpu_usage) 85过去1分钟内平均 CPU 使用率大于85%持续时间5m持续5分钟才触发避免瞬时高峰误报告警间隔30m触发后每隔30分钟重复告警一次直到恢复通知方式选择你刚配置好的 Telegram。这样当某台服务器的 CPU 持续高负荷运行时你的 Telegram 就会收到消息可以立即介入排查。注意事项告警规则不宜设置得过细或过于敏感否则容易产生“告警疲劳”导致真正的告警被忽略。建议从核心指标如离线、CPU、内存、磁盘开始根据业务重要性逐步增加。对于磁盘告警阈值建议设置在85%左右为清理和扩容留出缓冲时间。4.2 进程守护告别 nohup 和 screen这是我最喜欢的功能之一。以前跑个 Python 脚本或 Go 程序得用nohup或screen管理起来很不方便。现在只需要在 Nezha 面板上操作。在服务器管理页面找到“进程守护”标签点击添加名称你的应用名如my-blog。启动命令填写完整的启动命令例如/usr/bin/python3 /opt/app/main.py。关键点必须使用绝对路径因为守护进程的运行环境可能与你的 Shell 环境不同。工作目录命令执行的工作目录如/opt/app。运行用户建议以非 root 用户运行如www-data或appuser更安全。日志文件路径可选指定后可以在面板上直接查看该进程的标准输出和错误日志极其方便。保存后点击“启动”。Nezha 会负责拉起进程并在进程退出时自动重启。你可以在面板上看到进程的 PID、运行时间、内存占用并能随时执行重启、停止操作。踩坑记录我曾经遇到守护的进程启动后秒退但日志里看不到任何错误。后来发现是环境变量问题。比如一个 Python 程序依赖虚拟环境中的包。解决方案是在“启动命令”中通过source命令加载环境或者更稳妥地将完整的解释器路径和依赖路径写进命令例如/opt/venv/bin/python /opt/app/main.py。对于复杂应用建议写一个启动脚本shell script在脚本里设置好所有环境然后让 Nezha 守护这个脚本。4.3 反向代理与 SSL 证书管理这个功能对于快速搭建临时测试环境或管理内部工具非常有用。假设你在服务器192.168.1.100上运行了一个内部服务端口是8080。准备域名假设你有一个域名example.com将其子域名tool.example.com的 A 记录解析到你的 Nezha Dashboard 所在服务器的公网 IP。配置反向代理在 Dashboard 的“反向代理”页面点击添加代理名称内部工具监听域名tool.example.com目标地址http://192.168.1.100:8080如果目标服务在本地可以是http://127.0.0.1:8080启用 SSL勾选。Nezha 会自动通过 Let‘s Encrypt 为你申请并续签免费的 HTTPS 证书。防火墙设置确保你的服务器防火墙和安全组允许80和443端口的入站流量这是 Let’s Encrypt 验证域名和后续 HTTPS 访问所必需的。保存后Nezha 会尝试申请证书。成功后访问https://tool.example.com就会被代理到内网的8080端口服务并且连接是加密的。重要提醒Nezha 的反向代理功能相对简单适用于低频、内部或测试用途。对于高并发、生产级的流量代理建议还是使用专业的 Nginx 或 Caddy。另外Let‘s Encrypt 有速率限制频繁地添加/删除域名可能会导致临时被限。5. 高级技巧、问题排查与维护心得经过一段时间的深度使用我积累了一些超出基础文档的经验和解决问题的方法。5.1 性能优化与数据清理Nezha 默认使用 SQLite对于监控几十台服务器、保留数周数据来说完全没问题。但如果你监控的服务器很多或者希望保留更长时间的历史数据就需要做一些优化。调整数据保留策略在docker-compose.yml的环境变量中可以设置DATA_RETENTION_DAYS来控制监控数据保留的天数。默认可能是30天。根据你的磁盘空间和需求调整。environment: - DATA_RETENTION_DAYS90监控 Dashboard 本身别忘了运行 Dashboard 的服务器本身也是一台需要被监控的机器。你可以在它上面也安装 Agent连接到另一个 Nezha 实例或者就它自己虽然有点自指监控其资源使用情况确保监控系统自身健康。定期备份/opt/nezha-dashboard/data目录下的nezha.db文件包含了所有配置和监控数据。定期备份这个目录是良好的习惯。可以写一个简单的 Cron 任务用tar打包后传到异地存储。5.2 常见问题与排查实录问题一Agent 显示“离线”或“超时”这是最常见的问题。检查网络连通性在 Agent 服务器上执行telnet your-dashboard-ip 5555或curl -v http://your-dashboard-ip:5555。如果连接失败说明网络不通。排查防火墙确认 Dashboard 服务器的5555端口在防火墙firewall-cmd/ufw和云服务商安全组中已放行。检查 Agent 配置确认nezha-agent.service文件或一键脚本填写的 Server 地址和 Secret 完全正确没有多余的空格。检查 Agent 进程状态在 Agent 服务器上执行systemctl status nezha-agent查看是否在运行以及日志 (journalctl -u nezha-agent -f) 是否有错误信息。检查 Dashboard 日志在 Dashboard 服务器上执行docker-compose logs nezha-dashboard查看是否有连接错误。问题二监控数据不更新或延迟很大检查服务器时间确保 Dashboard 服务器和所有 Agent 服务器的系统时间同步使用 NTP。时间不同步会导致数据时间戳错乱。检查资源负载可能是 Agent 或 Dashboard 服务器负载过高导致数据处理延迟。通过面板本身监控它们的资源使用情况。调整上报间隔谨慎Agent 默认的上报间隔是合理的。非必要不建议调整会增加双方负载。问题三进程守护失败不断重启查看进程日志在 Nezha 面板的进程守护页面直接查看该进程的日志输出通常错误信息会直接显示在这里。检查命令路径和权限确保“启动命令”中的每一个二进制文件或脚本都存在且可执行。确保“运行用户”有权限访问工作目录和相关的文件。模拟环境执行切换到指定的“运行用户”在“工作目录”下手动执行“启动命令”看是否能成功运行。这是最直接的调试方法。5.3 安全加固建议强化 Dashboard 访问修改默认端口将8008端口改为一个不常见的端口。设置强密码管理员账户使用高强度、唯一的密码。使用 HTTPS强烈建议在 Dashboard 前放置一个 Nginx 或 Caddy 反向代理配置 SSL 证书强制 HTTPS 访问。不要将 HTTP 版本的 Dashboard 直接暴露在公网。IP 白名单如果可能在反向代理或服务器防火墙层面只允许特定的管理 IP 访问 Dashboard 端口。保护通信密钥SECRET_KEY和每个 Agent 的Secret是核心机密不要泄露。最小化 Agent 权限如果可能不要让 Agent 以 root 身份运行。可以创建一个专用用户并给予其读取系统状态如/proc,/sys的必要权限。不过监控某些信息如所有进程可能需要 root 权限需权衡。我个人在实际使用中的体会是Nezha 完美地填补了简单脚本监控和重型企业监控系统之间的空白。它降低了一线开发者和运维人员实施有效监控的门槛。它的“All-in-One”设计理念让维护成本大大降低——你只需要维护一个 Docker 容器和一堆轻量级的 Agent。对于中小项目和个人服务器集群来说它的功能已经绰绰有余甚至有些富余。最后分享一个小技巧你可以利用它的“计划任务”功能定期执行docker system prune -a来清理无用的 Docker 镜像和容器或者执行备份脚本让这个监控面板同时也成为一个轻量级的自动化运维中心。