使用阿里云 ESA 边缘函数转发代理 docker registry

破坏的艺术2025-07-24 16:50

ESA Docker Registry Proxy

这是一个基于 Alibaba ESA (Edge Security Acceleration) 的 Docker Registry 转发代理，为中国大陆用户提供更快的 Docker 镜像下载服务，并实现镜像白名单功能以增强安全性。

开源地址: https://github.com/jqknono/esa-registry-proxy

功能特性

Docker Registry 代理: 转发 Docker Hub 请求，提升中国大陆用户下载速度
镜像白名单: 限制只能下载指定的镜像，提高安全性
支持多种匹配模式: 支持精确匹配和前缀匹配
智能缓存机制: 优先使用缓存数据，减少重复请求，提高响应速度

快速开始

前提条件

Node.js 16+
npm 或 yarn
Alibaba ESA 账号及 AccessKey ID 和 Secret

安装部署

克隆项目:

bash 复制代码

git clone https://github.com/jqknono/esa-registry-proxy

部署到 Alibaba ESA

方法一：使用 ESA CLI (推荐)

安装 ESA CLI:
bash 复制代码
```
npm install esa-cli -g
```
登录 ESA:
bash 复制代码
```
esa login
```
初始化项目:
bash 复制代码
```
esa init
```
提交代码:
bash 复制代码
```
esa commit
```
部署函数:
bash 复制代码
```
esa deploy
```
绑定域名:
bash 复制代码
```
esa domain add registry.jqknono.com
```

方法二：手动部署

请参考 <DEPLOYMENT.md> 文件获取详细的手动部署说明。

白名单功能详解

白名单功能是本项目的核心安全特性，可以限制允许通过代理拉取的 Docker 镜像，防止恶意使用。

白名单配置格式

白名单配置为逗号分隔的字符串，每个字符串代表一个允许下载的镜像名称模式:

env 复制代码

WHITELIST=library/nginx,library/redis,library/*

支持的匹配模式

精确匹配 : 如 library/nginx，只允许下载完全匹配的镜像
前缀匹配 : 如 library/*，允许下载所有 library 组织的镜像

配置示例

env 复制代码

# 只允许官方nginx和redis镜像
WHITELIST=library/nginx,library/redis

# 允许所有官方镜像
WHITELIST=library/*

# 允许特定组织的所有镜像
WHITELIST=jqknono/*

使用方式

直接使用

bash 复制代码

docker pull registry.jqknono.com/library/nginx

配置 Docker 客户端

在 Docker 配置中添加镜像仓库:

json 复制代码

{
  "registry-mirrors": ["https://registry.jqknono.com"]
}

技术实现

利用 Alibaba ESA 的边缘网络加速镜像拉取
支持 Docker Registry v2 API
实现镜像白名单安全控制
利用 ESA Cache API 实现智能缓存，优先使用缓存数据，缓存时间为服务允许的最大值（一年）

注意事项

此项目主要用于个人开发环境或小型团队使用
大规模生产环境建议使用专业的镜像仓库服务
请确保您的 Alibaba ESA 账户有足够的配额

参考

上一篇：深度图像滤波

下一篇：React 批判 2 则

热门推荐

012025 年高教社杯全国大学生数学建模竞赛C 题 NIPT 的时点选择与胎儿的异常判定完整成品思路模型代码分享，全网首发高质量！！！022025年数学建模国赛C题超详细解题思路 032025全国大学生数学建模C题保姆级思路模型（持续更新）：NIPT 的时点选择与胎儿的异常判定 04UV安装并设置国内源 052025高教社杯国赛数学建模选题建议+初步分析 06奈飞工厂官网，国内Netflix影视在线看|中文网页电脑版入口 072025国赛B题保姆级教程思路分析碳化硅外延层厚度的确定 08KGG转MP3工具|非KGM文件|解密音频 09（E题｜AI 辅助智能体测）2025年高教杯全国大学生数学建模国赛解题思路|完整代码论文集合 10Qwen3-Coder 快速上手教程 | Qwen Code + Claude Code