|
|
首先,效果图片(图一)前言本功能并非实现真正意义上的已读,而是由模块实现,原理类似ip探针,模块发起信息[图二],引用外部链接,后台记录ip,返回模块实现,几个ip几个已读(苹果手机无法追踪)准备:微信.apk,模块.apk[滑稽][滑稽][滑稽]正片开始项目并非本人项目项目地址:https://github.com/gaigebeckmanChristinaJames/read-receipt-tracker (审核大大明辨,该项目为github开源项目,无引流,纯分享) Read‑Receipt‑Tracker ,一款开源、自托管的消息已读追踪后端服务。简单来讲,它可以帮你实现类似“已读回执”的能力:知道你的邮件、网页、自定义消息有没有被对方打开查看。项目提供 Python Flask 和 C++ 两套后端,支持 Docker、Linux、安卓Termux多种部署方式,不需要复杂环境,普通设备就可以搭建,数据保存在本地 SQLite,不会上传第三方平台。 工作原理 核心技术是1×1 透明像素埋点技术。 1. 服务端调用注册接口,为一条消息生成专属的追踪图片链接,图片是一个肉眼完全看不见的 1×1 透明 GIF。2. 将这个图片链接嵌入邮件正文、网页、聊天消息当中发送给接收方。3. 当接收方打开邮件/页面时,客户端会自动加载这张图片,就会向你的服务发起 HTTP 请求。4. 服务收到请求后,记录下访问时间、访客IP,可选解析IP归属地,存入数据库。5. 你通过 Web 后台或者 API,就可以查看这条消息是否被读取、读取时间、访问来源。 主要特性 1. ✅ 透明像素埋点追踪,支持生成多条追踪任务2. ✅ 自动去重:同一个IP对同一条消息只记录一次读取3. ✅ IP地理位置解析,可一键关闭定位功能4. ✅ Web可视化后台:查看记录、导出CSV、API密钥管理5. ✅ SQLite本地数据库,数据自持,不上传第三方6. ✅ 多部署方案:Docker、Linux服务器、安卓Termux7. ✅ 内置限流,防止恶意刷请求8. ✅ 提供完整HTTP API,方便对接其他程序 部署教程 方式一:Termux(安卓手机部署,适合测试,缺点为本机运行不能关闭,且连接不稳定。优点无需服务器等) 手机直接运行服务,没有公网IP需要搭配 cloudflared 内网穿透生成公网地址。 1. 打开Termux,执行一键部署脚本(标准版,带IP定位) bash
curl -fsSL https://raw.githubusercontent.com/gaigebeckmanChristinaJames/read-receipt-tracker/main/scripts/install_termux.sh | bash2. 脚本执行完毕,服务自动启动。本地访问地址: http://127.0.0.1:8080 3. 内网穿透(必须,外部网络才能访问你的追踪接口)脚本内置cloudflared一键隧道,执行隧道启动命令,复制输出的 https://xxx.trycloudflare.com 公网地址,就是你的对外服务地址。 ⚠️ Termux关闭后台会停止服务,需要保持后台运行,或者开启保活脚本。 方式二:Linux服务器部署 1. 克隆项目源码 bash
git clone https://github.com/gaigebeckmanChristinaJames/read-receipt-tracker.gitcd read-receipt-tracker 2. 使用Python后端(简单易上手) bash
cd pythoncp .env.example .env# 修改.env配置,设置后台密钥、端口、定位开关uv pip install -r requirements.txtpython run.py 3. 配置 systemd 实现后台常驻开机自启,项目scripts目录提供现成服务文件。 方式三:Docker部署(推荐正式使用) bash
git clone https://github.com/gaigebeckmanChristinaJames/read-receipt-tracker.gitcd read-receipt-trackerdocker-compose up -d 容器启动完成后,访问 http://localhost:8080 ,数据自动持久化挂载。 使用流程 1. 打开Web后台,使用你在 .env 配置的密钥登录管理面板。2. 在后台注册一条追踪任务,系统生成专属的像素图片URL。3. 将图片链接嵌入邮件HTML、网页当中发送给目标对象。 邮件中使用示例HTML片段: html
<img src="https://你的公网地址/pixel?id=任务ID" width="1" height="1" style="display:none;"> 4. 对方打开内容,加载图片就会触发追踪记录。5. 返回Web后台,查看该任务:读取时间、IP、地理位置,支持导出CSV文件保存记录。 本篇文章为本人结合ai生成,具体哪里不会可发在楼下。另外,如该教程过于繁琐可直接在图二模块页面填入本人实例站,域名已备案无引流信息审核大大明辨已读成品实例服务器(可直接填入模块使用):https://wx.hebcpc.top/
|
本帖子中包含更多资源
您需要 登录 才可以下载或查看,没有账号?立即注册
×
|