Installation / Konfiguration von VirtualBox und phpVirtualBox

VirtualBox ist eine Virtualisierungssoftware mit der virtuelle Rechner erstellt werden können um z.B. andere Betriebssysteme zu testen oder Systeme aus Sicherheitsgründen von einander zu trennen.

Grundlagen	Installation	Konfiguration
Virtualisierung	Installation VirtualBox	Konfiguration Virtualbox (CLI)
	Installation phpVirtualBox	Konfiguration phpVirtualbox
		Konfiguration Gemeinsame Ordner
		Auf Gastsystem zugreifen
		Terminal Befehle
		Bildschirmauflösungen d. Gastsystems
———————————————-	———————————————-	———————————————-

Virtualisierung

Unter Virtualisierung versteht man die Emulierung von Hardware. Dabei wird durch die Virtualisierungssoftware auf dem Hostssystem die gesamte Hardware zum Betrieb eines Betriebssystems bereitgestellt. Die Gastsysteme („VMs“) verhalten sich dabei wie „echte“ Rechner. Durch Virtualisierung kann ein Großteil an Hardware eingespart werden.

Installation VirtualBox

Voraussetzung ist eine Debian 11|12, Apache und PHP Installation. Die Installation kann über manuell heruntergeladene Packe aus dem phpVirtualbox Archiv oder mit Hilfe der Virtualbox Repositories erfolgen. Die Installation über Repositories von Virtualbox wird im Folgenden kurz beschrieben :

Virtualbox Repository hinzufügen ( Debian / Ubuntu / APT basierte Distributionen ):

http://download.virtualbox.org/virtualbox/debian $(lsb_release -c | tr -d : | cut -f 2) contrib" | sudo tee -a /etc/apt/sources.list

1

http://download.virtualbox.org/virtualbox/debian $(lsb_release -c | tr -d : | cut -f 2) contrib" | sudo tee -a /etc/apt/sources.list

Virtualbox Repository Signatur laden und registrieren

Debian 12 => wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- > /etc/apt/trusted.gpg.d/oracle_vbox_2016.asc
Debian 11 => wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O- | sudo apt-key add -

1 2	Debian 12 => wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- > /etc/apt/trusted.gpg.d/oracle_vbox_2016.asc Debian 11 => wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O- \| sudo apt-key add -

Aktuellste Virtualbox Version installieren :

Shell

sudo apt-get update sudo apt-get install $(sudo apt-cache search virtualbox- | grep "Oracle VM VirtualBox" | tail -n1 | cut -d " " -f1)

1
2

sudo apt-get update
sudo apt-get install $(sudo apt-cache search virtualbox- | grep "Oracle VM VirtualBox" | tail -n1 | cut -d " " -f1)

Virtualbox Extensionpack laden und installieren :

wget https://download.virtualbox.org/virtualbox/7.0.10/Oracle_VM_VirtualBox_Extension_Pack-7.0.10.vbox-extpack
sudo VBoxManage extpack install --replace Oracle_VM_VirtualBox_Extension_Pack-7.0.10.vbox-extpack
sudo rm Oracle_VM_VirtualBox_Extension_Pack-7.0.10.vbox-extpack

wget https://download.virtualbox.org/virtualbox/7.0.10/Oracle_VM_VirtualBox_Extension_Pack-7.0.10.vbox-extpack

sudo VBoxManage extpack install --replace Oracle_VM_VirtualBox_Extension_Pack-7.0.10.vbox-extpack

sudo rm Oracle_VM_VirtualBox_Extension_Pack-7.0.10.vbox-extpack

Virtualboxwebservice Init Script kopieren und ggf. Startverzögerung einstellen ( nur bei Debain 11 nötig ) :

Shell

sudo cp /usr/lib/systemd/system/vboxweb.service /etc/systemd/system/

1

sudo cp /usr/lib/systemd/system/vboxweb.service /etc/systemd/system/

Zurück zur Übersicht

Installation phpVirtualBox

phpVirtualbox herunterladen und entpacken

sudo apt-get install php-xml php-soap
cd /var/www

