Konfigurationsreferenz des Print Agents

Der Hintergrunddienst liest seine Konfiguration aus zwei Quellen (in dieser Reihenfolge, spätere gewinnt nicht — Umgebungsvariablen haben Vorrang):

1. Umgebungsvariablen mit dem Präfix DOCUFLAIR_; Doppel-Unterstrich trennt die Ebenen — aus PrintAgent:ServerUrl wird DOCUFLAIR_PRINTAGENT__SERVERURL.
2. appsettings.json / appsettings.Production.json neben dem Dienst-Binary, Abschnitt PrintAgent.

{
  "PrintAgent": {
    "ServerUrl": "https://print.example.com",
    "IgnoreServerCertificateErrors": false
  }
}

Registry ist keine Konfigurationsquelle

Der Schlüssel HKLM\SOFTWARE\Docuflair\PrintAgent wird vom Installer nur zu Erkennungszwecken beschrieben — der Dienst liest ihn nicht. Werte dort zu ändern hat keine Wirkung; verwenden Sie Umgebungsvariablen oder appsettings.Production.json.

Einstellungen des Dienstes

Alle Schlüssel liegen im Abschnitt PrintAgent:

Schlüssel	Standard	Bedeutung
ServerUrl	(leer)	Adresse des Docuflair Servers (https://…). Darf leer bleiben — die Statusleisten-App übergibt die Adresse bei der Anmeldung. Ist der Wert leer, greift als letzte Rückfallebene eine im Paket hinterlegte Standardadresse (https://docuflair.imc.ac.at); für eigene Installationen sollte die Adresse daher immer explizit gesetzt oder bei der Anmeldung eingetragen werden.
InboxDirectory	<Datenverzeichnis>/Inbox	Überwachter Ordner für „An Docuflair senden“.
PayloadDirectory	<Datenverzeichnis>/Payloads	Zwischenspeicher für Druckdaten bis zum Upload.
DatabasePath	<Datenverzeichnis>/queue.db	Lokale Auftragswarteschlange (SQLite).
PipeName	docuflair-printagent	Name des lokalen Kommunikationskanals zur Statusleisten-App. Bei Änderung muss derselbe Wert in tray-settings.json stehen.
UploadPollInterval	00:00:05	Prüfintervall des Upload-Prozesses.
LocalTcpListenerEnabled	true	Lokalen Druckdaten-Eingang aktivieren.
LocalTcpListenerPort	9100	Port des Eingangs auf 127.0.0.1.
IgnoreServerCertificateErrors	true	Akzeptiert auch nicht validierbare Serverzertifikate (Self-Signed). In Umgebungen mit vertrauenswürdigem Zertifikat auf false setzen — siehe Sicherheit und Datenschutz.
ProxyUrl	(leer)	Expliziter HTTP-Proxy, z. B. http://proxy.firma.local:3128. Leer = Systemproxy bzw. HTTP(S)_PROXY-Umgebungsvariablen.
ProxyUsername / ProxyPassword	(leer)	Zugangsdaten für den Proxy (nur Basic-Authentifizierung; Ablage im Klartext).

Ungültige Werte verhindern den Start

Eine syntaktisch ungültige ServerUrl oder ProxyUrl führt dazu, dass der Dienst den Start abbricht (unter Windows als Zeitüberschreitung beim Dienststart sichtbar). Eine leere ServerUrl ist dagegen erlaubt.

Einstellungen der Statusleisten-App

Die App speichert ihre Einstellungen in tray-settings.json im Benutzerprofil: %LOCALAPPDATA%\Docuflair\PrintAgent (Windows), ~/Library/Application Support/Docuflair/PrintAgent (macOS), ~/.config/docuflair-printagent (Linux). Gepflegt werden die Werte normalerweise über den Einstellungsdialog der App:

Schlüssel	Bedeutung
serverUrl	Serveradresse (wird bei der Anmeldung an den Dienst übergeben).
ignoreServerCertificateErrors	Zertifikatsprüfung der App (Standard true, analog zum Dienst).
language	auto, de oder en.
proxyUrl, proxyUsername, proxyPassword	Expliziter Proxy; wird bei der Anmeldung an den Dienst übergeben.
pipeName	Nur ändern, wenn auch der Dienst einen abweichenden PipeName verwendet.

Proxy-Besonderheiten

• Der Dienst läuft unter einem Systemkonto und sieht die Proxy-Einstellungen des Benutzers nicht. Typisches Symptom: Der Verbindungstest in der App gelingt, Uploads bleiben aber in Wiederholungsversuch hängen. Lösung: Proxy im Einstellungsdialog der App eintragen (wird an den Dienst übergeben) oder für Rechner ohne Anmeldung PrintAgent:ProxyUrl konfigurieren.
• Unterstützt wird nur Basic-Authentifizierung — NTLM-/Kerberos-Proxys funktionieren nicht.
• Der Microsoft-Login nutzt immer den Systemproxy, nicht den explizit konfigurierten.
• Wird der Proxy entfernt, übernimmt der Dienst das erst nach einem Neustart des Dienstes.

Weitere Umgebungsvariablen

Variable	Wirkung
DOCUFLAIR_PRINTAGENT__<SCHLÜSSEL>	Überschreibt jeden Dienst-Schlüssel (siehe oben).
DOCUFLAIR_PRINT_AGENT_PORT	Zielport des CUPS-Backends (Linux/macOS), Standard 9100.
DOCUFLAIR_PRINTER_NAME	Name der Druckwarteschlange bei der Paketinstallation (Linux/macOS).

Datenverzeichnisse

Betriebssystem	Dienst (Warteschlange, Logs)	Statusleisten-App
Windows	C:\ProgramData\Docuflair\PrintAgent	%LOCALAPPDATA%\Docuflair\PrintAgent
Linux	/var/spool/docuflair-printagent, Logs im Journal	~/.config/docuflair-printagent
macOS	/usr/local/var/docuflair-printagent, Logs unter /Library/Logs/Docuflair/PrintAgent	~/Library/Application Support/Docuflair/PrintAgent