前期准备
- Cloudflare 用来配置 CDN 和 SSL 证书
- 一个域名（如 qq.com）
- 两台服务器，A 服务器安装 Dashboard 面板 与 Nginx，B 服务器安装 Agent 探针。如果需要，也可以选择将两者安装在同一台服务器上。
1. Cloudflare 配置
1.1 添加 A 记录，指定到 A 服务器 IP
1.2 开启 gRPC 与 WebSockets
1.3 创建 SSL 证书，并复制到 A 服务器 /etc/ssl/private/ 目录
证书（.cer） 复制到 /etc/ssl/private/fullchain.cer
私钥（.key） 复制到 /etc/ssl/private/private.key2. 安装 Dashboard 哪吒监控面板
哪吒面板（Dashboard）用于管理和展示探针数据。 官方手册
2.1 执行脚本
# 海外服务器（GitHub）：
curl -L https://raw.githubusercontent.com/nezhahq/scripts/refs/heads/main/install.sh -o nezha.sh && chmod +x nezha.sh && sudo ./nezha.sh
# 中国大陆服务器（Gitee）：
curl -L https://gitee.com/naibahq/scripts/raw/main/install.sh -o nezha.sh && chmod +x nezha.sh && sudo CN=true ./nezha.sh2-2. 安装流程
3. 安装 Nginx 并配置反向代理
3.1 安装 Nginx
# 更新系统并安装 Nginx：
apt update
apt install -y curl wget sudo unzip
apt install -y nginx
# 生成 Diffie-Hellman 密钥
openssl dhparam -out /etc/ssl/certs/dhparam.pem 20483.2. 配置 Nginx 反向代理、gRPC
# 打开 Nginx 配置文件：
/etc/nginx/nginx.conf#user nobody;
worker_processes 1;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
sendfile on;
keepalive_timeout 65;
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name qq.com; # 替换为你的域名
ssl_certificate /etc/ssl/private/fullchain.cer; # 替换为你的域名证书路径
ssl_certificate_key /etc/ssl/private/private.key; # 替换为你的域名私钥路径
ssl_stapling on;
ssl_session_timeout 1d;
ssl_session_cache shared:SSL:10m;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers 'TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384';
ssl_prefer_server_ciphers on;
ssl_dhparam /etc/ssl/certs/dhparam.pem;
# 配置真实 IP 来源 (Cloudflare 的 IP 范围)
set_real_ip_from 103.21.244.0/22;
set_real_ip_from 103.22.200.0/22;
set_real_ip_from 103.31.4.0/22;
set_real_ip_from 104.16.0.0/13;
set_real_ip_from 104.24.0.0/14;
set_real_ip_from 108.162.192.0/18;
set_real_ip_from 131.0.72.0/22;
set_real_ip_from 141.101.64.0/18;
set_real_ip_from 162.158.0.0/15;
set_real_ip_from 172.64.0.0/13;
set_real_ip_from 173.245.48.0/20;
set_real_ip_from 188.114.96.0/20;
set_real_ip_from 190.93.240.0/20;
set_real_ip_from 197.234.240.0/22;
set_real_ip_from 198.41.128.0/17;
# 允许处理下划线的请求头（特别是 CF-Connecting-IP）
underscores_in_headers on;
real_ip_header CF-Connecting-IP;
real_ip_recursive on;
# 设置 proxy_temp_file_write_size
proxy_temp_file_write_size 512k;
# gRPC 设置
location ^~ /proto.NezhaService/ {
grpc_set_header Host $host;
grpc_set_header nz-realip $http_CF-Connecting-IP;
grpc_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
grpc_read_timeout 600s;
grpc_send_timeout 600s;
grpc_socket_keepalive on;
client_max_body_size 10m;
grpc_buffer_size 4m;
grpc_pass grpc://dashboard;
}
# websocket 反向代理
location ~* ^/api/v1/ws/(server|terminal|file)(.*)$ {
proxy_set_header Host $host;
proxy_set_header nz-realip $http_CF-Connecting-IP;
proxy_set_header Origin https://$host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
proxy_pass http://127.0.0.1:8008;
}
# Web 反向代理
location / {
proxy_set_header Host $host;
proxy_set_header nz-realip $http_CF-Connecting-IP;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
proxy_buffer_size 128k;
proxy_buffers 4 256k;
proxy_busy_buffers_size 256k;
proxy_max_temp_file_size 0;
proxy_pass http://127.0.0.1:8008;
}
}
upstream dashboard {
server 127.0.0.1:8008;
keepalive 512;
}
}3.3. 重启 Nginx
# 检查配置文件的语法和正确性
nginx -t
### 结果解释
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok # 语法正确
nginx: configuration file /etc/nginx/nginx.conf test is successful # 正常启动
# 重启 Nginx 并检查其运行状态：
systemctl restart nginx && systemctl status nginx4. 安装 Agent 探针
登录 （Dashboard） 面板，首次登录的默认用户名和密码均为 admin，并复制 Agent 安装命令，并在 B 服务器 安装。
# 安装 必要组件
apt update
apt install -y curl wget sudo unzip
### 安装 Agent 演示
root@s38455:~# curl -L https://raw.githubusercontent.com/nezhahq/scripts/main/agent/install.sh -o agent.sh && chmod +x agent.sh && env NZ_SERVER=qq.com:443 NZ_TLS=true NZ_CLIENT_SECRET=DFF4dDF44ffsfdfdfFFF ./agent.sh
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 4947 100 4947 0 0 15564 0 --:--:-- --:--:-- --:--:-- 15605
Installing...
2025/03/07 01:04:15 Successfully executed action install!
nezha-agent successfully installed # 说明成功5. 美化面板 Dashboard 与 监控节点
# NezhaDash官方文档：
https://nezhadash-docs.buycoffee.top/custom-code
# 服务器公开备注生成器:
https://nezhainfojson.pages.dev/
# 哪吒探针最简单美化教程
https://1keji.net/t/topic/31
https://dnsdaquan.com/
https://ipw.cn/doc/else/dns.html
# ICMP Ping 节点
https://www.nodeseek.com/post-82748-1
# TCP-Ping 节点
https://www.nodeseek.com/post-68572-1
# TCP-Ping 节点
https://hunter.qianxin.com
语法搜索：ip.city="广州" AND ip.isp="电信" AND (ip.port=80 OR ip.port=443) AND ip.asn="4134"6. 安全设置
6.1 （Dashboard） 面板开启 OAuth2 绑定第三方网站账户 官方说明
访问 GitHub 开发者设置 创建 OAuth 应用，并记录 Client ID 与 Client secrets：
- 打开 Dashboard 面板配置，设置 OAuth2
# 打开 /opt/nezha/dashboard/data/config.yaml 面板（Dashboard） 配置，添加下面代码：
oauth2:
GitHub:
clientid: "FF5sdfsfsbdb23dbf" # 替换你的 Client ID
clientsecret: "sfsdf6s5df65sf65sd6f5sd6f5sf5s6df" # 替换你的 Client secrets
endpoint:
authurl: "https://github.com/login/oauth/authorize"
tokenurl: "https://github.com/login/oauth/access_token"
userinfourl: "https://api.github.com/user"
useridpath: "id"- 登录 Dashboard 面板，进入个人信息，完成 GitHub 授权，即可通过 GitHub 账号登录面板。
- 授权 第三方网站 登录成功后，可到 更新个人资料 禁止密码登录。
6.2 关闭 探针（Agent）远程控制功能
把 disable_command_execute: 改成 true
# 探针（Agent） 配置
打开 /opt/nezha/agent/config.yml
client_secret: DXwVsdfsdfsfdsdf545s4f # 探针客户端密钥，必须与哪吒面板中的密钥匹配，否则无法连接
debug: false # 是否开启调试模式，true 开启详细日志，false 关闭（建议保持 false）
disable_auto_update: false # 是否禁用自动更新，true 禁用，false 允许探针自动更新
disable_command_execute: true # 是否禁用远程命令执行，true 禁止，false 允许（建议生产环境设置为 true 提高安全性）
disable_force_update: false # 是否禁用强制更新，true 禁止，false 允许探针被强制更新
disable_nat: false # 是否禁用 NAT 穿透，false 允许，true 禁用（适用于固定公网 IP 服务器）
disable_send_query: false # 是否禁用查询系统信息（如 CPU、内存、磁盘等），false 允许，true 禁用
gpu: false # 是否启用 GPU 监控，true 监控 GPU，false 关闭（适用于 GPU 服务器）
insecure_tls: false # 是否允许不安全的 TLS 连接（忽略证书错误），false 严格检查，true 忽略（自签名证书可设为 true）
ip_report_period: 0 # IP 变更上报间隔（秒），0 表示仅在启动时上报一次，>0 表示每 n 秒检测 IP 变更并上报
report_delay: 0 # 探针上报状态的延迟时间（秒），0 立即上报，>0 延迟 n 秒后上报（适用于网络不稳定环境）
self_update_period: 0 # 探针自更新周期（秒），0 代表不自动更新，>0 每 n 秒检查更新（建议保持 0）
server: qq.com:443 # 哪吒面板服务器地址，必须修改为实际的面板地址，例如 mynezha.example.com:443
skip_connection_count: false # 是否跳过网络连接数统计，false 统计，true 跳过
skip_procs_count: false # 是否跳过进程数统计，false 统计，true 跳过
temperature: false # 是否监控 CPU 温度，true 监控，false 关闭（适用于有温度传感器的服务器）
tls: true # 是否启用 TLS 加密通信，true 使用 HTTPS（推荐），false 使用 HTTP（仅适用于内网）
use_gitee_to_upgrade: false # 是否使用 Gitee 进行更新，false 使用 GitHub，true 使用 Gitee（适用于中国大陆服务器）
use_ipv6_country_code: false # 是否使用 IPv6 进行国家/地区判断，false 使用 IPv4，true 使用 IPv6（适用于 IPv6-only 服务器）
uuid: sdfsdf-0243480-3444-4343-gdfgdfg4343 # 探针唯一标识符，必须保持唯一，否则可能导致数据冲突- 重启让配置生效
# 运行 哪吒监控管理脚本，选择 3. 重启并更新面板
./nezha.sh
哪吒监控管理脚本
--- https://github.com/nezhahq/nezha ---
1. 安装面板端
2. 修改面板配置
3. 重启并更新面板
4. 查看面板日志
5. 卸载管理面板
————————————————-
6. 更新脚本
————————————————-
0. 退出脚本
请输入选择 [0-6]: 3- 按照上述方法操作，绝对能正常搭建并使用，但可能由于你开启了某些功能导致冲突，以下是排查问题时可能用到的命令
测试 gRPC 服务： curl https://qq.com:443/proto.NezhaService/ -H "Content-Type:application/grpc" -X POST -v7.1 按照教程操作后，探针（Agent）无法连接的解决方法
评论 (0)