Zum Inhalt springen
SONOYA.com
Raspberry Pi & Linux

Raspberry Pi als Druckserver: CUPS und AirPrint

Raspberry Pi als Druckserver mit CUPS: So druckst Du vom Mac, iPhone, Windows-PC und Android auf Deinem alten USB-Drucker, inklusive AirPrint.

Von

Umriss eines Druckers auf dunkelrotem Verlauf als Symbol für einen USB-Drucker, den ein Raspberry Pi mit CUPS ins WLAN bringt

Ein Laserdrucker, der nur einen USB-Anschluss hat, druckt oft noch jahrelang zuverlässig, er hängt nur eben an einem einzigen Rechner. Mit einem Raspberry Pi und dem Drucksystem CUPS machst Du daraus einen Netzwerkdrucker, auf den Mac, iPhone, iPad, Windows-PC und Android-Handy im WLAN drucken, das iPhone sogar per AirPrint ohne jede Einrichtung. Die Anleitung gilt für Raspberry Pi OS Trixie (Debian 13) mit CUPS 2.4 und für fast jeden USB-Drucker. Der wichtigste Teil ist die Frage, welcher Treiber zu Deinem Modell passt.

Was Du brauchst

Für einen Druckserver reicht jeder Raspberry Pi mit WLAN oder LAN-Anschluss, auch ein kleiner Raspberry Pi Zero 2 W (Affiliate Link). Er funkt allerdings nur im 2,4-GHz-Band und hat statt einer normalen USB-Buchse einen Micro-USB-Anschluss, für das Druckerkabel brauchst Du deshalb einen Micro-USB-OTG-Adapter (Affiliate Link). Ein älteres Modell mit normalen USB-Buchsen tut es genauso, etwa ein gebrauchter Raspberry Pi 3 bei eBay (Affiliate Link), denn Drucken fordert den Pi kaum.

Außerdem gehen wir von diesen Punkten aus:

Vorher klären: Welcher Treiber passt zu Deinem Drucker?

CUPS wandelt jeden Druckauftrag in die Sprache des Druckers um. Wie gut das klappt, hängt allein vom Treiber ab, deshalb lohnt sich ein Blick vor der Installation. Such Dein Modell zuerst in der Druckerdatenbank von OpenPrinting, dort steht, welcher freie Treiber es unterstützt und wie gut.

Dein DruckerPaket unter Raspberry Pi OSHinweis
Neueres Modell mit AirPrint- oder Mopria-Logo, nur per USB angeschlossenipp-usbDriverless über IPP Everywhere, kein Modelltreiber nötig
Ältere Tintenstrahler von Epson und Canon, viele PCL-Laserprinter-driver-gutenprintGrößte Modellauswahl, rund 3.600 Einträge
Neuere Epson-Tintenstrahlerprinter-driver-escprEpsons freier Treiber
HP Tinte und Laserprinter-driver-hpcupsEinträge mit „requires proprietary plugin“ meiden
Billige GDI-Laser, etwa HP LaserJet 1018, 1020, P1005, P1102 und einige Konica-Minolta-, Dell- und Xerox-Modelleprinter-driver-foo2zjsManche Modelle brauchen zusätzlich eine Firmware-Datei
Samsung- und Xerox-Laser mit SPLprinter-driver-splixVor allem ältere Samsung-Modelle
Brother-Laserprinter-driver-brlaserSiehe unten

Herstellertreiber für Linux gibt es meist nur für PCs mit Intel- oder AMD-Prozessor. Auf dem Pi mit ARM-Prozessor lassen sie sich dann nicht installieren, deshalb sind die freien Pakete aus der Tabelle fast immer der bessere Weg.

Für Brother-Laser ohne eigene Druckersprache, etwa den HL-2030, gibt es eine eigene, detaillierte Anleitung mit brlaser: Brother HL-2030 per AirPrint: Raspberry Pi als Druckserver. Dort kündigt eine eigene Avahi-Datei den Drucker an. Mit dem Standardweg aus diesem Artikel brauchst Du das nicht, weil Debians CUPS AirPrint schon selbst ankündigt.