sudo wget https://github.com/BartekSz95/phpvirtualbox/archive/main.zip
unp main.zip
sudo chown -R www-data:www-data phpvirtualbox-main
sudo ln -s phpvirtualbox-main/ phpvirtualbox


# obsolete source
# sudo git clone git://git.code.sf.net/p/phpvirtualbox-7/code phpvirtualbox-7-code 
# sudo mv phpvirtualbox-7-code/phpvirtualbox7.0/ . 
# sudo ln -s phpvirtualbox7.0 phpvirtualbox 
# sudo chown -R www-data:www-data phpvirtualbox7.0 
# sudo rm -r phpvirtualbox-7-code

sudo apt-get install php-xml php-soap

cd /var/www

sudo wget https://github.com/BartekSz95/phpvirtualbox/archive/main.zip

unp main.zip

sudo chown -R www-data:www-data phpvirtualbox-main

sudo ln -s phpvirtualbox-main/ phpvirtualbox

# obsolete source

# sudo git clone git://git.code.sf.net/p/phpvirtualbox-7/code phpvirtualbox-7-code

# sudo mv phpvirtualbox-7-code/phpvirtualbox7.0/ .

# sudo ln -s phpvirtualbox7.0 phpvirtualbox

# sudo chown -R www-data:www-data phpvirtualbox7.0

# sudo rm -r phpvirtualbox-7-code

phpVirtualbox Konfigurationsdatei für Apache Webserver kopieren und anpassen :

sudo cp /var/www/phpvirtualbox/phpvirtualbox.conf /etc/apache2/sites-available/
sudo sed -i 's|/usr/share/phpvirtualbox|/var/www/phpvirtualbox|' /etc/apache2/sites-available/phpvirtualbox.conf
sudo sed -i 's/Require local/#Require local/' /etc/apache2/sites-available/phpvirtualbox.conf

sudo cp /var/www/phpvirtualbox/phpvirtualbox.conf /etc/apache2/sites-available/

sudo sed -i 's|/usr/share/phpvirtualbox|/var/www/phpvirtualbox|' /etc/apache2/sites-available/phpvirtualbox.conf

sudo sed -i 's/Require local/#Require local/' /etc/apache2/sites-available/phpvirtualbox.conf

Zurück zur Übersicht

Konfiguration phpVirtualbox

Benutzer für phpVirtualbox anlegen
phpVirtualbox sollte aus Sicherheitsgründen unter einem eigenen Benutzer betrieben werden, da das Userpasswort für den Virtualbox User im Klartext gespeichert wird.

Anlegen und zuweisen eines Virtualboxnutzers :

sudo useradd -d /home/vbox -m -g vboxusers -s /bin/bash vbox
sudo adduser vbox vboxusers
sudo touch /etc/default/virtualbox
echo 'VBOXWEB_USER=vbox'  | sudo tee -a /etc/default/virtualbox
sudo passwd vbox

sudo useradd -d /home/vbox -m -g vboxusers -s /bin/bash vbox

sudo adduser vbox vboxusers

sudo touch /etc/default/virtualbox

echo 'VBOXWEB_USER=vbox' | sudo tee -a /etc/default/virtualbox

sudo passwd vbox

phpVirtualbox für User konfigurieren ( manuelles editieren der /var/www/phpvirtualbox/config.php Datei – Sonderzeichen mit \ maskieren)

sudo cp /var/www/phpvirtualbox/config.php-example /var/www/phpvirtualbox/config.php
sudo nano /var/www/phpvirtualbox/config.php

1 2	sudo cp /var/www/phpvirtualbox/config.php-example /var/www/phpvirtualbox/config.php sudo nano /var/www/phpvirtualbox/config.php

folgende Variablen in /var/www/phpvirtualbox-master/config.php Datei anpassen ( manuelles editieren )

var $username = 'vbox'
var $password = 'Passwort'  ( Passwort des users vbox )

1 2	var $username = 'vbox' var $password = 'Passwort' ( Passwort des users vbox )

phpVirtualBox für User konfigurieren ( automatisches editieren )

