Zum Hauptinhalt springen

Snap-Berechtigungen (Linux)

Diese Seite erklärt, wie du Berechtigungen für Rayforge konfigurierst, wenn es als Snap-Paket unter Linux installiert wurde.

Was sind Snap-Berechtigungen?​

Snaps sind containerisierte Anwendungen, die in einer Sandbox zur Sicherheit ausgeführt werden. Standardmäßig haben sie begrenzten Zugriff auf Systemressourcen. Um bestimmte Funktionen zu nutzen (wie serielle Ports für Laser-Controller), musst du explizit Berechtigungen erteilen.

Erforderliche Berechtigungen​

Rayforge benötigt diese Snap-Schnittstellen für volle Funktionalität:

SchnittstelleZweckErforderlich?
serial-portZugriff auf USB-Seriell-Geräte (Laser-Controller)Ja (für Maschinensteuerung)
homeDateien im Home-Verzeichnis lesen/schreibenAutomatisch verbunden
removable-mediaZugriff auf externe Laufwerke und USB-SpeicherOptional
networkNetzwerkverbindung (für Updates usw.)Automatisch verbunden

Seriellen Port-Zugriff gewähren​

Dies ist die wichtigste Berechtigung für Rayforge.

Voraussetzung: dialout-Gruppenmitgliedschaft​

Auf Debian-basierten Distributionen muss dein Benutzer Mitglied der dialout-Gruppe sein, auch bei Verwendung des Snap-Pakets. Ohne diese Gruppenmitgliedschaft kannst du AppArmor DENIED-Meldungen erhalten, wenn du versuchst, auf serielle Ports zuzugreifen.

# Füge deinen Benutzer zur dialout-Gruppe hinzu
sudo usermod -a -G dialout $USER

Wichtig: Du musst dich abmelden und wieder anmelden (oder neu starten), damit Gruppenänderungen wirksam werden.

Aktuelle Berechtigungen prüfen​

# Alle Verbindungen für Rayforge anzeigen
snap connections rayforge

Suche nach der serial-port-Schnittstelle. Wenn sie "disconnected" oder "-" anzeigt, musst du sie verbinden.

Serielle Port-Schnittstelle verbinden​

# Seriellen Port-Zugriff gewähren
sudo snap connect rayforge:serial-port

Du musst dies nur einmal tun. Die Berechtigung bleibt über App-Updates und Neustarts hinweg bestehen.

Verbindung verifizieren​

# Prüfen, ob serial-port jetzt verbunden ist
snap connections rayforge | grep serial-port

Erwartete Ausgabe:

serial-port     rayforge:serial-port     :serial-port     -

Wenn du einen Plug/Slot-Indikator siehst, ist die Verbindung aktiv.

Wechseldatenträger-Zugriff gewähren​

Wenn du Dateien von USB-Laufwerken oder externem Speicher importieren/exportieren möchtest:

# Zugriff auf Wechseldatenträger gewähren
sudo snap connect rayforge:removable-media

Jetzt kannst du auf Dateien in /media und /mnt zugreifen.

Fehlerbehebung bei Snap-Berechtigungen​

Serieller Port funktioniert immer noch nicht​

Nach dem Verbinden der Schnittstelle:

  1. USB-Gerät neu anschließen:

    • Deinen Laser-Controller abziehen
    • 5 Sekunden warten
    • Wieder einstecken

  2. Rayforge neu starten:

    • Rayforge vollständig schließen
    • Über das Anwendungsmenü neu starten oder: 
      snap run rayforge

  3. Prüfen, dass der Port erscheint:

    • Rayforge öffnen → Einstellungen → Maschine
    • Nach seriellen Ports im Dropdown suchen
    • Sollte /dev/ttyUSB0, /dev/ttyACM0 oder ähnliches sehen

  4. Verifizieren, dass das Gerät existiert:

    # USB-Seriell-Geräte auflisten
    ls -l /dev/ttyUSB* /dev/ttyACM*

"Permission Denied" trotz verbundener Schnittstelle​

Dies ist selten, kann aber passieren wenn:

  1. Die Snap-Installation beschädigt ist:

    # Snap neu installieren
    sudo snap refresh rayforge --devmode
    # Oder falls das fehlschlägt:
    sudo snap remove rayforge
    sudo snap install rayforge
    # Schnittstellen neu verbinden
    sudo snap connect rayforge:serial-port

  2. Konfliktierende udev-Regeln:

    • Prüfe /etc/udev/rules.d/ auf benutzerdefinierte serielle Port-Regeln
    • Diese könnten mit Snap's Gerätezugriff kollidieren

  3. AppArmor-Ablehnungen:

    # Auf AppArmor-Ablehnungen prüfen
    sudo journalctl -xe | grep DENIED | grep rayforge

    Wenn du Ablehnungen für serielle Ports siehst, kann es einen AppArmor-Profil-Konflikt geben.

Kein Zugriff auf Dateien außerhalb des Home-Verzeichnisses​

Standardmäßig können Snaps nicht auf Dateien außerhalb deines Home-Verzeichnisses zugreifen, es sei denn, du gewährst removable-media.

