本文适合第一次接触 NodeGet 的新手。你不需要懂复杂的编程，只需要会登录服务器、复制命令、粘贴执行，就能轻松搞定多台服务器的集中监控与管理。
💡 一、先搞懂：NodeGet 要装什么？
在动手之前，我们需要理清 NodeGet 的基本架构。它主要分为两个核心部分：
- Server（主控）：相当于“总指挥部”，负责接收所有节点的数据，并提供给面板展示。只需要在一台机器上安装。
- Agent（被控）：相当于“情报员”，安装在你想监控的各个服务器上，负责上报 CPU、内存、网络等运行状态。
最顺畅的安装主线任务：
- 在主服务器上安装 Server。
- 配置原生 Nginx 反向代理与 HTTPS（核心）。
- 打开 NodeGet 官方 Dashboard 面板，绑定主控。
- 在面板中生成专属的 Agent 安装命令。
- 把命令复制到其他服务器上执行，完成接入。
🛠️ 二、环境准备工作
开始前，请检查你是否具备以下条件：
- 一台可以访问公网的 Linux 服务器（用来装主控）。
- SSH 登录工具（如 Xshell、FinalShell、Termius 或系统自带终端）。
- 具有
root权限或可以使用sudo的用户账号。
登录服务器后，第一件事是更新系统软件包并安装 curl。根据你的系统，复制相应的命令执行：
Debian / Ubuntu 系统：
apt update -y
apt install curl -y
CentOS / Rocky / AlmaLinux 系统：
yum install curl -y
不知道自己是什么系统？ 执行
cat /etc/os-release，看输出带有 Ubuntu/Debian 还是 CentOS/Rocky 即可。
🚀 三、安装 NodeGet Server（主控端）
在主控服务器的终端里，粘贴并执行以下一键安装命令：
dashboard_url=https://YOUR_DASHBOARD.com \
bash <(curl -sL https://install.nodeget.com) install-server
执行后，如果没有特殊定制需求，一路按回车即可。
- 新手提示：安装过程中如果询问是否开启
tunnel（临时隧道），可以直接选否 (false)，因为我们马上就会自己配置更稳定的 Nginx 域名反代。
⚠️ 极其重要的一步：
安装完成后，屏幕上会输出几项核心信息，请务必截图或复制保存：
- Server 运行端口（默认通常是
2211或8080，请留意屏幕输出） - Super Token（最高权限密钥，绝对不能弄丢或泄露）
🔒 四、配置原生 Nginx 反代与 HTTPS（核心步骤）
NodeGet 面板出于安全考虑，强制要求使用 HTTPS 访问。这一步我们将纯手搓 Nginx，为你自己的域名加上 SSL 证书。
前提操作：请先登录你的域名解析商（如 Cloudflare、阿里云），将你的域名（例如
nodeget.example.com）添加 A 记录，解析到你这台主控服务器的 IP 上。
1. 安装 Nginx 和 Certbot (SSL证书申请工具)
在主控服务器执行以下命令（以 Debian/Ubuntu 为例）：
apt install nginx certbot python3-certbot-nginx -y
2. 编写 Nginx 配置文件
使用 nano 或 vim 编辑器创建一个新的网站配置文件：
nano /etc/nginx/conf.d/nodeget.conf
将下面的内容复制粘贴进去（注意把域名和端口替换成你自己的）：
server {
listen 80;
server_name nodeget.example.com; # 👈 替换成你的域名
location / {
proxy_pass http://127.0.0.1:2211; # 👈 注意核对你的实际端口(如 2211 或 8080)
# 开启 WebSocket 支持（核心配置）
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
保存并退出（在 nano 中按 Ctrl+O 回车保存，Ctrl+X 退出）。
3. 重启 Nginx 并一键申请 HTTPS 证书
先测试一下 Nginx 配置写对没有：
nginx -t
如果显示 test is successful，则重载 Nginx：
systemctl reload nginx
最后，运行 Certbot 自动为你刚才配置的域名申请并配置 HTTPS 证书：
certbot --nginx -d nodeget.example.com
(Certbot 运行期间可能会要求你输入邮箱并同意条款，照做即可。它会自动修改你刚才写的配置文件，加上 443 端口和证书路径。)
🎉 大功告成！ 你的主控正式地址现在就是：wss://nodeget.example.com。
🌐 五、连接控制台（Dashboard）
后端准备完毕，现在我们去官方安全面板里把主控接上。
- 浏览器打开官方静态面板：https://dash.nodeget.com
- 找到 “Server 管理” 或 “主控管理”，点击添加。
- 填写以下信息：
- 名称：随便起，比如“我的主控”。
- 地址：填写你第四步配置好的
wss://你的域名（注意必须是 wss 开头）。 - Token：填入第三步保存的 Super Token。
点击连接，如果一切顺利，你就能看到清爽的主控大盘界面了！
🤖 六、安装 Agent（被控节点）
主控连上后，我们要把其他机器加进来，这一步极其简单：
- 在 Dashboard 左侧菜单找到 “被控管理”。
- 点击 “添加被控 / 新增 Agent”。
- 面板会自动为你生成一条专属的安装命令，格式大致如下：
(注意：不要复制下面这行，去复制你面板里真实生成的那行代码！)bash <(curl -sL [https://install.nodeget.com](https://install.nodeget.com)) install-agent --server-ws "wss://你的域名" --token "你的Token" - 登录你想监控的 其他服务器（被控端），粘贴这段命令并回车。
稍等十几秒，回到 Dashboard 刷新，你就会发现新节点已经乖乖躺在列表里上线了！
🔧 七、日常维护与常用命令
如果遇到节点不上线、服务异常等情况，以下命令能救命：
检查运行状态：
systemctl status nodeget-server # 检查主控
systemctl status nodeget-agent # 检查被控
(看到绿色的 active (running) 说明运行正常)
查看实时日志（排错神器）：
journalctl -u nodeget-server -f
journalctl -u nodeget-agent -f
更新与卸载：
# 更新主控 / 被控
bash <(curl -sL [https://install.nodeget.com](https://install.nodeget.com)) update-server
bash <(curl -sL [https://install.nodeget.com](https://install.nodeget.com)) update-agent
# 卸载主控 / 被控
bash <(curl -sL [https://install.nodeget.com](https://install.nodeget.com)) uninstall-server
bash <(curl -sL [https://install.nodeget.com](https://install.nodeget.com)) uninstall-agent
💣 八、新手高频“踩坑”指南
- Dashboard 连不上 Server 怎么办？
- 检查你填的地址是不是
wss://开头。普通ws://（没有 s）会被浏览器安全策略直接拦截。 - 检查主控服务器的安全组或防火墙，有没有放行
80和443端口。
- 检查你填的地址是不是
- Super Token 忘了存怎么办？
- 可以在主控服务器重新运行
bash <(curl -sL https://install.nodeget.com)，选择找回/查看 Server UUID 选项。
- 可以在主控服务器重新运行
- Agent 安装了但不显示上线？
- 在被控机执行
systemctl status nodeget-agent看进程是否在运行。 - 在被控机上
ping 你的主控域名测试网络通不通。 - 重点检查面板生成的 Agent 安装命令里，主控地址和 Token 复制得对不对。
- 在被控机执行
评论区