Schritt 1: CUPS installieren

Melde Dich per SSH am Pi an und bring zuerst das System auf den aktuellen Stand:

Code
sudo apt update
sudo apt full-upgrade

Installiere danach CUPS, Avahi für die automatische Druckersuche im Netz und den Treiber aus der Tabelle oben. Im Beispiel ist es foo2zjs, tausche den letzten Paketnamen gegen Deinen:

Code
sudo apt install cups avahi-daemon avahi-utils printer-driver-foo2zjs

avahi-daemon läuft auf Raspberry Pi OS meist schon, der Befehl schadet dann nicht. avahi-utils bringt das Prüfwerkzeug avahi-browse mit, das wir später brauchen.

Damit Du Drucker in der Weboberfläche anlegen darfst, muss Dein Benutzer in der Gruppe lpadmin sein. Prüf das mit:

Code
groups

Steht lpadmin nicht in der Ausgabe, füg Dich hinzu, melde Dich mit exit ab und per SSH wieder an, damit die Gruppe greift:

Code
sudo usermod -aG lpadmin $USER

Schritt 2: Weboberfläche und Freigabe einschalten

Ab Werk lauscht CUPS nur auf dem Pi selbst. Dieser Befehl öffnet die Weboberfläche für andere Rechner im Heimnetz und schaltet die Druckerfreigabe ein:

Code
sudo cupsctl --remote-admin --share-printers

CUPS startet danach neu und nimmt Verbindungen auf Port 631 an, aber nur aus Deinem eigenen Netz (in der Konfiguration steht dafür Allow @LOCAL). Den Schalter --remote-any, der Zugriffe aus beliebigen Netzen erlaubt, brauchst Du im Heimnetz nicht. Gib Port 631 auch nie im Router nach außen frei.

Öffne nun am Mac oder PC im Browser:

Code
https://druckserver.local:631

Der Browser warnt vor einem unbekannten Zertifikat, weil CUPS sich selbst eines ausstellt. Das ist bei diesem Gerät im eigenen Netz in Ordnung, bestätige die Ausnahme. Sobald Du unter Verwaltung etwas änderst, fragt CUPS nach Benutzername und Passwort: Das sind die Zugangsdaten Deines Benutzers auf dem Pi.

Schritt 3: Drucker anschließen und erkennen

Schalte den Drucker ein, verbinde ihn per USB mit dem Pi und prüf, ob CUPS ihn sieht:

Code
sudo lpinfo -v

In der Liste sollte eine Zeile mit direct usb:// und dem Herstellernamen stehen, zum Beispiel direct usb://HP/LaserJet%201020?serial=.... Fehlt sie, zeigt lsusb, ob der Pi den Drucker überhaupt am USB-Bus erkennt. Ist er dort auch nicht zu sehen, liegt es fast immer am Kabel, am OTG-Adapter oder daran, dass der Drucker aus ist.

Neuere Drucker mit AirPrint-Logo tauchen hier unter Umständen gar nicht auf. Sie beherrschen IPP über USB, und das Paket ipp-usb übernimmt dann den USB-Anschluss und macht den Drucker ohne Modelltreiber für CUPS verfügbar. Läuft ipp-usb noch nicht, installierst Du es mit sudo apt install ipp-usb. In Schritt 4 wählst Du einen solchen Drucker unter Gefundene Netzwerkdrucker und als Modell IPP Everywhere. Einzelheiten beschreibt das Debian-Wiki zu driverless printing.

Schritt 4: Drucker in CUPS hinzufügen

