buu1(如提示需要,请输入)
这个工具解决什么问题
群里发来一条 t.cn 的短链,说「点开看看」。你不知道它通向哪里:也许是公众号文章,也许是一个要填手机号的落地页。想先弄清楚,能用的办法都不顺手——把链接粘进浏览器,它会自己跳完,地址栏只留最终那一个,中间经过了谁、跳了几次,得自己去翻开发者工具的 Network 面板,还得一条条数 301 和 302;用在线展开服务,一次只能查一条,公司的内网链接还不敢往第三方站上贴;自己写个脚本,每换一个场景(有的跳转写在 meta refresh 里、有的写在脚本里、有的是 308)就改一次代码。一批链接要核对的时候更麻烦:十个链接十条跳转链,手工记录下来,抄错一个字符就白对。这个工具把这件事做成一个窗口:粘一批链接进去,逐条展开,每一跳的状态码与目标列出来,最后落到哪个站、有没有明文降级、换了几次站,一行一行看清楚,还能导出成表格交给别人。
- 原来的做法:粘进浏览器让它跳完,再去开发者工具里翻 Network 面板,一条条数 301/302;或者用在线展开服务单条查,内网地址还不敢贴上去
- 用这个工具:双击打开 → 把链接粘进左边(一行一个)→ 点「开始还原」→ 列表里直接看到跳数与最终地址,点一行看每一跳的明细 → 需要留档就点「导出 CSV」
- 省下来的:一条链接从「翻面板数跳转」的一两分钟压到一次点击;十条一批的核对从半小时变成一次导出
技术实现
整个工具只有一个 Python 文件,界面用标准库自带 tkinter,打包成一个 exe,用户解压双击就能用,不需要装 Python、不需要装运行库。代码在结构上切成两块:一块是纯函数与请求层(URL 清洗、站点比较、meta/脚本跳转识别、单次请求、逐跳展开),完全不碰界面,因此可以在没有窗口的环境里被逐条断言;另一块是界面层,只负责收集输入、把结果填进表格、导出文件。这两块之间用「结果字典」通信,字典里就是输入、每一跳、最终地址、标题、错误原因这些字段,界面不关心它是怎么抓来的。请求层刻意不使用「自动跟随跳转」的默认行为:urllib 默认会一口气跟完所有跳转,最后只给你一个 200,中间那串 301/302 全部被吞掉,而这恰恰是本工具唯一要收集的东西。所以自定义了一个「不跟随」的处理器,让每个 3xx 都以响应的形式回到手里,自己记录、自己决定下一跳去哪。这样做还顺手拿到了两个好处:循环跳转能被自己的 seen 集合挡住,跳数上限也能精确控制。
- 让 urllib 不再自动跟随跳转:继承 HTTPRedirectHandler 并让 redirect_request 返回 None,urllib 就会把 301/302/303/307 当成 HTTPError 抛出来;在 fetch_once 里接住这个异常,反而拿到了完整的 code 与 Location 响应头。这是整个工具的关键一步:跟随跳转的库拿不到中间过程,不跟随的库才拿得到。另外 308(永久重定向)urllib 默认根本不认,会直接落到「未知状态码」分支,这里靠同一段逻辑统一处理。
- 用 GET 而不是 HEAD 探测,但只读 24KB:很多短链服务对 HEAD 请求返回 405 或 200 空响应,甚至干脆不回 Location,用 HEAD 去探测会得到「这条链接没有跳转」的错误结论。所以统一发 GET,但只 read(24×1024) 就关闭连接——找 <title> 和 meta refresh 用不了更多字节,也不会因为对方返回一个几百兆的文件把内存吃满。
- meta refresh 与脚本跳转要单独识别:相当一部分推广链接的中转页不是 3xx,而是返回 200 的 HTML,里面写着 <meta http-equiv="refresh" content="0;url=..."> 或 location.href=...。只看状态码会把这类链接判成「最终地址就是中转页」。识别 meta 时先把标签切出来再取属性,而不是写一个大正则硬套——属性顺序、单双引号、换行都能过;取 URL 时不能把分号排除在字符集外,否则 url=https://a.cn/b?x=1&y=2 会被切成半截。
- 循环跳转、跳数上限、超时三道刹车:每跳一次都把目标地址放进 seen 集合,第二次出现就判定循环并停止——A→B→A 这种链接如果不拦,程序会一直转到超时为止,用户只会看到一个卡死的窗口。跳数上限(默认 10,可调到 30)对付那种理论上不循环但极长的链;单次请求超时(默认 8 秒)保证某一条慢站不会拖住整批。三者到位之后,最坏情况也就是几秒钟出一条「失败」记录。
- 编码不靠猜测:先看响应头,再退 UTF-8 与 GB18030:国内站点大量使用 GBK,而响应头常常不写 charset。直接按 UTF-8 解码会得到一片乱码,<title> 与 meta 全都读不出来。解码顺序是:响应头声明的字符集 → UTF-8 → GB18030 → UTF-8 忽略错误。前三个都用严格模式试,能严格解出来的那个才是对的。
- 网络在工作线程,界面只负责刷新:一批链接展开可能要十几秒,如果跑在界面线程里,窗口会一直转圈甚至被系统标记为「无响应」。实际做法是把逐条展开放进后台线程,结果通过 queue 回传,主线程每 120 毫秒取一次队列刷新表格与进度条。这样即使某一条卡在超时,窗口照样能滚动、能点「停止」。
- 高分屏按实际缩放换算尺寸:声明 DPI 感知之后,175% 缩放下 9pt 字会渲染成 21 像素高,而窗口尺寸如果还按 96dpi 的数值写死,字就会顶出窗口、按钮被切掉一半。做法是读 tkinter 的 tk scaling 值除以 1.3333 得到缩放系数,窗口尺寸、行高、列宽、内边距全部乘这个系数。
技术栈:Python 3.12 + tkinter(标准库界面,零第三方依赖)、urllib.request 自定义 HTTPRedirectHandler,让每一跳都变成可读响应、同一套请求逻辑覆盖 301/302/303/307/308 五种状态码、meta refresh 与 location 脚本跳转的二次识别、循环跳转检测 + 跳数上限 + 单次超时三重熔断、工作线程 + 队列回传,界面在做网络请求时不假死、PyInstaller 单文件打包,窗口程序不带黑色控制台
已知局限:只解析 HTTP 层的跳转与 HTML 里的 meta / 脚本跳转,不解密 JavaScript 运行时才算出来的地址(比如先请求一个接口、拿到结果再 location 跳转的页面,本工具会停在中转页)。需要登录或带 Cookie 才能看的链接拿不到最终页面。部分站点对非浏览器请求返回验证页或 403,这时会如实报出错状态码,而不是假装展开成功。带防盗链校验的图片、需要 App 才能打开的 applink(sinaweibo:// 这类)也只记录到协议跳转为止。批量展开是逐条串行请求,几十条以上会花上一两分钟,这是刻意的——并发请求容易被对方限流,反而更慢。
同类软件对照
下面几款都是公开可查的同类软件,定位各不相同。这里只说明各自的定位,以及本工具在其中的位置,方便你判断哪一类更契合自己的用法。
| 软件 | 它的定位 | 本工具的定位 |
|---|---|---|
| urlex.org | 公开的网页版链接展开服务,把短链粘进网页,由服务端代为展开并显示最终地址 | 它是网页服务,链接要提交到对方服务器上;本工具在你自己的电脑上发请求,内网地址与带参数的推广链接不必交给第三方,结果也能直接导出成表格 |
| Redirect Path(浏览器扩展) | 装在浏览器里的扩展,在地址栏旁显示当前页面经过的每次跳转与状态码,主要给做投放与 SEO 的人用 | 它依附于浏览器、跟着你手动打开页面才记录;本工具是独立窗口,一次可以贴一批链接,展开完直接出表格,不需要真的把页面打开 |
| 浏览器开发者工具的 Network 面板 | 浏览器自带,能看到每个请求的状态码与响应头,是排查跳转最原始也最权威的手段 | 它面向调试,需要自己开面板、筛请求、一条条读 301/302;本工具把这件事固化成「贴进去、出结果」,并把跳数、换站次数、明文降级直接算好 |
| 站长工具类站点的短链还原入口 | 国内一些站长工具站提供短链还原,一般一次查一条,结果显示最终地址 | 它们通常是单条查询、结果不留档;本工具支持整批粘贴、逐跳明细与 CSV 导出,适合要把核对结果交给别人的场景 |
以上仅作定位对照,各软件的可用性、授权方式与功能范围请以其官方页面为准。
操作教程
- 解压后双击「短链还原与跳转追踪.exe」
不需要安装。Windows 可能弹出「Windows 已保护你的电脑」,点「更多信息 → 仍要运行」即可,这是未做代码签名的程序都会遇到的提示。
预期结果:出现一个窗口:上方是链接输入框,中间是「开始还原」按钮,下方是结果列表与跳转明细 - 把要查的链接粘进去
一行一个。可以直接从聊天窗口复制后点「粘贴剪贴板」,也可以先点「载入示例」看效果。粘贴的内容里夹着中文句子也没关系,程序会把其中的网址抠出来;没有写 http 开头的也会自动补上。
预期结果:输入框下方显示「已识别 N 条」,重复的行会自动去掉 - 确认三个选项
超时默认 8 秒,跳数上限默认 10 跳,两个都够用。想让结果里带上落地页标题就保持勾选「读页面标题」——它会多读一点页面内容。
预期结果:不改也能直接跑;改过之后本次生效,下次打开恢复默认 - 点「开始还原」
程序会对每条链接逐跳请求。第一行出现的速度取决于对方的响应,慢站可能要几秒。中途想停就再点一次按钮,按钮这时显示的是「停止」。
预期结果:进度条按条推进;列表里逐条出现「输入链接 / 跳数 / 最终地址 / 落地页标题」;状态栏显示「正在还原 3/5…」 - 点一行看每一跳
选中任意一行,下方明细区会列出这条链接的完整路径:第几跳、状态码是多少、从哪个地址跳到哪个地址、这一跳是后端重定向还是页面里的 meta/脚本跳转。
预期结果:明细区出现「第 1 跳 [302 3xx] 从 … 到 …」,末尾给出最终地址、最终站点与结论(跳数、换站次数、是否明文降级) - 导出或复制
「导出 CSV」把全部结果存成表格,用表格软件打开不会乱码;选中一行点「复制最终地址」,只把最终那一条粘到别处。
预期结果:保存出「短链还原_年月日_时分.csv」,含输入链接、最终地址、跳数、最终主机、协议、标题、是否明文降级等列
常见问题
技术实现与后续维护
这个工具由我们自己开发和维护,核心逻辑在本机跑过完整自测:由本机 HTTP 服务模拟链式跳转、循环、meta 与脚本跳转、308、超时等情形,逐条断言。下面说明它的技术构成与后续可以扩展的方向,方便你判断是否契合自己的使用场景。
技术构成:
纯函数区—— normalize_url / host_of / base_domain / is_same_site / is_downgrade 负责地址清洗与站点比较;find_meta_refresh / find_js_redirect / extract_title 负责从 HTML 里找跳转目标与标题;parse_urls / export_rows / describe_result 负责输入输出请求层—— _NoRedirect 处理器让 urllib 不自动跟随;fetch_once 请求一次并保留状态码、Location 与前 24KB 正文;expand 负责逐跳推进,带循环检测、跳数上限与超时界面层—— run_gui 内构建窗口:输入区、三个选项、开始/停止、结果表(Treeview)、跳转明细、导出与复制;网络跑在工作线程,结果经 queue 回主线程刷新自测—— tests/selftest.py 起一个本机 HTTP 服务,造出链式跳转、循环、meta、脚本跳转、308、相对地址、404、超时、跳数上限,再逐条断言
运行环境:
运行环境:Windows 10/11 64 位,不需要装 Python。开发环境用 Python 3.12 加标准库 tkinter,打包用 PyInstaller 的单文件模式(--onefile --noconsole),产物是一个 exe,双击即开,不会弹出黑色控制台窗口。自测脚本零依赖,起一个本机 HTTP 服务做断言,不访问外网。
可扩展方向:
- 域名黑名单:内置一份已知的诈骗与赌博中转域名清单,命中时在结果里标红提示
- 二维码识别:截图或粘贴二维码图片,先解出里面的地址再展开,省掉手抄这一步
- 定时复查:同一批链接按天重跑,记录最终地址变化,用来发现「链接被换成了别的内容」
- 并发控制:给每批设置并发数并自动退避,兼顾速度与对方的频率限制
- 落地页快照:把最终页面的标题、首屏文字与截图留档,作为链接当时指向的证据
本工具免费提供使用,功能完整、不设限制。如果你需要在本工具基础上做功能调整、对接内部系统或长期维护,可以联系我们做二次开发。
需要其它功能?可以定制
这个工具只做一件事:短链、推广链接、二维码里抄出来的地址,点开之前你只知道那十几个字符;中间经过几个中转域名、有没有从加密连接掉回明文、最后落在哪个站,全都要等浏览器跳完才知道,而那时候页面已经打开了。如果你的场景还需要别的处理,可以联系我们做二次开发,按你的实际数据格式和流程定制。
常见的定制需求:
- 要把展开结果接到内部的投放核对表里,按天自动出一份
- 要支持带登录状态展开(用公司账号的 Cookie 访问内部短链)
- 要把一批二维码图片直接拖进来,自动识别并展开
- 要在跳转链里标出指定的可疑域名并发出提醒
- 联系方式:邮箱/微信见站内「联系我们」页面,或在本文下方留言
- 定制说明:请附上你的数据样例(脱敏即可)和期望结果,方便快速评估工作量
- 交付形式:定制项目交付可执行程序,支持后续版本迭代与长期维护
使用说明与免责声明
- 本工具仅用于采集公开可见或你自身拥有权限的数据。
- 请遵守目标网站的服务条款、robots 协议及《网络安全法》等相关法律法规。
- 请合理控制请求频率,不要对目标站点造成访问压力。
- 不得用于采集个人隐私、付费墙内容或任何受法律保护的非公开数据。
- 因使用不当造成的后果由使用者自行承担;本工具不做数据二次分发。
buu1(如提示需要,请输入)
