HackerOS — Dokumentacja

1. Wprowadzenie

HackerOS to dystrybucja linuksowa bazująca na Debianie (testing), stworzona z myślą o:

• zwykłych użytkownikach,
• graczach,
• entuzjastach cyberbezpieczeństwa i power-userach.

Filozofia

HackerOS ma dawać użytkownikowi pełną kontrolę, jednocześnie oferując gotowe, przyjazne środowisko do codziennego użytku i grania. Projekt stawia na:

• dostępność (łatwe instalatory i GUI),
• wydajność (customowe jądro — np. XanMod oraz opcje przeinstalowanego firmware),
• bezpieczeństwo i prywatność użytkownika.

Cel

Celem HackerOS jest dostarczyć stabilne środowisko gotowe do pracy i rozrywki:

• stabilność — baza Debian testing z dodatkowymi testami i stabilizacją komponentów,
• wydajność — opcjonalne jądro XanMod oraz zoptymalizowane firmware,
• prostota aktualizacji — skrypty do tworzenia/updatu ISO/rootfs i proste GUI/CLI do aktualizacji (hacker-update),
• dostosowanie — łatwa personalizacja i integracja narzędzi dla pentesterów i graczy.

2. Wymagania sprzętowe

Minimalne

• Procesor: 2 rdzenie, 1.6 GHz (x86_64 / ARMv8)
• Pamięć RAM: 2 GB
• Dysk: 20 GB wolnej przestrzeni
• Grafika: zintegrowana, obsługa rozdzielczości 1024×768
• Sieć: karta sieciowa Ethernet/Wi-Fi

Te parametry pozwolą uruchomić system; przy nich wydajność GUI i gier będzie ograniczona.

Rekomendowane

• Procesor: 4 rdzenie, 2.5 GHz lub szybszy (x86_64 / ARM64)
• Pamięć RAM: 8 GB lub więcej
• Dysk: 50 GB wolnej przestrzeni (SSD zalecany)
• Grafika: GPU z akceleracją 3D (NVIDIA/AMD/Intel)
• Sieć: stabilne łącze internetowe

Obsługiwane architektury

• x86_64 (amd64) — pełne wsparcie

3. Instalacja

Pobieranie

Pobierz obraz ISO ze strony projektu:

https://hackeros-linux-system.github.io/HackerOS-Website/download.html

Tworzenie bootowalnego nośnika

• Windows: Rufus
• Linux: dd, balenaEtcher, Fedora Media Writer
• Przykład dd (UWAGA: dobierz poprawne /dev/sdX):

sudo dd if=HackerOS.iso of=/dev/sdX bs=4M status=progress oflag=sync

Instalacja z nośnika

1. Uruchom komputer z pendrive/USB.
2. Wybierz tryb Live (jeśli chcesz sprawdzić środowisko) lub bezpośrednio instalator.
3. Instalator poprowadzi przez: partycjonowanie, tworzenie użytkownika, wybór jądra/firmware (opcjonalnie: XanMod).
4. Po zakończeniu uruchom system z dysku.

Dual-boot

• Instalator posiada opcję instalacji obok istniejącego systemu.
• Zawsze wykonaj backup przed zmianami partycji.
• Jeżeli chcesz, by Bootloader (GRUB) był zarządzany ręcznie — wybierz opcję zaawansowaną.

4. Pierwsze kroki po instalacji

Logowanie

• Jeżeli wybrałeś automatyczne logowanie — zostaniesz zalogowany od razu.
• W przeciwnym razie: zaloguj się przy użyciu utworzonego użytkownika.

Menedżer pakietów

HackerOS używa APT oraz własnego narzędzia hacker:

• APT (przykłady):

sudo apt update
sudo apt upgrade
sudo apt install <pakiet>
sudo apt remove <pakiet>
sudo apt autoremove
sudo apt autoclean

• hacker (własny manager):

sudo hacker install <pakiet>
sudo hacker remove <pakiet>
sudo hacker update
sudo hacker upgrade-all # (przykładowa komenda — zależnie od implementacji)

hacker jest wrapperem i integruje dodatkowe repozytoria/paczki customowe — sprawdź hacker --help.

Konfiguracja sieci i podstawowe ustawienia

• GUI: Ustawienia → Sieć
• CLI: nmcli, ip, ifconfig (jeśli dostępne)
• Lista komend i gotowych skryptów do customizacji:
• https://hackeros-linux-system.github.io/HackerOS-Website/about-hackeros.html

5. Środowisko graficzne i aplikacje

Domyślne środowisko

KDE Plasma (edycja Official HackerOS), skonfigurowane pod wydajność i gry.

Preinstalowane aplikacje

• Przeglądarka: Vivaldi
• Terminale: Alacritty, Konsole
• Sklep/aplikacje: GNOME Software (lub software)
• Gry i autorskie aplikacje od HackerOS (zestaw zależny od wersji ISO)

Instalacja dodatkowego oprogramowania

• Z poziomu GUI: otwórz Software i zainstaluj wybrane aplikacje.
• Z CLI: sudo apt install <pakiet> lub sudo hacker install <pakiet>
• Możesz także instalować za pomocą Flatpak i Snap (jeśli masz je zainstalowane).

6. Konfiguracja i personalizacja

Wszystkie ustawienia graficzne i użytkowe znajdziesz w:

• Aplikacja Ustawienia (KDE) — wygląd, motywy, skróty, dźwięki, starupy.
• Dodatkowe pliki konfiguracyjne: ~/.config/, ~/.local/share/
• Aliasów i globalnych ustawień powłoki: /etc/bash.bashrc (tam znajdują się domyślne aliasy HackerOS).
• Animacje startowe i splash screen: /usr/share/HackerOS/Animations/ (np. HackerOS.webm).

7. Rozwiązywanie błędów (troubleshooting)

• Najpierw sprawdź logi:
• Systemd: journalctl -b (możesz też sprawdzić logi za pomocą hacker-syslog)
• Dmesg: dmesg | less
• X/Wayland logs: ~/.local/share/sddm/ lub ~/.xsession-errors
• Sieć: nmcli device status, ping 8.8.8.8
• Problem z paczkami: sudo apt --fix-broken install, sudo dpkg --configure -a
• Jeśli nic nie pomaga: napisz mail:
• Email: hackeros068@gmail.com
• Opisz krok po kroku problem, załącz logi (pastebin/plik), wersję systemu (cat /etc/os-release) i konfigurację sprzętową.

8. Licencja i prawa

• HackerOS stosuje mieszankę licencji zależnie od komponentu:
• Jądro i dystrybucyjne komponenty Debiana — zgodne z licencjami oryginalnych pakietów (GPL, itp.).
• Aplikacje i narzędzia customowe od HackerOS:
• domyślnie GNU GPL v3.0 (jeśli wymagasz kompatybilności z GPL dla modyfikacji),
• niektóre narzędzia mogą być pod BSD 3-Clause, MIT, lub Apache License 2.0 (w zależności od autora/komponentu).
• W LICENSE repo: zamieść główną licencję projektu i listę wyjątków/licencji dla poszczególnych komponentów (NOTICE/THIRD_PARTY).
• Znak towarowy / nazwa: zastrzeżona przez projekt — sprawdź politykę użycia nazwy i logo w LICENSE/TRADEMARK.