R4ven Discord消息格式详解:Embed颜色码、代码块与footer如何自定义

原创2026-10-11 14:06:101,330 阅读
文章标签:网络安全渗透测试应用安全

R4ven Discord消息格式详解:Embed颜色码、代码块与footer如何自定义

R4ven 是一款基于 Python 的安全意识工具,它通过浏览器权限获取目标的 GPS 坐标、IP 地址、设备信息并截取摄像头画面,再将结果实时发送到 Discord 频道。本文详解 R4ven Discord 消息格式的完整构成:Embed 颜色码的取值原理、代码块语法如何决定数据高亮效果、footer 页脚如何添加说明文字,并演示如何自定义一条专属风格的消息卡片。

R4ven 终端运行画面与手机位置权限弹窗

消息如何发到 Discord 频道:R4ven 的数据流

理解消息格式前,先看数据流向:

  1. 目标设备打开链接后,模块页面中的 JavaScript 构造一条 JSON 消息体(params + myEmbed);
  2. 消息先 POST 到本地 Flask 服务的 /location_update 接口,该路由定义在 port_forward.py;
  3. 路由调用 utils.py 中的 update_webhook(),把消息原样转发到你在 Discord 创建的 Webhook 地址;
  4. Webhook 地址由 utils.py 的 check_and_get_webhook_url() 用正则校验后,自动写入当前模块目录下的 dwebhook.js 文件,下次启动无需重复输入。

因此,你在频道里看到的每一条消息,样式都由模块 index.html 里的两个变量完全决定——改消息格式,就是改这两个变量。

Embed 消息结构:一条 Webhook 消息的组成

R4ven Discord Embed 消息示例:系统信息、IP 与 GPS 位置卡片

以"获取目标系统信息"为例,消息体由两部分组成(见 all/index.html):

外层 params —— 控制发送者身份:

字段 默认值 作用
username R4VEN 消息气泡中显示的名称
avatar_url 一顶黑客帽图标 消息头像
content @everyone Someone Opened The Link O_o 卡片外层的提醒文字,@everyone 会触发全员通知
embeds [myEmbed] 真正的富媒体卡片数组

内层 myEmbed —— 卡片本体,可用字段:

字段 作用
author.name 卡片顶部作者名,如 "Target System Information.."
title 卡片主标题,如 "Uagent:"
description 正文内容,支持 Markdown 与代码块
color 左侧竖条的颜色码(十进制整数)
footer.text 卡片底部的小字页脚

Embed 颜色码对照表:R4ven 默认的 4 种配色

color 是一个十进制整数,等于十六进制 0xRRGGBB 的数值。R4ven 的四个模块(gps、cam、ip、all)默认使用以下 4 种颜色,为不同类型的数据"配色分类":

颜色码(十进制) 十六进制 颜色 用于哪条消息
15418782 #EB459E 粉紫色 目标系统信息 / UserAgent
15548997 #ED4245 红色 目标 IP 消息(附 footer 提示)
5763719 #57F287 青绿色 IP Address Reconnaissance 详情
15844367 #F1C40F 琥珀黄 GPS 定位成功消息(附 footer 提示)

如何换成自己的颜色:把想要的十六进制色值换算成十进制即可。换算公式为 R×65536 + G×256 + B,例如 #3498DB(蓝色)= 34×65536… 实际为 0x34×256² + 0x98×256 + 0xDB = 3447003。修改 gps/index.html、cam/index.html、ip/index.html 中对应的 color 值,即可整体换色。

代码块语法:语言标签决定数据的高亮样式

Discord 的 description 字段支持三反引号代码块,语法为 ```语言标签。R4ven 巧妙地利用不同语言标签获得不同的语法高亮效果:

代码块 使用位置 视觉效果
```xl UserAgent 字符串、目标 IP 关键字高亮,突出长文本
```autohotkey 设备信息清单、IP 侦察字段 键值对逐行着色,适合列表
```prolog GPS 经纬度 简洁等宽展示坐标
```diff 定位被拒绝提示 以 - 开头的行显示为红色

例如目标拒绝授权时,R4ven 发送的就是一条纯 diff 代码块消息,没有任何 Embed 卡片(见 all/index.html):

```` ```diff

  • User denied the request for Geolocation. ``` ````

"IP Address Reconnaissance"消息的正文则由 ip-api.com 的返回字段逐行拼接而成,效果如下图所示——左侧正是代码块渲染出的字段清单:

IP 侦察数据:ip-api.com 返回的 JSON 字段与对应城市地图

footer 页脚:给卡片底部加一行小字

footer 是 Embed 底部的灰色小字区域,适合放免责声明或数据说明。R4ven 在两处使用了它:

  • IP 消息(all/index.html):提示"基于 IP 的地理位置并不精确,仅提供 ISP 的近似位置";
  • GPS 消息(all/index.html):提示"GPS 基于经纬度坐标,定位精度可达 20~30 米"。

语法非常简单,在 myEmbed 里加一个字段即可:

footer: { text: "在这里写你自己的页脚文字" }

删除该字段则不显示页脚。footer 还支持 icon_url 附一个 16×16 的小图标,属于进阶用法。

实战:5 步自定义一条专属 Embed 消息

R4ven Python 脚本终端运行界面:模块菜单与 Flask 服务启动

以 gps 模块为例,编辑 gps/index.html 即可完成个性化改造:

  1. 改作者名与标题:修改 author.name 和 title,比如改成 "📍 目标定位报告";
  2. 换颜色:将 color: 15844367 换成上节换算出的新十进制色值;
  3. 调正文格式:修改 description 中的代码块语言标签(如 ```prolog 换 ```xl),或增删拼进消息的字段;
  4. 加页脚:新增 footer: { text: "仅限授权测试使用" };
  5. 改通知身份:修改 params 里的 username、avatar_url,以及 content 中的 @everyone 提醒文案——若不想打扰全频道,直接删掉 @everyone 前缀即可。

改完后保存,重新启动 python3 r4ven.py(入口见 r4ven.py),新消息格式立即生效。四个模块(gps/、cam/、ip/、all/)的 index.html 结构基本一致,改动思路完全相同。

常见问题速答

Q1:color 为什么必须写数字,不能写 #EB459E? Discord Webhook API 规定 color 为整型(0xRRGGBB 的十进制值),字符串会直接报错。想要十六进制写法可以用 color: { type: ..., value: ... } 之外的官方替代:部分客户端支持 # 开头的字符串,但 Webhook 请求体中请以十进制为准最稳妥。

Q2:修改消息后 Discord 里没变化? 检查是否编辑了对应模块的 index.html(不同功能模块是独立文件),并确认目标设备刷新了页面——消息是页面加载时由浏览器端 JS 构造并发送的。

Q3:content 和 description 有什么区别? content 在卡片外层,是普通文本(支持 @ 提醒);description 在 Embed 卡片内部,支持完整 Markdown 与代码块。R4ven 的提醒句放在 content,数据放在 description。

结语

R4ven 的 Discord 消息格式本质是一份"手写"的 Webhook JSON:params 决定以谁的身份发言,myEmbed 决定长什么样。掌握上文的颜色码换算、代码块标签与 footer 页脚三件套,你就能把默认的粉紫/红色卡片改造成任意风格。相关使用说明可参考 README.md,项目定位为安全教育与授权测试工具,请务必只在获得明确授权的范围内使用。

登录后查看全文
r4ven