Aynı tarama motoru, terminalinde

Uygulamanın yaptığı her şey, betikleyebileceğin bir komut olarak. Ayrıca zamanlanmış tarama yapan bir ajan var; böylece hiç giriş yapmadığın bir makine bile diskine ne olduğunu anlatabilir.

Kurulum

curl -fsSL https://raw.githubusercontent.com/unalcakir28/spacetrace/main/install.sh | sh

spacetrace ve spacetrace-agent'ı /usr/local/bin içine kuruyor. Bilinçli olarak sıkıcı POSIX sh, çünkü kabuğu busybox olan NAS yazılımlarında da çalışması gerekiyor.

Windows'ta arşivi aç ve spacetrace.exe'yi PATH üzerinde bir yere koy. Komut satırı aracı için kurulum sihirbazı yok.

Komut satırı ve ajan Kılavuz

Gerçekten kullanacağın dört komut

Bir klasöre bak

Yürüyor ve toplamları basıyor. Hiçbir şey saklanmıyor, hiçbir şey değişmiyor.

$ spacetrace scan ~/projects
scanned 84,213 entries in 1.9s
total 12.4 GiB logical · 12.7 GiB on disk
3 paths could not be read

Sonucu sakla

Taramayı düz bir SQLite dosyasında anlık görüntü olarak saklıyor, istersen etiketle.

$ spacetrace scan /srv --save --label weekly
saved snapshot #1

Neyin değiştiğini sor

Bir kökün son iki anlık görüntüsünü, ya da en yenisini diskin şu anki hâliyle karşılaştırıyor.

$ spacetrace diff --path /srv
#1 2026-09-06 17:23 [weekly]  →  #2 2026-09-06 19:40
total 23.8 MiB → 76.3 MiB   (+52.5 MiB)

      CHANGE  STATUS          NEW  PATH
   +40.1 MiB  grew       42.9 MiB  app/logs/
   +14.3 MiB  grew       25.7 MiB  backups/
    -1.9 MiB  removed         0 B  uploads/

Başka bir makineyi oku

Salt okunur her komut --remote alıyor. Aynı alt komutlar, başka yere yönlenmiş.

$ spacetrace --remote nas diff --path /var
#12 2026-09-01 03:00 [nightly]  →  #19 2026-09-08 03:00
total 41.2 GiB → 58.9 GiB   (+17.7 GiB)

      CHANGE  STATUS          NEW  PATH
   +16.9 GiB  grew       21.4 GiB  lib/docker/overlay2/
    +0.8 GiB  grew        3.1 GiB  log/journal/

Bir yapay zeka asistanının kullanması kolay

Her komut JSON basar ve araçta bir dosyayı silebilecek hiçbir şey yok. Yani bir asistanın bir makineyi taramasına, sayıları okumasına ve diski neyin doldurduğunu açıklamasına izin verebilirsin — bir ayrıştırıcı yazmadan ve risk almadan.

Her komutta --json var, yani hiçbir şeyin insan için yazılmış metinden ayıklanması gerekmez
Yalnızca okur: bir modelin uzanabileceği bir silme işlevi yok
Tek statik ikili dosya, yani her konteynere ya da sandbox'a bırakılabilir
--remote ve düz SSH, yani bir asistan bütün bir filoya bakabilir
Toplamlar du ve df ile eşleşir, yani vardığı sonucu kontrol edebilirsin

Ajan

spacetrace-agent aynı kodun servis hâli. Yapılandırdığın kökleri zamanlanmış olarak tarıyor, anlık görüntüleri tutuyor ve HTTP üzerinden sunuyor. Tek statik ikili — ve yalnızca okuyor.

Ajanın tam kurulumu

Kök başına beş alanlı cron zamanlaması, sayıya göre saklama
Bearer token zorunlu; serve token olmadan başlamayı reddediyor
Varsayılan olarak yalnızca loopback dinliyor — bir envanteri ağa açmak bilinçli bir düzenleme olmalı
/health token istemiyor, böylece konteyner sağlık kontrolü çalışıyor ve başka hiçbir şey açığa çıkmıyor
Bilinmeyen yapılandırma anahtarları sessizce yoksayılmıyor, açılışta reddediliyor

Konteynerde

Ana makineyi salt okunur bağla ve onu tara. İmaj amd64 ve arm64'ü birlikte taşıyor.

docker run -d --name spacetrace \
  -v /:/host:ro \
  -v spacetrace-data:/var/lib/spacetrace \
  -v /etc/spacetrace:/etc/spacetrace:ro \
  -p 7878:7878 \
  ghcr.io/unalcakir28/spacetrace

Kodu okuyabilirsin

Tarama motoru, anlık görüntü deposu, karşılaştırma ve iki ikili de Apache-2.0. Kendi sunucularına kurduğun yazılım, inceleyebileceğin yazılım olmalı.

GitHub'da kaynak kodu Pano