NodeCtl - 节点搭建一键推送

大家好！今天给大家带来一个超级实用的开源项目 NodeCtl 的完整部署教程。

NodeCtl 是一个轻量级的个人节点与订阅管理面板，特别适合以下场景：

有自建节点但管理麻烦的小伙伴
订阅了多个机场，想统一测速、分流、切换配置
想用 Cloudflare Tunnel（无需公网 IP）暴露服务
希望通过 Web 面板实时监控流量、远程控制节点（重置链接、重装 sing-box 等）

核心亮点：主流协议的节点可直接由面板推送到VPS中，直接部署好。

一、🚀 快速部署

默认账号 / 密码：admin / admin，登录后请立即修改！

方式一：Docker Run（推荐）

docker run -d \
  --name nodectl \
  --restart unless-stopped \
  -p 7878:8080 \
  -v /opt/nodectl/data:/app/data \
  ghcr.io/hobin66/nodectl:latest

方式二：Docker Compose

新建 docker-compose.yml 文件，写入以下内容：

version: '3'
services:
  nodectl:
    image: ghcr.io/hobin66/nodectl:latest
    container_name: nodectl
    restart: unless-stopped
    ports:
      - "7878:8080"
    volumes:
      - ./data:/app/data

然后运行：

docker-compose up -d

方式三：二进制脚本安装

适合不想用 Docker 的用户，支持 Debian/Ubuntu 和 Alpine：

bash <(curl -fsSL https://raw.githubusercontent.com/hobin66/nodectl/main/install.sh)

部署成功后，访问 http://你的IP:8080，使用默认账号登录即可。

二、🖥️ 节点管理

进入面板后，点击左上角的「添加节点」，选择节点类型（直连或落地分组），填好相应信息保存。

节点创建完成后，点击节点旁的下载图标，复制「部署命令」，粘贴到你购买的 VPS 终端里执行。等待命令运行结束后，刷新 NodeCtl 页面，可以看到节点状态已自动更新。

注意：此时代理协议还没有配置好，需要继续下面的步骤。

添加代理协议：

点击节点旁的「编辑节点」进入详情页
点击右下角的「添加协议」，选择你需要的协议类型
确认端口无误后，点击「推送配置 → 确定推送」
推送成功后，代理节点就搭建好了

再次进入「编辑节点」，即可看到已生成的代理节点信息。如需添加多种协议，重复上述步骤即可。

节点都配置好之后，点击右上角的「我的订阅」，复制订阅链接到对应的代理客户端（如 Clash Verge、sing-box 等）即可使用。

三、⚙️ 其他配置项说明

Telegram Bot

填入机器人 Token 和交互用户 ID 后，即可在 Telegram 中发送 /sub 查看订阅信息和服务器列表，非常方便。

面板外部访问地址

可配可不配，目前没发现不填有什么影响。如果你有域名，可以在这里填上，方便识别。

自定义分流 / Clash 规则集

有能力的可以自己编写分流规则、添加规则集，玩法很丰富。

Sing-box 配置

可以在这里自定义伪装域名、路径、加密方式，不熟悉的话默认配置直接用就好。

机场订阅

填入机场订阅链接后，新添加的机场默认是「禁用」状态，需要手动改为「直连」或「落地」，才会同步到订阅链接中。

💡 测速注意：批量测速功能需要先在「系统设置」中安装 Mihomo 插件。安装完后才能正常使用测速，否则节点会显示无效。

CF 配置

这一块功能比较多，逐一说明：

Tunnel 隧道

在 Token 管理中填入对应域名的 Cloudflare Token 后，回到这里点击「启动」，即可自动配置好隧道，通过域名访问面板，不再依赖公网 IP。

Argo 节点

如果你的代理协议支持 Argo，可以在这里一键开启。

⚠️ 注意：开启 Argo 后，如果原机器有 2 个以上代理协议，订阅链接里只会显示 Argo 协议，其他协议的链接不会出现（但实际上是可以用的，只是不展示在订阅里）。

优选 IP

可以在这里进行 Cloudflare IP 优选，并将优选结果应用到 Argo 节点中，有助于提升连接速度。

DNS 证书

申请时遇到提示「Cloudflare 信息不完整，缺少：邮箱」，暂时没找到解决办法，后续研究清楚了再补充。

自定义节点

在这里可以手动添加已有的代理地址，添加后同样可以同步到订阅链接中，对于拼车用户来说很友好。

以上就是 NodeCtl 的完整部署和配置流程，整体体验下来，上手难度不高，功能却相当完整。感兴趣的朋友可以去 GitHub 点个 ⭐ 支持作者：

👉 https://github.com/hobin66/nodectl