VPS Üzerinde Nginx Proxy Manager: Bir İnceleme ve Kurulum Kılavuzu

NPM vs Caddy vs Traefik: Hangi Reverse Proxy VPS'inize Uyar

Üç araç, seçimi belirleyen dört eksende ayrışır: onları nasıl yapılandırdığınız, HTTPS'i nasıl yönettikleri, servis sayısıyla nasıl ölçeklendikleri ve boşta ne kadar RAM kullandıkları. İşte karşılaştırma.

Boşta RAM rakamları, şuradan yaklaşık gözlemlerdir: bir 2026 karşılaştırması, sabit gereksinimler değil. Gerçek kullanım, imaj sürümüne, etkin özelliklere, trafiğe ve günlüklemeye göre değişir.

Geçiş kriterleri doğrudan o tablodan çıkar. Bir kontrol paneli istiyorsanız ve sık değişmeyen bir avuç servis çalıştırıyorsanız, doğru araç NPM'dir. Kod olarak yapılandırmayı tercih ediyorsanız, en küçük ayak izini istiyorsanız veya Caddy'nin şu özelliğini takdir ediyorsanız: sıfır ACME kurulumuyla otomatik HTTPS sağlama ve yenileme, Caddy kullanın. SSL yönetimi otomatik ve Caddyfile kısa olduğu için tek siteli dağıtımlarda ben de Caddy'ye başvururum. Sık sık konteyner ekler, kaldırır veya yeniden dağıtırsanız, Traefik'in etiket tabanlı otomatik keşfi, her yeni host'u elle kaydetmeyi bırakmanız anlamına gelir.

Bazı yöneticilerin kesin denetim veya Docker dışı dağıtımlar için tercih ettiği, Certbot'lu çıplak Nginx de vardır. Certbot sertifika yenilemeyi otomatikleştirebilir, ancak sanal host yönlendirmesini ve Nginx yapılandırmasını yine de kendiniz yönetirsiniz. NPM'i düşünmenizin ana nedeni manuel proxy yapılandırmasından kaçınmaksa, çıplak Nginx'in daha iyi bir seçim olması olası değildir.

Seçim üzerine bir not: byte-guard'ın karşılaştırması, o karşılaştırmadaki en hafif seçenek olarak Caddy'de karar kılar ve sıfır bir 2026 tek host kurulumu için bu makul bir seçimdir. Caddy, NPM'den daha hafif olma konusunda kazanır, ancak özellikle bir GUI istiyorsanız en iyi tercihiniz değildir.

Alttaki motorların daha derin bir yan yana karşılaştırması için şuna bakın: VPS üzerinde Caddy vs Nginx karşılaştırması.

Ön koşullar: neye ihtiyacınız olacak

Dağıtmadan önce bunları hazır bulundurun. Bu kısa bir liste, ancak herhangi bir maddeyi atlarsanız sertifika adımı daha sonra başarısız olacaktır.

• Şunlara sahip bir VPS: Docker ve Docker Compose kurulu (Ubuntu 22.04 LTS veya Debian 12 uygundur).
• Bir alan adı, şununla: DNS A kaydı (ve IPv6 kullanıyorsanız AAAA) VPS genel IP'nize işaret eden.
• VPS'e SSH erişimi.
• Güvenlik duvarınızda internete açık 80 ve 443 portları.
• Yalnızca sizin erişebileceğiniz, halka açık olmayan port 81 (güvenlik bölümünde ele alınmıştır).

Nginx Proxy Manager'ı VPS'inizde Docker Compose ile Kurma

Bu bölüm NPM'i Docker Compose kullanarak dağıtır. DNS kayıtlarınız VPS'e çözümlendiğinde, DNS yayılımı ve sertifika verilmesi daha uzun sürebilse de, konteyner kurulumunun kendisi hızlıdır.

Kurulum, bir Docker Compose dosyası ve paylaşılan bir Docker ağı oluşturmak için tek seferlik bir komut kullanır. Bir dizin oluşturun, ağı oluşturun, aşağıdaki dosyayı ekleyin docker-compose.yml ve konteyneri ayağa kaldırın.

