vscode-gh-mirror

默认中文说明 | English

一个基于 Cloudflare Workers 的一体化下载服务：

• VSCode 插件下载站：支持搜索 Open VSX 插件、查看详情、下载最新或历史版本 VSIX
• GitHub Release 镜像站：将 GitHub Release 附件链接转换为当前站点的镜像下载链接

本项目可以部署在 Cloudflare Workers 免费版上，但仍会受到 Workers 平台限制影响。

Cloudflare Workers 通常不会对代理下载产生额外的带宽/出站流量费用，但每个进入 Worker 的请求都会计入请求次数限制。免费版中与本项目最相关的限制包括：

• 每天 100,000 次 Worker 请求
• 每个请求 10 ms CPU time
• 每个请求 128 MB 内存
• 每个请求 50 个 subrequests
• 单个可缓存对象最大 512 MB

对于较大的 GitHub Release 附件，尤其是超过 512 MB 的文件，不建议依赖 Cloudflare Cache API/CDN cache。Worker 应尽量使用流式转发，避免将大文件完整读入内存。

• 支持搜索插件关键字或扩展 ID
• 支持结果页 URL 参数保留，例如 ?q=python&sort=downloads
• 支持按下载量、名称、更新时间排序
• 搜索结果显示下载量、评论数、评分
• 插件详情页显示统计信息与历史版本列表
• 支持下载最新版本和历史版本 VSIX

• 输入 GitHub Release 附件地址
• 自动生成当前 Worker 的镜像下载链接
• 支持缓存与断点续传
• 页面内提供 Windows / macOS / Linux 示例入口

• 首页 /
• 插件页 /extensions
• 插件详情页 /extensions/:namespace/:name
• GitHub 加速页 /github
• 健康检查 /health

• /api/extensions/search?q=python
• /api/extensions/:namespace/:name
• /api/extensions/:namespace/:name/:version/download
• /api/github/resolve?url=...

• /:owner/:repo/releases/download/:tag/:file

• github.com
• open-vsx.org
• objects.githubusercontent.com
• release-assets.githubusercontent.com

本项目不是通用开放代理，而是面向特定下载场景的受限镜像服务。

• 搜索结果：短缓存
• 插件详情：中缓存
• 二进制下载：长缓存

响应头：

• X-Worker-Cache: HIT | MISS
• X-Proxy-Source: github | openvsx

npm install -g wrangler
wrangler login
wrangler deploy

默认 wrangler.toml：

name = "vscode-gh-mirror"
main = "worker.js"
compatibility_date = "2024-01-01"

• 轻量、易部署的 VSCode 插件下载站
• 面向 GitHub Release 的镜像下载入口
• 基于 Cloudflare Workers 的统一下载代理层

切换到 English README