====== VirtualBox Guest Additions ======

VirtualBox Guest Additions to zestaw sterowników i narzędzi, które poprawiają integrację i wydajność systemu operacyjnego uruchomionego na maszynie wirtualnej. Instalacja Guest Additions jest zalecana, aby uzyskać pełne wsparcie dla funkcji VirtualBox, takich jak udostępnione foldery, lepsza obsługa grafiki, synchronizacja schowka i inne.
{{page>:szablon:gfx:virtualbox}}

Narzędzia te znacząco poprawiają funkcjonalność i integrację maszyn wirtualnych z systemem gospodarza. Instalacja tych dodatków jest kluczowa dla pełnego wykorzystania możliwości, jakie oferuje [[virtualbox|VirtualBox]], szczególnie w kontekście pracy z folderami współdzielonymi, lepszą grafiką i integracją systemową.


===== Korzyści z instalacji Guest Additions =====

  * **Płynne przenoszenie kursora myszy:** Możliwość płynnego przemieszczania kursora myszy między systemem gospodarza a gościa bez konieczności klikania w okno maszyny wirtualnej.
  * **Lepsza obsługa grafiki:** Wyższa rozdzielczość ekranu, obsługa przyspieszenia 3D, dynamiczne zmienianie rozmiaru okna maszyny wirtualnej.
  * **Synchronizacja schowka:** Możliwość kopiowania i wklejania tekstu między systemem gospodarza a gościa.
  * **Udostępnione foldery:** Współdzielenie plików i folderów między systemem gospodarza a maszyną wirtualną.
  * **Synchronizacja czasu:** Automatyczna synchronizacja zegara systemowego gościa z systemem gospodarza.
  * **Zdalny pulpit:** Lepsza obsługa zdalnego pulpitu w VirtualBox.

===== Instalacja Guest Additions =====

Guest Additions można zainstalować w systemach Linux, Windows i macOS uruchomionych na maszynie wirtualnej.

==== Kroki instalacji na systemie Linux ====

  * Uruchom maszynę wirtualną z systemem Linux.
  * Zaloguj się do systemu jako użytkownik z uprawnieniami administratora.
  * W menu VirtualBox wybierz **"Devices"** <key>></key> **"Insert Guest Additions CD image..."**.
  * W terminalu uruchom poniższe polecenia:

''sudo mount /dev/cdrom /mnt''

''sudo /mnt/VBoxLinuxAdditions.run''

  * Po zakończeniu instalacji uruchom ponownie maszynę wirtualną.

==== Kroki instalacji na systemie Windows ====

  * Uruchom maszynę wirtualną z systemem Windows.
  * W menu VirtualBox wybierz //Devices// <key>></key> //Insert Guest Additions CD image...//.
  * W napędzie CD pojawi się nowy dysk. Otwórz go i uruchom plik **VBoxWindowsAdditions.exe**.
  * Postępuj zgodnie z instrukcjami instalatora.
  * Po zakończeniu instalacji uruchom ponownie maszynę wirtualną.

===== Konfiguracja udostępnionych folderów =====

Udostępnione foldery umożliwiają łatwą wymianę plików między systemem gospodarza a maszyną wirtualną. Aby skonfigurować udostępniony folder:

  * W VirtualBox, przejdź do ustawień maszyny wirtualnej i wybierz zakładkę **"Udostępnione foldery"**.
  * Kliknij ikonę dodawania folderu, wybierz folder z systemu gospodarza, który chcesz udostępnić, i skonfiguruj jego opcje.
  * W systemie gościa zamontuj udostępniony folder, np. używając polecenia:

''sudo mount -t vboxsf NAZWA_FOLDERU /ścieżka/docelowa''

====Dodanie użytkownika do grupy vboxsf====

  * Dodaj użytkownika do grupy ''vboxsf'', aby uzyskać dostęp do montowanego folderu:

''sudo usermod -aG vboxsf $USER''

