mirror of
https://github.com/mivodev/mivodev.github.io.git
synced 2026-01-26 13:32:07 +07:00
Fix dependencies: Add flag-icons, tailwind directives, and postcss config
This commit is contained in:
MivoDev
104
docs/id/guide/docker-aapanel.md
Normal file
104
docs/id/guide/docker-aapanel.md
Normal file
@@ -0,0 +1,104 @@
|
||||
# Deploy di aaPanel (Docker)
|
||||
|
||||
aaPanel adalah salah satu panel hosting paling populer yang memiliki modul **Docker Manager** yang sangat memudahkan manajemen container. Kami merekomendasikan penggunaan gaya "Native" aaPanel agar manajemen resource dan env lebih rapi.
|
||||
|
||||
::: tip PRASYARAT
|
||||
Pastikan Anda sudah menginstall modul **Docker** dari App Store di dalam aaPanel Anda.
|
||||
:::
|
||||
|
||||
## 1. Siapkan Konfigurasi
|
||||
|
||||
Metode ini memisahkan konfigurasi (di file `.env`) dari template logic, sehingga Anda bisa dengan mudah mengubah port atau resource limit tanpa mengedit file YAML yang rumit.
|
||||
|
||||
**File Environment (`.env`)**
|
||||
Buat file baru bernama `.env` (atau simpan teks ini untuk nanti):
|
||||
|
||||
```ini
|
||||
VERSION=latest
|
||||
CONTAINER_NAME=mivo
|
||||
HOST_IP=0.0.0.0
|
||||
APP_PORT=8085
|
||||
APP_PATH=/www/dk_project/mivo
|
||||
APP_ENV=production
|
||||
APP_DEBUG=false
|
||||
TZ=Asia/Jakarta
|
||||
CPUS=1.0
|
||||
MEMORY_LIMIT=512M
|
||||
```
|
||||
|
||||
**Penjelasan Atribut:**
|
||||
- `APP_PATH`: **Penting**. Ini harus sama persis dengan lokasi project di aaPanel Anda (defaultnya `/www/dk_project/<nama_project>`).
|
||||
- `APP_PORT`: Port host yang ingin dibuka (default `8080`).
|
||||
- `CPUS` & `MEMORY_LIMIT`: Batasan resource agar container tidak membebani server/VPS Anda.
|
||||
|
||||
## 2. Buat Project di aaPanel
|
||||
|
||||
1. Login ke dashboard aaPanel.
|
||||
2. Masuk ke menu **Docker** > **Project** (atau **Compose** di versi lama).
|
||||
3. Klik tombol **Add Project**.
|
||||
4. Isi form sebagai berikut:
|
||||
- **Name**: `mivo` (atau nama lain yang Anda suka)
|
||||
- **Path**: Perhatikan path yang muncul otomatis (biasanya `/www/dk_project/mivo`). **Pastikan `APP_PATH` di .env Anda sesuai dengan path ini!**
|
||||
- **Compose Template**: Copy-paste kode YAML berikut:
|
||||
|
||||
```yaml
|
||||
version: '3.8'
|
||||
|
||||
services:
|
||||
mivo:
|
||||
image: ghcr.io/mivodev/mivo:${VERSION:-latest}
|
||||
container_name: ${CONTAINER_NAME:-mivo}
|
||||
restart: unless-stopped
|
||||
ports:
|
||||
- "${HOST_IP:-0.0.0.0}:${APP_PORT:-8085}:80"
|
||||
volumes:
|
||||
# Database & Sessions
|
||||
- ${APP_PATH:-.}/mivo_data:/var/www/html/app/Database
|
||||
|
||||
# Custom Logos
|
||||
- ${APP_PATH:-.}/mivo_logos:/var/www/html/public/assets/img/logos
|
||||
|
||||
# Environment file (Optional - mapped from host)
|
||||
# - ${APP_PATH:-.}/.env:/var/www/html/.env
|
||||
|
||||
environment:
|
||||
- APP_ENV=${APP_ENV:-production}
|
||||
- APP_DEBUG=${APP_DEBUG:-false}
|
||||
- TZ=${TZ:-Asia/Jakarta}
|
||||
|
||||
deploy:
|
||||
resources:
|
||||
limits:
|
||||
cpus: '${CPUS:-1.0}'
|
||||
memory: ${MEMORY_LIMIT:-512M}
|
||||
|
||||
networks:
|
||||
- mivo_net
|
||||
|
||||
networks:
|
||||
mivo_net:
|
||||
driver: bridge
|
||||
```
|
||||
|
||||
5. **Tunggu!** Sebelum klik "Confirm":
|
||||
- Cari bagian konfigurasi **.env** (biasanya berupa tab atau input area di samping/bawah editor YAML).
|
||||
- Paste konten `.env` yang sudah Anda siapkan di langkah 1 ke sana.
|
||||
6. Klik **Confirm** untuk memulai deployment.
|
||||
|
||||
## 3. Verifikasi Deployment
|
||||
|
||||
aaPanel akan otomatis mendownload image dan menjalankan container.
|
||||
|
||||
- **Lokasi Data**: Database Anda aman tersimpan di `/www/dk_project/mivo/mivo_data`. folder ini tidak akan hilang walau container dihapus.
|
||||
- **Lokasi Logo**: Upload logo kustom Anda ke `/www/dk_project/mivo/mivo_logos`.
|
||||
|
||||
## 4. Setup Domain (Reverse Proxy)
|
||||
|
||||
Agar MIVO bisa diakses menggunakan domain (contoh: `mivo.domainanda.com`):
|
||||
|
||||
1. Ke menu **Website** > **Add Site**.
|
||||
2. Masukkan nama domain Anda.
|
||||
3. Pada **PHP Version**, pilih **Static** (atau langsung Reverse Proxy jika ada opsinya).
|
||||
4. Setelah site dibuat, buka settingannya > **Reverse Proxy** > **Add Reverse Proxy**.
|
||||
5. **Target URL**: `http://127.0.0.1:8085` (Ganti `8085` sesuai dengan `APP_PORT` Anda).
|
||||
6. Simpan dan aktifkan SSL agar lebih aman.
|
||||
77
docs/id/guide/docker.md
Normal file
77
docs/id/guide/docker.md
Normal file
@@ -0,0 +1,77 @@
|
||||
---
|
||||
title: Panduan Docker
|
||||
---
|
||||
|
||||
# Panduan Docker
|
||||
|
||||
Image Docker ini dibangun di atas **Alpine Linux** dan **Nginx**, dioptimalkan untuk performa tinggi dan penggunaan sumber daya rendah.
|
||||
|
||||
## <Icon name="Zap" color="warning" /> Mulai Cepat
|
||||
|
||||
Jalankan MIVO dengan satu perintah:
|
||||
|
||||
```bash
|
||||
docker run -d \
|
||||
--name mivo \
|
||||
-p 8080:80 \
|
||||
-e APP_KEY=base64:YOUR_GENERATED_KEY \
|
||||
-e APP_ENV=production \
|
||||
-v mivo_data:/var/www/html/app/Database \
|
||||
-v mivo_config:/var/www/html/.env \
|
||||
ghcr.io/mivodev/mivo:latest
|
||||
```
|
||||
|
||||
Buka browser Anda dan navigasi ke `http://localhost:8080`.
|
||||
|
||||
**Pengaturan Awal:**
|
||||
Jika ini adalah pertama kali dijalankan, Anda akan diarahkan ke **Web Installer**. Ikuti instruksi di layar untuk membuat database dan akun admin.
|
||||
|
||||
## <Icon name="Wrench" color="primary" /> Docker Compose
|
||||
|
||||
Untuk pengaturan yang lebih permanen, gunakan `docker-compose.yml`:
|
||||
|
||||
```yaml
|
||||
services:
|
||||
mivo:
|
||||
image: ghcr.io/mivodev/mivo:latest
|
||||
container_name: mivo
|
||||
restart: unless-stopped
|
||||
ports:
|
||||
- "8080:80"
|
||||
environment:
|
||||
- APP_ENV=production
|
||||
- TZ=Asia/Jakarta
|
||||
volumes:
|
||||
- ./mivo-data:/var/www/html/app/Database
|
||||
```
|
||||
|
||||
## <Icon name="Tags" color="info" /> Tags
|
||||
|
||||
- `latest`: Rilis stabil (direkomendasikan).
|
||||
- `edge`: Build terbaru dari branch `main` (bleeding edge).
|
||||
- `v1.x.x`: Versi rilis spesifik.
|
||||
|
||||
## <Icon name="Sliders" color="success" /> Variabel Lingkungan
|
||||
|
||||
| Variabel | Deskripsi | Default |
|
||||
| :--- | :--- | :--- |
|
||||
| `APP_ENV` | Lingkungan aplikasi (`production` atau `local`). | `production` |
|
||||
| `APP_DEBUG` | Aktifkan mode debug (`true` atau `false`). | `false` |
|
||||
| `APP_KEY` | String acak ca 32-karakter (base64). Dibuat otomatis saat install pertama kali jika kosong. | |
|
||||
| `TZ` | Zona waktu untuk container. | `UTC` |
|
||||
|
||||
## <Icon name="Folder" color="primary" /> Volume
|
||||
|
||||
Persist data Anda dengan me-mount path ini:
|
||||
|
||||
- `/var/www/html/app/Database`: Menyimpan database SQLite dan file sesi. **(Penting)**
|
||||
- `/var/www/html/public/assets/img/logos`: Menyimpan logo kustom yang diupload.
|
||||
|
||||
## <Icon name="Heart" color="danger" /> Dukung Proyek Ini
|
||||
|
||||
Jika Anda merasa MIVO bermanfaat, harap pertimbangkan untuk mendukung pengembangannya. Kontribusi Anda sangat berarti untuk kelangsungan proyek ini!
|
||||
|
||||
[](https://sociabuzz.com/dyzulkdev/tribe)
|
||||
|
||||
---
|
||||
*Dibuat dengan <Icon name="Heart" color="danger" /> oleh MivoDev*
|
||||
23
docs/id/guide/index.md
Normal file
23
docs/id/guide/index.md
Normal file
@@ -0,0 +1,23 @@
|
||||
---
|
||||
title: Pengenalan
|
||||
---
|
||||
|
||||
# Pengenalan
|
||||
|
||||
Selamat datang di Panduan MIVO. Bagian ini akan membantu Anda memahami apa itu MIVO dan bagaimana cara menjalankannya di sistem Anda.
|
||||
|
||||
## <Icon name="Zap" color="warning" /> Apa itu MIVO?
|
||||
|
||||
MIVO adalah sistem Manajemen Voucher Mikrotik yang modern dan ringan. Sistem ini dirancang agar efisien, cepat, dan mudah digunakan, memberikan pengalaman yang mulus untuk pengelolaan Hotspot.
|
||||
|
||||
## <Icon name="BookOpen" color="primary" /> Navigasi
|
||||
|
||||
Jelajahi bagian berikut untuk memulai:
|
||||
|
||||
- **[Panduan Instalasi](/id/guide/installation)**: Pelajari cara menginstal MIVO di berbagai platform.
|
||||
- **[Panduan Docker](/id/guide/docker)**: Cara yang direkomendasikan untuk menjalankan MIVO menggunakan container.
|
||||
- **[Buku Manual](/id/manual/)**: Instruksi detail tentang cara menggunakan fitur-fitur MIVO.
|
||||
|
||||
## <Icon name="Heart" color="danger" /> Dukungan
|
||||
|
||||
MIVO adalah proyek open-source. Jika Anda merasa MIVO bermanfaat, harap pertimbangkan untuk mendukung pengembangannya melalui [donasi](https://sociabuzz.com/dyzulkdev/tribe) atau [berkontribusi](https://github.com/dyzulk/mivo) langsung ke kode program.
|
||||
121
docs/id/guide/installation.md
Normal file
121
docs/id/guide/installation.md
Normal file
@@ -0,0 +1,121 @@
|
||||
---
|
||||
title: Panduan Instalasi
|
||||
---
|
||||
|
||||
# Panduan Instalasi
|
||||
|
||||
Panduan ini mencakup instalasi di berbagai platform. MIVO dirancang agar ringan dan berjalan di hampir semua server yang mendukung PHP.
|
||||
|
||||
## <Icon name="ClipboardList" color="primary" /> Persyaratan Umum {#persyaratan}
|
||||
* **PHP**: 8.0 atau lebih tinggi
|
||||
* **Ekstensi**: `sqlite3`, `openssl`, `mbstring`, `json`
|
||||
* **Database**: SQLite (Berbasis file, tidak perlu server database)
|
||||
|
||||
---
|
||||
|
||||
## <Icon name="Container" color="info" /> Docker (Direkomendasikan) {#docker}
|
||||
Cara termudah untuk menjalankan MIVO.
|
||||
|
||||
1. **Build & Run**
|
||||
```bash
|
||||
docker-compose up -d --build
|
||||
```
|
||||
Buka `http://localhost:8080`
|
||||
|
||||
2. **Manual Pull (Alternatif)**
|
||||
Jika Anda lebih suka menarik image secara manual:
|
||||
```bash
|
||||
docker pull ghcr.io/mivodev/mivo:latest # Stable
|
||||
docker pull ghcr.io/mivodev/mivo:v1.0.0 # Versi Spesifik
|
||||
docker pull ghcr.io/mivodev/mivo:edge # Bleeding Edge
|
||||
```
|
||||
|
||||
*Catatan: Database disimpan secara permanen di `app/Database` melalui volume.*
|
||||
|
||||
---
|
||||
|
||||
## <Icon name="Server" color="success" /> Web Server {#web-server}
|
||||
|
||||
### Nginx
|
||||
Nginx tidak membaca `.htaccess`. Gunakan blok konfigurasi ini di blok `server` Anda:
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name domain-anda.com;
|
||||
root /path/to/mivo/public;
|
||||
index index.php;
|
||||
|
||||
location / {
|
||||
try_files $uri $uri/ /index.php?$query_string;
|
||||
}
|
||||
|
||||
location ~ \.php$ {
|
||||
include snippets/fastcgi-php.conf;
|
||||
fastcgi_pass unix:/run/php/php8.2-fpm.sock; # Sesuaikan versi
|
||||
}
|
||||
|
||||
location ~ /\.ht {
|
||||
deny all;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## <Icon name="Smartphone" color="warning" /> Mobile / STB {#mobile-stb}
|
||||
|
||||
### Awebserver
|
||||
1. Salin file MIVO ke folder `/htdocs`.
|
||||
2. Arahkan document root ke `public` jika didukung, atau akses via `http://localhost:8080/public`.
|
||||
3. Pastikan versi PHP kompatibel.
|
||||
|
||||
### Termux
|
||||
1. Install PHP: `pkg install php`
|
||||
2. Masuk ke direktori MIVO: `cd mivo`
|
||||
3. Gunakan built-in server:
|
||||
```bash
|
||||
php mivo serve --host=0.0.0.0 --port=8080
|
||||
```
|
||||
4. Akses melalui browser.
|
||||
|
||||
---
|
||||
|
||||
## <Icon name="Globe" color="info" /> Shared Hosting {#shared-hosting}
|
||||
Kebanyakan shared hosting menggunakan Apache atau OpenLiteSpeed, yang didukung penuh.
|
||||
|
||||
1. **Upload File**: Upload file MIVO ke `public_html/mivo` (atau folder subdomain).
|
||||
2. **Arahkan Domain**:
|
||||
* **Direkomendasikan**: Pergi ke "Domains" atau "Subdomains" di cPanel dan set **Document Root** agar menunjuk langsung ke folder `public/` (contoh: `public_html/mivo/public`).
|
||||
* **Alternatif**: Jika tidak bisa mengubah Document Root, Anda bisa memindahkan isi `public/` ke root `public_html` dan memindahkan `app/`, `routes/`, dll satu level ke atas (tidak disarankan untuk keamanan).
|
||||
3. **Versi PHP**: Pilih PHP 8.0+ di menu "Select PHP Version".
|
||||
4. **Ekstensi**: Pastikan `sqlite3` dan `fileinfo` dicentang.
|
||||
|
||||
---
|
||||
|
||||
## <Icon name="Cloud" color="primary" /> VPS & Cloud {#vps-cloud}
|
||||
|
||||
### aaPanel
|
||||
1. **Buat Website**: Tambah situs -> PHP-8.x.
|
||||
2. **Direktori Situs**:
|
||||
* Set **Running Directory** ke `/public`.
|
||||
* Hapus centang "Anti-XSS" (terkadang memblokir penyimpanan konfigurasi).
|
||||
3. **URL Rewrite**: Pilih template `thinkphp` atau `laravel` yang kompatibel.
|
||||
4. **Izin File**: Chown user `www` ke direktori situs.
|
||||
|
||||
### PaaS Cloud (Railway / Render / Heroku)
|
||||
> [!WARNING]
|
||||
> MIVO menggunakan SQLite. Kebanyakan PaaS Cloud menggunakan **Ephemeral Filesytem** (Data hilang saat restart).
|
||||
> Anda WAJIB menggunakan **Persistent Volume/Disk**.
|
||||
|
||||
---
|
||||
|
||||
## <Icon name="Settings" color="success" /> Pasca-Instalasi {#pasca-instalasi}
|
||||
Setelah menyiapkan server:
|
||||
1. Salin `.env.example` ke `.env` (jika belum dilakukan).
|
||||
2. **Install Aplikasi**
|
||||
* **Opsi A: CLI**
|
||||
Jalankan `php mivo install` di terminal Anda.
|
||||
* **Opsi B: Web Installer**
|
||||
Buka `http://domain-anda.com/install` di browser.
|
||||
|
||||
Reference in New Issue
Block a user