Ters vekil arkasında

Sunucunuzda 80 ve 443 portlarını kullanan bir web sunucusu (ters vekil, reverse proxy) zaten varsa Bekci'yi onun arkasına koyarsınız: vekil HTTPS'i sağlar ve istekleri Bekci'ye iletir. Coolify kullanıyorsanız bu sayfa yerine Coolify rehberini izleyin.

Hangi vekili kullanırsanız kullanın, Bekci'nin düzgün çalışması için vekilin şunları yapması gerekir:

1. Bekci'yi yalnızca yerelde dinleyecek şekilde çalıştırın#

Vekil aynı sunucudaysa Bekci'nin portunu yalnızca 127.0.0.1 adresine yayınlayın; böylece Bekci'ye dışarıdan vekili atlayarak erişilemez. Docker Compose ile:

name: bekci
services:
  bekci:
    image: kadirsungurlu/bekci:latest
    restart: unless-stopped
    stop_grace_period: 30s
    ports:
      - "127.0.0.1:8080:8080"   # yalnızca bu sunucudan erişilebilir
    environment:
      BASE_URL: https://bekci.ornek.com
      TZ: Europe/Istanbul
    volumes:
      - bekci-data:/data
volumes:
  bekci-data:

cd /opt/bekci
docker compose up -d

BASE_URL, panelin dışarıdan açılacağı HTTPS adresi olmalıdır. (Traefik'i Docker etiketleriyle kullanıyorsanız bu dosya yerine aşağıdaki Traefik sekmesindekini kullanın.)

2. Vekili ayarlayın#

Kullandığınız vekilin sekmesini seçin. Her sekme dosyanın nereye gideceğini, tam içeriğini ve ayarı nasıl uygulayacağınızı anlatır.

nano /etc/nginx/sites-available/bekci

server {
    listen 80;
    listen [::]:80;
    server_name bekci.ornek.com;

    # Yedek geri yükleme ve Uptime Kuma içe aktarma için büyük dosyalar
    client_max_body_size 200m;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Connection "";

        # Canlı güncellemeler (SSE): tamponlamadan ilet, uzun bağlantıyı kesme
        proxy_buffering off;
        proxy_cache off;
        proxy_read_timeout 1h;
    }
}

ln -s /etc/nginx/sites-available/bekci /etc/nginx/sites-enabled/bekci
nginx -t
systemctl reload nginx

name: bekci
services:
  bekci:
    image: kadirsungurlu/bekci:latest
    restart: unless-stopped
    stop_grace_period: 30s
    environment:
      BASE_URL: https://bekci.ornek.com
      TZ: Europe/Istanbul
    volumes:
      - bekci-data:/data
    networks:
      - proxy
    labels:
      - traefik.enable=true
      - traefik.http.routers.bekci.rule=Host(`bekci.ornek.com`)
      - traefik.http.routers.bekci.entrypoints=websecure
      - traefik.http.routers.bekci.tls.certresolver=letsencrypt
      - traefik.http.services.bekci.loadbalancer.server.port=8080
networks:
  proxy:
    external: true
volumes:
  bekci-data:

cd /opt/bekci
docker compose up -d

a2enmod proxy proxy_http headers

nano /etc/apache2/sites-available/bekci.conf

<VirtualHost *:80>
    ServerName bekci.ornek.com

    ProxyPreserveHost On
    ProxyRequests Off
    RequestHeader set X-Forwarded-Proto expr=%{REQUEST_SCHEME}

    # Canlı güncellemeler (SSE): yanıtı beklemeden ilet, uzun bağlantıyı kesme
    ProxyPass        / http://127.0.0.1:8080/ flushpackets=on timeout=3600
    ProxyPassReverse / http://127.0.0.1:8080/
</VirtualHost>

a2ensite bekci
apachectl configtest
systemctl reload apache2

nano /etc/caddy/Caddyfile

bekci.ornek.com {
	encode zstd gzip
	reverse_proxy 127.0.0.1:8080 {
		# Canlı güncellemeler (SSE) tamponlanmadan iletilsin
		flush_interval -1
	}
}

caddy validate --config /etc/caddy/Caddyfile
systemctl reload caddy

3. Doğrulayın#

1. Tarayıcıda https://bekci.ornek.com adresini açın ve giriş yapın (ilk kez açıyorsanız Hoş geldiniz ekranında yönetici hesabınızı oluşturun).
2. Canlı güncellemeleri sınayın: kontrol aralığı kısa (ör. 20 saniye) bir monitör ekleyin ve monitör listesinde bekleyin. Her kontrolden sonra monitörün durum çubukları ve yanıt süresi sayfayı yenilemeden güncellenmelidir.

Güvenilir vekil (TRUSTED_PROXY)#

Bekci, X-Forwarded-For başlığındaki istemci adresine yalnızca isteği ileten bağlantı güvenilir bir adresten geliyorsa inanır. Varsayılan olarak tüm özel (10.x, 172.16–31.x, 192.168.x) ve yerel (127.x) adresler güvenilir sayılır; vekil aynı sunucuda ya da aynı Docker ağında çalışıyorsa ayar gerekmez.

Daha sıkı olmak isterseniz güvenilir ağları TRUSTED_PROXY ortam değişkeniyle virgülle ayırarak verin, ör. TRUSTED_PROXY=172.17.0.1/32. Ayarlıysa yalnızca bu ağlardan gelen başlıklara güvenilir.

Sık karşılaşılan sorunlar#

Canlı güncellemeler gelmiyor, “Bağlantı yok” uyarısı#

Vekil /api/events yanıtını tamponluyor ya da bağlantıyı erken kesiyor. Yukarıdaki ayarlardaki şu satırları kontrol edin: Nginx'te proxy_buffering off ve proxy_read_timeout, Apache'de flushpackets=on, Caddy'de flush_interval -1. Arada Cloudflare gibi başka bir katman varsa o da bağlantıyı tamponlamamalıdır.

502 Bad Gateway#

Vekil Bekci'ye ulaşamıyor. Bekci çalışıyor mu (docker compose ps), port doğru mu (curl http://127.0.0.1:8080/healthz)? Traefik'te Bekci ile Traefik aynı Docker ağında olmalı.

İçe aktarmada “413 Request Entity Too Large”#

Vekilin istek gövdesi sınırı düşük. Nginx'te client_max_body_size 200m; satırını ekleyin.

Giriş yapıyorum ama hemen çıkış yapılıyor ya da sonsuz yönlendirme#

X-Forwarded-Proto başlığı iletilmiyor ya da yanlış. Vekil HTTPS'i sonlandırıyorsa bu başlık https olmalıdır. Cloudflare kullanıyorsanız SSL/TLS modunu Full (strict) yapın; Flexible modu yönlendirme döngüsüne yol açar.

Bildirimlerdeki ve ajan komutlarındaki adres yanlış#

BASE_URL ayarlı değil ya da yanlış. Panelin dışarıdan açıldığı https:// adresini yazın ve konteyneri yeniden oluşturun (docker compose up -d).