Factorizer/Cluster ERP WikiCluster ERP English
Ana sayfa / İşletme

Referans

Ters vekil sunucu

nginx site şablonu deploy/nginx.conf.example mekanizma düzeyinde; TLS, statik web uygulaması dosyaları, varlık damgası, başlıklar ve kayıt hız sınırı.

Bir Linux düğümü uygulamanın önüne nginx koyar. nginx TLS'i sonlandırır, web uygulaması dosyalarını çalışma kopyasından sunar ve geri kalan her şeyi gunicorn ana sürecine iletir. Bu sayfa deploy/nginx.conf.example şablonunu ve onu kuran deploy/install.sh satırlarını açıklar. Uygulama tarafındaki önbellek kuralları önbellek ve varlık damgası sayfasındadır.

Kapsam ve kaynak

  • Tanımlandığı yer: deploy/nginx.conf.example (iki server bloğu ve yorum hâlinde bir http bloğu parçası) ve deploy/install.sh:189-209.
  • Sayı: şablonun location satırları olarak sayılan iki server bloğu ve yedi location bloğu.

Şablondaki ana makine adı erp.example.com yer tutucusudur; install.sh onu --domain değeriyle değiştirir (deploy/install.sh:195).

Düz HTTP sunucusu

Konum Davranış Kaynak
/.well-known/acme-challenge/ Sertifika aracının web kökünden sunulur; böylece sertifika yenilemeleri çalışmayı sürdürür. deploy/nginx.conf.example:13-16
/ Aynı adrese HTTPS üzerinden kalıcı yönlendirme. deploy/nginx.conf.example:17-19

HTTPS sunucusu

Parça Davranış Kaynak
TLS TLS 1.2 ve 1.3, yalnız AEAD şifreleri, şifre seçimini istemci yapar, oturum biletleri kapalı, doğrulamalı OCSP stapling. deploy/nginx.conf.example:33-47
Sürüm bilgisi server_tokens off. deploy/nginx.conf.example:49-50
Gövde boyutu Yüklemeler ve belge sürümleri için client_max_body_size 64m. deploy/nginx.conf.example:58-59
İletilen başlıklar Host, X-Real-IP, X-Forwarded-For ve X-Forwarded-Proto uygulamaya gider. deploy/nginx.conf.example:61-67
location = / /app/ adresine geçici yönlendirme. deploy/nginx.conf.example:72-76
Varlık damgası $cluster_asset_stamp değerini sürüm etiketine ayarlayan dosyayı içerir. deploy/nginx.conf.example:78-84
Sıkıştırma 1024 baytın üstündeki CSS, JavaScript, JSON, SVG ve yazı tipleri için gzip. deploy/nginx.conf.example:86-94
location /app/ webapp/ klasörünü çalışma kopyasından sunar, index.html dosyasına düşer, Cache-Control: no-cache gönderir ve HTML içindeki __ASSET_STAMP__ değerini damgayla değiştirir. deploy/nginx.conf.example:96-105
/app/ başlıkları HSTS, bir içerik güvenliği ilkesi, nosniff ve no-referrer; konum düzeyindeki bir add_header sunucu düzeyindekilerin yerini aldığı için konumun içinde listelenir. deploy/nginx.conf.example:52-56, deploy/nginx.conf.example:106-115
location ~ ^/app/v/... Aynı dosyaları damga altında, bir yıl değişmez olarak önbelleğe alınmış ve aynı başlıklarla sunar. deploy/nginx.conf.example:117-127
location / 120 saniyelik okuma zaman aşımıyla HTTP/1.1 üzerinden uygulamaya iletir. deploy/nginx.conf.example:129-134
location /api/v1/signup Beşlik ani yük payıyla signup hız sınırı bölgesini uygular, sonra iletir. Sonunda eğik çizgi yoktur; böylece çıplak yol da kapsanır. deploy/nginx.conf.example:136-148

http bloğu

  • signup hız sınırı bölgesi http bloğuna aittir (deploy/nginx.conf.example:151-152). Bu adda bir bölge yoksa install.sh onu bir nginx conf.d dosyasına yazar (deploy/install.sh:201-203).
  • Yorum hâlindeki bir erişim günlüğü biçimi yolu sorgu dizesi olmadan yazar (deploy/nginx.conf.example:154-163).

install.sh şablonla ne yapar

Adım Davranış Kaynak
Grup erişimi nginx işçi hesabını servis kullanıcısının grubuna ekler ve çalışma kopyasını 0750 kipine ayarlar. deploy/install.sh:189-193
Site dosyası Şablonu alan adı yerine konmuş olarak yazar ve etkin sitelere bağlar. deploy/install.sh:195-196
Varlık damgası Her kurulumda damga dosyasına set $cluster_asset_stamp "<tag>"; yazar. deploy/install.sh:197-200
Yeniden yükleme nginx'i yalnız alan adı için bir sertifika varsa sınar ve yeniden yükler; yoksa sertifika komutunu yazar. deploy/install.sh:204-209

Kısıtlar ve doğrulama

  • Uygulama max_request_body_bytes değerinden büyük bir gövdeyi HTTP 413 ile reddeder (src/cluster_erp/config/settings.py:342-347). Bu sınır ve client_max_body_size iki ayrı ayardır.
  • Uygulama iletilen başlıkları yalnız trust_proxy_headers açıkken ve karşı uç trusted_proxy_ips içindeyken yorumlar (src/cluster_erp/server/main.py:45-51, deploy/gunicorn.conf.py:47-49).
  • nginx olmadan uygulama webapp/ klasörünün aynı iki görünümünü kendisi sunar (src/cluster_erp/server/app.py:1574-1644).

Tanıtılan terimler

Terim Kod tanımlayıcısı Tanım Türkçe terim Kaynak
kayıt hız sınırı bölgesi zone=signup Anonim kayıt yoluna uygulanan nginx istek hızı bölgesi. kayıt hız sınırı bölgesi deploy/nginx.conf.example:141-142

İlgili sayfalar


92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.

Doğrulanan commit 92f8051 · 2026-11-13