İçeriğe geç
zeev1.0.0-rc.1

Web production profili

Depodaki docs/web-production-profili.md belgesinden Zee ile üretildi.

Zee V1 web runtime'ı process başına bilinçli olarak tek worker'dır. Bir worker aynı anda bir bağlantıyı okur, bir Zee request'i çalıştırır ve yanıtı bitirir. Production concurrency'si, aynı proje kökünü paylaşan birden çok süreç ve önlerindeki HTTPS reverse proxy ile kurulur.

Örnek iki worker:

sh
dil çalıştır --web-proxy https://panel.example --web-worker-port 18091 uygulama.dil
dil çalıştır --web-proxy https://panel.example --web-worker-port 18092 uygulama.dil

Kaynak içindeki sunucu başlat kapısı production kipinde worker portuyla geçersiz kılınır; rota ve uygulama kaynağı iki süreçte aynıdır. Proxy yalnız 127.0.0.1:18091 ve 127.0.0.1:18092 hedeflerine yük dağıtır. Runtime loopback dışına açılmaz; listener 127.0.0.1e bind eder ve kabul edilen socket peer'inin loopback olduğunu ayrıca doğrular.

Tek komutla çok işçi (K-336/K-337, Unix)

sh
dil çalıştır --web-proxy https://panel.example --web-worker-port 18091 \
  --web-isci-sayisi 4 --web-saglik-port 18099 uygulama.dil

Yönetici süreç 127.0.0.1:18091'i bir kez bağlar ve aynı dinleyiciyi dört işçiye devreder; proxy tek hedefe (server 127.0.0.1:18091;) gider. Oturum, CSRF ve varsayılan ortak oran deposu tek süreçle aynı davranır. Açılış işini koruyun:

zee
açılış_sahibi birincil süreç olsun
açılış_sahibi ise
    uzlastirma yarım yüklemeleri uzlaştır olsun

İkincil işçiler birincil sunucu başlata ulaşmadan başlamaz; çöken işçi ikincil olarak yeniden başlar ve açılışı tekrarlamaz. systemctl stop (SIGTERM) kabul edilmiş istekleri tamamlatıp grubu kapatır; unit'te KillMode=mixed ya da varsayılan control-group uygundur, TimeoutStopSec en az 45 sn olmalı. curl http://127.0.0.1:18099/saglik bütün işçiler yaşıyorsa 200 döner. --web-oran-deposu bellek işçi başınadır (sınır N katı); tek süreçle aynı oran davranışı için varsayılan ortak depoyu kullanın. Windows'ta bu profil yoktur: yukarıdaki ayrı portlu süreçler + proxy dengelemesi kullanılır. Normatif metin spec/12 §7, karar ADR-161.

Ortak durum

Production worker'ları proje kökündeki .zee/web-durumu-v1.json dosyasını paylaşır. Burada tokenın kendisi değil SHA-256 özeti, CSRF, kullanıcı/rol, mutlak expiry ve atomik oran pencereleri tutulur. Süreç restart'ı oturumu silmez; bir worker'daki logout diğerlerinde hemen görünür. .zee/dosya Unix izinleri 0700/0600'dür. Dosya başka bir klasöre kopyalanmamalı, elle düzenlenmemeli ve web sunucusundan servis edilmemelidir. .zee/ kaynak kontrolünde ve temiz kaynak arşivinde yok sayılır; klasör silinirse bütün oturumlar ve oran pencereleri bilinçli olarak sıfırlanır. Yedek alınacaksa dosya izinleriyle birlikte özel runtime durumu olarak korunmalıdır.

Bu adaptör aynı makine veya güvenilir, kilit ve atomik replace semantiği aynı olan ortak dosya sistemi içindir. Birden çok host için vaat edilen harici depo adaptörü henüz yoktur.

Proxy güven sözleşmesi

Reverse proxy:

  1. internetten yalnız HTTPS kabul eder;
  2. request'i bütünüyle buffer'lar ve kendi header/body/timeout sınırlarını uygular;
  3. istemciden gelen Forwarded, X-Forwarded-For ve benzeri proxy başlıklarını siler;
  4. backend'e tam olarak bir Forwarded: for=<kanonik-IP>;proto=https;host=panel.example başlığı yazar;
  5. özgün Hostu yapılandırılmış hosta, unsafe yöntemde Origini tarayıcıdan gelen tek değere bırakır;
  6. worker'lara yalnız loopback üzerinden erişir.

Runtime birden çok Forwarded başlığını, virgüllü proxy zincirini, IP olmayan for değerini, yanlış proto/hostu ve yalnız X-Forwarded-For taşıyan isteği reddeder. Rate-limit anahtarı ancak bu doğrulamadan sonra oluşan kanonik IP'dir. Loopback dışı peer, doğru görünen başlıklar taşısa bile 403 ile reddedilir.

Kanonik origin

--web-proxy, Host, Forwarded host ve unsafe Origin aynı AgHedefi parser'ından geçer. Ayrı bir CLI origin parser'ı yoktur. Geçerli örnekler:

text
https://panel.example
https://panel.example:8443
https://[2001:db8::1]:8443

