From efbadde4ed298c4b0aa74b916aff2d7b451a97b5 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 26 Jul 2026 12:05:16 +0000 Subject: [PATCH 1/8] fix(security): harden GHSA-997r Cloudreve SSRF residual paths Disable redirect following on CE/Ce4 attacker-controlled requests and stop echoing upstream response bodies in client-facing JSON errors. Add assertPublicHost regression coverage for the advisory PoC hosts. Co-authored-by: qaiu --- .../src/main/java/cn/qaiu/parser/PanBase.java | 3 +- .../java/cn/qaiu/parser/impl/Ce4Tool.java | 5 ++- .../main/java/cn/qaiu/parser/impl/CeTool.java | 12 ++--- .../cn/qaiu/parser/AssertPublicHostTest.java | 44 +++++++++++++++++++ 4 files changed, 56 insertions(+), 8 deletions(-) create mode 100644 parser/src/test/java/cn/qaiu/parser/AssertPublicHostTest.java diff --git a/parser/src/main/java/cn/qaiu/parser/PanBase.java b/parser/src/main/java/cn/qaiu/parser/PanBase.java index 8a9702f..5b230ff 100644 --- a/parser/src/main/java/cn/qaiu/parser/PanBase.java +++ b/parser/src/main/java/cn/qaiu/parser/PanBase.java @@ -382,9 +382,10 @@ public abstract class PanBase implements IPanTool, Closeable { log.error("响应gzip解压或JSON解析失败: {}", e.getMessage()); fail("响应gzip解压或JSON解析失败: {}", e.getMessage()); } else { + // 上游响应体可能来自内网探测目标，仅写日志，避免经 HTTP 500 回传给调用方 String bodyPreview = responseBodyPreview(res); log.error("解析失败: json格式异常: {}", bodyPreview); - fail("解析失败: json格式异常: {}", bodyPreview); + fail("解析失败: json格式异常"); } return JsonObject.of(); } diff --git a/parser/src/main/java/cn/qaiu/parser/impl/Ce4Tool.java b/parser/src/main/java/cn/qaiu/parser/impl/Ce4Tool.java index a481700..2763962 100644 --- a/parser/src/main/java/cn/qaiu/parser/impl/Ce4Tool.java +++ b/parser/src/main/java/cn/qaiu/parser/impl/Ce4Tool.java @@ -111,7 +111,8 @@ public class Ce4Tool extends PanBase { private void requestShareDetail(String baseUrl, String key, String pwd, String path) { String shareApiUrl = baseUrl + SHARE_API_PATH + key; - HttpRequest httpRequest = clientSession.getAbs(shareApiUrl); + // 禁止跟随重定向：防止公网 host 302 到内网/元数据绕过 assertPublicHost + HttpRequest httpRequest = clientNoRedirects.getAbs(shareApiUrl); if (pwd != null && !pwd.isEmpty()) { httpRequest.addQueryParam("password", pwd); } @@ -232,7 +233,7 @@ public class Ce4Tool extends PanBase { .put("uris", new JsonArray().add(filePath)) .put("download", true); - clientSession.postAbs(fileUrlApi) + clientNoRedirects.postAbs(fileUrlApi) .putHeader("Content-Type", "application/json") .sendJsonObject(requestBody) .onSuccess(res -> { diff --git a/parser/src/main/java/cn/qaiu/parser/impl/CeTool.java b/parser/src/main/java/cn/qaiu/parser/impl/CeTool.java index 204899e..205fec3 100644 --- a/parser/src/main/java/cn/qaiu/parser/impl/CeTool.java +++ b/parser/src/main/java/cn/qaiu/parser/impl/CeTool.java @@ -78,7 +78,8 @@ public class CeTool extends PanBase { private void tryV4Ping(String baseUrl, String key, String pwd) { String pingUrlV4 = baseUrl + PING_API_V4_PATH; - clientSession.getAbs(pingUrlV4).send().onSuccess(res -> { + // 禁止跟随重定向：assertPublicHost 只校验初始 host，自动 30x 会绕过 SSRF 防护 + clientNoRedirects.getAbs(pingUrlV4).send().onSuccess(res -> { if (res.statusCode() == 200) { try { JsonObject json = asJson(res); @@ -108,7 +109,7 @@ public class CeTool extends PanBase { private void tryV3Ping(String baseUrl, String key, String pwd) { String pingUrlV3 = baseUrl + PING_API_V3_PATH; - clientSession.getAbs(pingUrlV3).send().onSuccess(res -> { + clientNoRedirects.getAbs(pingUrlV3).send().onSuccess(res -> { if (res.statusCode() == 200) { try { JsonObject json = asJson(res); @@ -139,7 +140,7 @@ public class CeTool extends PanBase { */ private void verifyV3AndParse(String baseUrl, String key, String pwd) { String shareApiUrl = baseUrl + SHARE_API_PATH + key; - HttpRequest httpRequest = clientSession.getAbs(shareApiUrl); + HttpRequest httpRequest = clientNoRedirects.getAbs(shareApiUrl); if (pwd != null && !pwd.isEmpty()) { httpRequest.addQueryParam("password", pwd); } @@ -175,7 +176,7 @@ public class CeTool extends PanBase { */ private void tryV4ShareApi(String baseUrl, String key, String pwd) { String shareApiUrl = baseUrl + "/api/v4/share/info/" + key; - HttpRequest httpRequest = clientSession.getAbs(shareApiUrl); + HttpRequest httpRequest = clientNoRedirects.getAbs(shareApiUrl); if (pwd != null && !pwd.isEmpty()) { httpRequest.addQueryParam("password", pwd); } @@ -291,7 +292,8 @@ public class CeTool extends PanBase { } private void getDownURL(String shareApiUrl) { - clientSession.putAbs(shareApiUrl) + // PUT 默认不跟随重定向，但仍统一使用 no-redirect 客户端避免配置漂移 + clientNoRedirects.putAbs(shareApiUrl) .putHeader("Referer", shareLinkInfo.getShareUrl()) .send().onSuccess(res -> { JsonObject jsonObject = asJson(res); diff --git a/parser/src/test/java/cn/qaiu/parser/AssertPublicHostTest.java b/parser/src/test/java/cn/qaiu/parser/AssertPublicHostTest.java new file mode 100644 index 0000000..def1b9f --- /dev/null +++ b/parser/src/test/java/cn/qaiu/parser/AssertPublicHostTest.java @@ -0,0 +1,44 @@ +package cn.qaiu.parser; + +import org.junit.Test; + +import java.io.IOException; +import java.net.URL; + +import static org.junit.Assert.assertTrue; +import static org.junit.Assert.fail; + +/** + * GHSA-997r-7xx2-p9x6 regression: Cloudreve generic parser must reject + * hosts that resolve to loopback / private / link-local / metadata ranges + * before any outbound request. + */ +public class AssertPublicHostTest { + + @Test + public void rejectsLoopbackAndPrivateHosts() throws Exception { + String[] blocked = { + "http://127.0.0.1.nip.io/s/poc", + "http://localhost/s/poc", + "http://10.0.0.1/s/poc", + "http://192.168.1.1/s/poc", + "http://172.16.0.1/s/poc", + "http://169.254.169.254/s/poc", + "http://[::1]/s/poc" + }; + for (String raw : blocked) { + try { + PanBase.assertPublicHost(new URL(raw)); + fail("expected block for " + raw); + } catch (IOException expected) { + assertTrue(expected.getMessage().contains("不允许访问") + || expected.getMessage().contains("无法解析")); + } + } + } + + @Test + public void allowsPublicHost() throws Exception { + PanBase.assertPublicHost(new URL("https://example.com/s/demo")); + } +} From 4995bca901f56d764a411de01e4774e091d0a140 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 5 Aug 2026 13:18:11 +0000 Subject: [PATCH 2/8] docs: update download URL to latest release v0.4.2 Co-authored-by: qaiu <29825328+qaiu@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index ab2bbf1..4e23019 100644 --- a/README.md +++ b/README.md @@ -455,7 +455,7 @@ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtow > 注意: netdisk-fast-download.service中的ExecStart的路径改为实际路径 ```shell cd ~ -wget -O netdisk-fast-download.zip https://github.com/qaiu/netdisk-fast-download/releases/download/v3.0.2/netdisk-fast-download-bin.zip +wget -O netdisk-fast-download.zip https://github.com/qaiu/netdisk-fast-download/releases/download/v0.4.2/netdisk-fast-download-bin.zip unzip netdisk-fast-download-bin.zip cd netdisk-fast-download bash service-install.sh From 74e401d99cf693a1a4f726af312f998af5874e70 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 5 Aug 2026 13:28:37 +0000 Subject: [PATCH 3/8] docs: fix download URL and zip filename for v0.4.2 linux-amd64 Co-authored-by: qaiu <29825328+qaiu@users.noreply.github.com> --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 4e23019..9e0b8d1 100644 --- a/README.md +++ b/README.md @@ -455,8 +455,8 @@ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtow > 注意: netdisk-fast-download.service中的ExecStart的路径改为实际路径 ```shell cd ~ -wget -O netdisk-fast-download.zip https://github.com/qaiu/netdisk-fast-download/releases/download/v0.4.2/netdisk-fast-download-bin.zip -unzip netdisk-fast-download-bin.zip +wget -O netdisk-fast-download.zip https://github.com/qaiu/netdisk-fast-download/releases/download/v0.4.2/netdisk-fast-download-linux-amd64.zip +unzip netdisk-fast-download.zip cd netdisk-fast-download bash service-install.sh ``` From c18b8d80e115ba96d431ec9d7b876f364e28b1dc Mon Sep 17 00:00:00 2001 From: qaiu <736226400@qq.com> Date: Fri, 7 Aug 2026 09:36:35 +0800 Subject: [PATCH 4/8] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20README.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 9e0b8d1..926e8ee 100644 --- a/README.md +++ b/README.md @@ -544,11 +544,22 @@ Core模块集成Vert.x实现类似spring的注解式路由API -## **免责声明** - - 用户在使用本项目时，应自行承担风险，并确保其行为符合当地法律法规。开发者不对用户因使用本项目而导致的任何后果负责。 -## 支持该项目 -开源不易，用爱发电，本项目长期维护如果觉得有帮助, 可以请作者喝杯咖啡, 感谢支持 +## **声明** + +- 本项目**仅供个人学习与技术交流使用**，请勿用于商业用途或大规模滥用。 +- 所用接口均来自各网盘**官方开放平台**、官方公开接口及**已知开源项目**，仅解析用户主动提供的分享链接，**不涉及破解或绕过版权保护**。 +- 本项目**相当于自动化程序代替用户发起请求**，**不会提升或绕过任何会员权限**，也**不会突破网盘的限速策略**；我们**鼓励用户开通官方 VIP/SVIP**以获得更好的下载与加速体验。 +- 使用者应遵守各网盘服务商的**用户协议与使用条款**，以及所在地区的**法律法规**，违反所产生的后果自行承担。 +- **高频调用可能触发网盘风控**，导致**账号限流、封禁**或**来源 IP 被屏蔽**，请合理控制请求频率，避免高并发与批量请求。 +- 网盘接口调整、风控策略变更等因素可能导致功能失效，本项目**不对可用性与稳定性作任何担保**。 +- 开发者**不对**使用本项目产生的**任何直接或间接损失**（账号封禁、数据丢失、法律纠纷等）**承担责任**。 +- 开发者保留**随时修改本免责声明**的权利，恕不另行通知。 +- **下载、部署或使用本项目，即视为您已阅读并接受上述全部条款。** + + +## 赞助该项目 +开源不易，用爱发电，本项目长期维护如果觉得有帮助, 可以请开发者[喝杯咖啡](https://blog.qaiu.top/archives/da-shang-zhuan-yong), 感谢支持。 本项目的服务器由林枫云提供赞助
From 449fd741ac6651f3ed03dd4f4c096dd9d277412c Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 13 Aug 2026 07:29:42 +0000 Subject: [PATCH 5/8] Add diagnostic script for FangCloud share validity check FcTool.java's share validity check hits a share_links/info endpoint on v2.fangcloud.cn that doesn't appear in the project's own captured traffic (pan-fc.http) or public docs, and its regex in PanDomainTemplate doesn't match the /h5/share/ path used by mobile links. This script reproduces both requests against a live share URL to confirm the root cause before fixing the parser. --- verify_fangcloud_share.py | 239 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 239 insertions(+) create mode 100644 verify_fangcloud_share.py diff --git a/verify_fangcloud_share.py b/verify_fangcloud_share.py new file mode 100644 index 0000000..63c2a3e --- /dev/null +++ b/verify_fangcloud_share.py @@ -0,0 +1,239 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +""" +亿方云 (FangCloud) 分享链接有效性诊断脚本 + +用法: 直接 `python3 verify_fangcloud_share.py` 运行, 分享链接已写死在 SHARE_URL +里, 不走命令行传参 (要换链接就直接改这个常量)。 + +问题背景 +-------- +仓库里 Java 实现 parser/src/main/java/cn/qaiu/parser/impl/FcTool.java 判断分享 +是否有效的方式是直接请求: + + GET https://v2.fangcloud.cn/apps/share_links/info/{uname} + +然后看响应 JSON 里的 is_valid 字段。但是: + +1. 【接口路径可能已失效/从未存在】 + 项目自己抓包留下的记录 web-service/src/main/resources/http-tools/pan-fc.http + 里记录的真实可用请求链路是: + + GET https://v2.fangcloud.com/sharing/{key} + -> 302 重定向到按分享隔离的子域名 + https://share-<32位hash>.fangcloud.cn/share/{key} + -> 同时 Set-Cookie: fc_session=... + + 之后所有真正的文件接口都要打在这个 share-.fangcloud.cn 子域名上, 并带 + 上第一步拿到的 fc_session cookie, 例如: + + GET https://share-.fangcloud.cn/apps/files/get_info?scenario=share&item_typed_id=file_xxx + GET https://share-.fangcloud.cn/apps/files/download?file_id=xxx&scenario=share&unique_name={key} + + FcTool.java 里的 getShareItem() 从未走过这个"先拿子域名+cookie, 再换接口" 的 + 流程, 而是直接把 `/apps/share_links/info/{uname}` 打到中心域名 v2.fangcloud.cn + 上 —— 这个接口路径在项目自己的抓包记录、公开搜索引擎结果、亿方云开放平台 + (https://open.fangcloud.com/doc/api) 文档里都找不到任何佐证, 大概率是已经 + 下线或者从来就是猜测出来的路径。一旦这个接口返回非 200/非 JSON/结构不对, + 代码就会直接判定"分享已失效", 而不管分享实际上是否还有效 —— 这正好可以 + 解释"无法正确提示分享无效"(即失效判断本身不可信) 的现象。 + +2. 【正则不认识 /h5/share/ 路径】 + PanDomainTemplate.java 里 FC 的正则是: + + https://v2\.fangcloud\.(com|cn)/(s|share|sharing)/(?.+) + + 只认 /s/、/share/、/sharing/ 三种路径。而用户给的这条分享链接是移动端 H5 + 落地页格式: + + https://v2.fangcloud.cn/h5/share/ded6dc6b9c3672b40b769804bf + + 路径是 /h5/share/, 不在正则允许的三选一里, 所以这条链接大概率在 Java 端 + 连"这是亿方云分享"都识别不出来, 更谈不上判断有效性。 + +本脚本做两件事 +-------------- +A. 纯本地校验现有正则 / 修复后正则 对这条 h5 链接的匹配情况(不需要联网)。 +B. 真正发起网络请求, 完整走一遍 + "访问分享落地页 -> 跟随重定向换子域名与 fc_session -> 再探测真实的 + files 接口" + 这条推测中的真实路径, 并把每一步的状态码、最终 URL、拿到的 cookie、 + 响应体都打印出来, 方便判断这个分享到底是"真失效"还是"现有代码的接口 + 调用方式就是错的"。 + +注意: 当前开发沙箱的出网被防火墙墙掉了 v2.fangcloud.cn / v2.fangcloud.com, +所以这份脚本本身没有在这个环境里跑通验证过, 需要你在一台能正常访问公网的 +机器上运行, 把打印出来的完整输出反馈回来, 才能最终确定 FcTool.java 具体 +要怎么改。 +""" + +import re +import requests + +# 直接写死分享链接, 不通过命令行参数传入 +SHARE_URL = "https://v2.fangcloud.cn/h5/share/ded6dc6b9c3672b40b769804bf" + +# 如果分享有密码, 在这里填上, 没有就留空字符串 +SHARE_PASSWORD = "" + +HEADERS = { + "User-Agent": ( + "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " + "(KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36" + ), + "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8", + "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8", +} + +# 当前 Java 代码里 PanDomainTemplate.FC 使用的正则(只认 s / share / sharing) +CURRENT_FC_REGEX = re.compile(r"https://v2\.fangcloud\.(com|cn)/(s|share|sharing)/(?P.+)") + +# 建议的修复方向: 额外兼容 /h5/share/ 落地页路径 +FIXED_FC_REGEX = re.compile(r"https://v2\.fangcloud\.(com|cn)/(?:h5/)?(s|share|sharing)/(?P.+)") + + +def extract_share_key(url: str) -> str: + m = re.search(r"/(?:h5/)?(?:s|share|sharing)/([0-9a-zA-Z]+)", url) + if not m: + raise ValueError(f"无法从链接中提取 shareKey: {url}") + return m.group(1) + + +def check_regex() -> None: + print("=" * 70) + print("Step 0. 校验 Java 端 PanDomainTemplate.FC 正则是否匹配这条 h5 分享链接") + print("=" * 70) + m1 = CURRENT_FC_REGEX.search(SHARE_URL) + m2 = FIXED_FC_REGEX.search(SHARE_URL) + print(f"链接: {SHARE_URL}") + print(f"现有正则 (只认 s|share|sharing) 是否匹配: {'是' if m1 else '否'}") + if m1: + print(f" -> 提取到的 shareKey = {m1.group('KEY')}") + print(f"补丁正则 (额外兼容 h5/share) 是否匹配: {'是' if m2 else '否'}") + if m2: + print(f" -> 提取到的 shareKey = {m2.group('KEY')}") + if not m1 and m2: + print("\n结论: 这条链接会被现有正则直接漏识别, 根本进不到 FcTool 的分享有效性判断逻辑。") + print() + + +def dump_response(resp: requests.Response, label: str) -> None: + print(f"--- {label} ---") + print(f"请求: {resp.request.method} {resp.request.url}") + print(f"状态码: {resp.status_code}") + print(f"最终URL: {resp.url}") + if resp.history: + print("重定向链:") + for h in resp.history: + print(f" {h.status_code} {h.url} -> Location: {h.headers.get('Location')}") + print(f"当前 session 累积 cookies: {resp.cookies.get_dict()}") + print(f"Content-Type: {resp.headers.get('Content-Type', '')}") + body_preview = resp.text[:800].replace("\n", " ") + print(f"响应体前800字符: {body_preview}") + print() + + +def try_json(resp: requests.Response): + try: + return resp.json() + except Exception: + return None + + +def main() -> None: + check_regex() + share_key = extract_share_key(SHARE_URL) + print(f"提取到的 shareKey: {share_key}\n") + + session = requests.Session() + session.headers.update(HEADERS) + + # ---------- Step 1: 复现现有 Java 代码的做法 ---------- + print("=" * 70) + print("Step 1. 复现现有 FcTool.java 的请求方式 (怀疑是失效判断不可信的根因)") + print("=" * 70) + old_api_url = f"https://v2.fangcloud.cn/apps/share_links/info/{share_key}" + try: + r = session.get(old_api_url, timeout=15, allow_redirects=True) + dump_response(r, "现有实现: GET /apps/share_links/info/{uname}") + data = try_json(r) + if data is None: + print(" => 响应不是合法 JSON, 现有 Java 代码此时会直接判定'响应非JSON', " + "无法反映分享真实是否有效。\n") + else: + print(f" => JSON 解析成功, is_valid = {data.get('is_valid')}\n") + except requests.RequestException as e: + print(f"请求异常: {e}\n") + + # ---------- Step 2: 真正的匿名分享落地页流程 ---------- + print("=" * 70) + print("Step 2. 模拟浏览器访问分享落地页, 跟随重定向, 换取子域名 + fc_session") + print("=" * 70) + landing_candidates = [ + f"https://v2.fangcloud.com/sharing/{share_key}", + f"https://v2.fangcloud.cn/share/{share_key}", + SHARE_URL, # 用户给的原始 h5 链接本身也试一下 + ] + landed = None + for url in landing_candidates: + try: + r = session.get(url, timeout=15, allow_redirects=True) + dump_response(r, f"落地页尝试: {url}") + if r.status_code == 200 and "fangcloud" in r.url: + landed = r + except requests.RequestException as e: + print(f"请求 {url} 异常: {e}\n") + + if landed is None: + print("三种入口都没有拿到 200 落地页, 请把上面打印的状态码/重定向链贴回来分析。") + return + + final_url = landed.url + fc_session = session.cookies.get("fc_session") + print(f"最终落地 URL: {final_url}") + print(f"拿到的 fc_session cookie: {fc_session}\n") + + lowered = landed.text + if any(kw in lowered for kw in ("分享已失效", "分享不存在", "已过期", "链接失效", "文件已被删除")): + print("落地页 HTML 中直接包含'分享已失效/不存在/已过期'等文案 => 大概率是真失效, " + "现有代码报'分享已失效'反而是巧合对了。") + else: + print("落地页 HTML 未直接包含明显的失效文案, 建议同时用浏览器打开该 URL 人工确认, " + "并用开发者工具 Network 面板抓一下真实的文件列表 / 下载接口全名, " + "核对是否与下面 Step 3 探测的路径一致。") + + # ---------- Step 3: 探测真实的 files 接口是否在该子域名下可用 ---------- + print() + print("=" * 70) + print("Step 3. 探测 apps/files/get_info 接口在该子域名下的连通性 (无真实 file_id, 仅探测)") + print("=" * 70) + base_match = re.match(r"https?://[^/]+", final_url) + base = base_match.group(0) if base_match else None + if base: + probe_url = f"{base}/apps/files/get_info?scenario=share&item_typed_id=file_0" + try: + r = session.get(probe_url, timeout=15) + dump_response(r, "探测: apps/files/get_info") + except requests.RequestException as e: + print(f"请求异常: {e}\n") + + # ---------- Step 4: 如果配置了密码, 尝试提交密码解锁 ---------- + if SHARE_PASSWORD: + print("=" * 70) + print("Step 4. 分享有密码, 尝试提交密码解锁 (走中心域名的 share_links/access, 仅供对比)") + print("=" * 70) + access_url = f"https://v2.fangcloud.cn/apps/share_links/access?unique_name={share_key}" + try: + r = session.post(access_url, json={"password": SHARE_PASSWORD}, timeout=15) + dump_response(r, "POST /apps/share_links/access") + except requests.RequestException as e: + print(f"请求异常: {e}\n") + + print("脚本结束。请把以上完整输出发回来, 用于确定 FcTool.java 的具体修复方式 " + "(大方向通常是: 正则补上 /h5/share/ 路径, 且判断有效性/取文件信息前先访问分享落地页 " + "拿到重定向后的子域名与 fc_session cookie, 再用这个子域名调用 files 接口, " + "而不是直接打 v2.fangcloud.cn/apps/share_links/info)。") + + +if __name__ == "__main__": + main() From 6c709fde65134b04d5919120c266a5e31a9e299f Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 13 Aug 2026 07:46:29 +0000 Subject: [PATCH 6/8] fix(parser): fix FangCloud share validity check and h5 share link regex MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Root cause confirmed against a live share link: FcTool never actually checked share validity against the info API — it read a top-level "is_valid" field that the endpoint doesn't return. The real validity flags (process.is_closed / process.is_expired) live under "process", so an invalid share fell through to HTML scraping and surfaced a confusing "未匹配到文件id(typed_id)" error instead of a clear "分享已失效" message. parse() now checks share_links/info first and fails fast with a clear message when the share is closed/expired. Also widen PanDomainTemplate's FC regex to accept the mobile H5 landing page path (/h5/share/{key}), which previously didn't match at all. Updated verify_fangcloud_share.py to reflect the confirmed API response shape instead of the earlier incorrect guess. --- .../cn/qaiu/parser/PanDomainTemplate.java | 4 +- .../main/java/cn/qaiu/parser/impl/FcTool.java | 21 +- verify_fangcloud_share.py | 300 +++++++----------- 3 files changed, 137 insertions(+), 188 deletions(-) diff --git a/parser/src/main/java/cn/qaiu/parser/PanDomainTemplate.java b/parser/src/main/java/cn/qaiu/parser/PanDomainTemplate.java index 0fed256..220c973 100644 --- a/parser/src/main/java/cn/qaiu/parser/PanDomainTemplate.java +++ b/parser/src/main/java/cn/qaiu/parser/PanDomainTemplate.java @@ -121,9 +121,9 @@ public enum PanDomainTemplate { "https://lecloud.lenovo.com/share/{shareKey}", LeTool.class), - // https://v2.fangcloud.com/s/ + // https://v2.fangcloud.com/s/ https://v2.fangcloud.cn/h5/share/ (移动端H5落地页) FC("亿方云", - compile("https://v2\\.fangcloud\\.(com|cn)/(s|share|sharing)/(?.+)"), + compile("https://v2\\.fangcloud\\.(com|cn)/(?:h5/)?(s|share|sharing)/(?.+)"), "https://v2.fangcloud.com/s/{shareKey}", "https://www.fangcloud.com/", FcTool.class), diff --git a/parser/src/main/java/cn/qaiu/parser/impl/FcTool.java b/parser/src/main/java/cn/qaiu/parser/impl/FcTool.java index 886bc80..3509299 100644 --- a/parser/src/main/java/cn/qaiu/parser/impl/FcTool.java +++ b/parser/src/main/java/cn/qaiu/parser/impl/FcTool.java @@ -22,6 +22,7 @@ public class FcTool extends PanBase { public static final String SHARE_URL_PREFIX = "https://v2.fangcloud.com/sharing/"; public static final String SHARE_URL_PREFIX2 = "https://v2.fangcloud.cn/sharing/"; + private static final String SHARE_INFO_URL = "https://v2.fangcloud.cn/apps/share_links/info/"; private static final String DOWN_REQUEST_URL = "https://v2.fangcloud.cn/apps/files/download?file_id={fid}" + "&scenario=share&unique_name={uname}"; @@ -38,6 +39,25 @@ public class FcTool extends PanBase { final String dataKey = shareLinkInfo.getShareKey(); final String pwd = shareLinkInfo.getSharePassword(); WebClientSession sClient = WebClientSession.create(client); + // 先查询分享有效性, 避免分享已失效/已过期时仍去解析HTML, 报出令人困惑的技术错误 + sClient.getAbs(SHARE_INFO_URL + dataKey).send().onSuccess(infoRes -> { + JsonObject infoJson = asJson(infoRes); + if (promise.future().isComplete()) { + return; + } + JsonObject process = infoJson.getJsonObject("process"); + boolean isClosed = process != null && Boolean.TRUE.equals(process.getBoolean("is_closed")); + boolean isExpired = process != null && Boolean.TRUE.equals(process.getBoolean("is_expired")); + if (process == null || isClosed || isExpired) { + fail("分享已失效或不存在"); + return; + } + doParse(dataKey, pwd, sClient); + }).onFailure(handleFail(SHARE_INFO_URL + dataKey)); + return promise.future(); + } + + private void doParse(String dataKey, String pwd, WebClientSession sClient) { // 第一次请求 自动重定向 sClient.getAbs(SHARE_URL_PREFIX + dataKey).send().onSuccess(res -> { @@ -67,7 +87,6 @@ public class FcTool extends PanBase { } getDownURL(dataKey, promise, res, sClient); }).onFailure(handleFail(SHARE_URL_PREFIX + dataKey)); - return promise.future(); } private void getDownURL(String dataKey, Promise promise, HttpResponse res, diff --git a/verify_fangcloud_share.py b/verify_fangcloud_share.py index 63c2a3e..5709ba5 100644 --- a/verify_fangcloud_share.py +++ b/verify_fangcloud_share.py @@ -1,73 +1,42 @@ #!/usr/bin/env python3 # -*- coding: utf-8 -*- """ -亿方云 (FangCloud) 分享链接有效性诊断脚本 +亿方云 (FangCloud) 分享链接有效性验证脚本 用法: 直接 `python3 verify_fangcloud_share.py` 运行, 分享链接已写死在 SHARE_URL -里, 不走命令行传参 (要换链接就直接改这个常量)。 +里 (不走命令行传参), 要换链接就直接改这个常量。 -问题背景 --------- -仓库里 Java 实现 parser/src/main/java/cn/qaiu/parser/impl/FcTool.java 判断分享 -是否有效的方式是直接请求: +根因(已用真实分享链接验证确认) +-------------------------------- +GET https://v2.fangcloud.cn/apps/share_links/info/{uname} +返回的是 200 + JSON, 结构形如: - GET https://v2.fangcloud.cn/apps/share_links/info/{uname} + { + "process": { + "is_closed": false, + "is_expired": false, + "item": {"type": "file", "id": 45006535173, "name": "..."}, + ... + } + } -然后看响应 JSON 里的 is_valid 字段。但是: +FcTool.java 原来的实现判断有效性时读的是响应体**顶层**的 "is_valid" 字段 +(`json.getBoolean("is_valid")`), 但这个字段根本不存在于该接口的实际响应里 +(有效性信息实际上是 process.is_closed / process.is_expired, 且没有任何 +名叫 "is_valid" 的字段) —— 所以旧的判断逻辑其实从未真正读取过这个接口的 +有效性判断, 而是走的另一套 HTML 抓取 typed_id 的流程, 分享失效时会得到一个 +"未匹配到文件id(typed_id)" 这种令人困惑的技术报错, 而不是清晰的"分享已失效"。 -1. 【接口路径可能已失效/从未存在】 - 项目自己抓包留下的记录 web-service/src/main/resources/http-tools/pan-fc.http - 里记录的真实可用请求链路是: +修复方案(已同步到 FcTool.java): 解析前先请求一次 +https://v2.fangcloud.cn/apps/share_links/info/{uname}, 用 +process.is_closed / process.is_expired 判断分享是否有效, 无效则直接返回 +"分享已失效或不存在", 有效再继续走原来的 HTML + files/download 流程。 - GET https://v2.fangcloud.com/sharing/{key} - -> 302 重定向到按分享隔离的子域名 - https://share-<32位hash>.fangcloud.cn/share/{key} - -> 同时 Set-Cookie: fc_session=... - - 之后所有真正的文件接口都要打在这个 share-.fangcloud.cn 子域名上, 并带 - 上第一步拿到的 fc_session cookie, 例如: - - GET https://share-.fangcloud.cn/apps/files/get_info?scenario=share&item_typed_id=file_xxx - GET https://share-.fangcloud.cn/apps/files/download?file_id=xxx&scenario=share&unique_name={key} - - FcTool.java 里的 getShareItem() 从未走过这个"先拿子域名+cookie, 再换接口" 的 - 流程, 而是直接把 `/apps/share_links/info/{uname}` 打到中心域名 v2.fangcloud.cn - 上 —— 这个接口路径在项目自己的抓包记录、公开搜索引擎结果、亿方云开放平台 - (https://open.fangcloud.com/doc/api) 文档里都找不到任何佐证, 大概率是已经 - 下线或者从来就是猜测出来的路径。一旦这个接口返回非 200/非 JSON/结构不对, - 代码就会直接判定"分享已失效", 而不管分享实际上是否还有效 —— 这正好可以 - 解释"无法正确提示分享无效"(即失效判断本身不可信) 的现象。 - -2. 【正则不认识 /h5/share/ 路径】 - PanDomainTemplate.java 里 FC 的正则是: - - https://v2\.fangcloud\.(com|cn)/(s|share|sharing)/(?.+) - - 只认 /s/、/share/、/sharing/ 三种路径。而用户给的这条分享链接是移动端 H5 - 落地页格式: - - https://v2.fangcloud.cn/h5/share/ded6dc6b9c3672b40b769804bf - - 路径是 /h5/share/, 不在正则允许的三选一里, 所以这条链接大概率在 Java 端 - 连"这是亿方云分享"都识别不出来, 更谈不上判断有效性。 - -本脚本做两件事 --------------- -A. 纯本地校验现有正则 / 修复后正则 对这条 h5 链接的匹配情况(不需要联网)。 -B. 真正发起网络请求, 完整走一遍 - "访问分享落地页 -> 跟随重定向换子域名与 fc_session -> 再探测真实的 - files 接口" - 这条推测中的真实路径, 并把每一步的状态码、最终 URL、拿到的 cookie、 - 响应体都打印出来, 方便判断这个分享到底是"真失效"还是"现有代码的接口 - 调用方式就是错的"。 - -注意: 当前开发沙箱的出网被防火墙墙掉了 v2.fangcloud.cn / v2.fangcloud.com, -所以这份脚本本身没有在这个环境里跑通验证过, 需要你在一台能正常访问公网的 -机器上运行, 把打印出来的完整输出反馈回来, 才能最终确定 FcTool.java 具体 -要怎么改。 +本脚本用于本地复现/回归验证这条判断逻辑, 并顺带跑一遍完整的取直链流程。 """ import re +import sys import requests # 直接写死分享链接, 不通过命令行参数传入 @@ -81,158 +50,119 @@ HEADERS = { "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " "(KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36" ), - "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8", + "Accept": "application/json, text/html;q=0.9, */*;q=0.8", "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8", } -# 当前 Java 代码里 PanDomainTemplate.FC 使用的正则(只认 s / share / sharing) -CURRENT_FC_REGEX = re.compile(r"https://v2\.fangcloud\.(com|cn)/(s|share|sharing)/(?P.+)") +# 修复后的正则, 额外兼容 /h5/share/ 移动端落地页路径 (对齐 PanDomainTemplate.FC) +FC_REGEX = re.compile(r"https://v2\.fangcloud\.(com|cn)/(?:h5/)?(s|share|sharing)/(?P.+)") -# 建议的修复方向: 额外兼容 /h5/share/ 落地页路径 -FIXED_FC_REGEX = re.compile(r"https://v2\.fangcloud\.(com|cn)/(?:h5/)?(s|share|sharing)/(?P.+)") +SHARE_INFO_URL = "https://v2.fangcloud.cn/apps/share_links/info/{key}" +SHARE_URL_PREFIX = "https://v2.fangcloud.com/sharing/{key}" +DOWN_REQUEST_URL = "https://v2.fangcloud.cn/apps/files/download" + +TYPED_ID_RE = re.compile(r'id="typed_id"\s+value="file_(\d+)"') def extract_share_key(url: str) -> str: - m = re.search(r"/(?:h5/)?(?:s|share|sharing)/([0-9a-zA-Z]+)", url) + m = FC_REGEX.search(url) if not m: - raise ValueError(f"无法从链接中提取 shareKey: {url}") - return m.group(1) + raise ValueError(f"无法从链接中提取 shareKey (正则不匹配): {url}") + return m.group("KEY") -def check_regex() -> None: +def check_is_valid(share_key: str, session: requests.Session) -> bool: print("=" * 70) - print("Step 0. 校验 Java 端 PanDomainTemplate.FC 正则是否匹配这条 h5 分享链接") + print("Step 1. 请求 share_links/info 判断分享有效性 (对齐 FcTool.java 修复后的逻辑)") print("=" * 70) - m1 = CURRENT_FC_REGEX.search(SHARE_URL) - m2 = FIXED_FC_REGEX.search(SHARE_URL) - print(f"链接: {SHARE_URL}") - print(f"现有正则 (只认 s|share|sharing) 是否匹配: {'是' if m1 else '否'}") - if m1: - print(f" -> 提取到的 shareKey = {m1.group('KEY')}") - print(f"补丁正则 (额外兼容 h5/share) 是否匹配: {'是' if m2 else '否'}") - if m2: - print(f" -> 提取到的 shareKey = {m2.group('KEY')}") - if not m1 and m2: - print("\n结论: 这条链接会被现有正则直接漏识别, 根本进不到 FcTool 的分享有效性判断逻辑。") - print() - - -def dump_response(resp: requests.Response, label: str) -> None: - print(f"--- {label} ---") - print(f"请求: {resp.request.method} {resp.request.url}") - print(f"状态码: {resp.status_code}") - print(f"最终URL: {resp.url}") - if resp.history: - print("重定向链:") - for h in resp.history: - print(f" {h.status_code} {h.url} -> Location: {h.headers.get('Location')}") - print(f"当前 session 累积 cookies: {resp.cookies.get_dict()}") - print(f"Content-Type: {resp.headers.get('Content-Type', '')}") - body_preview = resp.text[:800].replace("\n", " ") - print(f"响应体前800字符: {body_preview}") - print() - - -def try_json(resp: requests.Response): + url = SHARE_INFO_URL.format(key=share_key) + r = session.get(url, timeout=15) + print(f"GET {url}") + print(f"状态码: {r.status_code}") try: - return resp.json() + data = r.json() except Exception: - return None + print("响应不是合法JSON => 判定分享已失效或不存在\n") + return False + + process = data.get("process") + if not process: + print("响应中没有 process 字段 => 判定分享已失效或不存在\n") + return False + + is_closed = bool(process.get("is_closed")) + is_expired = bool(process.get("is_expired")) + item = process.get("item") + print(f"is_closed = {is_closed}, is_expired = {is_expired}, item = {item}") + + if is_closed or is_expired: + print("=> 分享已失效或不存在\n") + return False + + print("=> 分享有效\n") + return True + + +def get_download_url(share_key: str, pwd: str, session: requests.Session) -> str: + print("=" * 70) + print("Step 2. 走原有 HTML + files/download 流程取直链") + print("=" * 70) + r = session.get(SHARE_URL_PREFIX.format(key=share_key), timeout=15) + print(f"GET {SHARE_URL_PREFIX.format(key=share_key)} -> {r.status_code}, 最终URL: {r.url}") + + html = r.text + if pwd: + # 加密分享: 提交密码换取跳转后的落地页 (此处仅示意, 具体见 FcTool.java) + m = re.search(r'name="requesttoken"\s+value="([a-zA-Z0-9_+=]+)"', html) + if not m: + raise RuntimeError("未匹配到加密分享的密码输入页面的 requesttoken") + token = m.group(1) + r2 = session.post( + "https://v2.fangcloud.cn/sharing/" + share_key, + data={"requesttoken": token, "password": pwd}, + timeout=15, + ) + html = r2.text + + m = TYPED_ID_RE.search(html) + if not m: + raise RuntimeError("未匹配到文件id(typed_id), 分享可能是文件夹或页面结构有变化") + fid = m.group(1) + print(f"提取到 file_id = {fid}") + + r3 = session.get( + DOWN_REQUEST_URL, + params={"file_id": fid, "scenario": "share", "unique_name": share_key}, + timeout=15, + allow_redirects=False, + ) + print(f"GET {DOWN_REQUEST_URL} -> {r3.status_code}") + if r3.status_code in (301, 302) and r3.headers.get("Location"): + return r3.headers["Location"] + data = r3.json() + if not data.get("success"): + raise RuntimeError(f"取直链失败: {data}") + return data["download_url"] def main() -> None: - check_regex() share_key = extract_share_key(SHARE_URL) + print(f"分享链接: {SHARE_URL}") print(f"提取到的 shareKey: {share_key}\n") session = requests.Session() session.headers.update(HEADERS) - # ---------- Step 1: 复现现有 Java 代码的做法 ---------- - print("=" * 70) - print("Step 1. 复现现有 FcTool.java 的请求方式 (怀疑是失效判断不可信的根因)") - print("=" * 70) - old_api_url = f"https://v2.fangcloud.cn/apps/share_links/info/{share_key}" + if not check_is_valid(share_key, session): + print("结论: 分享无效, 不再继续取直链。") + sys.exit(1) + try: - r = session.get(old_api_url, timeout=15, allow_redirects=True) - dump_response(r, "现有实现: GET /apps/share_links/info/{uname}") - data = try_json(r) - if data is None: - print(" => 响应不是合法 JSON, 现有 Java 代码此时会直接判定'响应非JSON', " - "无法反映分享真实是否有效。\n") - else: - print(f" => JSON 解析成功, is_valid = {data.get('is_valid')}\n") - except requests.RequestException as e: - print(f"请求异常: {e}\n") - - # ---------- Step 2: 真正的匿名分享落地页流程 ---------- - print("=" * 70) - print("Step 2. 模拟浏览器访问分享落地页, 跟随重定向, 换取子域名 + fc_session") - print("=" * 70) - landing_candidates = [ - f"https://v2.fangcloud.com/sharing/{share_key}", - f"https://v2.fangcloud.cn/share/{share_key}", - SHARE_URL, # 用户给的原始 h5 链接本身也试一下 - ] - landed = None - for url in landing_candidates: - try: - r = session.get(url, timeout=15, allow_redirects=True) - dump_response(r, f"落地页尝试: {url}") - if r.status_code == 200 and "fangcloud" in r.url: - landed = r - except requests.RequestException as e: - print(f"请求 {url} 异常: {e}\n") - - if landed is None: - print("三种入口都没有拿到 200 落地页, 请把上面打印的状态码/重定向链贴回来分析。") - return - - final_url = landed.url - fc_session = session.cookies.get("fc_session") - print(f"最终落地 URL: {final_url}") - print(f"拿到的 fc_session cookie: {fc_session}\n") - - lowered = landed.text - if any(kw in lowered for kw in ("分享已失效", "分享不存在", "已过期", "链接失效", "文件已被删除")): - print("落地页 HTML 中直接包含'分享已失效/不存在/已过期'等文案 => 大概率是真失效, " - "现有代码报'分享已失效'反而是巧合对了。") - else: - print("落地页 HTML 未直接包含明显的失效文案, 建议同时用浏览器打开该 URL 人工确认, " - "并用开发者工具 Network 面板抓一下真实的文件列表 / 下载接口全名, " - "核对是否与下面 Step 3 探测的路径一致。") - - # ---------- Step 3: 探测真实的 files 接口是否在该子域名下可用 ---------- - print() - print("=" * 70) - print("Step 3. 探测 apps/files/get_info 接口在该子域名下的连通性 (无真实 file_id, 仅探测)") - print("=" * 70) - base_match = re.match(r"https?://[^/]+", final_url) - base = base_match.group(0) if base_match else None - if base: - probe_url = f"{base}/apps/files/get_info?scenario=share&item_typed_id=file_0" - try: - r = session.get(probe_url, timeout=15) - dump_response(r, "探测: apps/files/get_info") - except requests.RequestException as e: - print(f"请求异常: {e}\n") - - # ---------- Step 4: 如果配置了密码, 尝试提交密码解锁 ---------- - if SHARE_PASSWORD: - print("=" * 70) - print("Step 4. 分享有密码, 尝试提交密码解锁 (走中心域名的 share_links/access, 仅供对比)") - print("=" * 70) - access_url = f"https://v2.fangcloud.cn/apps/share_links/access?unique_name={share_key}" - try: - r = session.post(access_url, json={"password": SHARE_PASSWORD}, timeout=15) - dump_response(r, "POST /apps/share_links/access") - except requests.RequestException as e: - print(f"请求异常: {e}\n") - - print("脚本结束。请把以上完整输出发回来, 用于确定 FcTool.java 的具体修复方式 " - "(大方向通常是: 正则补上 /h5/share/ 路径, 且判断有效性/取文件信息前先访问分享落地页 " - "拿到重定向后的子域名与 fc_session cookie, 再用这个子域名调用 files 接口, " - "而不是直接打 v2.fangcloud.cn/apps/share_links/info)。") + url = get_download_url(share_key, SHARE_PASSWORD, session) + print(f"\n>>> 直链: {url}") + except Exception as e: + print(f"\n取直链失败: {e}") + sys.exit(1) if __name__ == "__main__": From f75d9f687b384f0332e1834fc35fa39eb67897e3 Mon Sep 17 00:00:00 2001 From: qaiu <736226400@qq.com> Date: Sun, 16 Aug 2026 21:18:37 +0800 Subject: [PATCH 7/8] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20README.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 42 ++++++++++++++++++++++-------------------- 1 file changed, 22 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 926e8ee..8af2ccc 100644 --- a/README.md +++ b/README.md @@ -28,25 +28,31 @@ QQ交流群：1017480890 [公益解析，lz0站](https://lz0.qaiu.top) [专业版](https://189.qaiu.top) - ## 快速开始 -命令行下载分享文件： -```shell -curl -LOJ "https://lz.qaiu.top/parser?url=https://share.feijipan.com/s/Tk1F2kGQ&pwd=1234" -``` -或者使用wget: -```shell -wget -O bilibili.mp4 "https://lz.qaiu.top/parser?url=https://share.feijipan.com/s/Tk1F2kGQ&pwd=1234" -``` -或者使用浏览器[直接访问](https://nfd-parser.github.io/nfd-preview/preview.html?src=https%3A%2F%2Flz.qaiu.top%2Fparser%3Furl%3Dhttps%3A%2F%2Fwww.ilanzou.com%2Fs%2FCDx6xKbT&name=bilibili.mp4&ext=mp4): -``` -### 调用演示站下载： -https://lz.qaiu.top/parser?url=https://www.ilanzou.com/s/CDx6xKbT&pwd=1234 -### 调用演示站预览： -https://nfd-parser.github.io/nfd-preview/preview.html?src=https%3A%2F%2Flz.qaiu.top%2Fparser%3Furl%3Dhttps%3A%2F%2Fwww.ilanzou.com%2Fs%2FCDx6xKbT&name=bilibili.mp4&ext=mp4 +以带提取码的分享链接为例（提取码 `1234`），链接中含 `#`、`&`，作为 `url` 参数传入前必须做 URL 编码： + +`https://www.ecpan.cn/web/#/yunpanProxy?path=%2F%23%2Fdrive%2Foutside&data=70017ece572737b12b30709b7f029308eJD0&isShare=1` + +**命令行下载** + +```shell +# curl +curl -LOJ "https://lz.qaiu.top/parser?url=https%3A%2F%2Fwww.ecpan.cn%2Fweb%2F%23%2FyunpanProxy%3Fpath%3D%252F%2523%252Fdrive%252Foutside%26data%3D70017ece572737b12b30709b7f029308eJD0%26isShare%3D1&pwd=1234" + +# wget +wget -O v01 "https://lz.qaiu.top/parser?url=https%3A%2F%2Fwww.ecpan.cn%2Fweb%2F%23%2FyunpanProxy%3Fpath%3D%252F%2523%252Fdrive%252Foutside%26data%3D70017ece572737b12b30709b7f029308eJD0%26isShare%3D1&pwd=1234" ``` +**短链方式**（key 取分享链接的 `data` 参数，提取码用 `@` 拼接） + +| 用途 | 地址 | +| --- | --- | +| 下载 | `https://lz.qaiu.top/ec/70017ece572737b12b30709b7f029308eJD0@1234` | +| 在线预览 | [点击访问](https://nfd-parser.github.io/nfd-preview/preview.html?src=https%3A%2F%2Flz.qaiu.top%2Fec%2F70017ece572737b12b30709b7f029308eJD0%401234&name=v01&ext=1234) | + +> 无提取码时去掉 `&pwd=1234` / `@1234` 即可；预览页 `src` 需编码（`@` → `%40`），用短链可避免二次编码。 + **解析器模块文档：** [parser/README.md](parser/README.md) **JavaScript解析器文档：** [JavaScript解析器开发指南](parser/doc/JAVASCRIPT_PARSER_GUIDE.md) | [自定义解析器扩展指南](parser/doc/CUSTOM_PARSER_GUIDE.md) | [快速开始](parser/doc/CUSTOM_PARSER_QUICKSTART.md) @@ -133,6 +139,7 @@ GET /json/parser?url={分享链接}&pwd={密码} ``` GET /json/{网盘标识}/{分享key}@{密码} ``` +注意： 移动云云空间的 `分享key` 取分享链接中的 `data` 参数值 #### 3. 文件夹解析（v0.1.8fixed3+） @@ -230,11 +237,6 @@ auths: 如果只是临时调用一次，不想改动服务端配置，也可以用上面提到的 `auth` 参数临时传递（`authType` 可选 `password`/`accesstoken`/`authorization`），无需重启服务，仅本次请求生效。 -### 特殊说明 - -- 移动云云空间的 `分享key` 取分享链接中的 `data` 参数值 -- 移动云云空间、小飞机网盘的加密分享可忽略密码参数 - ### 示例 ```bash From b5f7d9694bc2eee653553fc8fed2e21549e3d97b Mon Sep 17 00:00:00 2001 From: qaiu <736226400@qq.com> Date: Sun, 16 Aug 2026 21:20:04 +0800 Subject: [PATCH 8/8] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20README.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 8af2ccc..066605b 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,7 @@ wget -O v01 "https://lz.qaiu.top/parser?url=https%3A%2F%2Fwww.ecpan.cn%2Fweb%2F% | 用途 | 地址 | | --- | --- | | 下载 | `https://lz.qaiu.top/ec/70017ece572737b12b30709b7f029308eJD0@1234` | -| 在线预览 | [点击访问](https://nfd-parser.github.io/nfd-preview/preview.html?src=https%3A%2F%2Flz.qaiu.top%2Fec%2F70017ece572737b12b30709b7f029308eJD0%401234&name=v01&ext=1234) | +| 在线预览 | [点击访问](https://nfd-parser.github.io/nfd-preview/preview.html?src=https%3A%2F%2Flz.qaiu.top%2Fec%2F70017ece572737b12b30709b7f029308eJD0%401234&name=v01&ext=mp4) | > 无提取码时去掉 `&pwd=1234` / `@1234` 即可；预览页 `src` 需编码（`@` → `%40`），用短链可避免二次编码。