Skip to content

Releases: AlexWuYh/easy-docker-proxy

Release list

v0.2.1 — Console entry redirects

v0.2.1 — Console entry redirects Latest
Latest

Choose a tag to compare

View all tags
@AlexWuYh AlexWuYh released this 27 Oct 10:40
v0.2.1
2dd4c54

🧭 easy-docker-proxy v0.2.1 · 控制台入口跳转修复 / Console entry redirects

修复管理面反代到域名后，直接访问根路径只看到 unauthorized 的问题：浏览器入口现在会自动跳转到登录页。
Fixes the bare unauthorized response when the admin plane is served behind a reverse proxy: browser entry points now redirect to the login page.

🛠️ 修正 / Fixes

  • 管理面 /、/login、/index.html 等非 API 的浏览器访问自动跳转到 /stats/login.html，无需手输完整路径
  • /stats/ 下不存在的页面（如 /stats/index）跳转到控制台首页，未登录时继续转到登录页；缺失的静态资源仍返回 404
  • /api/、/metrics、/-/ 行为不变，未登录仍返回 401，供脚本与监控使用
  • 文档补充反代暴露管理面后的访问地址与访问限制建议（IP 白名单 / VPN）

🚀 快速开始 / Quick start

git clone https://github.com/AlexWuYh/easy-docker-proxy.git
cd easy-docker-proxy
cp .env.example .env                       # 填入 PROXY_DOMAIN / PROXY_ADMIN_TOKEN / PROXY_WEB_PASSWORD
cp configs/config.docker.yaml configs/config.yaml
docker compose --env-file .env -f deploy/docker-compose.yaml up -d   # 拉取 GHCR 镜像

或下载下方的 源码包 easy-docker-proxy-v0.2.1-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

  • 升级：docker compose --env-file .env -f deploy/docker-compose.yaml pull && docker compose --env-file .env -f deploy/docker-compose.yaml up -d。
  • 管理面本身只有应用内登录保护，经反代公开时请在反代层增加 IP 白名单或 VPN。

Full Changelog: v0.2.0...v0.2.1

Assets 4
Loading

v0.2.0 — GHCR image & deploy fixes

v0.2.0 — GHCR image & deploy fixes

Choose a tag to compare

View all tags
@AlexWuYh AlexWuYh released this 27 Oct 08:36
v0.2.0
ea3e054

🐳 easy-docker-proxy v0.2.0 · GHCR 镜像与部署修正 / GHCR image & deploy fixes

本版起，Release 流水线会自动构建多架构镜像并推送到 GHCR，部署可直接拉取，无需本地构建。
Starting with this release, CI builds a multi-arch image and pushes it to GHCR, so you can deploy without building locally.

✨ 亮点 / Highlights

  • GHCR 镜像 / GHCR image — ghcr.io/alexwuyh/easy-docker-proxy，linux/amd64 + linux/arm64，标签为 latest 与版本号；compose 默认拉取 latest，可用 PROXY_IMAGE 固定版本，加 --build 仍可本地源码构建。
  • 域名与端口走环境变量 / Domain & port via .env — PROXY_DOMAIN 同时驱动 config.yaml 的 hosts 与自带 Caddy 站点名；PROXY_PORT 控制宿主机数据面端口（默认 5000，macOS 被 AirPlay 占用时可改 15000）。无需再手改 YAML / Caddyfile。

🛠️ 修正 / Fixes

  • 部署文档：修正 docker login 续行错误；.env 不支持 $(...)，改用 sed 生成随机密钥并补全 PROXY_WEB_PASSWORD；纠正过时的 hosts 说明
  • 自带 Caddy（--profile edge）补充域名配置提示；热重载新增无需映射 5001 的容器内写法
  • 明确 default: dockerhub 在公网需配合 ACL / pull_auth，避免成为开放加速器
  • Dockerfile 改为交叉编译（不再在 QEMU 中跑 Go）；新增 .dockerignore，构建上下文不再带入 .env 与 config.yaml

🚀 快速开始 / Quick start

git clone https://github.com/AlexWuYh/easy-docker-proxy.git
cd easy-docker-proxy
cp .env.example .env                       # 填入 PROXY_DOMAIN / PROXY_ADMIN_TOKEN / PROXY_WEB_PASSWORD
cp configs/config.docker.yaml configs/config.yaml
docker compose --env-file .env -f deploy/docker-compose.yaml up -d   # 拉取 GHCR 镜像

或下载下方的 源码包 easy-docker-proxy-v0.2.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

  • 首次推送后，请在 GitHub Packages 设置里将镜像包改为 Public，否则匿名拉取会返回 401。
  • 镜像仅在发布 Release 时构建；仍仅支持只读拉取，Stats 控制台不提供在线改配置。

Full Changelog: v0.1.0...v0.2.0

Loading

v0.1.0 — First release

v0.1.0 — First release

Choose a tag to compare

View all tags
@AlexWuYh AlexWuYh released this 26 Oct 07:52
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

Loading