DNS adı büyük/küçük harfe duyarsızdır; https://PANEL.EXAMPLE:443/ kanonik olarak https://panel.example olur. IPv4/IPv6 standart metinsel yazımına çevrilir. Farklı port farklı origin'dir. HTTP, kullanıcı bilgisi, yol/sorgu/parça, geçersiz DNS etiketi, ayraçsız IPv6 ve 0 ya da 65535'i aşan port fail-closed reddedilir. Proxy Forwarded host değerini yapılandırılmış kanonik otoriteyle kurmalıdır.

Sabit oran ve süreler

KapıPencereEşikAşım
Aynı istemci + yöntem + sorgusuz path60 sn100429
CSRF doğrulaması60 sn60429
Argon2id parola doğrulaması300 sn5Argon2id çalışmadan 429

Oturum 30, anonim form oturumu 10 dakika mutlak ömürlüdür. Erişim ömrü kaydırmaz. K-330: ana proje.dil kimlikli oturum ömrünü oturum_ömrü_saniye N olsun (300–2592000 sn) ile seçebilir; oturum_kayar doğru olsun her kimlikli istekte geçerliliği şimdi + Ne taşır ve çerezin Max-Age'ini yeniler, ama oluşturmadan sayılan 30 günü aşamaz. Anonim oturum ve çıkış davranışı değişmez. Oturumlar .zee/web-durumu-v1.json içinde kaldığından worker yeniden başlatma ve dağıtım kullanıcıyı düşürmez; bu dosyayı dağıtımda silmeyin (ADR-158). Toplam oturum 4096, anonim oturum 1024, canlı rate anahtarı 32768 ile sınırlıdır. Kalıcı depo okunamaz/bozuksa veya kapasite güvenle yönetilemiyorsa istek fail-closed 503 olur.

Reverse proxy buffering Slowloris etkisini internet sınırında keser; backend ayrıca bağlantı kabulünden başlayan 10 saniyelik mutlak request okuma ve 30 saniyelik Zee request çalışma deadline'ı taşır. Benchmark sonuçları process başına tek worker gerçeğiyle yorumlanmalı; -c 100 tek bir process'te 100 paralel uygulama yürütümü vaat etmez.

K-140'tan itibaren backend request-line, başlık ve gövdeyi ham byte parser'da doğrular. Proxy backend'e yalnız CRLF satırlı, origin-form hedefli, tek Content-Length taşıyan ve Transfer-Encoding taşımayan HTTP/1.0/1.1 isteği göndermelidir. Chunked aktarım, obs-fold, pipelining, UTF-8 dışı/NUL gövde ve duplicate CL desteklenmez. Her yanıt Connection: close ile bağlantıyı sonlandırır.

K-218 / ADR-089: explicit --web-oran-deposu bellek seçimi yalnız oran durumunu süreç başına sınırlı Arc/Mutex deposuna taşır. Varsayılan dosya backend'i ve kalıcı oturum/revoke paylaşımı sürer; ayrı worker/restart için ortak proxy kotası gerekir. Soak sürücüsü her dönemde 32768 anahtar doldurup süre dolumuyla temizler; yeni tampon derleyici RSS'ine dahildir. Sabit benchmark korpusu ve eski performans tarihçesi değiştirilmedi. Katman sahibi web_guvenligi'dir; bin_soak bu sahibe tek ileri kenar ekler.

Bellek kipine geçiş için .zee dosyası silinmez: oturumlar korunur. Eski dosya oran kayıtları bellek kotasına aktarılmaz; backend değişimi yeni süreç kotası başlatır. Karışık backend kullanan worker'lar ortak kota sağlamaz. Cookie'li istekler taze oturum/LRU kontrolü için kalıcı dosyaya erişmeye devam eder; bu iş bütün web dosya I/O'sunu kaldırdığı iddiasını taşımaz. Yeni bayrak ayrı worker başlatmalarının her birine verilmelidir.

K-219 / ADR-090: bellek backend’inde --web-oran-siniri 250, --web-oran-kapasitesi 32768, --web-oran-doluluk en-eski seçilebilir. Sınır IP+uç nokta başına 60 saniyedir; kapasite 1..32768, eşik 1..1000000. Varsayılan doluluk reddet; en-eski penceresi atılmış uç nokta kotası tekrar geldiğinde sıfırlanabilir. Login/CSRF canlı sayaçları asla tahliye edilmez; yalnız korunmuş kayıtlarla dolulukta yeni anahtar hâlâ 503 alır. Ortak proxy bütçesi ve ayrı worker/restart sınırı sürer. Ayarlar her worker’a verilir; canlı yeniden yapılandırma, sınırsız kapasite ve PostgreSQL backend’i yoktur.

K-220: form insan doğrulamasında POST doğrulaması kayıt/e-posta öncesinde yapılır. Native HTTPS başlıklı HTTP Sonucu, explicit http_gizli_değişkenleri ve kanonik HTTP JSON helper kullanılabilir. Yanlış hostname, JSON tür taklidi ve başarısız doğrulama reddedilir; erişim/bozuk yanıt kapalı başarısızlıktır. Ürün helper, karar. TLS/origin/IP/redirect sınırları korunur; canlı kurulum bu değişiklikte yapılmaz.

Kaynak: docs/web-production-profili.md · Bütün belgeler