v2ray-agent 是 mack-a 维护的命令行管理脚本。本文走官方无域名 REALITY 教程的路线：安装脚本、选择核心与协议、读取生成参数、导入客户端。菜单序号会变，操作时应以当前选项名称为准。
资料核对：2026 年 9 月 30 日。下方配图为科学之家绘制的操作流程示意，具体菜单以所用版本为准。
01 · 准备与填写约定
准备一台具有管理员权限、能够访问项目发布源的 Linux 服务器，以及支持所选协议的客户端。记录公网地址和已占用端口；已有服务的主机先做快照。文中的 SERVER_IP、USER、示例密码和证书路径必须换成自己的值。
先确定一个测试目标：只创建一个入站或用户，导入一台客户端并验证。这能让安装、账号和连接三个阶段的问题分别定位。
02 · 安装与首次进入
在目标 Linux 服务器的 SSH 终端操作。先下载并查看官方脚本，再执行安装；安装命令不在日常使用的电脑上运行。
curl -fL https://raw.githubusercontent.com/mack-a/v2ray-agent/master/install.sh -o v2ray-agent-install.sh
less v2ray-agent-install.sh
sudo bash v2ray-agent-install.sh进入交互菜单后选择所需核心与协议安装流程。本文以 Xray 的 VLESS + REALITY 为目标；重新进入菜单使用 sudo vasma。不要在已由其他面板管理的相同端口上重复安装。
03 · 建立第一条可用连接
- 按照菜单的安装 / 自定义安装流程选择 Xray 与 REALITY 相关协议，填写未占用的监听端口。首次只配置一条连接，便于确认客户端兼容性。
- 按脚本提示设置目标站点相关参数，保留它生成的 UUID、密钥和 short ID。目标站点要求以官方 REALITY 文档为准，不能随便把任意域名当作兼容目标。
- 安装结束后打开账号 / 订阅管理功能，查看这条配置的分享链接。保存时把节点地址、端口、SNI、public key、short ID 和 flow 一起记录。
- 云安全组与系统防火墙放行本次使用的端口，在脚本状态页确认核心运行。使用当前支持 REALITY 的客户端导入刚生成的链接。
04 · 看图核对连接信息
| 设置或现象 | 填写方法与检查方向 |
|---|---|
| 服务器地址 | 客户端连接自己的服务器公网地址。 |
| SNI / public key | 分别用于握手参数和服务端身份校验，必须与生成的配置对应。 |
| short ID / flow | 按脚本导出的值填写；省略或自行改写可能导致不兼容。 |
| 目标与节点地址 | REALITY 目标域名不是你自己的节点 IP，两个字段用途不同。 |
05 · 导入客户端并验证
在兼容客户端从剪贴板导入 VLESS 链接，对照上述字段后连接。测试失败时先查看服务端和客户端同一时刻的日志。脚本里已有多条配置时，给每条添加明确备注，避免导入旧端口或旧密钥。
- 确认客户端拿到了节点，而不是网页、管理地址或错误提示。
- 重新建立连接，查看一次真实请求的结果；单独显示“已连接”不能替代访问测试。
- 对照同一时段的客户端日志和服务端日志 / 用量，确认测试用的是新配置。
06 · 常见问题
| 设置或现象 | 填写方法与检查方向 |
|---|---|
| 菜单序号与旧教程不一致 | 按安装、账号、订阅、核心管理等名称选择；不要盲输旧版数字序列。 |
| 端口可达但 REALITY 握手失败 | 核对 SNI、public key、short ID、flow 和客户端版本；同时检查目标站点可达性与系统时间。 |
| 更新脚本后配置变动 | 恢复前先对比保存的配置与当前导出链接，确认是核心版本变化还是参数发生修改。 |
07 · 备份与后续维护
维护前保留 /etc/v2ray-agent 中的配置、证书及版本记录。升级通过脚本当前提供的管理入口完成，升级后重新导出并对照连接参数；不要把他人的完整配置覆盖到自己的账号目录。
每次只调整一类设置，并保留可恢复的旧配置。改端口、凭据或域名后重新生成分享信息；客户端也需要同步更新。
08 · 官方资料与下一步
文字与流程图由科学之家整理制作；安装来源和协议字段参见上述官方资料。本文未附带任何服务商套餐或推广链接。