sudo cp /var/www/phpvirtualbox/config.php-example /var/www/phpvirtualbox/config.php
printf "Enter vbox user password:" && read Password
sudo sed -i s/'var $username = .*vbox.*;'/"var \$username = \'vbox\';"/ /var/www/phpvirtualbox/config.php
sudo sed -i s/'var $password = .*;'/"var \$password = \'$Password\';"/ /var/www/phpvirtualbox/config.php)

sudo cp /var/www/phpvirtualbox/config.php-example /var/www/phpvirtualbox/config.php

printf "Enter vbox user password:" && read Password

sudo sed -i s/'var $username = .*vbox.*;'/"var \$username = \'vbox\';"/ /var/www/phpvirtualbox/config.php

sudo sed -i s/'var $password = .*;'/"var \$password = \'$Password\';"/ /var/www/phpvirtualbox/config.php)

phpvirtualbox für apache aktivieren

cp /var/www/phpvirtualbox/phpvirtualbox.conf /etc/apache2/sites-available/phpvirtualbox.conf
sed -s 's|/usr/share/phpvirtualbox|/var/www/phpvirtualbox|' -i /etc/apache2/sites-available/phpvirtualbox.conf
a2ensite phpvirtualbox.conf
systemctl restart apache2

cp /var/www/phpvirtualbox/phpvirtualbox.conf /etc/apache2/sites-available/phpvirtualbox.conf

sed -s 's|/usr/share/phpvirtualbox|/var/www/phpvirtualbox|' -i /etc/apache2/sites-available/phpvirtualbox.conf

a2ensite phpvirtualbox.conf

systemctl restart apache2

Verbinden mit phpVirtualbox Server

phpVirtualbox ist nun unter dem Link : http://IP-DES-VIRTUALBOXSERVERS/phpvirtualbox erreichbar. Dies ist der Virtualbox Manager wie er auf einem Lokalen System gestartet wird. Der Standard-Benutzername und Kennwort lautet : admin/admin. Hier sollte umgehend ein sicheres Passwort gewählt werden
Mit Remmina oder vergleichbaren Remotedesktop Clienten kann sich direkt auf eine durch den Virtualbox Manager gestartete Virtuelle Maschine eingeloggt werden. Jeder Virtuellen Maschine muss dabei ein eigener Port zugewiesen werden.

Virtualbox Guest Additions

Das phpvirtualbox Webinterface bietet keine Möglichkeit die VirtualBox Guest Additions über das virtuelle Laufwerk des Clients zu installieren. Die VirtualBox Guest Additions.iso Datei kann HIER heruntergeladen werden (Auf Version achten), alternativ befindet sich das ISO Image der installierten VirtualBox Version unter /usr/share/virtualbox/VBoxGuestAdditions.iso.

Zurück zur Übersicht

Konfiguration Shared Folder

Freigegebene Ordner befinden sich physisch auf dem Host und werden für den Gast über einen speziellen Dateisystemtreiber in den Guest Addons bereitgestellt. Für Windows-Gäste werden freigegebene Ordner als Pseudo-Netzwerk-Redirector implementiert. Für Linux- und Oracle Solaris-Gäste stellen die Guest Addons ein virtuelles Dateisystem bereit. Der Virtuabox Benutzer auf dem Host sowie der Gast Benutzer in der VM müssen der Gruppe “vboxsf” hinzugefügt werden.

Es gibt mehrere Möglichkeiten, freigegebene Ordner für eine virtuelle Maschine einzurichten:

- - GUI => Unter Geräte im VM Menu befindet sich die Option „Freigegebene Ordner“
  - CLI => VBoxManage sharedfolder add “VM name” –name “sharename” –hostpath “/path/on/host” ( –transient (temporär) )

Die Freigaben selbst können mit folgenden Optionen konfiguriert werden:

- - Permanente Freigaben ( dauerhafte Freigabe, gespeichert in VM Einstellungen )
  - Temporäre Freigaben ( nur während der laufenden VM aktiv, keine dauerhafte Speicherung )

Symlinks des Hosts ( Linux, Solaris ) können nur nach Aktivierung in den VM Einstellungen vom Gast gelesen werden und sind aus Sicherheitsgründen nicht automatisch aktiv.

