引言

在日常工作和学习中，我们经常需要从各种网盘（如蓝奏云、奶牛快传、123云盘等）下载文件。然而，许多网盘要求登录客户端或开通VIP才能获取直链下载地址，这对于临时下载来说非常不便。netdisk-fast-download 是一个开源的网盘直链解析工具，能够将多种网盘的分享链接转化为直链，极大简化下载流程。本文将深入介绍该工具的实用性、功能特性、安装步骤以及使用方法，帮助用户快速上手并高效利用这一工具。

免费下载：https://download.csdn.net/download/lzy_leogeo/91956900

项目链接：https://github.com/qaiu/netdisk-fast-download

项目概述

功能与实用性

netdisk-fast-download 是一个功能强大的网盘直链解析服务，支持多种主流网盘，包括但不限于：

  • 蓝奏云（lz）及其优享版（iz）
  • 奶牛快传（cow）
  • 移动云云空间（ec）
  • 小飞机网盘（fj）
  • 亿方云（fc）
  • 123云盘（ye）
  • 文叔叔（ws）
  • 联想乐云（le）
  • QQ邮箱文件中转站（qq）
  • Cloudreve 自建网盘（ce）等

该工具不仅支持普通分享链接的解析，还能处理加密分享链接以及部分网盘的文件夹分享解析。它的核心优势在于：

  1. 快速下载：通过直链下载，绕过网盘客户端或VIP限制，节省时间。
  2. 多平台支持：支持多种网盘，覆盖大部分常用云存储服务。
  3. 灵活的API接口：提供通用接口和短地址接口，方便开发者集成或用户直接使用。
  4. 缓存机制：内置59分钟缓存机制，优化解析速度，减少对网盘服务器的重复请求。
  5. 开源免费：基于MIT许可证，完全开源，适合个人学习和部署。

适用场景

  • 个人用户：需要快速下载网盘分享文件但不想安装客户端。
  • 开发者：希望集成网盘直链解析功能到自己的应用或服务。
  • 企业用户：需要批量处理网盘分享链接以提高文件分发效率。

技术栈

  • 编程语言：Java 17
  • 框架：Vert.x 4.5.6（事件驱动的高性能框架）
  • 构建工具：Maven
  • 数据库支持：H2DB、MySQL、PostgreSQL（0.1.8版本新增）
  • 其他：支持Docker部署，内置反向代理服务器（默认端口6401）

安装教程

以下是 netdisk-fast-download 的详细安装步骤，适用于 Linux 和 Windows 系统。安装过程简单，但需要确保环境配置正确。

准备工作

  1. 安装 JDK 17：
    • 从 Oracle 或 OpenJDK 下载并安装 JDK 17。
    • 配置环境变量，确保 java -version 命令返回版本为 17.x。
  2. 安装 Maven：
    • 从 Maven 官网 下载并安装 Maven。
    • 配置环境变量，确保 mvn -version 命令正常运行。
  3. 安装 Git：
  4. （可选）安装 Docker：
    • 如果计划使用 Docker 部署，需安装 Docker（参考 Docker 官网）。

详细安装步骤

步骤 1：克隆项目代码

使用 Git 克隆 netdisk-fast-download 仓库到本地：

git clone https://github.com/qaiu/netdisk-fast-download.git
cd netdisk-fast-download
步骤 2：构建项目

使用 Maven 构建项目，生成可执行文件：

mvn clean package

构建完成后，可执行文件位于 web-service/target/netdisk-fast-download-bin.zip。

步骤 3：解压并配置

解压生成的压缩包到指定目录：

unzip web-service/target/netdisk-fast-download-bin.zip -d netdisk-fast-download
cd netdisk-fast-download
步骤 4：启动服务

  • Linux 系统：
    运行以下命令安装并启动服务：

    bash service-install.sh
systemctl start netdisk-fast-download.service

    如果遇到 CRLF 换行问题（常见于从 Windows 克隆的代码），可先转换脚本格式：

    sed -i 's/\r$//' service-install.sh

  • Windows 系统：
    以管理员权限运行以下命令安装服务：

    nfd-service-install.bat

    或者直接运行 run.bat 启动服务。

步骤 5：验证服务

服务默认运行在 http://localhost:6400。通过浏览器访问以下地址验证服务是否正常运行：

http://your_host:6400

如果返回正常响应，说明服务已成功启动。

注意事项
  • JDK 版本：确保环境变量中的 Java 版本为 JDK 17。如果使用其他版本，需修改 nfd-service-template.xml 中的 Java 命令路径。
  • IP 限制：部分网盘（如小飞机网盘）对解析请求有 IP 限制，建议配置代理或在本地部署以避免限制。
  • 公共解析警告：频繁解析可能导致 IP 被网盘厂商限制，不建议将服务用于公共解析。建议本地或私有云部署。

Docker 部署（可选）

如果希望通过 Docker 部署，可以拉取官方镜像：

docker pull ghcr.io/qaiu/netdisk-fast-download:main

启动容器：

docker run -d -p 6400:6400 ghcr.io/qaiu/netdisk-fast-download:main

访问 http://your_host:6400 验证服务。

使用方法

命令行下载

使用 curl 或 wget 下载网盘分享文件。例如，解析小飞机网盘的加密分享链接：

curl -LOJ "https://lz.qaiu.top/parser?url=https://share.feijipan.com/s/nQOaNRPW&pwd=1234"

或使用 wget：

wget -O bilibili.mp4 "https://lz.qaiu.top/parser?url=https://share.feijipan.com/s/nQOaNRPW&pwd=1234"