In der Weboberfläche gehst Du so vor:

  1. Klick auf Verwaltung und dann auf Drucker hinzufügen. Melde Dich mit Deinem Pi-Benutzer an.
  2. Wähl unter Lokale Drucker den Eintrag mit Deinem Druckermodell und klick auf Weiter.
  3. Vergib einen Namen ohne Leerzeichen, etwa Buero-Laser. Unter diesem Namen erscheint der Drucker später auf allen Geräten. Setz unbedingt den Haken bei Drucker im Netzwerk freigeben und klick auf Weiter.
  4. Wähl den Hersteller und dann das Modell. Steht hinter einem Eintrag (recommended), nimm diesen. Klick auf Drucker hinzufügen.
  5. Auf der nächsten Seite legst Du die Standardeinstellungen fest. Stell hier das Papierformat auf A4, denn viele Treiber starten mit US-Letter. Bestätige mit Standardeinstellungen festlegen.

Druck danach auf der Seite des Druckers über das Menü Wartung eine Testseite drucken. Kommt sie sauber heraus, ist der schwierigste Teil erledigt.

Auf der Kommandozeile kontrollierst Du den Zustand mit:

Code
lpstat -p

Die Ausgabe sollte etwa printer Buero-Laser is idle. enabled since ... lauten. In der Protokolldatei von CUPS siehst Du bei klassischen Treibern die Warnung „Printer drivers are deprecated“. Sie bedeutet nur, dass die CUPS-Entwickler Modelltreiber langfristig abschaffen wollen. Mit CUPS 2.4 unter Trixie funktionieren sie weiterhin.

Schritt 5: Prüfen, ob AirPrint angekündigt wird

Debian hat CUPS so erweitert, dass jeder freigegebene Drucker über Avahi automatisch als AirPrint-Drucker im Netz erscheint, ganz ohne eigene Konfigurationsdatei. So beschreibt es auch das Debian-Wiki zu CUPS und AirPrint. Prüf das direkt auf dem Pi:

Code
avahi-browse -rt _universal._sub._ipp._tcp

In der Ausgabe muss Dein Drucker als Buero-Laser @ druckserver stehen, und in der Zeile txt finden sich unter anderem URF=..., pdl=...image/urf und mopria-certified=1.3. Die ersten beiden braucht das iPhone für AirPrint, die letzte richtet sich an Mopria-Druckdienste, wie sie Android und Windows verwenden. Kommt hier nichts, ist der Drucker nicht freigegeben, oder Avahi läuft nicht (systemctl status avahi-daemon).

Getestet ist dieser Ablauf in einem Debian-13-Container (arm64) mit CUPS 2.4.10, Avahi 0.8 und dem foo2zjs-Treiber: Freigabe, AirPrint-Ankündigung, ein Druckauftrag von einem zweiten Rechner im Netz ohne Anmeldung sowie die Umwandlung von PDF und AirPrint-Rasterdaten in die Druckersprache. Die Schritte an den Geräten unten folgen der Dokumentation von Apple, Microsoft und Google.

Drucken vom Mac, iPhone und iPad

iPhone und iPad: Hier ist nichts einzurichten. Tipp in einer App auf das Teilen-Symbol und auf Drucken, dann auf Drucker und wähl Buero-Laser @ druckserver. Voraussetzung ist laut Apple nur, dass iPhone und Pi im selben Netzwerk sind.

Mac (macOS Tahoe 26): Öffne Systemeinstellungen > Drucker & Scanner und klick auf Drucker, Scanner oder Fax hinzufügen …. Im ersten Reiter erscheint der Drucker mit dem Namen aus Schritt 4. Unter Verwenden sollte AirPrint stehen, dann brauchst Du am Mac keinen Treiber. Klick auf Hinzufügen.

Drucken von Windows 11

Öffne Einstellungen > Bluetooth und Geräte > Drucker und Scanner und klick auf Gerät hinzufügen. Windows sucht im Netz und findet den Pi-Drucker meist von selbst, weil CUPS ihn als Mopria-Drucker ankündigt. Windows nimmt dann seinen eingebauten IPP-Klassentreiber, einen Herstellertreiber brauchst Du nicht.

