使用指南

本服务允许您通过 Cloudflare Pages 代理下载文件，适用于需要隐藏原始下载地址、避免跨域问题或需要额外安全控制的场景。

核心功能

  • 隐藏真实文件下载地址
  • 支持大文件分片下载
  • 自动处理下载文件名
  • 跨域资源共享支持
  • 基础安全验证（可选）

快速开始

API 地址：

/api/download?url=您的文件URL

API 使用说明

基本用法

GET /api/download?url={encoded_file_url}

参数说明

必需参数：

url - 要下载的文件URL（需要URL编码）

使用示例

// JavaScript 示例 async function downloadViaProxy() { const fileUrl = encodeURIComponent('https://example.com/sample.pdf'); const proxyUrl = `/api/download?url=${fileUrl}`; // 方法1: 直接打开 window.open(proxyUrl, '_blank'); // 方法2: 通过 fetch const response = await fetch(proxyUrl); const blob = await response.blob(); const url = window.URL.createObjectURL(blob); const a = document.createElement('a'); a.href = url; a.download = 'downloaded-file.pdf'; a.click(); }

返回格式

HTTP/1.1 200 OK Content-Type: application/octet-stream Content-Disposition: attachment; filename="original_filename.ext" Content-Length: {file_size}

错误代码

400 - 缺少必要的URL参数

403 - 文件大小超过限制（默认100MB）

404 - 源文件不存在

500 - 服务器内部错误