44 lines
20 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>一键安装Agent | 哪吒监控</title>
<meta name="description" content="哪吒监控是一个轻量化的运维工具">
<link rel="stylesheet" href="/assets/style.c3210e46.css">
<link rel="modulepreload" href="/assets/app.13513b34.js">
<link rel="modulepreload" href="/assets/guide_agent.md.69fc9967.lean.js">
<meta name="twitter:title" content="一键安装Agent | 哪吒监控">
<meta property="og:title" content="一键安装Agent | 哪吒监控">
</head>
<body>
<div id="app"><!--[--><div class="theme"><header class="nav-bar" data-v-675d8756><div class="sidebar-button" data-v-675d8756><svg class="icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z" class></path></svg></div><a class="nav-bar-title" href="/" aria-label="哪吒监控, back to home" data-v-675d8756 data-v-cc01ef16><!----> 哪吒监控</a><div class="flex-grow" data-v-675d8756></div><div class="nav" data-v-675d8756><nav class="nav-links" data-v-675d8756 data-v-eab3edfe><!--[--><div class="item" data-v-eab3edfe><div class="nav-link" data-v-eab3edfe data-v-b8818f8c><a class="item active" href="/" data-v-b8818f8c>使用指南 <!----></a></div></div><div class="item" data-v-eab3edfe><div class="nav-link" data-v-eab3edfe data-v-b8818f8c><a class="item" href="/developer/basics" data-v-b8818f8c>开发手册 <!----></a></div></div><!--]--><div class="item" data-v-eab3edfe><div class="nav-dropdown-link" data-v-eab3edfe data-v-56bf3a3f><button class="button" data-v-56bf3a3f><span class="button-text" data-v-56bf3a3f>Languages</span><span class="right button-arrow" data-v-56bf3a3f></span></button><ul class="dialog" data-v-56bf3a3f><!--[--><li class="dialog-item" data-v-56bf3a3f><div class="nav-dropdown-link-item" data-v-56bf3a3f data-v-bbc27490><a class="item active" href="/guide/agent.html" data-v-bbc27490><span class="arrow" data-v-bbc27490></span><span class="text" data-v-bbc27490>简体中文</span><span class="icon" data-v-bbc27490><!----></span></a></div></li><li class="dialog-item" data-v-56bf3a3f><div class="nav-dropdown-link-item" data-v-56bf3a3f data-v-bbc27490><a class="item" href="/en_US/guide/agent.html" data-v-bbc27490><span class="arrow" data-v-bbc27490></span><span class="text" data-v-bbc27490>English</span><span class="icon" data-v-bbc27490><!----></span></a></div></li><!--]--></ul></div></div><div class="item" data-v-eab3edfe><div class="nav-link" data-v-eab3edfe data-v-b8818f8c><a class="item isExternal" href="https://github.com/nezhahq/nezhahq.github.io" target="_blank" rel="noopener noreferrer" data-v-b8818f8c>GitHub <svg class="icon outbound" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewbox="0 0 100 100" width="15" height="15" data-v-b8818f8c><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div></div></nav></div><!--[--><!--]--></header><aside class="sidebar" data-v-83e92a68><nav class="nav-links nav" data-v-83e92a68 data-v-eab3edfe><!--[--><div class="item" data-v-eab3edfe><div class="nav-link" data-v-eab3edfe data-v-b8818f8c><a class="item active" href="/" data-v-b8818f8c>使用指南 <!----></a></div></div><div class="item" data-v-eab3edfe><div class="nav-link" data-v-eab3edfe data-v-b8818f8c><a class="item" href="/developer/basics" data-v-b8818f8c>开发手册 <!----></a></div></div><!--]--><div class="item" data-v-eab3edfe><div class="nav-dropdown-link" data-v-eab3edfe data-v-56bf3a3f><button class="button" data-v-56bf3a3f><span class="button-text" data-v-56bf3a3f>Languages</span><span class="right button-arrow" data-v-56bf3a3f></span></button><ul class="dialog" data-v-56bf3a3f><!--[--><li class="dialog-item" data-v-56bf3a3f><div class="nav-dropdown-link-item" data-v-56bf3a3f data-v-bbc27490><a class="item active" href="/guide/agent.html" data-v-bbc27490><span class="arrow" data-v-bbc27490></span><span class="text" data-v-bbc27490>简体中文</span><span class="icon" data-v-bbc27490><!----></span></a></div></li><li class="dialog-item" data-v-56bf3a3f><div class="nav-dropdown-link-item" data-v-56bf3a3f data-v-bbc27490><a class="item" href="/en_US/guide/agent.html" data-v-bbc27490><span class="arrow" data-v-bbc27490></span><span class="text" data-v-bbc27490>English</span><span class="icon" data-v-bbc27490><!----></span></a></div></li><!--]--></ul></div></div><div class="item" data-v-eab3edfe><div class="nav-link" data-v-eab3edfe data-v-b8818f8c><a class="item isExternal" href="https://github.com/nezhahq/nezhahq.github.io" target="_blank" rel="noopener noreferrer" data-v-b8818f8c>GitHub <svg class="icon outbound" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewbox="0 0 100 100" width="15" height="15" data-v-b8818f8c><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div></div></nav><!--[--><!--]--><ul class="sidebar-links" data-v-83e92a68><!--[--><li class="sidebar-link"><p class="sidebar-link-item">哪吒监控</p><ul class="sidebar-links"><li class="sidebar-link"><a class="sidebar-link-item" href="/">介绍</a><!----></li></ul></li><li class="sidebar-link"><p class="sidebar-link-item">安装手册</p><ul class="sidebar-links"><li class="sidebar-link"><a class="sidebar-link-item" href="/guide/dashboard">安装 Dashboard</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item active" href="/guide/agent">安装 Agent</a><ul class="sidebar-links"><li class="sidebar-link"><a class="sidebar-link-item" href="#一键安装agent">一键安装Agent</a><ul class="sidebar-links"><li class="sidebar-link"><a class="sidebar-link-item" href="#准备工作">准备工作</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="#linux一键安装">Linux一键安装</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="#windows一键安装">Windows一键安装</a><!----></li></ul></li><li class="sidebar-link"><a class="sidebar-link-item" href="#其他方式安装agent">其他方式安装Agent</a><ul class="sidebar-links"><li class="sidebar-link"><a class="sidebar-link-item" href="#linux安装agent">Linux安装Agent</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="#windows安装agent">Windows安装Agent</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="#openwrt安装agent">OpenWRT安装Agent</a><!----></li></ul></li><li class="sidebar-link"><a class="sidebar-link-item" href="#自定义agent监控项目">自定义Agent监控项目</a><!----></li></ul></li></ul></li><li class="sidebar-link"><p class="sidebar-link-item">管理面板配置</p><ul class="sidebar-links"><li class="sidebar-link"><a class="sidebar-link-item" href="/guide/servers">主机</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="/guide/services">服务</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="/guide/tasks">定时任务</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="/guide/notifications">报警通知</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="/guide/settings">设置</a><!----></li></ul></li><li class="sidebar-link"><p class="sidebar-link-item">常见问题</p><ul class="sidebar-links"><li class="sidebar-link"><a class="sidebar-link-item" href="/guide/q1">TG api被墙</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="/guide/q2">问题2</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="/guide/q3">问题3</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="/guide/q4">问题4</a><!----></li><li class="sidebar-link"><a class="sidebar-link-item" href="/guide/q5">问题5</a><!----></li></ul></li><!--]--></ul><!--[--><!--]--></aside><div class="sidebar-mask"></div><main class="page" data-v-7eddb2c4><div class="container" data-v-7eddb2c4><!--[--><!--]--><div style="position:relative;" class="content" data-v-7eddb2c4><div><p><strong>哪吒监控的被控端服务被称为Agent本文档将介绍如何在被控端服务器上安装Agent并与Dashboard连接</strong><br><br></p><h2 id="一键安装agent" tabindex="-1">一键安装Agent <a class="header-anchor" href="#一键安装agent" aria-hidden="true">#</a></h2><p>目前哪吒监控已支持在WIndows和Linux上一键安装Agent遵循本文档的步骤你可以很轻松的在服务器上部署它<br><br></p><h3 id="准备工作" tabindex="-1">准备工作 <a class="header-anchor" href="#准备工作" aria-hidden="true">#</a></h3><p>你需要提前在管理面板中设置好通信域名此域名不可以接入CDN这里以前面提到过的示例通信域名 “<a href="http://data.example.com" target="_blank" rel="noopener noreferrer">data.example.com</a>” 来做演示<br> 进入后台管理面板转到“设置”页在“未接入CDN的面板服务器域名/IP”项中填入通信域名然后点击&quot;保存&quot;<br><br></p><h3 id="linux一键安装" tabindex="-1">Linux一键安装 <a class="header-anchor" href="#linux一键安装" aria-hidden="true">#</a></h3><ul><li>首先在管理面板中添加一台服务器</li><li>点击新添加的服务器旁绿色的Linux图标按钮复制一键安装命令</li><li>在被控端服务器中运行复制的一键安装命令等待安装完成后返回到Dashboard主页查看服务器是否上线<br><br></li></ul><h3 id="windows一键安装" tabindex="-1">Windows一键安装 <a class="header-anchor" href="#windows一键安装" aria-hidden="true">#</a></h3><ul><li>首先在管理面板中添加一台服务器</li><li>点击新添加的服务器旁绿色的Windows图标按钮复制一键安装命令</li><li>进入Windows服务器运行PowerShell在PowerShell中运行复制的安装命令</li><li>如遇到确认「执行策略变更」请选择 Y</li><li>等待安装完成后返回Dashboard主页查看服务器是否上线<br><br><br><br></li></ul><h2 id="其他方式安装agent" tabindex="-1">其他方式安装Agent <a class="header-anchor" href="#其他方式安装agent" aria-hidden="true">#</a></h2><br><h3 id="linux安装agent" tabindex="-1">Linux安装Agent <a class="header-anchor" href="#linux安装agent" aria-hidden="true">#</a></h3><hr><ul><li>首先在管理面板中添加一台服务器</li><li>在被控服务器中,运行脚本(位于中国大陆的服务器请使用镜像):</li></ul><div class="language-bash"><pre><code><span class="token function">curl</span> -L https://raw.githubusercontent.com/naiba/nezha/master/script/install.sh -o nezha.sh <span class="token operator">&amp;&amp;</span> <span class="token function">chmod</span> +x nezha.sh <span class="token operator">&amp;&amp;</span> <span class="token function">sudo</span> ./nezha.sh
</code></pre></div><ul><li>选择“安装监控Agent”</li><li>输入通信域名,如:”<a href="http://data.example.com" target="_blank" rel="noopener noreferrer">data.example.com</a></li><li>输入面板通信端口默认为5555</li><li>输入Agent密钥Agent密钥在管理面板中添加服务器时生成可以在管理面板中的“主机”页中找到</li><li>等待安装完成后返回Dashboard主页查看服务器是否上线<br><br></li></ul><h3 id="windows安装agent" tabindex="-1">Windows安装Agent <a class="header-anchor" href="#windows安装agent" aria-hidden="true">#</a></h3><ul><li>请参考社区文章:<br><a href="https://nyko.me/2020/12/13/nezha-windows-client.html" target="_blank" rel="noopener noreferrer">哪吒探针 - Windows 客户端安装</a><br><br></li></ul><h3 id="openwrt安装agent" tabindex="-1">OpenWRT安装Agent <a class="header-anchor" href="#openwrt安装agent" aria-hidden="true">#</a></h3><p><strong>如何使 旧版OpenWRT/LEDE 自启动</strong></p><ul><li>请参考项目:<br><a href="https://github.com/Erope/openwrt_nezha" target="_blank" rel="noopener noreferrer">哪吒监控 For OpenWRT</a><br><br></li></ul><p><strong>如何使 新版OpenWRT 自启动?来自 @艾斯德斯</strong></p><ul><li>首先在 release 下载对应的二进制解压 zip 包后放置到 <code>/root</code></li><li>运行 <code>chmod +x /root/nezha-agent</code> 赋予执行权限,然后创建 <code>/etc/init.d/nezha-service</code></li></ul><div class="language-shell"><pre><code><span class="token shebang important">#!/bin/sh /etc/rc.common</span>
<span class="token assign-left variable">START</span><span class="token operator">=</span><span class="token number">99</span>
<span class="token assign-left variable">USE_PROCD</span><span class="token operator">=</span><span class="token number">1</span>
<span class="token function-name function">start_service</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
procd_open_instance
procd_set_param <span class="token builtin class-name">command</span> /root/nezha-agent -s 面板通信地址:端口 -p 秘钥 -d
procd_set_param respawn
procd_close_instance
<span class="token punctuation">}</span>
<span class="token function-name function">stop_service</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
<span class="token function">killall</span> nezha-agent
<span class="token punctuation">}</span>
<span class="token function-name function">restart</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
stop
<span class="token function">sleep</span> <span class="token number">2</span>
start
<span class="token punctuation">}</span>
</code></pre></div><ul><li>运行 <code>chmod +x /etc/init.d/nezha-service</code> 赋予执行权限</li><li>启动服务: <code>/etc/init.d/nezha-service enable &amp;&amp; /etc/init.d/nezha-service start</code><br><br><br><br></li></ul><h2 id="自定义agent监控项目" tabindex="-1">自定义Agent监控项目 <a class="header-anchor" href="#自定义agent监控项目" aria-hidden="true">#</a></h2><hr><h4 id="自定义监控的网卡和硬盘分区" tabindex="-1">自定义监控的网卡和硬盘分区 <a class="header-anchor" href="#自定义监控的网卡和硬盘分区" aria-hidden="true">#</a></h4><ul><li>执行 <code>/opt/nezha/agent/nezha-agent --edit-agent-config</code> 来选择自定义的网卡和分区,然后重启 Agent 即可生效</li></ul><h4 id="其他运行参数" tabindex="-1">其他运行参数 <a class="header-anchor" href="#其他运行参数" aria-hidden="true">#</a></h4><p>通过执行 <code>./nezha-agent --help</code> 查看支持的参数如果你使用了一键脚本安装Agent可以编辑 <code>/etc/systemd/system/nezha-agent.service</code>,在 <code>ExecStart=</code> 这一行的末尾加上以下参数</p><ul><li><code>--report-delay</code> 控制系统信息上报的间隔,默认为 1 秒,可以设置为 3 来进一步降低 agent 端系统资源占用(配置区间 1-4</li><li><code>--skip-conn</code> 不监控连接数,推荐 机场/连接密集型服务器或CPU占用较高的服务器设置</li><li><code>--skip-procs</code> 不监控进程数,也可以降低 agent 占用</li><li><code>--disable-auto-update</code> 禁止 <strong>自动更新</strong> Agent安全特性</li><li><code>--disable-force-update</code> 禁止 <strong>强制更新</strong> Agent安全特性</li><li><code>--disable-command-execute</code> 禁止在 Agent 上执行定时任务、打开在线终端(安全特性)</li><li><code>--tls</code> 启用 SSL/TLS 加密(使用 nginx 反向代理 Agent 的 grpc 连接,并且 nginx 开启 SSL/TLS 时,需要启用该项配置)</li></ul></div></div><footer class="page-footer" data-v-7eddb2c4 data-v-07c132fc><div class="edit" data-v-07c132fc><div class="edit-link" data-v-07c132fc data-v-1ed99556><a class="link" href="https://github.com/nezhahq/nezhahq.github.io/edit/main/docs/guide/agent.md" target="_blank" rel="noopener noreferrer" data-v-1ed99556>在GitHub中编辑 <svg class="icon outbound icon" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewbox="0 0 100 100" width="15" height="15" data-v-1ed99556><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></div></div><div class="updated" data-v-07c132fc><!----></div></footer><div class="next-and-prev-link" data-v-7eddb2c4 data-v-38ede35f><div class="container" data-v-38ede35f><div class="prev" data-v-38ede35f><a class="link" href="/guide/dashboard" data-v-38ede35f><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 24 24" class="icon icon-prev" data-v-38ede35f><path d="M19,11H7.4l5.3-5.3c0.4-0.4,0.4-1,0-1.4s-1-0.4-1.4,0l-7,7c-0.1,0.1-0.2,0.2-0.2,0.3c-0.1,0.2-0.1,0.5,0,0.8c0.1,0.1,0.1,0.2,0.2,0.3l7,7c0.2,0.2,0.5,0.3,0.7,0.3s0.5-0.1,0.7-0.3c0.4-0.4,0.4-1,0-1.4L7.4,13H19c0.6,0,1-0.4,1-1S19.6,11,19,11z"></path></svg><span class="text" data-v-38ede35f>安装 Dashboard</span></a></div><div class="next" data-v-38ede35f><a class="link" href="/guide/servers" data-v-38ede35f><span class="text" data-v-38ede35f>主机</span><svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 24 24" class="icon icon-next" data-v-38ede35f><path d="M19.9,12.4c0.1-0.2,0.1-0.5,0-0.8c-0.1-0.1-0.1-0.2-0.2-0.3l-7-7c-0.4-0.4-1-0.4-1.4,0s-0.4,1,0,1.4l5.3,5.3H5c-0.6,0-1,0.4-1,1s0.4,1,1,1h11.6l-5.3,5.3c-0.4,0.4-0.4,1,0,1.4c0.2,0.2,0.5,0.3,0.7,0.3s0.5-0.1,0.7-0.3l7-7C19.8,12.6,19.9,12.5,19.9,12.4z"></path></svg></a></div></div></div><!--[--><!--]--></div></main></div><!----><!--]--></div>
<script>__VP_HASH_MAP__ = JSON.parse("{\"developer_algolia-search.md\":\"f247b64d\",\"developer_basics.md\":\"b1833b91\",\"developer_carbon-ads.md\":\"b1f27f6d\",\"developer_homepage.md\":\"1284e614\",\"en_us_developer_algolia-search.md\":\"e1475589\",\"en_us_developer_basics.md\":\"b2add91b\",\"en_us_developer_carbon-ads.md\":\"34f23488\",\"en_us_developer_homepage.md\":\"a6db7ce7\",\"en_us_guide_agent.md\":\"ec593a1a\",\"en_us_guide_dashboard.md\":\"655e4802\",\"en_us_guide_notifications.md\":\"fa68d9af\",\"en_us_guide_q1.md\":\"2c880b4a\",\"en_us_guide_q2.md\":\"a57b9066\",\"en_us_guide_q3.md\":\"018a0f68\",\"en_us_guide_q4.md\":\"efc1a45c\",\"en_us_guide_q5.md\":\"7b50c57d\",\"en_us_guide_servers.md\":\"91b70570\",\"en_us_guide_services.md\":\"0e43c6e1\",\"en_us_guide_settings.md\":\"f9df49c1\",\"en_us_guide_tasks.md\":\"b49be1d5\",\"en_us_index.md\":\"9f0f5302\",\"guide_agent.md\":\"69fc9967\",\"guide_dashboard.md\":\"455b8333\",\"guide_notifications.md\":\"062c0195\",\"guide_q1.md\":\"97a040ca\",\"guide_q2.md\":\"1c44553b\",\"guide_q3.md\":\"a2fb1bac\",\"guide_q4.md\":\"a0ce8f50\",\"guide_q5.md\":\"e8c8124d\",\"guide_servers.md\":\"13555887\",\"guide_services.md\":\"1451bbac\",\"guide_settings.md\":\"c4717b88\",\"guide_tasks.md\":\"cf303285\",\"index.md\":\"daa17c5e\"}")</script>
<script type="module" async src="/assets/app.13513b34.js"></script>
</body>
</html>