Skip to content

v0.1.0 — First release

Choose a tag to compare

View all tags
@AlexWuYh AlexWuYh released this 26 Oct 07:52
· 7 commits to main since this release
v0.1.0
2028488

🎉 easy-docker-proxy v0.1.0 · 首个正式版 / First release

轻量的多上游 Docker Registry 只读加速代理：一个域名、客户端镜像名不改写、零镜像缓存。
A lightweight, read-only multi-upstream Docker Registry pull-through proxy: one domain, unchanged image names, zero layer cache.

✨ 亮点 / Highlights

  • 单域名混合接入 / Single-domain access — Docker Hub 通过 registry-mirrors 直接加速；其他仓库用路径前缀，如 reg.example.com/ghcr.io/owner/app:tag（无需 DNS 劫持）。
  • 流式转发，零缓存 / Streaming, no cache — 不落盘镜像层，不挂载 docker.sock。
  • 多上游与鉴权 / Multi-upstream auth — 上游支持 token / anonymous / basic；Token 换发带 realm 白名单；upstream_allowlist 校验上游主机。
  • 可选客户端认证 / Optional pull auth — off / optional / required，使用独立的拉取账号。
  • 拉取记录与 Stats / Pull records & Stats — 异步写入 SQLite（事件 + 日聚合），Web 控制台含仪表盘、上游分析、镜像与事件列表；viewer 只读，admin 管理账号。
  • 运维友好 / Ops-ready — ACL、限流、trusted_proxies、可选 /metrics（需鉴权）、/-/reload 热重载（仅 admin）。
  • 安全默认 / Secure by default — 密钥仅走环境变量；管理 API 仅接受 Bearer / X-Admin-Token，禁止 ?token=；数据面重定向防 SSRF。

🔒 本版硬化 / Hardening in this release

  • 出站重定向防 SSRF，热重载后旧请求不污染新配置缓存
  • 拉取记录写失败可观测；展示 pull_user；最后一个管理员的并发保护
  • Stats 界面：移动端适配、ARIA、分页，以及加载 / 错误 / 竞态状态处理
  • 可执行的 TLS / 可信代理 / 备份说明，文档拆分为安装、配置、排障

🚀 快速开始 / Quick start

git clone https://github.com/AlexWuYh/easy-docker-proxy.git
cd easy-docker-proxy
cp .env.example .env                       # 填入 PROXY_ADMIN_TOKEN / PROXY_WEB_PASSWORD
cp configs/config.docker.yaml configs/config.yaml   # 把 hosts 改成你的真实域名
docker compose --env-file .env -f deploy/docker-compose.yaml up -d --build

或下载下方的 源码包 easy-docker-proxy-v0.1.0-source.zip（附 .sha256 校验文件）解压后按相同步骤操作。
Or download the source package below (with a .sha256 checksum) and follow the same steps.

📚 文档 / Docs

文档 说明
README 简介与速查 / Overview
docs/install.md 安装与配置详解
docs/configuration.md 配置参考
docs/troubleshooting.md 故障排查
deploy/README.md 部署架构、安全清单、备份

⚠️ 已知限制 / Notes

  • 仅支持只读拉取，不支持 push；Stats 控制台不提供在线修改配置。
  • Webhook / PostgreSQL 等增强功能尚未提供（规划中）。

Full Changelog: https://github.com/AlexWuYh/easy-docker-proxy/commits/v0.1.0

Assets 4
Loading