gpanel

KO | EN

gitlite — search

#hacktoberfest #typescript #llm #go #docker #windows #awesome #cli #kubernetes #awesome-list #vue #mcp #openai #open-source

(★ 23)

Ücretsiz plesk ve cpanel alternatif kendi amaçlalarınız için kullanacağınız panel

gpanel Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <a href="https://girginos.io"><b>🌐 girginos.io</b></a> &nbsp;·&nbsp;
  <a href="https://girginos.io/belgeler">Belgeler</a> &nbsp;·&nbsp;
  <a href="https://girginos.io/kur">Kurulum</a>
</p>

# GirginOSPanel

Boş bir **AlmaLinux 10** sunucuyu tek komutla komple bir hosting kontrol paneline çevirir — nginx + MariaDB + çok sürümlü PHP + Valkey (Redis) + phpMyAdmin + güvenlik duvarı, hepsi otomatik kurulur ve ayarlanır.

## Tek satır kurulum

Temiz bir AlmaLinux 10 (min. 2 GB RAM) sunucuda **root** olarak:

```bash
curl -fsSL https://girginos.io/kur | bash
```

Kurulum ~5-10 dakika sürer (paket indirmeleri). Bittiğinde panel adresi + giriş bilgileri ekrana yazılır.

## Kurulum sonrası

- **Panel:** `https://SUNUCU_IP:8443` (self-signed sertifika — tarayıcı uyarısını geçin)
- **Giriş:** kullanıcı **`root`** · parola = **sunucunun root parolası**
  (panel yöneticisini işletim sistemi root parolasıyla — /etc/shadow hash doğrulaması — doğrular; ayrı bir panel parolası yoktur)

## Ne kurar?

