🧩 Mira — Docker Control Panel

Neon-themed, fast and modern container management UI.

---

🇺🇿 O‘zbekcha

🚀 Mira haqida

Mira — bu Docker konteynerlari, tarmoqlar, obrazlar, volumelar va shablonlarni boshqarish uchun zamonaviy veb-panel.
Panel React + Vite + Tailwind asosida qurilgan, backend esa FastAPI (Python).

Kuchli tomonlari:

• 🔥 Real vaqtli konteyner monitoringi
• 🌐 Tarmoqlarni yaratish / o‘chirish
• 📦 Obrazlar bilan ishlash
• 🧱 Volume boshqaruvi
• 📝 Shablonlar orqali tez konteyner yaratish
• ✨ Neon / cyberpunk UI

---

📸 Skrinshotlar

🧱 Panel / Konteynerlar

📦 Obrazlar

🌐 Tarmoqlar

📝 Shablonlar

📦 O‘rnatish

1️⃣ Repozitoriyani klonlash

git clone https://github.com/d3ad0x1/MIRAJANE.git
cd mirajane-mira-panel

2️⃣.env faylini yaratish

cp .env.example .env

Keyingi parametrlarni to‘ldiring:

API_URL=http://Sening IP manziling:porting/api/v1

3️⃣ Docker orqali ishga tushirish

docker compose up -d --build

4️⃣ Frontendni ishga tushirish (lokal)

cd frontend
npm install
npm run dev

🛠 Kerakli dasturlar

• Docker + Docker Compose
• Node.js 18+
• Git

🧯 Muammolarni bartaraf qilish

❗ API ishdan chiqdi yoki 500 xatolik

• Backend konteynerini tekshiring:

docker compose logs api -f

❗ Frontend oq ekran

• Frontend logini ko‘ring:

npm run dev

• API_URL noto‘g‘ri bo‘lishi mumkin.

🗂 Loyihaning tuzilishi

• frontend/ — React + Vite asosidagi Mira interfeysi. Dev rejimida 5173-port orqali ishlaydi, prod rejimida esa nginx orqali xizmat qiladi.
• backend/ — Docker boshqaruvi uchun FastAPI API xizmati. Asosiy API-servis, konteyner ichidagi port — 8088.
• mira-data/ — Mira uchun doimiy ma’lumotlar katalogi: shablonlar, presetlar, foydalanuvchi sozlamalari. Ushbu katalogni muntazam backupga qo‘shish tavsiya etiladi.
• assets/ — bannerlar, logotiplar va UI tasvirlari.
• docker-compose.yml — Mira xizmatlarini orkestratsiya qilish fayli.
• README.md, README_RU.md, README_EN.md — loyiha hujjatlari.

🔐 Xavfsizlik

Mira Docker-hostni boshqaradi, demak panelga kirish = serverga to‘liq kirish degani.

Tavsiya etiladi:

• Mirani internetga ochiq holda qo‘ymaslik.
• Foydalanish:
  • VPN (WireGuard / OpenVPN / ZeroTier);
  • ichki tarmoq (LAN);
  • zarurat bo‘lsa SSH tunnel.
• Panelni reverse-proxy orqali ishga tushirish:
  • Nginx / Traefik / Caddy;
  • HTTPS + Basic Auth / tokenlar / SSO.
• /var/run/docker.sock bilan ehtiyotkor bo‘lish: agar u konteynerga ulangan bo‘lsa, panelga kirgan har qanday foydalanuvchi Dockerga to‘liq root darajasida egalik qiladi.

🛣 Roadmap (yo‘l xaritasi)

✅ Joriy holat (v0.1 — Core UI)

• Konteynerlar paneli (start / stop / restart / remove)
• Konteyner holati va asosiy statistikani ko‘rish
• Docker imijlar ro‘yxati, imijlarni o‘chirish
• Tarmoqlarni boshqarish (yaratish / o‘chirish)
• Volumelarni boshqarish
• Shablonlar asosida konteynerlarni yaratish (presets)
• Docker Compose orkestratsiyasi (backend + frontend)
• Neon / cyberpunk uslubidagi Mira UI

---

🔐 v0.2 — Avtorizatsiya va rollar

• Panel ichida avtorizatsiya (login/parol)
• Foydalanuvchi rollari:
  • admin — Mira va Docker bo‘yicha to‘liq huquqlarga ega
  • read-only — faqat ko‘rish rejimi
• Amallarni cheklash (masalan, read-only uchun konteyner/imij o‘chirishni bloklash)
• Avtorizatsiyani nginx/traefik orqali tashqariga chiqarish imkoniyati (Basic Auth / SSO)

---

🧩 v0.3 — Shablonlar va presetlar

• Moslashuvchan shablonlar (docker run / docker compose)
• Tayyor presetlar galereyasi (nginx + php-fpm, db + app va boshqalar)
• Shablonlarni eksport/import qilish (JSON/YAML)
• Shablonlarni mira-data/ katalogiga bog‘lash (qulay backup uchun)

---

📈 v0.4 — Monitoring va qulayliklar (QoL)

• Batafsil konteyner statistikasi (CPU, RAM, disk yuklanishi)
• Konteyner loglari (filtrlash + live-update)
• Qidiruv va filtrlar (konteynerlar / imijlar / tarmoqlar bo‘yicha)
• Yorug‘ / qorong‘i tema (theme switcher)
• UI lokalizatsiyasi (RU / EN / UZ)

---

🚀 v0.5 — Integratsiyalar va prodakshn

• Bir nechta Docker-hostlarni qo‘llab-quvvatlash (multi-node / remote Docker API)
• Mira sozlamalarini UI orqali boshqarish (.env tahririsiz)
• Mira konfiguratsiyasining backup/restore funksiyasi
• Tashqi monitoring tizimlari bilan integratsiya (Prometheus / Loki / Grafana — imkoniyatga qarab)

---

Roadmap yakuniy emas — Mira rivojlanishi jarayonida o‘zgarishi mumkin. Takliflar va g‘oyalarni Issues yoki Pull requests orqali yuborish mumkin.

🔖 Mavzular

📄 License: MIT License