Önce, paylaşılan Docker ağını oluşturun:

docker network create proxy

Ardından aşağıdakini oluşturun: docker-compose.yml dosya:

# docker-compose.yml
services:
  npm:
    image: 'jc21/nginx-proxy-manager:<PATCHED_VERSION>'
    restart: unless-stopped
    ports:
      - '80:80'                 # public HTTP
      - '443:443'               # public HTTPS
      - '127.0.0.1:81:81'       # admin UI, reachable only from the VPS itself
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
    networks:
      - proxy
networks:
  proxy:
    external: true

NPM'in servis adıyla erişmesi gereken her arka uç konteynerini aynı harici ağa bağlayın: proxy ağ. Bu, NPM'in arka uç uygulamasının portunu VPS'te yayınlamadan konteyneri servis adıyla çözümlemesini sağlar.

Her ikisini de yedekleyin: ./data ve ./letsencrypt yükseltmelerden önce. Veri dizini NPM'in veritabanını ve oluşturulan yapılandırmayı içerirken, Let's Encrypt dizini onun sertifika materyalini içerir.

Bu dosya hakkında birkaç şey. İmaj, varsayılan olarak şurada saklanan bir SQLite veritabanı kullanır: ./data birim. Bu varsayılan arka uçtur ve çoğu tek VPS dağıtımı için doğrudur. Harici bir veritabanına ihtiyacınız varsa, NPM MariaDB/MySQL ve PostgreSQL'i destekler, bu da bir veritabanı servisi ve eşleşen ortam değişkenleri eklemek anlamına gelir. Tek bir VPS için, veritabanını veri biriminden taşımak için net bir nedeniniz olmadıkça SQLite hâlâ en basit varsayılandır. Şu restart: unless-stopped politikası, VPS yeniden başlarsa NPM'in tekrar ayağa kalkacağı anlamına gelir, ki bu her şeyin önünde duran bir servis için istediğiniz şeydir.

Onu ayağa kaldırın ve çalıştığını doğrulayın:

docker compose up -d
docker compose ps

Beklenen çıktı: şu npm konteyner şu durumda: Up, 80 ve 443 portları genel olarak eşlenmiş ve port 81 yalnızca şuna bağlı: 127.0.0.1. İlk başlatma, NPM bir JWT anahtarı oluştururken, veritabanını başlatırken ve varsayılan yönetici kullanıcısını oluştururken birkaç dakika sürer. Şu resmi kurulum belgeleri bu ilk çalıştırma sırasını açıklar.

Yönetici arayüzünü açmadan önce yerel bilgisayarınızdan bir SSH tüneli oluşturun:

ssh -L 8181:127.0.0.1:81 user@your-vps

Ardından şunu açın: http://127.0.0.1:8181 tarayıcınızda. Sıfır bir kurulumda, şununla oturum açın: [email protected] ve changeme, ardından varsayılan e-posta ve parolayı hemen değiştirin. Varsayılan kimlik bilgileri etkinken kontrol panelini genel olarak erişilebilir hale getirmeyin.

Yönetici kimlik bilgilerini değiştirdikten sonra, ilk proxy host'unuzu ekleyin:

1. Kontrol panelinde şuraya gidin: Hosts, ardından Proxy Hosts, ardından Add Proxy Host.
2. Ayarla Domain Name alt alan adınıza (örneğin cloud.example.com).
3. Ayarla Forward Hostname / IP arka uç konteyner adına veya IP'sine ve Forward Port dinlediği porta.
4. Kaydedin. Proxy host listede görünür ve o alt alan adına gelen trafik artık konteynerinize ulaşır.

Bunun yanında bir Docker yönetim arayüzü çalıştırıyorsanız, aynı kalıp geçerlidir: bir alt alan adını konteyner yönetim aracına aynı şekilde yönlendirin ve proxy arkasında durmasını istediğiniz bir şey için de aynısını yapın: Prometheus ve Grafana izleme yığını proxy'nin arkasında durmasını istediğiniz.

