[[Vorlage(Getestet, bionic, focal)]] 

{{{#!vorlage Wissen
[:Pakete installieren:Installation von Programmen]
[:Terminal:Ein Terminal öffnen]
[:sudo:Root-Rechte]
}}}

[[Inhaltsverzeichnis(2)]] 

[[Bild(Wiki/Icons/debian.png, 32, left)]] 

Eine komfortable Möglichkeit, lokal oder per Fernzugriff, durch die installierten Debian-Pakete buchstäblich zu browsen bietet  '''dpkg-www'''. dpkg-www benötigt einen [:Serverdienste:Webserver], der sofern er nicht schon auf dem System vorhanden ist, automatisch installiert und eingerichtet wird. 

= Installation =
Folgendes Paket muss installiert [1] werden: 

{{{#!vorlage Paketinstallation
dpkg-www, universe
}}}
 
Unter Bionic wird [:dwww:] automatisch mitinstalliert, dies ist jedoch in neueren Ubuntu-Versionen nicht mehr der Fall. Ist bisher kein Webserver auf dem System installiert worden, so wird automatisch der [:Apache_2.4:Apache]-Webserver installiert.

Der Server muss [wikipedia:Common_Gateway_Interface:CGI] aktiviert haben. Bei Apache geht dies wie folgt:

{{{#!vorlage Befehl
sudo a2enmod cgid 
}}}

Anschließend Apache neu starten:
{{{#!vorlage Befehl
sudo service apache2 restart
}}}

= Verwendung =

[[Bild(./Bildschirmfoto.png, 340, right)]]

== Browser ==

Um sich die installierten Pakete anzeigen zu lassen, braucht man dann lediglich einen Webbrowser:

 * `http://localhost/cgi-bin/dpkg?query=` - Liste aller Pakete 
 * `http://localhost/cgi-bin/dpkg?query=foobar` - detaillierte Informationen zum Paket '''foobar'''

Alternativ kann dpkg-www im Startmenü über "''System -> Debian Package Browser''" geöffnet werden.

== Terminal ==
Mit dpkg-www können auch Abfragen aus einem Terminal [2] gestartet werden:

{{{#!vorlage Befehl
dpkg-www bash
}}}

öffnet beispielsweise die Paketinformationen zum Paket '''bash''' im Browser des [:Alternativen-System: Alternativen-Systems], wenn in der [#Konfiguration Konfiguration] nichts anderes angegeben ist.

Um die Ausgabe direkt im Terminal zu erhalten, verwendet man den Parameter `-s`. Dazu muss ein Textbrowser (wie zum Beispiel lynx, links, links2, elinks, w3m) installiert sein:

{{{#!vorlage Befehl
dpkg-www -s bash
}}}

= Konfiguration =
== Allgemein==
Für die Anpassung der Einstellungen kann die Konfigurationsdatei '''/etc/dpkg-www.conf''' mit einem Texteditor mit administrativen Rechten [3] bearbeitet werden.

{{{#!vorlage Warnung
Die Möglichkeit, dpkg-www so einzustellen, dass darüber Pakete installiert oder entfernt werden können, wird im Artikel bewusst nicht angesprochen. Die Entwickler selbst raten von der Benutzung ab, da es als Sicherheitsrisiko gilt.
}}}
==Apache==
Die [:Apache:]-spezifischen Einstellungen nimmt man in der Datei '''/etc/apache2/conf-available/dpkg-www.conf''' vor. So ist dort zum Beispiel standardmäßig aus Sicherheitsgründen der Zugriff auf dpkg-www über den Apache-Server nur für localhost, also dem Server, auf dem dpkg-www läuft, zulässig. Zugriff für andere Rechner kann man erlauben, indem eine oder mehrere gewünschte IP-Adressen mittels `Require ip IP-ADRESSE` angibt. Damit Änderungen an der Apache-Konfigurationsdatei wirksam werden, muss Apache neu geladen werden.
=Links=

 * [:dwww:] - [:man:Manpages] im Webbrowser lesen
 * [:Paketverwaltung:] {Übersicht} - Übersichtsartikel
 
# tag: Paketverwaltung, Netzwerk, Internet