HubProxy

HubProxy is a lightweight, high-performance proxy for accelerating access to Docker images and GitHub files.

  • Infrastructure
  • Network Services
  • Other
  • Productivity
  • Tools & Utilities
HubProxy is a lightweight, high-performance proxy for accelerating access to Docker images and GitHub files. It provides Docker image acceleration, offline image packaging, and online Docker image search across registries such as Docker Hub and GitHub Container Registry, all without a local Docker install, making it useful for self-hosters who want faster, more reliable image pulls and GitHub downloads.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

51/100 Fair

Maintained
73last commit 111 days ago
Popular
703,001 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
07 serious findings, 4 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 21 days ago

GitHub stars
3,001
Open issues
6
Last commit
2026-08-02
Latest release
v1.2.5
License
MIT
Activity
stale

Checked 7 days ago - source: GitHub (sky22333/hubproxy)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set a webhook secret before starting Set the same shared password in GitHub and HubProxy, usually by exporting HUBPROXY_WEBHOOK_SECRET before launch. Without it, GitHub can reject or ignore the automated notifications you expect. source
  • Point it at your app's webhook address Set target-url to the full web address that should receive GitHub webhooks, like the endpoint your service already uses. If this is missing or wrong, HubProxy will run but your project will not get updates. source
  • Start with SQLite and keep the file safe For a first install, use a local SQLite (a small file-based database) file by setting the database option to sqlite:hubproxy.db. Keep or back up that file because it stores the events HubProxy can replay later. source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I deploy and verify HubProxy with Docker?

Use the Docker quick start to run the HubProxy image with host port 5000 mapped to container port 5000. Verify the service with the ready endpoint or the web page.

Is a reverse proxy required for public HubProxy deployment?

A reverse proxy is strongly recommended for public deployment. It provides TLS and correct client IP passing.

Can I restrict which Docker images or GitHub repositories HubProxy can serve?

Yes, you can configure IP allow and deny lists plus image and GitHub repository black and white lists. The repository lists support wildcard patterns.

Does HubProxy support per-client bandwidth limiting?

Yes, it applies token bucket rate limiting by real client IP. IPv6 is grouped by /64, and the limit period and quota are configurable.

Do I need Docker on the HubProxy host to create offline image packages?

No, HubProxy can package single images or batch tar files online without local Docker. It uses streaming downloads with an anti-shake design.

Answers sourced from docs.52013120.xyz, github.com

Community

Collected 48 days ago - public community threads