Bir Alt Alan Adı İçin Otomatik HTTPS Yapılandırma

Bu bölüm, alt alan adınız için geçerli, otomatik yenilenen bir Let's Encrypt sertifikası sağlar. Ön koşul, insanları yakalayan şeydir: o alt alan adı için DNS A kaydının zaten VPS'inize işaret etmesi ve port 80'in internetten erişilebilir olması gerekir, çünkü Let's Encrypt alan adını ona geri bağlanarak doğrular.

Proxy host oluşturulduğunda, sertifikayı isteyin:

1. Proxy host'u düzenleyin, şunu açın: SSL sekme.
2. Altında SSL Sertifikasıseç Request a new SSL Certificate.
3. Etkinleştir Force SSL ve HTTP/2 Support. HSTS'yi yalnızca HTTPS'in doğru çalıştığını doğruladıktan sonra açın, çünkü tarayıcılar politikayı önbelleğe alabilir ve bir sertifika veya proxy yapılandırması hatasından kurtarmayı daha zor hale getirebilir.
4. Let's Encrypt koşullarını kabul edin ve kaydedin.

Varsayılan olarak NPM, joker olmayan adlar için HTTP-01 doğrulamasını kullanır ve istenen her ana bilgisayar adını port 80 üzerinden doğrular. Bir sertifika birden fazla joker olmayan ad içerebilir, ancak HTTP-01 joker sertifikalar veremez. Şunun gibi joker adlar: *.example.com desteklenen bir DNS sağlayıcısıyla DNS-01 doğrulaması gerektirir. Normal, servis başına tek alt alan adı kurulumu için ihtiyacınız olan tek şey HTTP-01'dir ve yenilemeler otomatiktir.

VPS'inizi Nginx Proxy Manager İçin Boyutlandırma

NPM'in kendisi hafiftir; boyutlandırma sorusu aslında NPM artı arkasında duran servislerle ilgilidir. Proxy'nin boşta ayak izi nadiren kısıtlayıcı faktördür. Bir Nextcloud örneği veya Ghost blogu, proxy'nin kendisinden daha fazla kaynak kullanacaktır.

Katmanların pratikte nasıl işlediği şöyledir:

• Minimum pratik temel: 1 GB RAM, 1 vCPU ve 10 GB depolama. Bir üçüncü taraf boyutlandırma kılavuzu aynı temeli kullanır, ancak bunu resmi bir NPM gereksinimi değil, planlama rehberi olarak değerlendirin. NPM, işletim sistemi ve birkaç hafif servis için yeterlidir, ancak sınırlı bir pay bırakır.
• Rahat: 2 GB RAM, 1 vCPU, 20 GB depolama. NPM artı nefes alacak yeri olan üç ila beş servis. Bu, çoğu kendi sunucusunda barındıran için ideal noktadır.
• Bir üst kademe: 4 GB RAM, 2 vCPU. Sekiz ila on iki servis için veya TLS sonlandırması için CPU payı istediğiniz kayda değer trafiği olan bir kurulum için.

Boyutlandırdığınız sayı, NPM değil, proxy'lenen uygulamaların toplamıdır. Çalıştırmayı düşündüğünüz servislerin RAM ayak izlerini toplayın, üzerine proxy'nin küçük boşta yükünü ekleyin ve bunun üzerindeki katmanı bir marjla seçin.

Sunucuyu boyutlandırmak işin kolay kısmıdır. NPM'i çalıştırmak yine de VPS'i sağlamak, Docker'ı kurmak, imajı çekmek ve o ilk çalıştırma kurulumundan geçmek anlamına gelir. Sağlama adımlarını atlamayı tercih ederseniz, Cloudzy'nin pazar yerinde tek tıklamalık bir Nginx Proxy Manager dağıtımı bir NVMe VPS üzerinde vardır. Konteyneri sıfır bir sunucuda ayağa kaldırır, böylece doğrudan kontrol paneline ve ilk proxy host'unuza geçersiniz. Her iki durumda da, yukarıdaki boyutlandırma katmanları sağlama yaptığınız referanstır.

Sıkça Sorulan Sorular