Skip to content

快速开始:跑通第一条节点 ​

目标是完成一条可以真实使用的链路:控制端可登录 → Agent 在线 → 入站运行 → 用户获授权 → 客户端连接成功。先完成最小闭环,再配置 DDNS、证书和多跳转发。

从部署到验证的六个步骤

开始前准备 ​

准备项需要确认什么
控制端 Linux 主机AMD64 或 ARM64;有管理权限;可下载 GitHub Release
节点主机可以与控制端通信;有可用的 TCP/UDP 端口
域名生产控制端建议使用独立域名和 HTTPS
云安全组与系统防火墙是两层规则,均需核对;仅开放实际使用的端口
客户端使用支持所选协议和传输方式的版本

控制端和节点可以在同一台机器上,但仍是不同职责。对已有 Xray、Nginx 或其他面板的服务器,先确认端口及文件归属,避免直接接管。

1. 安装并初始化控制端 ​

推荐下载脚本后运行,便于查看内容及保留报错:

bash
curl -fsSL https://raw.githubusercontent.com/violetaini/relaydock/main/quick-install.sh -o quick-install.sh
sudo bash quick-install.sh

按菜单完成安装,记录安装器显示的端口、服务名和数据位置。默认面板端口为 12889,默认绑定全部 IPv4 接口;生产环境应通过防火墙或 BIND_HOST 限制直连,而不是假定它只监听本地。

首次访问进入初始化向导,由你创建管理员账号。没有可以通用套用的默认账号密码。详见控制端安装。

2. 配置 HTTPS ​

将 panel.example.com 解析到控制端,通过 Nginx 或现有网关反代。代理应保留 Host、来源协议和 WebSocket 升级头。完成后统一使用 HTTPS 域名登录。

HTTPS 有助于保护登录和订阅信息,也是剪贴板、Passkey 等浏览器能力正常工作的基础。完整配置见 HTTPS 与反向代理。

3. 添加第一台服务器 ​

在 服务管理 中添加服务器。建议首次选择 WebSocket 连接模式:Agent 主动连接控制端,适合节点没有方便开放管理端口的场景。

填写易识别的名称,核对连接模式、地址和端口,保存后打开面板生成的接入命令。不同版本及模式生成的参数不同,应使用本实例命令,勿照抄他人的令牌。

详见 Agent 部署与连接模式。

4. 安装 Agent,确认在线 ​

在节点服务器执行接入命令。回到服务管理,检查:

  • 在线状态及最近心跳已经更新;
  • 上报的公网地址、主机信息符合预期;
  • Agent 版本可读取,核心模式与现有环境一致。

“Agent 在线”只代表控制通道建立,不等于代理端口已经可用。还需要下一步创建入站。

5. 创建入站和节点 ​

在对应服务器的操作界面创建受管入站,选择客户端支持的协议组合,设置可用端口。保存后检查远端核心是否接受配置、节点管理是否出现对应条目。

首次建议只创建一条简单链路。需要 TLS 的组合应先具备匹配证书;REALITY 等组合有不同参数要求,不能把任意域名填到所有字段里。详见创建节点。

6. 分配授权,再导入客户端 ​

创建测试用户,选择套餐授权或自定义服务授权,分配所需服务器/固定节点及有效期。使用该用户登录,检查是否可开通和取得属于自己的订阅或分享链接。

在客户端导入后实际访问一个测试站点,观察连接、延迟和流量变化。客户端显示“导入成功”不能替代连通性验证。

最小验收

管理员可登录、Agent 在线、核心接受入站、端口可达、用户有授权、客户端有实际流量,这六项都成立,才算完成第一条节点。

后续按需求扩展 ​

你的需求下一篇
节点 IP 会变化动态 IP 与域名
使用另一台机器作为入口任意门转发
让域名自动跟随 IPDDNS
给更多用户分配服务用户与服务授权
准备正式运行备份恢复、更新与回滚

操作示例与截图均使用演示数据 · 内容核对于 2026-11-20