浏览器下载

直接在浏览器访问解析接口：

https://lz.qaiu.top/parser?url=https://share.feijipan.com/s/nQOaNRPW&pwd=1234

浏览器将自动跳转到直链并开始下载。

预览文件

支持部分文件的在线预览，例如视频文件：

https://nfd-parser.github.io/nfd-preview/preview.html?src=https%3A%2F%2Flz.qaiu.top%2Fparser%3Furl%3Dhttps%3A%2F%2Fshare.feijipan.com%2Fs%2FnQOaNRPW&name=bilibili.mp4&ext=mp4

API 接口

netdisk-fast-download 提供两种接口形式：

  1. 通用接口：/parser?url=分享链接&pwd=密码
    • 示例：http://your_host:6400/parser?url=https://lanzoux.com/ia2cntg
  2. 标志短链：/d/网盘标识/分享key@密码
    • 示例：http://your_host:6400/d/lz/ia2cntg

获取 JSON 格式直链：

  • 通用接口：http://your_host:6400/json/parser?url=分享链接&pwd=密码
  • 标志短链：http://your_host:6400/json/lz/ia2cntg

JSON 返回示例：

{
  "code": 200,
  "msg": "success",
  "success": true,
  "count": 0,
  "data": {
    "shareKey": "lz:xxx",
    "directLink": "下载直链",
    "cacheHit": true,
    "expires": "2024-09-18 01:48:02",
    "expiration": 1726638482825
  },
  "timestamp": 1726637151902
}

注意事项

  • 密码参数：加密分享链接需提供 pwd 参数，部分网盘（如移动云空间、小飞机网盘）可忽略密码。
  • URL 编码：建议对分享链接进行 URL 编码，特别是包含特殊字符（如 #）的链接。
  • 防盗链：奶牛快传等网盘需要添加 Referer: https://cowtransfer.com/ 请求头。

进阶功能与优化

缓存机制

项目自 0.1.8 版本起引入缓存机制，默认缓存时间为 59 分钟。这种设计平衡了链接有效性和缓存效率，避免因缓存过长导致链接失效。开发者可根据需要调整缓存时间。

数据库支持

支持 H2DB、MySQL 和 PostgreSQL，适合需要持久化存储解析记录的场景。配置方法参考官方文档。

反向代理

内置反向代理服务器（默认端口 6401），支持 HTTPS 和 Web 页面展示。推荐使用 Nginx 代理以提高性能：

location / {
  proxy_pass http://127.0.0.1:6401;
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

文件夹解析

自 0.1.9 版本起支持文件夹解析，适合批量下载网盘文件夹内容。访问演示站查看目录列表：

https://lz.qaiu.top/parser?url=文件夹分享链接

局限性与注意事项

  1. IP 限制：小飞机网盘等服务对大陆 IP 有严格限制，建议配置代理。
  2. 部分网盘限制：
    • 123云盘大文件（>100MB）解析需登录。
    • UC网盘解析已失效，需登录验证。
  3. 非商业用途：项目仅限学习和个人使用，禁止用于商业用途。

结论

netdisk-fast-download 是一个功能强大、易于部署的网盘直链解析工具，适合需要快速下载网盘文件的用户和开发者。通过简单的安装步骤和灵活的 API 接口，用户可以轻松实现直链下载、文件预览以及批量文件夹解析。无论是个人使用还是集成到其他项目，这款工具都展现了极高的实用性。建议用户在本地或私有云部署以避免 IP 限制，并关注官方更新以获取最新功能和修复。

项目地址：https://github.com/qaiu/netdisk-fast-download
预览地址：https://lz.qaiu.top

# 开源
Logo
腾讯云开发者社区

腾讯云面向开发者汇聚海量精品云计算使用和开发经验，营造开放的云计算技术生态圈。

更多推荐

终极指南：Flink SQL连接器版本管理从混乱到有序的升级之路

Apache Flink作为流处理领域的佼佼者，其SQL连接器的版本管理一直是开发者面临的核心挑战。本文将系统讲解Flink SQL连接器版本管理的最佳实践，帮助你轻松应对版本兼容性问题，实现从混乱到有序的升级之旅。## 连接器版本管理的常见痛点 😫在Flink应用开发中，连接器版本管理常常让开发者头疼不已。不同版本的连接器可能导致各种兼容性问题，例如API变更、功能差异甚至运行时错误。

avatar 腾讯云开发者社区

Elasticsearch复杂数据类型终极指南：从入门到精通

Elasticsearch作为功能强大的搜索引擎，支持多种复杂数据类型，让开发者能够灵活处理各种结构化和非结构化数据。本文将带你全面了解Elasticsearch中的复杂数据类型，从基础概念到实际应用，助你轻松掌握数据建模的核心技巧。## 内部对象：构建层级化数据结构在Elasticsearch中，对象类型（Object）是最基础的复杂数据类型之一，用于表示具有嵌套关系的数据。例如，我们可

avatar 腾讯云开发者社区

如何快速搭建Neon无服务器PostgreSQL：面向初学者的完整指南

Neon是一款革命性的无服务器PostgreSQL解决方案，它通过分离存储和计算层，实现了自动扩缩容、类代码式数据库分支以及零级扩展能力。本指南将帮助你从零开始搭建Neon开发环境，体验这款创新数据库的强大功能。## 准备工作：环境要求与依赖项在开始搭建Neon环境前，请确保你的系统满足以下要求：- Linux操作系统（推荐Ubuntu 20.04+或Debian 11+）- Git

avatar 腾讯云开发者社区