Behelfslösungen:

  1. Dateien in dein Home-Verzeichnis verschieben:

    # SVG-Dateien nach ~/Dokumente kopieren
    cp /irgendein/anderer/ort/*.svg ~/Dokumente/

  2. Removable-media-Zugriff gewähren:

    sudo snap connect rayforge:removable-media

  3. Snap's Dateiauswahl verwenden:

    • Der integrierte Dateiwähler hat breiteren Zugriff
    • Dateien über Datei → Öffnen öffnen statt über Kommandozeilen-Argumente

Manuelle Schnittstellen-Verwaltung​

Alle verfügbaren Schnittstellen auflisten​

# Alle Snap-Schnittstellen auf deinem System sehen
snap interface

Eine Schnittstelle trennen​

# Serial-port trennen (falls erforderlich)
sudo snap disconnect rayforge:serial-port

Nach Trennung wieder verbinden​

sudo snap connect rayforge:serial-port

Alternative: Aus dem Quellcode installieren​

Wenn Snap-Berechtigungen zu restriktiv für deinen Workflow sind:

Option 1: Aus dem Quellcode bauen

# Repository klonen
git clone https://github.com/kylemartin57/rayforge.git
cd rayforge

# Abhängigkeiten mit pixi installieren
pixi install

# Rayforge ausführen
pixi run rayforge

Vorteile:

  • Keine Berechtigungseinschränkungen
  • Voller Systemzugriff
  • Einfacheres Debugging
  • Neueste Entwicklungsversion

Nachteile:

  • Manuelle Updates (git pull)
  • Mehr Abhängigkeiten zu verwalten
  • Keine automatischen Updates

Option 2: Flatpak verwenden (falls verfügbar)

Flatpak hat ähnliches Sandboxing, aber manchmal mit anderen Berechtigungsmodellen. Prüfe, ob Rayforge ein Flatpak-Paket anbietet.

Snap-Berechtigungs-Best-Practices​

Nur verbinden, was du benötigst​

Verbinde keine Schnittstellen, die du nicht verwendest:

  • ✓ Verbinde serial-port wenn du einen Laser-Controller verwendest
  • ✓ Verbinde removable-media wenn du von USB-Laufwerken importierst
  • ✗ Verbinde nicht alles "für alle Fälle" - widerspricht dem Sicherheitszweck

Snap-Quelle verifizieren​

Installiere immer aus dem offiziellen Snap Store:

# Herausgeber prüfen
snap info rayforge

Suche nach:

  • Verifiziertem Herausgeber
  • Offizieller Repository-Quelle
  • Regelmäßigen Updates

Snap-Sandbox verstehen​

Was können Snaps standardmäßig zugreifen?​

Erlaubt:

  • Dateien in deinem Home-Verzeichnis
  • Netzwerkverbindungen
  • Anzeige/Audio

Nicht erlaubt ohne explizite Berechtigung:

  • Serielle Ports (USB-Geräte)
  • Wechseldatenträger
  • Systemdateien
  • Home-Verzeichnisse anderer Benutzer

Warum dies für Rayforge wichtig ist​

Rayforge benötigt:

  1. Home-Verzeichnis-Zugriff (automatisch gewährt)

    • Um Projektdateien zu speichern
    • Um importierte SVG/DXF-Dateien zu lesen
    • Um Einstellungen zu speichern

  2. Seriellen Port-Zugriff (muss gewährt werden)

    • Um mit Laser-Controllern zu kommunizieren
    • Dies ist die kritische Berechtigung

  3. Wechseldatenträger (optional)

    • Um Dateien von USB-Laufwerken zu importieren
    • Um G-Code auf externen Speicher zu exportieren

Snap-Probleme debuggen​

Ausführliche Snap-Protokollierung aktivieren​

# Snap mit Debug-Ausgabe ausführen
snap run --shell rayforge
# Innerhalb der Snap-Shell:
export RAYFORGE_LOG_LEVEL=DEBUG
exec rayforge

Snap-Protokolle prüfen​

# Rayforge-Protokolle anzeigen
snap logs rayforge

# Protokolle in Echtzeit verfolgen
snap logs -f rayforge

System-Journal auf Ablehnungen prüfen​

# Nach AppArmor-Ablehnungen suchen
sudo journalctl -xe | grep DENIED | grep rayforge

# Nach USB-Geräte-Ereignissen suchen
sudo journalctl -f -u snapd
# Dann deinen Laser-Controller einstecken

Hilfe erhalten​

Wenn du immer noch Snap-bezogene Probleme hast:

  1. Zuerst Berechtigungen prüfen:

    snap connections rayforge

  2. Einen seriellen Port-Test versuchen:

    # Falls du screen oder minicom installiert hast
    sudo snap connect rayforge:serial-port
    # Dann in Rayforge testen

  3. Das Problem melden mit:

    • Ausgabe von snap connections rayforge
    • Ausgabe von snap version
    • Ausgabe von snap info rayforge
    • Deiner Ubuntu/Linux-Distributionsversion
    • Genauen Fehlermeldungen

  4. Alternativen in Betracht ziehen:

    • Aus dem Quellcode installieren (siehe oben)
    • Ein anderes Paketformat verwenden (AppImage, Flatpak)

Schnellreferenz-Befehle​

# Seriellen Port-Zugriff gewähren (am wichtigsten)
sudo snap connect rayforge:serial-port

# Wechseldatenträger-Zugriff gewähren
sudo snap connect rayforge:removable-media

# Aktuelle Verbindungen prüfen
snap connections rayforge

# Rayforge-Protokolle anzeigen
snap logs rayforge

# Rayforge aktualisieren
sudo snap refresh rayforge

# Entfernen und neu installieren (letztes Mittel)
sudo snap remove rayforge
sudo snap install rayforge
sudo snap connect rayforge:serial-port

Verwandte Seiten​