Paket Deposu Sunucusu

Nucora Linux ST 3.0 — Obsidian Engine | Resmî teknik dokümantasyon

Nginx statik repo yapısı, indeksler, cache, CORS ve telemetri proxy tasarım notları.

Komutları güvenli çalıştır

Örneklerdeki paket ve aygıt adlarını kendi sisteminle karşılaştır. Root yetkisi gerektiren işlemlerde komutun etkisini ve hedef yolu doğrulamadan devam etme.

Repo dosya ağacı

/var/www/repo/lfs/
├── packages.list
├── index.json
├── packages/
├── testing/{packages.list,index.json,packages/}
└── unstable/{packages.list,packages/}

Stable’de yaklaşık 433 paket ve 2.5 GB toplam .nux boyutu belirtilmiştir; bu değer anlık disk kullanım garantisi değildir.

İndeksler

packages.list düz metin client indeksi, index.json web sitesi/istemci tüketimine yönelik JSON olarak açıklanmıştır. Her ikisi aynı paket envanterini göstermeli. nux-reindex .nux dosyalarını tarayıp indeksleri üretir; yayın esnasında indeksin yarım yazılmasını önlemek için geçici dosya/atomik rename stratejisini gerçek uygulamada doğrula.

Nginx ve cache

Nginx 1.22.1 ve Cloudflare kullanımı verilmiştir. Uzun ömürlü cache immutable, sürümlü paket dosyalarına uygundur; indekslerde kısa TTL veya revalidation/ETag gerekir. index.meta.json ETag, SHA256 ve timestamp tutar. Purge ve stale cache davranışını gerçek Cloudflare zone policy’siyle teyit et.

CORS ve HTTPS

Tarayıcı tabanlı site JSON indeksine farklı origin’den erişecekse sadece gerekli origin, method ve header’lara izin ver. Paket indirme endpoint’ine herkese açık * CORS eklemek gerekmez. HTTPS/Certbot/Cloudflare SSL katmanlarında origin sertifika ve proxy mode’u tutarlı yapılandır.

Telemetri proxy

Repo alanında telemetri proxy’si nux-intake port 9377’ye yöneltilir. Backend portunu doğrudan internete açmak yerine Nginx üzerinden rate-limit, body-size limiti ve request log redaksiyonu uygula. Endpoint sözleşmesi /api/v1/telemetry ve /api/v1/telemetry/tester olarak verilmiştir.

Örnek değil, canlı config gerekir

Bu spesifikasyon gerçek server block, origin IP, TLS sertifika yolu veya cache key değerlerini sağlamıyor. Üretime kopyalanacak Nginx yapılandırmasıymış gibi uydurma ayar yayımlama; nginx -t ve staging doğrulaması yap.

Güvenli uygulama akışı

Bu sayfadaki Paket Deposu Sunucusu adımlarını uygularken önce mevcut durumu kaydet; ilgili sistemde nux update komutunun kullanılabilirliğini ve yardım metnini doğrula. 1. Hedef cihazın ST sürümünü, x86_64 mimarisini, aktif kanalı ve gerekli disk alanını doğrula. 2. Geri alınması zor işlem öncesinde kullanıcı verisini yedekle ve cihazı kararlı güç kaynağına bağla. 3. Tek seferde tek değişiklik uygula; komut, zaman, çıkış kodu ve sonucu not et. 4. Başarısızlık halinde işlemi tekrarlamadan önce tam logu ve son başarılı durumu sakla. 5. Sonucu nux doctor, ilgili bileşen sorgusu ve gerçek kullanıcı senaryosuyla doğrula.

ST 3.0 referans matrisi

Bileşen	Verilen referans
Sürüm / kod adı	ST 3.0 / Obsidian Engine
Taban / mimari	Saf LFS / x86_64
Kernel / init	linux-nucora 6.4.12 / SysVinit
libc / derleyici	glibc 2.39 / GCC 14.2.0
Masaüstü / görüntü	XFCE 4.20, Xfwm4 / Xorg
Paket yöneticisi	nux 8.4.10; Go
Bellek / depolama	Boşta ~450 MB; minimum 2 GB RAM, 15 GB disk
Paket envanteri	stable 433; testing 46 (sağlanan sayılar)

Değişiklik sonrası doğrulama

Beklenen dosya/paket/ayar doğru yerde ve doğru sürümde.
İlgili servis, masaüstü oturumu veya ağ bağlantısı yeniden çalışıyor.
Paket veritabanı tutarlı; nux doctor yeni hata üretmiyor.
Loglarda checksum, bağımlılık veya izin hatası yok.
Geri dönüş yolu ve yedeğin okunabilirliği biliniyor.

Hata ayırma matrisi

Belirti	İlk kontrol	Güvenli sonraki adım
Paket bulunamıyor	`nux channel`, `nux repo list`	İndeksi yenile; gerçek paket adını ara.
Hash uyuşmuyor	Arşiv SHA256 ve repo metadata	Arşivi kurma; kaynağı/indeksi doğrula.
Bağımlılık eksik	`nux check-deps`, `nux info`	Sağlayıcıyı belirle; rastgele dosya kopyalama.
Sistem beklenmedik	History ve son log	Yeni değişiklik yapmayı durdur; yedekle ve raporla.

Güvenlik sınırları

Arşiv, recipe, maintainer script veya tester anahtarını güvenilir kaynaktan doğrulamadan root ile çalıştırma.
.nux checksum uyuşmazlığını görmezden gelme; hash düzeltme aracı kaynağın güvenilirliğini kanıtlamaz.
/var/lib/nux/ veritabanını elle düzenleme veya snapshot dosyalarını doğrulamadan silme.
-y bayrağını özellikle remove/upgrade işlemlerinde etkisini anlamadan kullanma.
Rapor ve ekran görüntülerinden parola, anahtar, kişisel dosya yolu ve token’ları ayıkla.

İlgili sayfalar

Dokümantasyon ve ürün verisi notu

Bu içerik proje tarafından sağlanan ST 3.0 tanımına dayanır; burada açıklanmayan endpoint, environment variable, CLI flag, canlı checksum veya otomatik downgrade davranışı varsayılmaz. Sistemde gözlenen davranış bu metinle çelişirse önce nux --version, aktif repo indeksi ve kaynak kodu/release notlarını karşılaştır; doğrulanmış düzeltmeyi issue veya değişiklik günlüğüne ekle. Bu sayfanın konusu: paket deposu sunucusu. Üretim sistemlerinde değişiklikleri önce test kanalında veya yalıtılmış ortamda doğrula.

İşlem kaydını hazırlama

Destek veya bakım kaydı açarken dağıtım sürümünü, mimariyi, aktif kanalı ve etkilenen paket sürümünü ekle. Komutu kopyalayıp yapıştırmak yerine hedef dosya ve aygıt adlarını önce gözden geçir. Birden fazla adım varsa her adımın çıktısını ayrı sakla; sorunun ilk görüldüğü zamanı not et. Başarılı sonucu yalnızca komutun çıkış koduyla değil, beklenen işlevi test ederek doğrula. Kişisel verileri ve gizli anahtarları paylaşmadan önce logları redakte et. Bu sayfadaki sürüm bilgilerini yeni release çıktısıyla karşılaştırarak güncel tut.