W tym poleceniu ''$USER'' odnosi się do bieżącego użytkownika, który jest zalogowany. Możesz także ręcznie wpisać nazwę użytkownika zamiast ''$USER''.

  * Sprawdź uprawnienia katalogu ''/media/sf_FREE'', aby upewnić się, że grupa vboxsf ma odpowiednie uprawnienia:

''ls -ld /media/sf_FREE''

Powinieneś zobaczyć coś takiego:

<code bash>drwxrwx--- 1 root vboxsf 4096 Aug 21 12:34 /media/sf_FREE</code>

W tym przykładzie, drwxrwx- - - oznacza, że właściciel ''root'' i grupa ''vboxsf'' mają uprawnienia do odczytu, zapisu i wejścia do tego katalogu. Grupa ''vboxsf'' powinna mieć odpowiednie uprawnienia, jeśli Twój użytkownik jest jej członkiem.

  * Upewnij się, że Twój użytkownik należy do grupy ''vboxsf'':

''sudo usermod -aG vboxsf $USER''

Wyloguj się i zaloguj ponownie, aby zmiany weszły w życie.

===Sprawdź montowanie folderu===

Czy folder jest poprawnie zamontowany?

''mount | grep sf_FREE''

Powinieneś zobaczyć coś podobnego do:

''/dev/sr0 on /media/sf_FREE type vboxsf (rw,relatime)''


=====Instalacja narzędzi virtualbox-guest-dkms=====
  * Otwórz terminal i wykonaj następujące polecenie:

''sudo apt update''

''sudo apt install virtualbox-guest-dkms virtualbox-guest-utils virtualbox-guest-x11''

  * Zainstaluj nagłówki jądra (kernel headers):

Otwórz terminal i wykonaj następujące polecenie, aby zainstalować nagłówki jądra dla obecnej wersji jądra:

''sudo dnf install kernel-desktop-devel-$(uname -r)''

''uname -r'' zwróci aktualnie używaną wersję jądra, co pozwoli na automatyczne pobranie odpowiednich nagłówków.

  * Zainstaluj dodatkowe pakiety deweloperskie:

Może być również konieczne zainstalowanie dodatkowych pakietów narzędziowych potrzebnych do kompilacji modułów:

''sudo dnf install gcc make perl''

  * Zrestartuj system po instalacji.

  * Uruchom ponownie instalację Dodatków Gościa:

Po zainstalowaniu nagłówków jądra, uruchom ponownie instalację modułów VirtualBox:

''sudo /sbin/rcvboxadd setup''

Zrestartuj system:


  * Po zakończeniu instalacji zrestartuj system, aby nowe moduły zostały załadowane:

''sudo reboot''

  * Jeśli nie możesz znaleźć pasujących nagłówków dla obecnego jądra, możesz spróbować zaktualizować jądro do nowszej wersji, dla której nagłówki są dostępne:

''sudo dnf install kernel-desktop kernel-desktop-devel''

  * Sprawdź obecność modułów jądra:

Czy moduły jądra VirtualBox zostały załadowane?

''lsmod | grep vboxguest''
===== Sprawdzanie statusu instalacji Guest Additions =====

Aby upewnić się, że Guest Additions zostały poprawnie zainstalowane i działają, możesz:

  * **Sprawdzić status modułów:**

W terminalu systemu gościa sprawdź, czy moduły VirtualBox są załadowane. Uruchom polecenie:

''lsmod | grep vbox''

  * **Zweryfikuj usługę:**

W systemach Linux aby sprawdzić, czy usługa VirtualBox Additions jest aktywna użyj polecenia:

''systemctl status vboxadd'' 

===== Zasoby =====

  * Oficjalna strona VirtualBox: [[https://www.virtualbox.org|virtualbox.org]]
  * Dokumentacja Guest Additions: [[https://www.virtualbox.org/manual/ch04.html|Guest Additions Manual]]
  * Forum wsparcia: [[https://forums.virtualbox.org/|VirtualBox Forums]]

{{page>:szablony:kategorie}}
==Kategoria: Software==
{{indexmenu>:software#1}}
==Inne==
{{pagebox>:pagebox:kategorie}}