KCNLanzouDirectLink 是一个用于解析蓝奏云分享链接并获取直链的 C# 原生实现类库。它提供了简单的 API 用于获取蓝奏云分享链接的直链，无需登录或第三方工具。
- ✅ 支持解析蓝奏云普通分享直链 & 加密分享直链
- ✅ 支持解析普通分享 & 加密分享链接的文件信息
- ✅ 支持批量解析
- ✅ 自动处理阿里云盾反爬虫机制
- ✅ 智能过滤垃圾广告下崽器页面（自动重试）
- ✅ 支持所有蓝奏云域名变体
- ✅ 兼容新旧版页面
- ✅ 不使用curl，原生实现所有功能
- ✅ 提供标准错误处理模式
- ✅ 完整的实现 Demo，快速上手
本项目支持以下 .NET 版本：
.NET 6、.NET 7、.NET 8、.NET 9、.NET 10、以及更高版本的 .NET。
你可以通过 NuGet 包管理器安装 KCNLanzouDirectLink 库：
Install-Package KCNLanzouDirectLink或者通过 .NET CLI：
dotnet add package KCNLanzouDirectLink获取普通链接的直链
using KCNLanzouDirectLink;
class Program
{
static async Task Main(string[] args)
{
string shareUrl = "https://syxz.lanzoue.com/qwertyuiopas";
var (state, link) = await KCNLanzouLinkHelper.GetDirectLinkAsync(shareUrl);
if (state == DownloadState.Success)
{
Console.WriteLine($"直链地址: {link}");
}
else
{
Console.WriteLine($"获取直链失败，状态: {state}");
}
}
}获取加密链接的直链
using KCNLanzouDirectLink;
class Program
{
static async Task Main(string[] args)
{
string shareUrl = "https://syxz.lanzoue.com/qwertyuiopas";
string key = "your_encryption_key";
// 3 代表错误后重试次数。加密链接获取直链可能不稳定，推荐设置为3次。
var (state, linkEncryption) = await KCNLanzouLinkHelper.GetDirectLinkAsync(shareUrl, key, 3);
if (state == DownloadState.Success)
{
Console.WriteLine($"直链地址: {linkEncryption}");
}
else
{
Console.WriteLine($"获取直链失败，状态: {state}");
}
}
}批量获取分享链接直链(支持普通/加密链接混合获取)
using KCNLanzouDirectLink;
class Program
{
static async Task Main(string[] args)
{
var urls = new List<Tuple<string, string>>
{
Tuple.Create("https://syxz.lanzoue.com/qwertyuiopas", string.Empty),
Tuple.Create("https://syxz.lanzouw.com/abcdefghijkl", "your_encryption_key")
};
// 该方法泛型传参允许实现 string 及 Tuple<string, string>。
var results = await KCNLanzouLinkHelper.GetDirectLinksAsync(urls);
foreach (var (url, state, link) in results)
{
if (state == DownloadState.Success)
{
Console.WriteLine($"{url} 解析直链地址: {link}");
}
else
{
Console.WriteLine($"{url} 获取直链失败，状态: {state}");
}
}
}
}获取链接的文件信息
using KCNLanzouDirectLink;
class Program
{
static async Task Main(string[] args)
{
string shareUrl = "https://syxz.lanzoue.com/qwertyuiopas";
string key = "your_encryption_key";
// true表示强制指定分享链接为加密链接类型。具体信息请查看方法重载。
var (state, fileInfo) = await KCNLanzouLinkHelper.GetFileInfoAsync(true, shareUrl, key);
if (state == DownloadState.Success)
{
string message = $"文件信息解析成功：\n" +
$"File info retrieved successfully:\n" +
$"文件名称\\File Name: {fileInfo.FileName}\n" +
$"文件大小\\File Size: {fileInfo.Size}\n" +
$"上传时间\\Upload Time: {fileInfo.UploadTime}\n" +
$"上传者\\Uploader: {fileInfo.Uploader}\n" +
$"运行平台\\Platform: {fileInfo.Platform}\n" +
$"文件描述\\Description: {fileInfo.Description}";
Console.WriteLine($"直链地址: {message}");
}
else
{
Console.WriteLine($"获取文件信息失败，状态: {state}");
}
}
}本库自动处理蓝奏云的反爬虫机制，包括：
- Cookie验证：自动计算并添加
acw_sc__v2Cookie - 阿里云盾绕过：自动处理
arg1参数并进行XOR运算 - 智能重试：检测到反爬虫响应时自动重试
无需手动处理，完全自动化。
自动识别并跳过蓝奏云的下崽器推广页面：
- 自动检测广告Html页特征
- 智能重试获取真实下载页面
- 用户无感知，透明处理
public enum DownloadState
{
/// <summary>
/// 操作成功完成。
/// </summary>
Success,
/// <summary>
/// 未提供有效的分享链接。
/// </summary>
UrlNotProvided,
/// <summary>
/// 无法获取网页内容。分享链接无效？
/// </summary>
HtmlContentNotFound,
/// <summary>
/// 无法解析加密信息。分享链接无效或密钥错误？
/// </summary>
PostsignNotFound,
/// <summary>
/// 无法解析中间链接。
/// </summary>
IntermediateUrlNotFound,
/// <summary>
/// 无法获取最终的直链地址。
/// </summary>
FinalUrlNotFound,
/// <summary>
/// 未知错误，操作未成功完成。
/// </summary>
Error
} public class LanzouFileInfo
{
/// <summary>
/// 文件名称
/// </summary>
public string? FileName { get; set; }
/// <summary>
/// 上传时间
/// </summary>
public string? UploadTime { get; set; }
/// <summary>
/// 文件大小
/// </summary>
public string? Size { get; set; }
/// <summary>
/// 上传者
/// </summary>
public string? Uploader { get; set; }
/// <summary>
/// 运行平台
/// </summary>
public string? Platform { get; set; }
/// <summary>
/// 文件描述
/// </summary>
public string? Description { get; set; }
}请前往Github存储库查看类库Demo：https://github.com/JDDKCN/KCNLanzouDirectLink
该项目使用 A-GPLv3 许可协议。
欢迎提出问题、改进建议或直接提交 Pull Request！