- - VBoxManage setextradata „VM-Name“ VBoxInternal2/SharedFoldersEnableSymlinksCreate/sharename 1
    
    1
    
    VBoxManage setextradata „VM-Name“ VBoxInternal2/SharedFoldersEnableSymlinksCreate/sharename 1

Info docs.oracle.com

Zurück zur Übersicht

Auf Gastsystem zugreifen

Für die Grafische Verwaltung des Gastsystems auf dem VM Server bieten sich drei Möglichkeiten.

Zum einen kann die Virtuelle Maschine über das phpvirtualbox interface und das rdp Protokoll direkt verwaltet werden. Allerdings ist dabei der Login für alle virtuellen Maschinen gleich, da diese alle unter einem Konto laufen ( vbox s.o. ).
Eine weitere Möglichkeit besteht darin, direkt auf die Virtuellen Maschinen via Remotedesktop zuzugreifen. Dazu muss die Virtuelle Netzwerkkarte allerdings als Netzwerkbrücke konfiguriert werden.
phpVirtualbox bietet jedoch auch auch die Option, über manuelles Editieren der Konfigurationsdateien für jede virtuelle Maschine ein eigenes Benutzerkonto anzulegen.

Zurück zur Übersicht

Terminal Befehle

Verfügbare Virtuelle Maschinen auflisten :

Shell

VBoxManage list vms

1

VBoxManage list vms
Virtuelle Maschine starten :

Shell

VBoxManage startvm <VM-NAME>

1

VBoxManage startvm <VM-NAME>
Virtuelle Maschine im Headless Modus starten ( VM wird ohne Displayausgabe gestartet )

Shell

VBoxManage startvm <VM-NAME> --type headless # alternativ: VBoxHeadless -s <VM-NAME>

1

VBoxManage startvm <VM-NAME> --type headless # alternativ: VBoxHeadless -s <VM-NAME>
Detaillierte Informationen zu einer Virtuellen Maschine :

Shell

VBoxManage showvminfo <VM-NAME>

1

VBoxManage showvminfo <VM-NAME>
Shared Folder erstellen :

Shell

VBoxManage sharedfolder add <VM-NAME> -name <NAME> -hostpath <HOSTPATH>

1

VBoxManage sharedfolder add <VM-NAME> -name <NAME> -hostpath <HOSTPATH>
Symlinks für Shared Folder aktivieren

VBoxManage setextradata „VM-Name“ VBoxInternal2/SharedFoldersEnableSymlinksCreate/sharename 1

1

VBoxManage setextradata „VM-Name“ VBoxInternal2/SharedFoldersEnableSymlinksCreate/sharename 1

Auflistung der Parameter des Virtualbox Managers im Terminal :
Virtualbox Headless Control
Create/Manage VirtualBox VMs from the Command Line
Ausführliche Erklärung der Virtualbox Funktionsweise

Infosource / Infosource2

Zurück zur Übersicht

Bildschirmauflösungen d. Gastsystems

Die Auflösungen eines Linux Gastsystems lassen sich durch folgenden Befehl auf dem phpVirtualboxserver (temporär) oder Einträge in der /etc/X11/xorg.conf des Gastsystems (dauerhaft) festlegen :

VBoxManage controlvm <VMNAME> setvideomodehint <Xres> <Yres> <Cdepth>

1	VBoxManage controlvm <VMNAME> setvideomodehint <Xres> <Yres> <Cdepth>

Section "Screen"
        Identifier      "Default Screen"
        Device          "VBOX Video device"
        Monitor         "VBOX Screen"
        DefaultDepth    24
        SubSection      "Display"
                Virtual 1280    800
                Depth   24
                 Modes Modes "800x600@60" "1024x768@60" "1200x800@60" "1280x720@60" "1366x768@60" "1440x900@60" "1650x900@60" "1680x1050@60" "1920x1080@60" "1920x1200@60"
        EndSubSection
EndSection

Section "Screen"

Identifier "Default Screen"

Device "VBOX Video device"

Monitor "VBOX Screen"

DefaultDepth 24

SubSection "Display"

Virtual 1280 800