Erscheint der Drucker nicht, richtest Du ihn von Hand ein. Microsoft beschreibt den Weg in der Doku zum IPP-Klassentreiber: Klick neben „Der gewünschte Drucker ist nicht aufgeführt“ auf Manuell hinzufügen, wähl die Option, einen Drucker über IP-Adresse oder Hostnamen hinzuzufügen, und als Gerätetyp IPP-Gerät. Trag statt nur der Adresse die vollständige Druckeradresse ein:

Code
ipp://192.168.178.50:631/printers/Buero-Laser

Ersetze 192.168.178.50 durch die feste IP-Adresse Deines Pi und Buero-Laser durch den Namen aus Schritt 4. Groß- und Kleinschreibung zählt.

Drucken von Android

Android bringt einen eingebauten Druckdienst mit, der IPP-Drucker im WLAN findet. Auf einem Pixel liegt er unter Einstellungen > Verbundene Geräte > Verbindungseinstellungen > Drucken, wie Google beschreibt. Dort muss der vorinstallierte Druckdienst eingeschaltet sein. Bei Samsung und anderen Herstellern heißen die Menüs etwas anders, die Suche in den Einstellungen nach „Drucken“ führt Dich hin.

Zum Drucken öffnest Du in der App das Menü mit den drei Punkten, tippst auf Drucken (manchmal über Teilen), dann oben auf die Druckerauswahl und wählst Buero-Laser @ druckserver.

Wenn es nicht klappt

Der Drucker erscheint auf iPhone, Mac oder Android nicht. Die automatische Suche funktioniert nur im selben Netz. Hängt Dein Handy im Gastnetz oder ist im WLAN die Trennung der Geräte untereinander aktiv, sieht es den Pi nicht. Was im FRITZ!Box-Gastnetz alles wegfällt, steht in Smart Home ins FRITZ!Box-Gastnetz: IoT sicher trennen. Prüf außerdem mit dem Befehl aus Schritt 5, ob der Pi den Drucker überhaupt ankündigt.

Der Auftrag kommt an, aber es druckt nichts oder nur Zeichensalat. Dann passt der Treiber nicht. Sieh direkt nach einem Druckversuch ins Protokoll:

Code
sudo tail -n 50 /var/log/cups/error_log

Steht dort Filter failed, wähl in der Weboberfläche unter Drucker, Deinem Drucker und Verwaltung > Drucker ändern einen anderen Treiber aus der Tabelle oben. Bei foo2zjs-Druckern, die zwar Daten empfangen, aber nicht anfangen, fehlt oft die Firmware-Datei. Debian liefert sie aus Lizenzgründen nicht mit, die Datei /usr/share/doc/printer-driver-foo2zjs/README.Debian beschreibt, wie Du sie nachlädst.

Die Weboberfläche meldet „Forbidden“ oder fragt immer wieder nach dem Passwort. Dein Benutzer ist nicht in der Gruppe lpadmin, oder Du hast Dich nach dem Hinzufügen nicht neu angemeldet. Wiederhol den letzten Teil von Schritt 1.

Aufträge bleiben in der Warteschlange hängen. Schau mit lpstat -t nach, ob der Drucker angehalten ist (disabled). Nach einem Papierstau oder wenn der Drucker beim Senden aus war, stoppt CUPS die Warteschlange. In der Weboberfläche nimmst Du sie über Wartung > Drucker starten wieder auf.

Wenn der Druckserver einmal läuft, musst Du Dich um ihn kaum noch kümmern: Neue Geräte im Haushalt finden den Drucker von selbst. Wer den Drucker selten nutzt, kann ihn zusätzlich nach Gebrauch automatisch vom Strom trennen, wie es Home Assistant: Drucker automatisch abschalten und Strom sparen zeigt.

Weiterlesen.