| Bileşen | Detay |
|---|---|
| **Web** | nginx (panel :8443 + müşteri siteleri :80/:443) |
| **PHP** | 7.4 / 8.2 / 8.3 / 8.4 / 8.5 (remi) — her domain bağımsız sürüm seçer, per-domain FPM havuzu |
| **Veritabanı** | MariaDB 10.11 (`panel` DB) + phpMyAdmin (`/pma/`) |
| **Cache** | Valkey (Redis) — per-tenant izole object cache (WordPress'e otomatik bağlanır) |
| **Güvenlik** | nftables güvenlik duvarı, SELinux uyumlu, ClamAV |
| **Performans** | MariaDB + nginx + OPcache otomatik tuning (`girginospanel-optimize`) |

## Panel özellikleri

- Domain / subdomain yönetimi, DNS düzenleme, toplu işlemler
- Tek-tık **WordPress** kurulumu + WP-CLI
- Per-tenant **Redis object cache** (tek tıkla aç/kapa, WP'ye otomatik bağlama)
- **Güvenlik duvarı** arayüzü (IP ban / whitelist / port kapatma + hazır şablonlar)
- Backup yöneticisi, izleme/loglar, istatistikler
- Hizmet planları ve kaynak limitleri (domain oluştururken varsayılan **Başlangıç**)

## Sistem gereksinimleri

- **AlmaLinux 10** (RHEL 10 / Rocky 10 de çalışır)
- En az **2 GB RAM**, 2 vCPU (5 PHP sürümü + MariaDB + Valkey için)
- Root erişimi + internet bağlantısı

## Kurulum sonrası yardımcı araçlar

Kurulumla birlikte `/usr/local/bin`'e şu araçlar gelir:

```bash
girginospanel-update        # paneli GitHub'dan güvenli güncelle (aşağıya bak)
girginospanel-optimize      # MariaDB/nginx/PHP'yi sunucu kaynaklarına göre yeniden ayarla
girginospanel-redis-setup   # Valkey (Redis) altyapısını kur/onar
girginospanel-wp-redis <sk> # bir domainin WordPress'ine Redis cache bağla/çöz
girginospanel-repair        # izin / SELinux / sahiplik onarımı (idempotent)
girginospanel-db-backup     # panel DB'sinin sıkıştırılmış dump'ını al (aşağıya bak)
```

## Yedekleme

### Panel veritabanı (`panel`)

Kurulumla birlikte **günlük otomatik yedek** gelir — ayrı bir şey yapmanız gerekmez:

| | |
|---|---|
| **Ne zaman** | Her gün **03:30** (`girginospanel-db-backup.timer`, ±5 dk rastgele gecikme) |
| **Nereye** | `/var/backups/girginospanel/db/panel-<TARİH>.sql.gz` (dizin `0700`, dump `0600`) |
| **Saklama** | **14 gün** — daha eskiler otomatik silinir |
| **Kapsam** | `panel` şeması + routine/trigger/event'ler (`mysqldump --single-transaction` → kilitsiz tutarlı anlık görüntü) |

Elle yedek almak için (üretilen dosyanın yolunu ekrana basar):

```bash
girginospanel-db-backup
# /var/backups/girginospanel/db/panel-2026-07-17-143052.sql.gz
```

Timer'ın durumunu görmek / bir sonraki çalışmayı öğrenmek için:

```bash
systemctl list-timers girginospanel-db-backup.timer
systemctl status girginospanel-db-backup.timer
journalctl -u girginospanel-db-backup -n 20    # son yedeklerin logu
```

Bir yedeği geri yüklemek için:

```bash
systemctl stop girginospanel
zcat /var/backups/girginospanel/db/panel-2026-07-17-143052.sql.gz | mysql
systemctl start girginospanel
```

> Yedek **fail-closed**'dır: gzip bütünlüğü doğrulanmadan veya dosya şüpheli derecede küçükse dump `panel-*.sql.gz` adını **almaz** — yarım bir dump asla geçerli yedek gibi görünmez.

### Güncelleme öncesi otomatik yedek

`girginospanel-update`, **migration'ları uygulamadan önce** panel DB'sinin tam dump'ını alır. Dump alınamazsa **güncelleme hiç başlamaz** (yedeksiz migration reddedilir). Ayrıntı için aşağıdaki "Güncelleme" bölümüne bakın.

### Müşteri siteleri

Müşteri siteleri + veritabanları ayrı bir işle yedeklenir: `girginospanel-backup-all` (cron, her gün 03:00 UTC, `/var/backups/girginospanel/<sistem_kullanıcı>/`, 14 gün saklama). Panel DB yedeği bu dizinlere **dokunmaz**.

## Güncelleme (SSH / CLI)

Kurulu bir panelde, SSH ile root olarak tek komut:

```bash
girginospanel-update            # son sürümü GitHub'dan çek → binary+frontend+migration değiştir → yeniden başlat
girginospanel-update --dry-run  # önce ne yapacağını göster (dokunmadan)
girginospanel-update --force    # binary aynı olsa bile yeniden uygula
girginospanel-update --branch X # farklı dal
```

- **Güvenli & veri-korumalı:** `/etc/girginospanel/env` (JWT/DB/Redis secret), MariaDB `panel` veritabanı ve `/home/c_*` müşteri siteleri **asla silinmez**. `install.sh`'in aksine yeni secret üretmez.
- Yeni migration'lar servis yeniden başlarken **otomatik + idempotent** uygulanır.
- Binary değişmemişse (sha eşleşir) hiçbir şey yapmaz.
- **Migration'lardan önce panel DB'sinin tam dump'ı alınır** → `/var/backups/girginospanel/db/`.
- **Fail-closed:** dump alınamazsa güncelleme **hiç başlamaz** — binary'ye, frontend'e ve migration'lara dokunulmaz. Yedeksiz migration kabul edilmez.
- Yeni sürüm sağlıklı başlamazsa **otomatik olarak eski binary'ye _ve_ güncelleme öncesi DB'ye geri döner** (rollback). Panel o sırada zaten durmuş olduğu için yazma kaybı olmaz.

> Kendi fork'unu deploy ediyorsan: kaynağı derle (`GOAMD64=v1 go build` + `npm run build`), `assets/girginospanel-server` + `assets/frontend-dist.tar.gz`'i güncelle, repona push et — sunucularda `girginospanel-update` yeni sürümü çeker. **Binary'yi mutlaka `GOAMD64=v1` ile derle** (bkz. "Backend (Go)" altındaki uyarı) — aksi halde eski CPU'lu müşteri sunucularında panel açılmaz.

## Sürüm kontrolü ve gizlilik

Panel günde bir kez yayın manifestini okuyarak **yeni sürüm** ve **kritik güvenlik
duyurusu** olup olmadığını kontrol eder. Amaç, kritik bir yama çıktığında bunu
size duyurabilmektir.

**Ne gönderilir:** Yalnızca iki şey — anonim kurulum kimliği (`?id=`) ve panel
sürümü (`?v=`). Kimlik **saf rastgeledir**: hostname, IP veya MAC adresinden
türetilmez, dolayısıyla geri çözülemez ve hangi müşteriye ait olduğu bilinemez.
Amaç yalnızca kaç kurulumun aktif olduğunu sayabilmektir.

**Ne gönderilmez:** Domain adları, hostname, IP adresi, e-posta, müşteri verisi,
veritabanı içeriği, lisans bilgisi, dosya içerikleri. Hiçbiri.

**Sunucu tarafında ne saklanır:** Erişim logu **IP adresi kaydetmez** — yalnızca
zaman damgası, istenen adres (kimlik + sürüm) ve HTTP durum kodu tutulur. Sayım
bu logdaki benzersiz kimlikler üzerinden yapılır.

Kurulum kimliği `/etc/girginospanel/kurulum-kimlik` dosyasında saklanır
(yalnız root okuyabilir). Silerseniz yeni bir kimlik üretilir; bu durumda
kurulumunuz sayımda yeni bir kayıt gibi görünür.

**Kapatmak için** `/etc/girginospanel/env` dosyasına ekleyin ve paneli yeniden
başlatın — bu durumda panel hiçbir dış istek atmaz ve hiçbir şey gönderilmez:

```bash
echo "PANEL_SURUM_KONTROL=0" >> /etc/girginospanel/env
systemctl restart girginospanel
```

Farklı bir manifest adresi kullanmak için: `PANEL_SURUM_UC=https://...`

## Site Taşıma (cPanel / Plesk / DirectAdmin)

Başka bir kontrol panelindeki siteleri **dosyaları, veritabanları, DNS kayıtları ve
SSL ile birlikte** bu panele aktarır. Tek site veya toplu (çoklu) taşıma yapılabilir.

**Nerede:** Araçlar ve Ayarlar → Site Taşıma (`/araclar/tasima`) — yalnız yönetici.

**Akış**

1. **Kaynak sunucu** — panel tipi, adres, SSH portu/kullanıcısı + parola *veya* SSH
   anahtarı. "Bağlantıyı test et" uzak sunucuda kurulu paneli de saptar.
2. **Keşif** — kaynaktaki tüm hesap/alan adları, PHP sürümü, veritabanları ve
   docroot boyutu listelenir. Panelde zaten var olanlar işaretlenir.
3. **Seçim + ayarlar** — hangi siteler taşınacak; dosya / veritabanı / DNS / SSL
   adımları tek tek açılıp kapatılabilir; hedef PHP sürümü seçilebilir.
4. **Taşıma** — arka planda çalışır, canlı kayıt (log) ve site-başına ilerleme
   gösterilir. Sayfa kapatılabilir; tekrar açılınca durum sunucudan okunur.

**Site başına yapılanlar:** sistem hesabı + docroot + php-fpm havuzu + nginx vhost →
FTP hesabı → dosyalar (rsync) → veritabanları (uzak `mysqldump` → yerel import) →
**yapılandırma dosyalarındaki DB bilgilerinin güncellenmesi** (`wp-config.php`, `.env`,
`configuration.php` …) → DNS kayıtları → SSL.

**Davranış notları**

- Kaynaktaki PHP sürümü hedefte kurulu değilse en yakın kurulu sürüme düşer ve uyarır.
- DNSte A kayıtları otomatik olarak bu sunucunun IPsine çevrilir; kaynak zone
  okunamazsa varsayılan şablon kullanılır.
- Panelde aynı alan adı varsa taşıma atlanır — üzerine yazmak için "Mevcut siteyi ez"
  açılmalıdır (mevcut dosya ve veritabanlarını ezer, önce yedek alın).
- Aynı anda yalnızca **tek** taşıma işi çalışır (ikinci istek `409` alır).
- Bir site hata alırsa yalnız o site geri alınır (oluşturulan hesap silinir), toplu
  taşımanın kalanı devam eder.

**Güvenlik**

- Uçlar yalnız yöneticiye açıktır; kimlik bilgileri `internal/gizli` (AES-256-GCM) ile
  şifreli saklanır ve **iş bitince silinir**.
- Parola komut satırına yazılmaz (`sshpass -e`, ortam değişkeni).
- Uzak sunucudan dönen her değer (hesap, alan adı, DB adı) doğrulanır; komutlarda
  kabuk kullanılmaz, uzak tarafa giden değerler tırnaklanır.
- Yeniden yazılan yapılandırma dosyalarının yedeği **web kökünün dışına**
  (`/var/lib/girginospanel/tasima-yedek`, 0600 root) alınır — eski DB parolası
  içerdiği için web kökünde bırakılmaz.

## Notlar

- Kurulum **idempotent** değildir; her çalıştırma yeni secret (JWT/DB parola) üretir. Yeniden çalıştırma yerine `girginospanel-repair` / `girginospanel-optimize` kullanın.
- Panel HTTP/2 + self-signed SSL ile :8443'te yayınlanır; gerçek alan adı için Let's Encrypt panel üzerinden eklenebilir.

---

## Kaynaktan derleme ve geliştirme

Bu proje **tamamen açık kaynaktır** (MIT). İstersen hazır binary'yi kurmak yerine kaynağı kendin derleyip geliştirebilirsin — katkılar açıktır.

### Gereksinimler

- **Go 1.23+** (backend)
- **Node.js 20+** ve **npm** (frontend)
- Çalıştırma için: MariaDB/MySQL erişimi (backend başlarken migration + admin seed uygular)

### Backend (Go)

> ⚠️ **Yayınlanacak binary `GOAMD64=v1` ile derlenmelidir.** AlmaLinux 10 (go1.26+) varsayılan olarak `GOAMD64=v3` üretir; v3 ile derlenen binary eski/yaygın müşteri CPU'larında
> `"This program can only be run on AMD64 processors with v3 microarchitecture support"` verip **çalışmaz**. `assets/girginospanel-server` daima `GOAMD64=v1` ile derlenmelidir
> (kolaylık için `scripts/build-assets.sh` kullan — bunu zaten sabitler).

```bash
# tek statik binary derle (eski CPU uyumu için GOAMD64=v1 ZORUNLU)
CGO_ENABLED=0 GOAMD64=v1 go build -o girginospanel-server ./cmd/server

# çalıştır (ortam değişkenleriyle)
PANEL_JWT_SECRET="$(openssl rand -hex 32)" \
PANEL_DB_DSN="root@unix(/var/lib/mysql/mysql.sock)/panel" \
./girginospanel-server
```

Backend API `/api/v1` altında; sağlık kontrolü `/healthz`. Admin girişi işletim sistemi root parolasıyla doğrulanır: `/etc/shadow` hash'i okunur ve karşılaştırılır (PAM API **kullanılmaz**; yescrypt `$y$` natif Go ile, eski formatlar python3 yedeğiyle). Giriş uçları IP başına hız-sınırlıdır (kaba-kuvvet koruması). Geliştirmede `scripts/seed_admin.go` ile ayrı bir admin tohumlayabilirsin:

```bash
go run scripts/seed_admin.go -dsn '<DSN>' -kullanici admin -parola 'SECELECEGIN_PAROLA'
# ya da: PANEL_SEED_PAROLA env değişkeni
```

### Frontend (React + Vite + TypeScript)

```bash
cd frontend
npm install
npm run dev        # geliştirme sunucusu :5185 (proxy /api → VITE_API_PROXY)
npm run build      # üretim derlemesi → frontend/dist/
```

Dev sunucusunun backend'i nereye proxy'leyeceğini `VITE_API_PROXY` ile ayarla (varsayılan `http://localhost:8080`):

```bash
VITE_API_PROXY=http://localhost:8080 npm run dev
```

### Depo yapısı

```
cmd/server/       Go giriş noktası (main)
internal/         Backend paketleri (domains, wordpress, dns, redis, guvenlikduvari, github, backups, ...)
frontend/src/     React arayüzü (pages/, components/, lib/)
migrations/       SQL şema migration'ları (başlangıçta uygulanır)
scripts/          Ops yardımcıları (optimize, repair, redis-setup, seed_admin, ...)
assets/           Kurulum için hazır (prebuilt) release çıktıları — installer bunları kullanır
install.sh        Tek satır bootstrap (repoyu indirir → girginospanel-install.sh)
```

> `assets/` içindeki hazır binary + `frontend-dist.tar.gz`, `curl | bash` kurulumunun kaynağı derlemeden çalışması içindir. Kendi değişikliklerini yayınlarken bunları yukarıdaki `go build` / `npm run build` çıktısıyla güncelle.

## Katkı & lisans

- Katkılar (issue / PR) açıktır.
- Lisans: **MIT** — bkz. [LICENSE](LICENSE). Kullanabilir, değiştirebilir, dağıtabilir ve kendi ürününde kullanabilirsin.

## Güncelleme

Paneli son sürüme güncellemek için sunucuda:

```bash
girginospanel-update              # son sürümü kur
girginospanel-update --dry-run    # sadece ne yapacağını göster
girginospanel-update --force      # aynı sürüm olsa bile yeniden uygula
```

Panel içinden de güncelleyebilirsiniz: **Araçlar ve Ayarlar → Panel Güncellemesi → "Güncellemeleri denetle ve kur"**.

Güncelleme **korur** (asla dokunmaz): `/etc/girginospanel/env` (JWT/DB/Redis secret), MariaDB `panel` veritabanı + tüm müşteri verisi, `/home/c_*` siteleri.

Güncelleme, **migration'ları uygulamadan önce** panel DB'sinin tam dump'ını `/var/backups/girginospanel/db/` altına alır. Dump alınamazsa güncelleme **hiç başlamaz** (yedeksiz migration reddedilir). Yeni sürüm sağlıklı başlamazsa otomatik olarak **eski binary'ye + güncelleme öncesi DB'ye geri döner**.

### "girginospanel-update: command not found" alıyorsanız

Panelinizi, güncelleme aracı dağıtıma eklenmeden **önce** kurmuşsanız bu komut sunucunuzda bulunmaz. Aracı almanın tek yolu yine kendisi olduğu için kısır döngüye girersiniz. Tek seferlik şu komutla kurun:

```bash
curl -fsSL https://raw.githubusercontent.com/girginos/gpanel/main/assets/ops/girginospanel-update \
  -o /usr/local/bin/girginospanel-update && chmod +x /usr/local/bin/girginospanel-update

girginospanel-update
```

Bunu **bir kez** yapmanız yeterlidir: `girginospanel-update` her çalıştığında `assets/ops/` altındaki tüm araçları `/usr/local/bin`'e yeniden kurar, dolayısıyla kendini de güncel tutar. Bundan sonra panel içindeki **Panel Güncellemesi** butonunu da kullanabilirsiniz.

> Panel içi güncelleme butonu, aracı eksikse **otomatik indirir** — yani butona basmanız da yeterlidir; yukarıdaki komut yalnızca panele hiç erişemediğiniz durumlar için.

gpanel

gpanel Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

gpanel

gpanel Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README