R4ven Discord消息格式详解:Embed颜色码、代码块与footer如何自定义
R4ven Discord消息格式详解:Embed颜色码、代码块与footer如何自定义
R4ven 是一款基于 Python 的安全意识工具,它通过浏览器权限获取目标的 GPS 坐标、IP 地址、设备信息并截取摄像头画面,再将结果实时发送到 Discord 频道。本文详解 R4ven Discord 消息格式的完整构成:Embed 颜色码的取值原理、代码块语法如何决定数据高亮效果、footer 页脚如何添加说明文字,并演示如何自定义一条专属风格的消息卡片。
消息如何发到 Discord 频道:R4ven 的数据流
理解消息格式前,先看数据流向:
- 目标设备打开链接后,模块页面中的 JavaScript 构造一条 JSON 消息体(
params+myEmbed); - 消息先 POST 到本地 Flask 服务的
/location_update接口,该路由定义在 port_forward.py; - 路由调用 utils.py 中的
update_webhook(),把消息原样转发到你在 Discord 创建的 Webhook 地址; - Webhook 地址由 utils.py 的
check_and_get_webhook_url()用正则校验后,自动写入当前模块目录下的dwebhook.js文件,下次启动无需重复输入。
因此,你在频道里看到的每一条消息,样式都由模块 index.html 里的两个变量完全决定——改消息格式,就是改这两个变量。
Embed 消息结构:一条 Webhook 消息的组成
以"获取目标系统信息"为例,消息体由两部分组成(见 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 的返回字段逐行拼接而成,效果如下图所示——左侧正是代码块渲染出的字段清单:
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 消息
以 gps 模块为例,编辑 gps/index.html 即可完成个性化改造:
- 改作者名与标题:修改
author.name和title,比如改成 "📍 目标定位报告"; - 换颜色:将
color: 15844367换成上节换算出的新十进制色值; - 调正文格式:修改
description中的代码块语言标签(如```prolog换```xl),或增删拼进消息的字段; - 加页脚:新增
footer: { text: "仅限授权测试使用" }; - 改通知身份:修改
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,项目定位为安全教育与授权测试工具,请务必只在获得明确授权的范围内使用。


