sshpocket paketi (kimlik utility; repo adı şimdilik kurulum): iki iş bir arada.
- Sunucu ayarları: saat dilimi, sistem dili (
LANG) ve NTP (chrony) menüden, önizleyerek, yedekleyerek ve onayla. Ayrıntı: docs/saat-dil-ntp.md (eskiutilityv0.1.2 belgesi) ve aşağıdaki NTP bölümü. - Kurulum merkezi: Docker taban kurulumu, nginx, MariaDB ve Redis (her biri native ya da Docker modunda), önizleyerek, sürümü sabitleyerek ve veriyi silmeden.
Durum: v0.2.0 (birleştirme sürümü; yayın öncesi). Eski
utilitypaketi (v0.1.2) bu pakete taşındı. Kimlikutilityolduğundan sonuç satırı önekiutility.*oldu (kurulum eylemleri artıkutility.kurvb.). Denenmedi (gerçek VM): birleştirilmiş paket,ntp_durum/ntp_ayarla, chrony ilesystemd-timesyncdbirlikte etkinken davranış,utility/durumanahtar uyumunun sshpocket tarafında. Kurulum eylemleri için v0.1.0 notları geçerli: LAB tam, gerçek VM turu kısmen (docs/vm-turu.md); V01–V05 düzeltmeleri ve hardening'li tur gerçek VM'de doğrulanmadı. Utility eylemleri v0.1.2'de Ubuntu 26.04 ve Debian 13.7'de gerçek VM'de denendi (docs/saat-dil-ntp.md).
| Profil | Durum | Not |
|---|---|---|
ubuntu-26.04 |
supported | Sunucu ayarları (utility eylemleri): LAB ve gerçek VM. Kurulum eylemleri: LAB'da (arm64 konteyner) ve kısmen gerçek VM'de (amd64, ubuntutest, doğrudan playbook, hardening'siz); VM turu sürüyor |
debian-13 |
supported | Yalnızca sunucu ayarları (utility eylemleri), Debian 13.7'de tek gerçek VM'de denendi. Kurulum eylemleri (kur/yukselt/kaldir/kurulum_*) Debian 13'te DENENMEDİ: kurulum_planned_os gereği ön kontrol "planned" der ve durur (aşağıdaki not) |
Proxmox VE bilerek reddedilir (/usr/bin/pveversion ya da /etc/pve varsa --check dahil durur); Raspberry Pi kapsam dışı.
Sunucu ayarları (eski utility; eylem adları, anahtarlar ve davranış değişmedi):
| Eylem | Etki | Onay | Ne yapar |
|---|---|---|---|
durum |
salt okunur, sudo yok | – | timezone=… locale=… ntp_servis=… ntp_senkron=… offset_ms=… kaynak_sayisi=… sapma_ms=… secili_kaynak=… saat_sapma_kontrolcuye_gore_sn=…. sshpocket'in sunucu ekleme sihirbazı ve bağlantı testi bunu çağırır: anahtar adları korunur, yalnızca eklenebilir |
preview |
salt okunur (--check --diff) |
– | Saat dilimi/locale/NTP planı: degisen=<N> plan=… |
apply |
installs-package, changes-config |
yes-no, preview ön koşul |
Önce yedek, sonra saat dilimi + locale + NTP + saat adımlama |
geri_yukle |
changes-config |
yes-no |
Yedekten dosyaları geri yazar |
ntp_durum |
salt okunur, sudo yok | – | Yeni. durumun NTP kısmının ayrıntılısı: hizmetler= (etkin zaman hizmetleri: chrony, systemd-timesyncd, ntp, ntpsec, ntpd-rs; yoksa yok), yonetilen_kaynak= (utility.sources satırı), proxmox=evet|hayir |
ntp_ayarla |
installs-package, changes-config |
yes-no, preview ön koşul |
Yeni. Yalnızca NTP: chrony kurar, utility_ntp_servers kaynaklarını drop-in'e yazar, gerekirse tek seferlik saat adımlar; saat dilimi ve locale'a dokunmaz. Yedek alır (geri_yukle geri alır). Proxmox'ta --check dahil reddedilir |
Kurulum merkezi (eski kurulum; eylem adları değişti: sonuç öneki utility.*, durum/preview kurulum karşılıkları yeniden adlandırıldı):
| Eylem | Etki | Onay | Ne yapar |
|---|---|---|---|
kurulum_durum |
salt okunur | – | Ana klasör işareti, Docker durumu, kurulu yazılımlar ve portlar: ana_durum=… docker=… kurulu=… portlar=… (eski kurulum/durum) |
kurulum_onizle |
salt okunur (--check --diff) |
– | kur'un aynı görevleri --check ile; degisen=<N> yukseltme=evet|hayir (eski kurulum/preview; kur/yukselt/kaldir bunu ön koşul ister) |
kur |
installs-package, changes-config |
yes-no, kurulum_onizle ön koşul |
Seçili yazılımı kurar. İkinci çalıştırma changed=0. Sürümü sessizce değiştirmez |
yukselt |
+ destructive |
type-server-name, kurulum_onizle ön koşul |
Yalnızca docker modunda, daha yeni sürüme; önce döküm/yedek. Geri düşürme yok |
kaldir |
changes-config |
yes-no, kurulum_onizle ön koşul |
Servisi durdurur/kaldırır; veriye dokunmaz |
Kurulum çıktısı tek satırdır: SSHPOCKET_RESULT utility.<eylem> yazilim=… mod=… surum=… port=… degisen=… yukseltme=… gizli=<üretilen parola sayısı>. Parola değeri hiçbir satıra yazılmaz. Envanter grubu utility (eski kurulum grubu kurulum idi).
- Tek sahip: yalnızca chrony yazılır (
/etc/chrony/sources.d/utility.sources,chrony.conf'a dokunulmaz).systemd-timesyncd/ntp/ntpseckapatılmaz: biri chrony ile birlikte etkinsentp_durumbunuhizmetler=a+bile gösterir, karar sizindir. Debian 13'te chrony kurulumu timesyncd'yi paket çakışmasıyla kaldırmıştı (v0.1.2 VM turu); Ubuntu 26.04'te birlikte davranışı denenmedi. - Değişkenler: mevcut
utility_ntp_servers,utility_ntp_makestep,utility_ntp_clock_from_controller(yeni değişken yok). - Proxmox VE:
ntp_ayarla(ve diğer yazan eylemler)/usr/bin/pveversionya da/etc/pvevarsa--checkdahil reddedilir ve hiçbir şey değişmez: Proxmox kümelerinde (corosync) saat ayarı kritiktir, bu pakette yok.ntp_durumyalnız okur veproxmox=evetder. Proxmox bu sürümde kapsam dışıdır. ntp_ayarlaiçinpreviewön koşuldur;previewtüm planı (saat dilimi, locale, NTP) gösterir,ntp_ayarlayalnız NTP kısmını uygular.
Sunucu ayarları değişkenleri (utility_timezone, utility_locale, utility_ntp_servers, utility_ntp_clock_from_controller, utility_ntp_makestep, utility_backup, utility_restore_from): tür, varsayılan ve anlamları docs/saat-dil-ntp.md içinde.
Kurulum değişkenleri:
| Değişken | Tür | Varsayılan | Anlamı |
|---|---|---|---|
kurulum_yazilim |
enum | docker |
docker (taban) · nginx · mariadb · redis. Eylemler seçili yazılım için çalışır |
kurulum_mod |
enum | native |
native (apt) · docker. docker yazılımı için yok sayılır. Bir yazılım için tek mod |
kurulum_ana_klasor |
path | /srv/homelab |
Docker uygulamalarının klasörü; sunucu başına bir kez (aşağıda) |
kurulum_docker_kaynak |
enum | resmi |
resmi (download.docker.com) · dagitim (docker.io) |
kurulum_dis_erisim |
bool | false |
false = 127.0.0.1; true = 0.0.0.0 (uyarı çıkar, ufw'ye yazılmaz) |
kurulum_<yz>_port |
int | 8080 / 3306 / 6379 | Sunucuya yayınlanan port |
kurulum_<yz>_surum |
enum | 1.30.6 / 11.4.13 / 7.4.12 | Küratörlü imaj sürümü (docker modu; latest yok) |
kurulum_<yz>_imaj_ozel |
string | boş | Listede olmayan sürüm: nginx:1.31.8. Denenmemiştir; latest/etiketsiz reddedilir |
Küratörlü sürümler (artan; paket sürümüyle gelir): nginx 1.30.6, 1.31.8 · mariadb 10.11.19, 11.4.13, 11.8.9 · redis 7.2.17, 7.4.12, 8.2.11, 8.4.8. Parola/anahtar değişkeni yoktur.
- Docker kontrolü: kurulu değil →
kurulum_yazilim=dockerile kurulur; apt'ten kurulu (docker-ce ya da docker.io) → dokunulmaz; snap/paket dışı → uyarı, dokunulmaz ve Docker modu çalışmaz. Kullanıcıdockergrubuna eklenmez (root-eşdeğeri); komutlar sudo ile.daemon.jsonve/var/lib/dockerdeğişmez. Docker modu için Docker önceden kurulu olmalı (uygulama kurulumu Docker'ı kendiliğinden kurmaz). - Docker kaynağı: varsayılan Docker'ın resmi apt deposu. Depo anahtarı pakette gelir (
roles/docker_taban/files/docker.asc), parmak izi sabit (9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88, testle denetlenir); ağdan anahtar indirilmez. Yedek yolkurulum_docker_kaynak=dagitim. - Ana klasör: sunucuda
/etc/kurulum/ana(yol) ve<ana>/.kurulum(JSON işaret: kurulu yazılımlar, mod, sürüm, port, veri yolu) gerçek kaynaktır. Yerelkurulum_ana_klasorfarklıysa değiştiren eylemler durur ("ana klasör sunucuda X, yerelde Y"), sessiz düzeltme yok. Yol kuralları: mutlak, boşluk/özel karakter yok,/ /etc /usr /var /srv …kökleri ve/var/lib/dockeraltı yasak, tmpfs değil, dizin 0750 root. Sonradan taşıma v0.1'de yok. - Docker modu:
<ana>/<yazılım>/compose.ymlşablondan,docker compose configile doğrulanır; veri<ana>/<yazılım>/data(bind-mount; adlandırılmış volume vedown -vyok); ortak ağkurulum; port varsayılanı127.0.0.1. Konteyner adıkurulum-<yazılım>. - Gizli değerler:
<ana>/<yazılım>/.env(0600); parola sunucuda/dev/urandom'dan, yalnızca yoksa üretilir;no_log.<ana>/.envyalnızca gizli olmayan bağlantı anahtarlarını taşır (NGINX_HOST,MARIADB_PORT,REDIS_HOST_PORT…): native127.0.0.1, docker servis adı. - Native: nginx (kendi sitesi
sites-available/kurulum, dağıtım varsayılan bağı devre dışı, dosya silinmez), MariaDB (99-kurulum.cnf: bind/port; rootunix_socket, parola yok), Redis (redis.confsatırları yedekli; parolarequirepass). Veri dağıtım yerinde (/var/lib/mysql,/var/lib/redis,/var/www/html). Zaten kurulu ama kayıtsız paket varsa durur. Paketin kurulum betiği servisi varsayılan portta (80/3306/6379) kısaca başlatır; o port doluysa kurulum başlamadan durur. - Port çakışması:
ss+ işaret dosyası; "3306 portu mariadb uygulamasına verilmiş, boş port önerisi: 3307". - Yeniden çalıştırmada toparlanma: paket indeksi bayat/boşsa (
apt-cache policyadayı yok)kurindeksi yeniler; yarım kalan koşudan sonrakur'u tekrar çalıştırmak yeterlidir. - Saat sapması: sunucu saati kontrol makinesinden 1 saatten fazla farklıysa (
apt"Release file ... is not valid yet" der) koşu başında net bir UYARI ve çözüm önerisi çıkar; koşu durmaz. - Eşzamanlılık: sunucuda
/run/kurulum.locküzerindeflock; ikinci koşu durur. Tutucu süreç en geç 30 dk sonra kendiliğinden düşer.
- Modlar arası veri taşıma YOKTUR. Docker modunun verisi
<ana>/<yazılım>/data, native modun verisi dağıtım yerindedir (/var/lib/mysql,/var/lib/redis).kaldirile modu değiştirince eski modun verisi kullanılmaz (silinmez, orada durur); taşımayı kendiniz yaparsınız. - Sürümler aynı değildir: native, dağıtım paketinin sürümünü verir (Ubuntu 26.04 VM'de nginx 1.28.3, MariaDB 11.8.6, Redis 8.0.5); docker modu küratörlü sabit etiketi (örn. Redis 7.4.12). Aynı yazılımın iki modu aynı sürümü vermez.
- Ortak
.envanahtarları aynı, değerleri moda göre değişir:NGINX_HOST/_PORTdocker modunda servis adı ve konteyner portu (nginx,80), native modda127.0.0.1ve yayınlanan port (8080). Yayınlanan port her iki modda<YZ>_HOST_PORT'tur. Mod değişince tüketicilerin bu değerleri yeniden okuması gerekir. kaldirortak<ana>/.env'deki o yazılımın bağlantı anahtarlarını siler (<YZ>_HOST,_PORT,_HOST_PORT; sır değil); yenidenkuryazar. Gizli<ana>/<yazılım>/.env(parola) silinmez: yeniden kur ve mod değişimi aynı parolayı kullanır.
kurulum ufw'ye yazmaz (tek sahibi linux-hardening). kurulum_dis_erisim=true yapıldığında çıktı, servers/<ad>/linux-hardening.vars içindeki hardening_ufw_extra_allow_host listesine eklenecek kuralı önerir (from <yönetim ağı> to any port N proto tcp, any değil). Ansible liste değişkenlerini birleştirmez, üzerine yazar: öneriyi mevcut listeye siz eklersiniz. Docker yayınlanan portu ufw'yi atlayarak açar (LAB'da Docker 29.1.3 ile doğrulandı); DOCKER-USER ile kısıtlama denenmedi. Varsayılan 127.0.0.1 yayınında kural gerekmez. Hardening'le birlikte kullanım VM'de denenmedi (docs/vm-turu.md "Hardening turları"): hardening_kernel_modules_disabled=true Docker'ı bozar (kurulum sonra); hardening_ufw_outgoing_deny açıksa apt ve docker pull kapanır; /tmp noexec ve AppArmor'un MariaDB'ye etkisi doğrulanmadı.
- Yükseltme (
yukselt) yalnızca docker modunda ve daha yeni sürüme: önce döküm/yedek (<ana>/<yazılım>/yedek/<tarih>/, dizin 0700, dosya 0600; MariaDBmariadb-dump --all-databases, RedisSAVE+ veri kopyası, nginx web kökü ve compose.yml), sonra yeni imaj çekilir, sonra compose güncellenir. Geri düşürme yoktur; eski sürüme dönmek için yedeği kendiniz geri yüklersiniz (bu paket geri yüklemeyi yapmaz). Native sürüm yükseltme v0.1'de yok (apt'i kendiniz yönetin). - Kaldır (
kaldir) veriye dokunmaz: docker modundacompose down(-vyok); veri klasörü,.env(parola) vecompose.ymlkalır. Native'de servis durur/devre dışı kalır, paketapt removeile çıkar (purge yok), yapılandırma ve veri kalır. Kaldırılan yazılım işarettekaldirilanaltında kalır; yenidenkuraynı veriyi ve aynı parolayı kullanır. Docker taban kaldırma v0.1'de yok. - Geri almaz: kurulan Docker/apt paketlerini, çekilmiş imajları, oluşturulan
kurulumDocker ağını. Zamanlayıcılı geri alma güvenlik ağı yoktur (ssh/ufw/PAM'a dokunulmaz, erişimi kesmez).
Ayrıntı sonuçlar CHANGELOG'dadır. Özet:
| Ne | Sonuç |
|---|---|
component_validate.py . --strict --unsigned (git archive arşivi) |
temiz |
LAB (Colima + systemd'li ubuntu:26.04 arm64 konteyneri, iç içe Docker): lab-docker.bats / lab-native.bats / lab-preview.bats / lab-apt.bats |
21/21, 11/11, 8/8 ve 7/7: idempotans, yükseltmede veri duruyor, kaldır veriyi bırakır, parola sızmıyor (ayrıntı CHANGELOG) |
test/run-all.sh (statik desen denetimi, release betikleri, tutarlılık) |
yeşil |
| Gerçek VM ubuntutest (Ubuntu 26.04 amd64, hardening'siz, doğrudan playbook) | ✅ Docker taban (kur, ikinci kur changed=0); docker modu nginx/MariaDB/Redis kur + ikinci kur changed=0, parola sızıntısı 0 eşleşme, yükseltme (MariaDB 10.11.19→11.4.13 veri duruyor, Redis 7.2.17→7.4.12 anahtar duruyor, nginx 1.30.6→1.31.8), kaldır (veri/.env/compose kalır; Redis yeniden kur veri ve parolayı korudu); native nginx/MariaDB/Redis kur + ikinci kur changed=0. Ayrıntı CHANGELOG |
| Gerçek VM: V04 (indeks toparlama) ve V05 (saat sapması uyarısı) düzeltmeleri — LAB'da sınandı (faketime), VM'de denenmedi | denenmedi |
Gerçek VM: hardening'li iki sıralı tur, native Redis'te yeni parola üretimi, düzeltilmiş native Redis preview, sshpocket menüsü |
denenmedi |
Debian 13 (konteyner dahil); kurulum_docker_kaynak=dagitim |
denenmedi (yalnızca Debian deposunun varlığı apt -s ile görüldü). Profil planned kalır; v0.1.0 yalnızca Ubuntu 26.04 içindir |
| amd64 (LAB arm64) | denenmedi |
python3.13 -m venv .venv && .venv/bin/pip install --require-hashes --only-binary :all: -r requirements.txt
python3 -I tools/validate/component_validate.py . --strict --unsigned
test/run-all.sh
LAB_CA_FILE=<gerekirse kök sertifika.pem> bats test/e2e/lab-docker.bats test/e2e/lab-native.bats test/e2e/lab-preview.bats test/e2e/lab-apt.bats # Colima/Docker gerekirLAB notu: iç içe Docker için /var/lib/docker ve /var/lib/containerd ayrı volume'dür (yalnızca LAB; gerçek VM'de gerekmez). Ağda TLS'i araya giren bir güvenlik yazılımı varsa kök sertifikası yalnızca LAB konteynerine eklenir (LAB_CA_FILE); doğrulama kapatılmaz, paket buna bağımlı değildir.
Yayın: scripts/release.sh / release-publish.sh (imza anahtarı ve yayın kullanıcıdadır). release-publish.sh Release doğrulandıktan sonra imzalı paket indeksini (syhgorath/sshpocket-index, SSHPOCKET_INDEX_DIR) günceller; normal sürümde components.lock PR'ı gerekmez. İndeks hatası Release'i geçersiz kılmaz: index-publish.sh tek başına yeniden çalıştırılabilir. İndeks deposunda yalnızca yerel commit oluşur, push kullanıcıdadır.