# MirrorProxy

> MirrorProxy is a self-hosted, open-source mirror acceleration gateway for GitHub, Docker/OCI, language packages, and Linux/BSD repos with access control and quotas.

- **Category:** Proxy
- **Licence:** MIT
- **Latest version:** v1.7.1
- **Open source:** oss
- **Languages:** Typescript, Rust
- **Platforms:** Docker Compose, Linux, Windows, macOS, Debian, Homebrew
- **Tags:** Proxy, OAuth, Acme, Npm, OIDC, Docker, Go, Rust, Passkey, Prometheus, Caching, Self Hosted, Maven, Pypi, GitHub, Homebrew, Mirror, Apt, Yum, Cargo, Pacman, Winget

## Description

MirrorProxy is a self-hosted mirror acceleration platform that acts as a unified proxy for software sources developers rely on daily. It supports around 30 proxy adapters covering code hosts (GitHub), container registries (Docker Hub, GHCR, Quay, GCR, etc.), language ecosystems (npm, PyPI, Cargo, Go modules, Maven, NuGet, Composer, RubyGems, and many more), developer toolchains (Homebrew, WinGet, Rustup, NVM), and over 30 Linux/BSD operating system repositories. The server fetches and caches content on-demand with bounded disk caching, supports multiple upstreams per source with automatic failover and health checks, and provides a web administration console for managing users, teams, monthly quotas, IP/CIDR access rules, rate limiting, and passkey/WebAuthn authentication. It integrates OAuth/OIDC for single sign-on, exposes Prometheus metrics and optional OTLP tracing, and can automate HTTPS via ACME (HTTP-01/DNS-01) or run behind Caddy/Nginx/Traefik. Deployment options include Docker Compose, standalone Linux binaries (x86_64 and ARM64), and systemd service installation. A cross-platform CLI client (Linux, macOS, Windows) helps configure local package managers to use the proxy. The project is MIT-licensed and written in Rust.

## Links

- [Homepage](https://github.com/inbjo/mirrorproxy)
- [Website](https://sina.dev)
- [Docker](kudang/mirrorproxy)
- [GitHub Repository](https://github.com/inbjo/MirrorProxy)
- [Documentation Wiki](https://github.com/inbjo/MirrorProxy/wiki)
- [Getting Started Guide](https://github.com/inbjo/MirrorProxy/wiki/Getting-Started)
- [Deployment Guide](https://github.com/inbjo/MirrorProxy/wiki/Deployment)
- [Proxy Adapters Documentation](https://github.com/inbjo/MirrorProxy/wiki/Proxy-Adapters)
- [Client Documentation](https://github.com/inbjo/MirrorProxy/wiki/Client)
- [Administration Guide](https://github.com/inbjo/MirrorProxy/wiki/Administration)
- [Docker Hub](https://hub.docker.com/r/kudang/mirrorproxy)
- [Latest Release](https://github.com/inbjo/MirrorProxy/releases/latest)

---
Source: https://selfhost.directory/project/mirrorproxy