hacker

Czym jest hacker? #

hacker to napisane w języku Odin narzędzie CLI będące sercem HackerOS. Zastępuje i ujednolica dziesiątki osobnych skryptów — od instalacji pakietów APT/Flatpak/Snap, przez zarządzanie kontenerami podman/distrobox, aż po uruchamianie gier i przełączanie środowisk graficznych.

Binarka jest dostępna globalnie jako hacker. Konfiguracja użytkownika przechowywana jest w ~/.config/hackeros/hacker/.

Użycie ogólne #

hacker <komenda> [podkomenda] [opcje]

Wywołanie bez argumentów lub z help wyświetla listę wszystkich dostępnych komend:

hacker
hacker help
hacker help-ui      # interaktywne TUI z wyszukiwarką

Język interfejsu #

Komunikaty narzędzia są tłumaczone. Domyślnym językiem jest polski. Obsługiwane języki:

hacker settings language en    # zmień na angielski
hacker settings language       # wyświetl aktualny język

Ustawienie języka zapisywane jest w ~/.config/hackeros/hacker/language.json.

install / remove #

Instalacja i usuwanie pakietów APT przez wbudowany frontend.

hacker install nmap
hacker remove  nmap

flatpak-install / flatpak-remove #

hacker flatpak-install com.brave.Browser
hacker flatpak-remove  com.brave.Browser

unpack — instalacja zestawów #

Instaluje gotowe zestawy oprogramowania. Każdy zestaw to grupa powiązanych narzędzi instalowanych jednym poleceniem.

hacker unpack <zestaw>

pack — usuwanie zestawów #

Usuwa zestawy zainstalowane przez unpack. Nazwy podkomend są identyczne jak w unpack.

hacker pack gaming
hacker pack h#
hacker pack automatic-updates

env — środowiska kontenerowe #

Zarządzanie izolowanymi środowiskami opartymi na podman. Środowiska są etykietowane hacker-env=true i obsługują automatyczną synchronizację konfiguracji i narzędzi.

hacker env create ./pentest.hk
hacker env enter  pentest-env
hacker env remove pentest-env
hacker env settings

Format pliku konfiguracyjnego .hk #

Pliki .hk definiują środowisko kontenerowe. Obsługiwana jest też składnia YAML.

# pentest.hk — przykładowa konfiguracja środowiska pentestowego

[env]
-> name  => pentest-env
-> image => fedora:latest
-> shell => zsh

[packages]
-> -> nmap
-> -> metasploit-framework
-> -> burpsuite
-> -> wireshark

[sync_configs]
-> -> ~/.zshrc
-> -> ~/.config/nvim
-> -> ~/.tmux.conf

[sync_tools]
-> snap    => ["code"]
-> flatpak => ["com.brave.Browser"]
-> system  => ["~/go/bin/gf", "~/go/bin/subfinder"]

Sekcje pliku .hk

update — aktualizacja systemu #

Uruchamia HackerOS Updater — interaktywny TUI aktualizujący APT, Flatpak, Snap, Brew, firmware, Oh-My-Zsh, Distrobox oraz komponenty HackerOS.

hacker update             # TUI w bieżącym terminalu
hacker update --with-gui  # otwórz w nowym oknie Alacritty

system — komendy systemowe #

hacker system logs   # journalctl -xe

run — uruchamianie skryptów i aplikacji #

Bezpośrednie uruchamianie wbudowanych skryptów i aplikacji HackerOS.

switch — przełączanie środowisk graficznych #

Wykrywa bieżące środowisko graficzne, wyłącza je i uruchamia wybrany tryb bez konieczności wylogowywania.

hacker switch hacker-mode         # przełącz na Hacker-Mode (Wayland)
hacker switch steam-gamemode      # przełącz na Steam Gaming Mode

Obsługiwane środowiska wykrywane automatycznie: KDE Plasma, GNOME, XFCE4.

restart #

hacker restart NetworkManager
hacker restart bluetooth

Wykonuje sudo systemctl restart <usługa>.

game — gra tekstowa #

