Skip to main content
MirrorBox Logo

MirrorBox v2 🚀

Enterprise Docker Gateway & Anti-Sanction Toolkit

Bypass 403 Errors | Smart Caching | High-Speed Mirrors

Python Docker License Status


📖 Introduction

MirrorBox is not just a proxy; it's a Smart Wrapper around Docker designed specifically for restricted environments.

It intelligently intercepts your Docker commands, routing traffic through the fastest available high-speed mirrors to bypass sanctions (403 Forbidden). With MirrorBox v2, you get a modern GUI, real-time telemetry, and an advanced Offline Cache System that ensures you never have to download the same image twice.

Stop fighting with VPNs and DNS settings. Let MirrorBox handle the traffic while you focus on coding.


✨ Key Features

📦 Intelligent Local Caching (Offline Mode)

MirrorBox automatically saves every pulled image as a portable archive on your disk.

  • Save Bandwidth: Internet cut off? No problem. MirrorBox loads the image from your local cache instantly.
  • Portable: Easily transfer your cached images between machines.
  • Zero Latency: Loading from disk is faster than any gigabit internet connection.

🚀 Smart Proxy Engine

Simply replace docker with mirrorbox in your terminal. The engine automatically:

  1. Checks available mirrors (ArvanCloud, Focker).
  2. Selects the fastest one based on real-time ping.
  3. Injects the mirror URL seamlessly while preserving all your original flags (-d, -p, -v).

🛡️ System-Wide Configuration

For servers and CI/CD pipelines, MirrorBox can configure your Docker Daemon directly, applying Registry Mirrors

📊 Modern GUI Dashboard

A beautiful, glassmorphism-based interface to manage your images, monitor network health, and visualize your cache.

MirrorBox Dashboard

📦 Installation & Quick Start

MirrorBox requires Python 3.10+. It is strongly recommended to install it inside a virtual environment to avoid conflicts with system packages.

1️⃣ Create a Virtual Environment

python3 -m venv venv

2️⃣ Activate the Environment

# Linux / macOS
source venv/bin/activate 

# Windows
venv\Scripts\activate.bat 

3️⃣ Install MirrorBox

pip install --upgrade mirrorbox

🖥️ Graphical Interface

For a visual experience, launch the modern desktop dashboard:

mirrorbox open

This will launch the MirrorBox Control Center, where you can:

  • Monitor Real-Time Network Latency.
  • Search for images across all mirrors.
  • Manage your Local Cache files.
  • Run Docker Compose projects with one click.

🛠️ CLI Reference (The Power of Terminal)

MirrorBox CLI is a hybrid tool. It has its own management commands, but it also acts as a full proxy for Docker.

1. MirrorBox Management Commands

Command Description
mirrorbox open Launches the GUI Dashboard.
mirrorbox search <name> Searches for an image across all available mirrors to find the best source.
mirrorbox setup (Root/Admin) Configures /etc/docker/daemon.json with Mirrors & DNS. Recommended for Servers.
mirrorbox unsetup Restores the original Docker configuration.
mirrorbox compose <cmd> A wrapper for docker-compose. Example: mirrorbox compose up -d.
mirrorbox help Shows the beautiful interactive documentation.

2. Docker Proxy Commands (Smart Passthrough)

You can use ANY standard Docker command with MirrorBox. It will intelligently handle image pulls and pass everything else to the Docker Daemon.

⬇️ Pulling Images (Accelerated)

# Automatically finds the fastest mirror
mirrorbox pull nginx:latest
mirrorbox pull ubuntu:22.04

🏃 Running Containers

MirrorBox intercepts the image name, redirects it to a mirror, but keeps ALL your flags intact.

# Standard usage
mirrorbox run -d -p 8080:80 nginx

# Complex usage with Volumes and Env Vars
mirrorbox run -it --rm -v $(pwd):/app -e DEBUG=true python:3.9-alpine sh

📋 Managing Containers (Passthrough)

These commands work exactly like standard Docker:

# List containers
mirrorbox ps -a

# View logs
mirrorbox logs -f my-container

# Stop/Remove
mirrorbox stop my-container
mirrorbox rm my-container

# System Prune
mirrorbox system prune -f

❤️ Support the Development

Building enterprise-grade tools requires coffee and dedication. If MirrorBox saved your time, consider supporting the project:

💎 Donate & Support

Powered by Testeto | Developed by Pouya Rezapour

Metadata

Release files for mirrorbox 2.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mirrorbox 2.0.1
File Size Uploaded Provenance Actions
mirrorbox-2.0.1.tar.gz 493.1 kB Without provenance Details for mirrorbox-2.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mirrorbox 2.0.1
File Interpreter ABI Platform Actions
mirrorbox-2.0.1-py3-none-any.whl Python 3 none any Details for mirrorbox-2.0.1-py3-none-any.whl

Total release size: 985.4 kB

Release files / mirrorbox-2.0.1.tar.gz

Download URL mirrorbox-2.0.1.tar.gz
Size 493.1 kB
Tags Source
SHA-256 checksum
How to use checksums
f7ce3c276071aeb39d8e4073a2979995002b7bc01e59a71efc1531961d4185e8
BLAKE2b-256 checksum
How to use checksums
7f155c231d1acc37ef33f8b7d4c1ee8dbc7c1fa5b7abaefe9c3c309d7be54f2a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Release files / mirrorbox-2.0.1-py3-none-any.whl

Download URL mirrorbox-2.0.1-py3-none-any.whl
Size 492.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ef367a1c40270d527653f7784617258a4e6f47f2e867b439c96979a6d98a4091
BLAKE2b-256 checksum
How to use checksums
85299054bca6019778fbf58c74336594a69adeee9becc541c5938e6032e167f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Security for mirrorbox 2.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page