MirrorBox v2 🚀
Enterprise Docker Gateway & Anti-Sanction Toolkit
Bypass 403 Errors | Smart Caching | High-Speed Mirrors
📖 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:
- Checks available mirrors (ArvanCloud, Focker).
- Selects the fastest one based on real-time ping.
- 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.
📦 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
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.