Wbudowana przygodowa gra tekstowa w klimatach hakerskich. Trzy poziomy trudności: Easy, Normal, Hard.

hacker game

Cel: wejść do komnaty rdzenia, zebrać USB drive, hasło i narzędzie deszyfrujące, a następnie użyć komendy hack.

ascii #

hacker ascii

Wyświetla logo HackerOS w ASCII art z /usr/share/HackerOS/Config-Files/HackerOS-Ascii.

shell / interactive #

hacker shell          # Python TUI shell z autouzupełnianiem
hacker interactive   # Go TUI wrapper (wywołuje komendy przez hsh)

shell to interaktywna powłoka z listą komend i autouzupełnianiem. interactive to pełne TUI oparte na bibliotece Bubble Tea — każda komenda wykonywana jest przez hsh -c "komenda".

enter / remove-container #

hacker enter            blackarch
hacker remove-container blackarch

Wchodzi do kontenera distrobox lub go usuwa. Kontenery tworzone przez hacker env create można też wejść przez to polecenie.

doctor / repair #

hacker doctor jest bramą do narzędzia naprawczego. Aby uruchomić tryb naprawy, najpierw musisz wpisać hacker doctor.

hacker doctor   # diagnoza + dostęp do narzędzia repair
hacker repair   # (tylko po przejściu przez doctor)

Narzędzie hacker-repair to pełny TUI napisany w Rust (ratatui), oferujący:

• Naprawę pakietów APT (apt-get install -f, dpkg --configure -a)
• Naprawę bootloadera GRUB
• Diagnostykę sieci (ping, gateway, DNS, rfkill)
• Analizę logów systemowych
• Czyszczenie systemu (apt clean, vacuum journal)
• Reset stosu sieciowego
• Zarządzanie snapshotami Timeshift

System pluginów #

Pluginy rozszerzają hacker o nowe komendy i możliwości. Przechowywane w ~/.config/hackeros/hacker/plugins/ jako pliki .hacker.

hacker plugin list              # lista pluginów i ich status
hacker plugin enable  mój-plugin
hacker plugin disable mój-plugin

Format pliku pluginu #

[
name > Mój Plugin
version > 1.0.0
description > Opis działania pluginu
author > Jan Kowalski
enabled > true

commands.scan.exec > /usr/bin/nmap
commands.scan.description > Szybki skan sieci
commands.scan.help > Skanuje podaną sieć za pomocą nmap

commands.report.exec > ~/scripts/generate-report.sh
commands.report.description > Generuj raport bezpieczeństwa

hooks.pre_update > ~/scripts/pre-update-hook.sh
hooks.post_update > ~/scripts/post-update-hook.sh

depends > nmap, curl
]

Pola pluginu

Po dodaniu pliku pluginu z enabled = true i zdefiniowaniu commands.mojakomenda.exec, możesz wywołać go jako:

hacker mojakomenda [argumenty]

Własne komendy #

Lżejsza alternatywa dla pluginów — pojedynczy plik .hacker definiuje jedną komendę.

# ~/.config/hackeros/hacker/custom-commands/mojaskrypt.hacker
[
exec > ~/scripts/mojaskrypt.sh
description > Mój własny skrypt
]

Wywołanie: hacker mojaskrypt [argumenty]

settings #

enable / disable #

index #

hacker index

Wyświetla indeks wszystkich narzędzi ekosystemu HackerOS z krótkimi opisami: bit, virus, bytes, hl, hackerc, hacker, Hacker Kernel, HackerOS Steam, HackerOS Welcome, HackerOS App, Hacker Mode, isolator, hpm, HackerOS Game Mode, hup, hammer, HackerOS Games, Hacker Launcher, lpm, hedit, ngt, hbuild, HackerDeck, Hacker Term, HackerOS Store, hsh, getit, HackerOS Builder, HexAi, chker, anvil, Blue Environment.

info / version / edition #

issue #

hacker issue

Otwiera stronę zgłaszania błędów na GitHub w przeglądarce (preferuje Vivaldi, fallback: xdg-open).

Wszystkie komendy — skrócona referencja #