外观
快速开始:跑通第一条节点
目标是完成一条可以真实使用的链路:控制端可登录 → 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 主动连接控制端,适合节点没有方便开放管理端口的场景。
填写易识别的名称,核对连接模式、地址和端口,保存后打开面板生成的接入命令。不同版本及模式生成的参数不同,应使用本实例命令,勿照抄他人的令牌。
4. 安装 Agent,确认在线
在节点服务器执行接入命令。回到服务管理,检查:
- 在线状态及最近心跳已经更新;
- 上报的公网地址、主机信息符合预期;
- Agent 版本可读取,核心模式与现有环境一致。
“Agent 在线”只代表控制通道建立,不等于代理端口已经可用。还需要下一步创建入站。
5. 创建入站和节点
在对应服务器的操作界面创建受管入站,选择客户端支持的协议组合,设置可用端口。保存后检查远端核心是否接受配置、节点管理是否出现对应条目。
首次建议只创建一条简单链路。需要 TLS 的组合应先具备匹配证书;REALITY 等组合有不同参数要求,不能把任意域名填到所有字段里。详见创建节点。
6. 分配授权,再导入客户端
创建测试用户,选择套餐授权或自定义服务授权,分配所需服务器/固定节点及有效期。使用该用户登录,检查是否可开通和取得属于自己的订阅或分享链接。
在客户端导入后实际访问一个测试站点,观察连接、延迟和流量变化。客户端显示“导入成功”不能替代连通性验证。
最小验收
管理员可登录、Agent 在线、核心接受入站、端口可达、用户有授权、客户端有实际流量,这六项都成立,才算完成第一条节点。
后续按需求扩展
| 你的需求 | 下一篇 |
|---|---|
| 节点 IP 会变化 | 动态 IP 与域名 |
| 使用另一台机器作为入口 | 任意门转发 |
| 让域名自动跟随 IP | DDNS |
| 给更多用户分配服务 | 用户与服务授权 |
| 准备正式运行 | 备份恢复、更新与回滚 |
