付费用户如何新增自己的私有节点

私有节点适合希望把转发执行完全放在自己服务器上的付费用户。ChannelFlow 仍负责网页配置、规则引擎和投递记录，你的 Linux 服务器负责运行 Node Agent、所选平台的监听容器，以及一个节点级投递容器——监听和投递都在你的服务器上执行。

节点显示“在线”只代表服务器已经接入。完成后还要检查来源账号是否连接，并用一条测试消息确认目标端真实收到。

开始前准备

你需要：

一个有效的 ChannelFlow 付费方案；每个付费用户当前可创建一个私有节点。
一台可以通过 SSH 登录的 Linux 服务器，并拥有 root 或 sudo 权限。
服务器可以出站访问 HTTPS、Docker 镜像及依赖下载地址和你准备接入的平台。
建议至少 2 核 CPU、2 GB 内存、10 GB 可用磁盘。实际容量取决于平台数量、消息量和媒体处理量。

服务器不需要开放新的公网入站端口。Debian 或 Ubuntu 可以由安装器补装 docker.io；其他发行版请先自行安装并启动 Docker。

第一步：在控制台创建私有节点

登录 ChannelFlow，进入“转发实例”。
打开“实例设置”页，在“我的私有执行节点”卡片中填写节点名称和区域。
点击“创建私有节点”。
页面会显示 Node ID、一次性“注册 Key”和专属安装命令。

如果节点仍处于“待接入”且 Key 丢失，可以点击“重新生成注册 Key”。旧 Key 会立即失效。

第二步：在自己的服务器执行安装命令

在控制台点击“复制接入命令”，然后 SSH 登录你的 Linux 服务器，直接粘贴运行。命令形式大致如下；请使用控制台生成的完整命令，不要手工填写示例 ID：

(tmp=$(mktemp) && trap 'rm -- "$tmp"' EXIT && \
  curl --proto '=https' --tlsv1.2 -fsSL \
  'https://channelflow.cc/install-node.sh' -o "$tmp" && \
  sudo bash "$tmp" --node-id '<你的 Node ID>' \
  --control-url 'https://channelflow.cc' \
  --connectors discord,discord-ai,telegram,qq,x \
  --install-docker)

安装器会完成以下工作：

检查 Docker；在支持的 Debian/Ubuntu 上按需安装。
在服务器本地构建 Node Agent、所选平台的监听 Worker 镜像和投递 Worker 镜像。
提示输入注册 Key。输入过程不会回显，这是正常现象。
注册节点、启动 channelflow-node-agent，并等待控制台确认心跳。

首次安装通常需要几分钟，具体取决于服务器网络和镜像构建速度。不要把注册 Key 直接拼进命令行，否则它可能进入 Shell 历史。

第三步：确认节点在线

回到“我的私有执行节点”卡片，节点状态应从“待接入”变为“在线”。你也可以在服务器上检查：

docker ps --filter name=channelflow-node-agent
docker ps --filter name=channelflow-delivery
docker logs --tail 50 channelflow-node-agent

接入后应能看到 Node Agent 和各来源的监听容器；节点有投递任务时，Agent 还会自动启动节点级投递容器 channelflow-delivery-<Node ID>。

如果控制台一直显示“待接入”，优先检查服务器能否访问 https://channelflow.cc、Docker 是否运行、磁盘是否充足，以及安装时输入的 Key 是否属于当前 Node ID。

第四步：把转发实例分配到私有节点

创建新转发实例时，在“执行节点”中选择刚上线的私有节点，再点击“新建实例”。如果实例尚未创建 Worker，也可以在该实例的“实例设置”中选择私有节点并保存。

实例首次运行 Worker 后会固定在该节点。为了避免同一账号在两台服务器重复登录，已经存在 Worker 的实例不能直接切换节点；节点离线时也不会自动迁移到其他服务器。

第五步：接入来源并验证真实转发

在实例中添加 Discord、Telegram、QQ、X 等来源账号。
添加投递目标并创建频道转发规则。
启动或重启实例，确认来源状态已连接。
从来源端发送一条专用测试消息。
在“投递记录”查看结果，并到目标平台确认真实收到。

转发链路的监听和投递都由你节点上的容器执行；平台只负责规则引擎、发件箱和投递记录。

只有“节点在线 + 来源已连接 + 投递记录成功 + 目标端收到”四项都满足，才算完成私有节点接入。

日常维护与安全提示

节点数据默认保存在 /opt/channelflow-node，不要随意删除或复制到另一台服务器。
不要复制控制面的数据库密码、Kafka 地址、加密密钥或其他用户凭据到节点。
节点上的投递容器只持有平台签发的投递专用凭据，只能领取本节点实例的投递任务；它不包含数据库密码、加密密钥或其他用户凭据。
停用节点会中断节点通信并影响其上的实例；维护前先安排业务窗口。
付费方案失效后，私有节点会被停用。恢复订阅后请回到控制台检查节点和实例状态。
安装脚本用于首次接入或原机恢复，不会自动升级已安装节点，也不会自动迁移实例。

如果节点已经接入但本地长期凭据丢失，请不要把旧节点身份复制到另一台服务器。先停止旧服务器上的 Agent，再联系 ChannelFlow 支持处理节点重新接入和实例绑定。