Depth 24

Modes Modes "800x600@60" "1024x768@60" "1200x800@60" "1280x720@60" "1366x768@60" "1440x900@60" "1650x900@60" "1680x1050@60" "1920x1080@60" "1920x1200@60"

EndSubSection

EndSection

Zurück zur Übersicht

Bekannte Fehlerquellen :

VirtualBox lässt sich nach Update nicht starten.
=> Kerneltreiber wurden nicht neu compiliert :

Shell

sudo /etc/init.d/vboxdrv setup

1

sudo /etc/init.d/vboxdrv setup

Virtualbox Systemd Autostart funktioniert nicht ( Kerneltreiber noch nicht geladen )
=> Dienstneustart über cron (Zeile hinzufügen): @reboot sleep 5 && systemctl restart vboxweb.service
=> Startverzögerung einstellen ( “ExecStartPre=/bin/sleep 5” in “/etc/systemd/system/vboxweb.service” ) :

[Unit]
Description=VirtualBox Web Service
After=network.target

[Service]
Type=forking
ExecStartPre=/bin/sleep 5
ExecStart=/usr/lib/virtualbox/vboxweb-service.sh start
PIDFile=/run/vboxweb-service.sh

[Install]
WantedBy=multi-user.target

[Unit]

Description=VirtualBox Web Service

After=network.target

[Service]

Type=forking

ExecStartPre=/bin/sleep 5

ExecStart=/usr/lib/virtualbox/vboxweb-service.sh start

PIDFile=/run/vboxweb-service.sh

[Install]

WantedBy=multi-user.target

USB Geräte lassen sich nicht an VM durchreichen.
=> Benutzer ist nicht in vboxusers Gruppe

Shell

sudo adduser <user> vboxusers

1

sudo adduser <user> vboxusers

Einloggen ins Webinterface meldet Falschen Benutzernamen oder Passwort:
- in /etc/default/virtualbox festgelegter User ist nicht Mitglied Gruppe vboxusers
- in /var/www/phpvirtualbox/config.php festgelegter user weicht von user in /etc/default/virtualbox ab
- default Login => user: admin / pass: admin
Remote Desktopverbindung kann nicht hergestellt werden ( VirtualBox Remote Display Extension nicht aktiviert):
- RDP für einzelne VM aktivieren und für Lan Verbindungen freigeben
  
  Shell
  
  VBoxManage modifyvm "VM name" --vrde on --vrdeaddress $(hostname -I)
  
  1
  
  VBoxManage modifyvm "VM name" --vrde on --vrdeaddress $(hostname -I)
- RDP für alle VMs aktivieren und für Lan Verbindungen freigeben
  
  Shell
  
  for i in $(vboxmanage list vms | cut -d "{" -f2 | cut -d "}" -f1) ; do VBoxManage modifyvm "$i" --vrde on --vrdeaddress $(hostname -I); done
  
  1
  
  for i in $(vboxmanage list vms | cut -d "{" -f2 | cut -d "}" -f1) ; do VBoxManage modifyvm "$i" --vrde on --vrdeaddress $(hostname -I); done
Hardware Uhr des Gastsystem wird nach einer Pause der Virtuallen Maschine nicht aktualisiert.
- Die Gasterweiterungen wurden nicht installiert. ( Anleitung: Installation der Gasterweiterung )

Sonstige Infos :

Virtualbox Quellcode Ab Version 4.0 wurde VirtualBox als OpenSource freigegeben. Da sowohl die unfreie Version und auch die Open-Source-Version des Herstellers keinen Sourcecode mitliefert, sollte man abwägen, ob die Quellen in die Paketquellen eingetragen werden sollten.

Versionsupdate Ein Update mit Versionssprung (major update) erfordert das Entfernen der niedrigeren/alten/installierten Version. Dabei gehen weder Einstellungen, noch virtuelle Maschinen verloren. Die Gasterweiterungen der Clients nach der Neuinstallation von Virtualbox müssen ebenfalls für die aktualisierte Version angepasst werden.

by Speefak | wiki.debian.org | github.com

Installation / Konfiguration von VirtualBox und phpVirtualBox