Mimari
Minecraft Server Manager, tek süreçli, sunucu tarafından oluşturulan bir Node.js uygulamasıdır.
itzg/docker-minecraft-server görüntüsünü kullanarak Docker
kapsayıcıları olarak çalışan Minecraft sunucularını yönetir ve Docker daemon’ı ile API’si üzerinden konuşur
(asla docker CLI’sine kabuktan erişmez).
Çalışma zamanı yapısı
Bölüm başlığı “Çalışma zamanı yapısı”- Express + Handlebars sayfaları sunucu tarafında oluşturur. SPA yoktur;
public/js/içindeki tarayıcı JS’si elle yazılmış aşamalı geliştirmedir. Bir esbuild adımı (pnpm run build:js) onupublic/dist/js/içine paketler ve küçültür; uygulama, mevcut olduğunda bu paketi, aksi takdirde ham kaynağı sunar, böylece derleme olmadan bir geliştirme çalıştırması hala çalışır. node:sqlite(Node’a yerleşik; panel Node ≥ 24 gerektirir) veritabanıdır - senkron, sıfır yerel modül, WAL modu. Küçük bir sürümlü geçiş çalıştırıcısı, önyüklemedesrc/db/migrations/*uygular. Hazırlanmış ifadeler, SQL metnine göre anahtarlanmış olaraksrc/db/index.jsiçinde önbelleğe alınır.wscanlı konsol ve istatistik akışlarını taşır. Her ikisi de aracılıdır: her sunucu için bir yukarı akışdocker logs --follow(veyadocker stats), bir kez ayrıştırılır ve her bağlı sekmeye dağıtılır, her görüntüleyici için bir yukarı akış yerine. Konsol aracısı, geç katılan sekmeler için küçük bir tekrar arabelleği tutar ve paylaşılan akışı durdurmak yerine soketi çok geride kalan bir aboneyi düşürür.- dockerode, uygulamanın Docker ile konuşmasının tek yoludur. Uç nokta platforma göre otomatik olarak algılanır (Windows adlandırılmış boru vs. unix soketi).
- Tüm kalıcı durum tek bir dizin altında yaşar (
$DATA_DIR, varsayılan./data). Bu dizini kopyalamak tüm paneli taşır.
Katmanlama
Bölüm başlığı “Katmanlama”Bağımlılıklar tek yönde akar:
┌─────────────────────────────┐ HTTP ───────▶│ web/routes/* (+ middleware)│ girdiyi ayrıştır ve doğrula, yanıtları şekillendir └──────────────┬──────────────┘ │ ┌──────────────▼──────────────┐ │ services/* │ alan mantığı (gerçek özellikler) └───┬─────────┬─────────┬─────┘ │ │ │ ┌────────────▼──┐ ┌────▼────┐ ┌──▼──────────┐ │ docker/* │ │ db/* │ │ storage/* │ altyapı └───────────────┘ └─────────┘ └─────────────┘web/routes/- her alan için bir yönlendirici (players,worlds,crashes,blueprints,files, …).web/app.jsüst düzey olanları bağlar (api.js, çekirdek sunucu rotalarını tutarak sunucu başına alan yönlendiricilerini bağlayan oturum JSON API’si;index.js, sayfalar;auth,account,tasks, …). Yönlendiriciler zod ile doğrular, bir hizmeti çağırır ve JSON döndürür veya bir görünüm oluşturur. İş mantığı buraya ait değildir. İki yönlendirici,requireAuthöncesinde genel bölgeye bağlanır:routes/status.js(isteğe bağlı sunucu başına HTML durum sayfaları) veroutes/apiV1.js(/api/v1,services/apiTokens.jstarafından yönetici tarafından oluşturulan bir Taşıyıcı jetonla kimliği doğrulanmış salt okunur bir JSON API’si, Ayarlar’da etkinleştirilmedikçe kapalıdır; bkz.docs/public-api.md).services/- uygulamanın kalbi. Her hizmet bir alanı yönetir ve altyapıya ve diğer hizmetlere bağımlı olabilir.docker/- dockerode sarmalayıcıları:connect(uç nokta algılama + daemon sağlığı),containers(bağlama bağlamaları, bellek/CPU limitleri ve etiketlerle oluşturma/başlatma/durdurma/yeniden oluşturma),logs,stats,images,networks(ana bilgisayar ağı keşfi),hostPath(DATA_DIR_HOSTaltındaki bağlama yollarını yeniden köklendirir) ve Docker olaylarını geçmiş + çökme algılamasına dönüştüren birwatcher.db/- SQLite sarmalayıcısı ve geçiş çalıştırıcısı.storage/-./dataönyüklemesi, yol koruyucusu (safeJoin, dosya güvenliği omurgası) ve arka plan boyut dizinleyici + kota uygulaması.
Çapraz kesim:
config/- ortam yapılandırması artı alan kataloğu: sunucu ayarları için tek doğruluk kaynağı. Her itzg ortam değişkeni kataloglanır (etiket, yardım, tür, birim, varsayılan, doğrulama, bölüm, tehlike bayrakları). Sihirbaz, ayarlar formları ve zod doğrulaması hepsi bundan türetilir, bu nedenle yeni bir ayarı açığa çıkarmak bir veri değişikliğidir, yeni UI tesisatı değildir.events/-recordEvent()geçmiş günlüğü için tek giriş noktasıdır; yaşam döngüsü olayları ayrıca kapsayıcı günlüğü alıntılarınıdata/logs/<id>/events/içine yakalar.ws/- kimliği doğrulanmış konsol + istatistik WebSockets (yükseltmede oturum çerezi doğrulanır, siteler arası ele geçirmeyi engellemek içinOriginkontrol edilir), sunucu başına aracılı (bkz. “Çalışma zamanı yapısı”).logger.js+instrument.js-require('./logger')(label)modül başına bir Pino günlükçüsü döndürür;LOG_LEVEL’den seviye,makeFailureThrottle()kalıcı olarak başarısız olan bir arka plan döngüsünü bir günlük satırına ve bir “kurtarıldı” satırına tutar.src/utils/logSanitize.jskimlik bilgisi şeklindeki anahtarları ve webhook jetonlarını yapılandırılmış meta verilerden gizler;src/config/logLevel.jspaylaşılan seviye izin listesidir (configile bir require döngüsünü önlemek için ayrı tutulur).src/instrument.js,src/server.jsiçinde ilk yüklenen uyuyan bir Sentry dikişidir.src/web/middleware/requestLog.jsher istek için bir erişim günlüğü satırı yazar (/healthzve statik varlıkları atlar). ESLint,src/**altındano-console’ı zorlar,preflight.js,instrument.jsveconfig/index.jsmuaf tutulur (günlükçü var olmadan önce çalışırlar).- Hız sınırlama -
src/web/middleware/rateLimit.js,/api(RATE_LIMIT_API_PER_MIN, varsayılan 1200) ve giriş / 2FA / kurulum POST’larının önüneexpress-rate-limitkoyar (RATE_LIMIT_AUTH_PER_15MIN, varsayılan 100);0bir sınırlayıcıyı devre dışı bırakır.req.ip’ye göre anahtarlanır, bu nedenle bir proxy arkasındaTRUST_PROXYönemlidir./api/v1kendi sınırlayıcılarına sahiptir: jeton doğrulanmadan önce çalışan istemci IP başına bir üst sınır (jeton başına bütçenin beş katı), ardından doğrulanmış jetonun kimliğine göre anahtarlanmış jeton başına bir bütçe (RATE_LIMIT_PUBLIC_API_PER_MIN, varsayılan 120).src/web/middleware/auth.jsiçindeki ayrı bir hesap başına yumuşak sayaç, giriş kilitlemesini (IP başına ve hesap genelinde, azalan) ele alır. - Yetkilendirme: iki katman. Genel rol (
requireAuth→requireRole/requireWriteinsrc/web/middleware/auth.js) panel genelindeki eylemleri kilitler ve her sunucuda varsayılandır. Sunucu başına izinler (src/services/permissions.js,user_server_permissionsiçinde(kullanıcı, sunucu)başına bir JSON listesi olarak depolanan dokuz yetenek) bu varsayılanı bir sunucu için iyileştirir; her/api/servers/:idrotası, alt yönlendirici bağlaması, sayfa, WebSocket ve filo genelindeki listelemesrc/web/middleware/serverAccess.jsüzerinden geçer (serverScope, hem API’nin hem de sayfa yönlendiricisinin/servers/:idönekine bağlıdır,viewolmadan bir sunucuyu 404 olarak gizler;requireCap(cap)bir rotanın ihtiyaç duyduğu yeteneği adlandırır). Gövdesinde sunucularını adlandıran yazmalar (programlar, dünya çıkarma ve kurulum, şablon dışa aktarma) yalnızca o sunucu içinrequireWritetarafından görüntüleyiciler için açılır ve bu tür her rota yeteneği kendisi kontrol eder.test/permissions-routes.test.jscanlı yönlendirici yığınlarını dolaşır ve sunucu kapsamlı bir yazma rotası, bağlama veya sayfanın bir geçidi yoksa başarısız olur.
Temel alan davranışları
Bölüm başlığı “Temel alan davranışları”- Mod paketleri her zaman sabitlenir. Görüntü, her yeniden başlatmada sabitlenmemiş paketleri
otomatik olarak yükseltir, bu nedenle panel “en son”u kurulum zamanında somut bir sürüm kimliğine
çözümler ve sabitler. Yükseltmeler açıkça düzenlenmiş bir akıştır (
updates/): önizleme → güncelleme öncesi yedekleme → sorunsuz durdurma → yeniden sabitleme → yeniden oluşturma → sağlık izleme → tek tıklamayla geri alma. - Özel mod katmanı panel tarafından yönetilir: kullanıcı tarafından eklenen modlar,
tekilleştirilmiş kütüphaneye iner ve sunucuya sabit bağlantılarla bağlanır, böylece paket
güncellemelerinden sağ çıkarlar. Devre dışı bırakma sınıf farkındadır. Kütüphane indirdiği her
yapıyı tuttuğu için, bir güncelleme değiştirdiği yapıyı (
server_content.previous_*) kaydeder ve yalnızca yerel dosyalardan geri alınabilir. Bir paket modunu devre dışı bırakmak, paketin hariç tutma ortam değişkenini yazar;packs.applyPackbunu ve paketin geri kalan ayarlarını (PACK_TUNING_KEYS) aynı paketin sürüm değişikliği boyunca taşır ve paket değiştiğinde düşürür. - Bir Minecraft sürüm yükseltmesinin kazanılması gerekir.
services/compat.jsbir sunucunun modlarını tarar - panel tarafından yüklenen satırlardan, ardından CurseForge paket manifestosundan, ardından Modrinth/CurseForge’a karşı içerik karmasıyla çözümlenir - ve CurseForge’unlatestFilesIndexes(istek başına 200 proje) ve Modrinth’in proje başına sürüm listesinden (proje başına bir istek, bu da yükleyici ve sürümün eşleşmesini sağlar) proje başına bir (yükleyici, Minecraft sürümü) destek matrisi oluşturur. Güncelleme denetleyicisi yalnızca HER modun desteklediği en yeni sürümü sunar ve yanıt belirlenemediğinde hiçbir şey sunmaz: tarama yok, farklı bir sürüm veya yükleyici için tarama, hiç bitmeyen bir tarama veya hiçbir kayıt defterinin tanımadığı bir jar. Taramalar yalnızca manueldir ve ilerlemeleri ve kısmi sonuçlarıversion_compatiçinde yaşar (bellektekiservices/tasks.jsiçinde değil), bu nedenle bir yenileme veya panel yeniden başlatma bir dönen simgede takılı kalmak yerine devam eder;reconcileScans()bir kapatma tarafından yetim bırakılan taramaları bir sonraki önyüklemede işaretler. - Mod yükleyici sürümü, diğer her şey gibi bir sabittir.
services/loaderPin.js, görüntünün kendi kurulum manifestosundan (.forge-manifest.jsonve benzerleri) kurulu yapıyı okur ve sabiti yazar: düz bir sunucuda yükleyicinin itzg değişkeni (FORGE_VERSION, …) veya Forge veya Fabric CurseForge paketindeCF_MOD_LOADER_VERSION, bu da paketin bildirdiği sürümü geçersiz kılar. Görüntünün CurseForge yükleyicisi NeoForge için bu geçersiz kılmayı yok sayar ve Modrinth ve FTB paketlerinin hiçbiri yoktur, bu nedenle yükleyicileri paketi takip eder.packs.applyPack, bir paket güncellemesi veya geri alma işleminde herCF_değişkenini kaldırır, bu da bir geçersiz kılmayı diğerleriyle birlikte düşürür. Yazılı bir yapı, önce kayıt defterinin tam listesine karşı kontrol edilir (services/loaderVersions.js; Forge’unki maven meta verilerinden gelir, bu da sayıları atlar; bir eksiklik kayıt defterinin kendisine karşı bir kez daha kontrol edilir), ardından değişiklik yedekleme → sabitleme (yedeklemeden sonraki ortam üzerinden) → yeniden oluşturma şeklindedir. - Portlar bir temel şemadan tahsis edilir (oyun
PORT_GAME_START’tan yukarı, RCON = oyun +PORT_RCON_OFFSET, BedrockPORT_BEDROCK_START’tan), kullanılabilirlik için kontrol edilir ve DB’de rezerve edilir. “Alınmış” olan, her sunucunun taleplerinin (canlı portlar, artı aşağıda bekleyen bir çift), herhangi bir Docker kapsayıcısının yayınladığı her ana bilgisayar portunun (containers.publishedHostPorts: çalışan kapsayıcıların canlı bağlamaları artı durdurulmuş her kapsayıcının yapılandırılmış olanları, çünkü panelin kendi kapsayıcısından bir işletim sistemi bağlama kontrolü yalnızca o kapsayıcının ağ ad alanını görür) ve işletim sistemi kontrolünün birleşimidir. Docker kısmı 3 saniye önbelleğe alınır ve sınırlıdır: 2.5 saniyede yanıt vermeyen bir liste yalnızca Docker kısmını düşürür ve yavaş bir inceleme yalnızca o kapsayıcının portlarına mal olur. Sunucu oluşturmaları veservers.changeGamePort, yalnızca seçimi ve talebini (bir oluşturma için satır yazma, bir port değişikliği için bellekteki rezervasyon) kapsayan tek bir serileştirme zinciri aracılığıyla portları seçer; BlueMap’in port seçicisi ve ekstra port geçersiz kılmaları içinde değildir ve Docker’a danışmaz. Mevcut bir sunucuda bir port değişikliği (sunucunun işlem kilidi altındaservers.changeGamePort), Docker port bağlamalarını kapsayıcı oluşturmada sabitlediği için hemen uygulanır: yeni çift (RCON her zaman oyun +PORT_RCON_OFFSET) kontrol edilir ve port kilidi altında bellekte rezerve edilir (ports.reserve, hem eski hem de yeni çift, diğer her seçim tarafından onurlandırılır). Diğer ayarlar yeniden oluşturmayı beklerken reddedilir (409PENDING_CHANGES), bu nedenle yalnızca zaten çalışan bir kapsayıcıyı yeni bir portta yeniden oluşturur; ve çalışan bir sunucu yalnızca istekrestart: truedediğinde değiştirilir (aksi takdirde 409NEEDS_CONFIRM). Görüntü çekilir ve özel bir kapsayıcı adı, herhangi bir şeye dokunulmadan önce kontrol edilir. Çalışan bir sunucu durdurulur; ardından yeni çiftpending_recreate = 1ile yazılır (böylece oradan bir panel çökmesi dürüst bir “yeniden oluşturma bekleniyor” bırakır), kapsayıcı kaldırılır, yeni çiftte yeniden oluşturulur ve başlatılır. Durdurmadan sonra herhangi bir adım başarısız olursa,putBackOnOldPorteski çifti geri yazar, üzerinde yeniden oluşturur (ve çalışıyorsa yeniden başlatır) ve hangi adımın başarısız olduğunu kaydeder; geçmiş ve uyarılar, bunun bile başarısız olup olmadığını söyler, bu da sunucuyu biri başlatana kadar durdurulmuş bırakır.settingsyeteneği yeterlidir, çalışan sunucu dahil. Yönetici olmayanlar yalnızcaPORT_GAME_START’tan yukarı seçebilirler. (Geçiş 029’dakiport_*_pendingsütunları daha önceki, yayınlanmamış bir tasarıma aittir ve kullanılmaz; 031 onları temizler.) Bir kilit çakışması 409 ilecode: 'BUSY'yanıtlar, bu da aşağıdaki yeniden deneyen çağırıcılar tarafından kelime yerine kontrol edilir. Bir çökme otomatik yeniden başlatması (watcher.restartAfterCrash) ve başka bir eylemle meşgul olan sunucuyu bulan zamanlanmış bir yedekleme veya başlatma (scheduler.runTaskWithRetry), 30 dakikaya kadar her 20 saniye / 60 saniyede bir tekrar dener ve bir paket güncellemesi veya geri alması kilitli adımlarını aynı şekilde yeniden dener (opLock.retryWhileBusy); bir çökme yeniden başlatması veya bekleyen zamanlanmış bir başlatma, biri sunucuyu durdurduğundan, öldürdüğünden veya başlattığından beri vazgeçer (events.lifecycleActionSince) ve çökme yeniden başlatması ayrıca otomatik yeniden başlatma kapalı olduğunda veya sunucu gittiğinde de vazgeçer. Zamanlanmış yeniden başlatmalar, durdurmalar ve komutlar yeniden denenmez ve son çalışması hala bekleyen bir program bir sonraki tetiklemesini atlar. - Disk kotaları panel tarafından uygulanır çünkü Docker bağlama bağlama kullanımını sınırlayamaz: dizinleyici dizin başına boyutları önbelleğe alır ve disk büyütme işlemleri bunlara göre kilitlenir.
- Sırlar (RCON şifreleri, API anahtarları, TOTP sırları, Discord webhook URL’si)
AES-256-GCM kullanılarak
$DATA_DIR/.secret-keyadresinde özel bir rastgele anahtarla şifrelenir (0600modu, otomatik olarak oluşturulur).SESSION_SECRET’ten bağımsızdır;SESSION_SECRET’ten türetilmiş bir anahtar, özel anahtar var olmadan önce yazılan değerler için yalnızca şifre çözme yedeklemesi olarak tutulur vesrc/services/secretsMigration.jsbunları önyüklemede bir kez özel anahtar altında yeniden şifreler. Var olan ancak ayrıştırılamayan bir.secret-keysert bir önyükleme hatasıdır (asla sessizce yeniden oluşturulmaz). Şablonlar dışa aktarmada tüm sırları kaldırır. server.propertiespanel tarafından yönetilir ancak env tarafından gölgelenir. itzg görüntüsü, her başlangıçta her env destekli özelliği yeniden onaylar (OVERRIDE_SERVER_PROPERTIESvarsayılan olarak doğrudur), bu nedenle panelin doğrudan düzenlediği bir değer - Dünya Kontrolleri PvP/zorluk, beyaz liste geçişi, Dosyalar düzenleyicisi - eşleşen env değişkeni kaldırılmadıkça ve kapsayıcı yeniden oluşturulmadıkça bir sonraki başlangıçta sessizce geri alınır. Her doğrudan özellik yazımı,src/services/servers.jsiçindekiwriteServerProperties()(tüm dosya) veyasetServerProperty()(bir anahtar) aracılığıyla gerçekleşir, bu da dosyayı atomik olarak yeniden yazar, değiştirilen her anahtarın arkasındaki env değişkenini kaldırır (katalog alanlarındakiprop:özniteliği aracılığıyla, görüntünün kendi özellik tanımlarına karşı testlerde kontrol edilir) vepending_recreatebayrağını ayarlar. Zorluk, dosyaya yazıldığı gibi RCON üzerinden de gönderilir, çünkü özel bir sunucu her önyüklemededifficultyözelliğini yeniden uygular. Minecraft’ın kendisi,whitelist on/offüzerinde önyükleme zamanı değerlerinden server.properties’i yeniden kaydeder, bu da sunucu çalışırken yapılan düzenlemeleri geri alırdı, bu nedenle çalışan beyaz liste geçişi önce dosyayı anlık görüntüler ve yalnızcawhite-listdeğiştirilmiş olarak geri yazar. Env değişkenleri oluşturma sırasında tamamen yapılandırılabilir kalır (sihirbaz onları oluşturur ve bir kez uygulanırlar); yalnızca panel temel özelliği ilk kez düzenlediğinde sabitlemeyi kaldırırlar. MOTD aynı sözleşmedir: doğrudan birmotddosya düzenlemesi onu kaldırır, bu nedenle son yazım kazanır.
Veri ve kablo formatları
Bölüm başlığı “Veri ve kablo formatları”data/panel.db- SQLite veritabanı. Günlük olarakVACUUM INTOaracılığıyladata/backups/_panel/içine anlık görüntülenir (en yeni 14’ü tutulur);PRAGMA integrity_checkönyüklemede çalışır.data/.session-secret-SESSION_SECRETayarlanmamışsa ilk çalıştırmada oluşturulan otomatik olarak oluşturulan çerez imzalama sırrı. Silinmesi sırrı döndürür (bu da oturumları geçersiz kılar).data/.secret-key- ilk çalıştırmada otomatik olarak oluşturulan özel 32 baytlık depolama şifreleme anahtarı (0600modu).SESSION_SECRET’ten bağımsızdır; silinmesi depolanan her kimlik bilgisini şifre çözülemez hale getirir, bu nedenle yedeklerinizle birlikte olmalıdır.- Şablonlar (
.mcserver.zip) - yapılandırmayı, kaynakları, sabitlenmiş paket referansını, katman manifestosunu (kaynak URL’leri + sha256), seçilen yapılandırma dosyalarını ve isteğe bağlı olarak bir dünyayı açıklayan birmanifest.jsoniçeren bir zip. İçe aktarma, her modu yeniden indirir ve karma doğrulaması yapar ve yeni portlar atar. - Panel tarafından oluşturulan Docker kapsayıcıları adlandırılır ve etiketlenir, böylece izleyici onları bulabilir; panel tüm yaşam döngülerini yönetir.
Önyükleme sırası
Bölüm başlığı “Önyükleme sırası”- Her şeyden önce
require('./instrument')(Sentry dikişi), ardından desteklenmeyen bir Node sürümünde açıkça başarısız olmak içinrequire('./preflight'). - Yapılandırmayı yükle;
.session-secretve.secret-key’yi sağla/oluştur. ensureDataRoot()-./datadüzenini oluştur,tmp/’yi sil.- DB geçişlerini çalıştır, ardından
PRAGMA integrity_check(yüksek sesle günlüğe kaydeder, başarısızlık durumundadata/backups/_panel’i işaret eder). - Eski
SESSION_SECRETanahtarlı sırları.secret-keyaltında yeniden şifrele (secretsMigration). - API anahtarlarını ortamdan bir kez içe aktar (
apiKeys.importFromEnvOnce()), hala sabitlenmemiş bir mod paketi seçici taşıyan herhangi bir sunucuyu sabitle (packPins.pinUnpinnedServers()), önceki bir işlem tarafından çalışır durumda bırakılan sürüm uyumluluk taramalarını kesintiye uğramış olarak işaretle (compat.reconcileScans()), ardından başlangıç şablonlarını tohumla (korumalı). - HTTP + WS sunucusunu başlat. Açıkta bir bağlamada, ilk çalıştırma
/setupPIN’ini yazdır. - Önyükleme sonrası çalışma zamanı koruyucusunu yükle (yakalanmayan hataları yakalar;
MSM_EXIT_ON_FATAL=1denetimli dağıtımlar için sert çıkış yapar). - Arka plan hizmetlerini başlat: WS aracısı, depolama dizinleyici, çökme + envanter izleyicileri,
zamanlayıcı, Discord olay köprüsü, sohbet botu erişim izleyicisi ve günlük bakım zamanlayıcısı
(eski analiz satırlarını, sohbet botu transkriptlerini, olay geçmişini (365 gün) ve API önbellek
satırlarını buda, ardından
panel.db’yi anlık görüntüle). - Docker’ı arka planda başlat. Daemon kapalıyken UI tamamen kullanılabilir; Docker özellikleri
erişilebilir hale geldiğinde yanar. Bağlandıktan sonra,
refreshStatuses({ boot })önbelleğe alınmış durumları uzlaştırır, panel yeniden başlatılmadan önce çalışan ve geri getirilemeyecek bir sunucu için bir kerelikoffline-after-restartolayı yayar ve önyükleme döngüsüauto_startsunucularını başlatır ve kesinti sırasında çökmüş bulunanauto_restartsunucularını kurtarır (çökme döngüsü geri çekilmesine saygı göstererek).
Enstrüman-öncesi-ön kontrol sırası kasıtlı bir takasdır: gelecekteki bir Sentry kablolamasının çalışma zamanını önce yamalamasına izin verir, gerçekten eski bir Node’da biraz daha az dostça bir mesajın maliyetiyle.
Derleme hattı
Bölüm başlığı “Derleme hattı”pnpm run build = build:css (Tailwind → public/css/app.css) + build:js (esbuild →
public/dist/js/, kod bölmeli ESM). postinstall yalnızca CSS çalıştırır. public/css/app.css
ve public/dist/ gitignore edilmiş derleme yapıtlarıdır; Dockerfile derleme aşaması tam
pnpm run build komutunu çalıştırır ve public/ dizinini çalışma zamanı görüntüsüne kopyalar.
Statik varlıklar parmak izli dosyalar için immutable/uzun önbellek, CSS/JS için kısa önbellek ve
HTML ve /api için no-cache olarak sunulur.