Ir al contenido principal

Permisos de Snap (Linux)

Esta página explica cómo configurar permisos para Rayforge cuando se instala como paquete Snap en Linux.

¿Qué son los Permisos de Snap?​

Los Snaps son aplicaciones en contenedores que se ejecutan en un sandbox por seguridad. Por defecto, tienen acceso limitado a los recursos del sistema. Para usar ciertas funciones (como puertos serie para controladores láser), debes otorgar permisos explícitamente.

Permisos Requeridos​

Rayforge necesita estas interfaces de Snap conectadas para funcionalidad completa:

InterfazPropósito¿Requerido?
serial-portAcceso a dispositivos serie USB (controladores láser)Sí (para control de máquina)
homeLeer/escribir archivos en tu directorio personalAuto-conectado
removable-mediaAcceso a unidades externas y almacenamiento USBOpcional
networkConectividad de red (para actualizaciones, etc.)Auto-conectado

Otorgando Acceso al Puerto Serie​

Este es el permiso más importante para Rayforge.

Prerrequisito: membresía al grupo dialout​

En distribuciones basadas en Debian, tu usuario debe ser miembro del grupo dialout, incluso cuando uses el paquete Snap. Sin esta membresía al grupo, puedes recibir mensajes AppArmor DENIED al intentar acceder a los puertos serie.

# Añade tu usuario al grupo dialout
sudo usermod -a -G dialout $USER

Importante: Debes cerrar sesión y volver a entrar (o reiniciar) para que los cambios de grupo surtan efecto.

Verificar Permisos Actuales​

# Ver todas las conexiones para Rayforge
snap connections rayforge

Busca la interfaz serial-port. Si muestra "desconectado" o "-", necesitas conectarla.

Conectar Interfaz de Puerto Serie​

# Otorgar acceso al puerto serie
sudo snap connect rayforge:serial-port

Solo necesitas hacer esto una vez. El permiso persiste a través de actualizaciones de la app y reinicios.

Verificar Conexión​

# Verificar si serial-port ahora está conectado
snap connections rayforge | grep serial-port

Salida esperada:

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

Si ves un indicador de plug/slot, la conexión está activa.

Otorgando Acceso a Medios Removibles​

Si quieres importar/exportar archivos desde unidades USB o almacenamiento externo:

# Otorgar acceso a medios removibles
sudo snap connect rayforge:removable-media

Ahora puedes acceder a archivos en /media y /mnt.

Solución de Problemas de Permisos de Snap​

El Puerto Serie Todavía No Funciona​

Después de conectar la interfaz:

  1. Vuelve a conectar el dispositivo USB:

    • Desconecta tu controlador láser
    • Espera 5 segundos
    • Vuelve a conectarlo

  2. Reinicia Rayforge:

    • Cierra Rayforge completamente
    • Relanza desde el menú de aplicaciones o: 
      snap run rayforge

  3. Verifica que el puerto aparezca:

    • Abre Rayforge → Configuración → Máquina
    • Busca puertos serie en el menú desplegable
    • Deberías ver /dev/ttyUSB0, /dev/ttyACM0, o similar

  4. Verifica que el dispositivo existe:

    # Listar dispositivos serie USB
    ls -l /dev/ttyUSB* /dev/ttyACM*

"Permiso Denegado" A Pesar de la Interfaz Conectada​

Esto es raro pero puede suceder si:

  1. La instalación de Snap está rota:

    # Reinstalar el snap
    sudo snap refresh rayforge --devmode
    # O si eso falla:
    sudo snap remove rayforge
    sudo snap install rayforge
    # Volver a conectar interfaces
    sudo snap connect rayforge:serial-port

  2. Reglas udev en conflicto:

    • Revisa /etc/udev/rules.d/ para reglas personalizadas de puerto serie
    • Podrían estar en conflicto con el acceso a dispositivos de Snap

  3. Denegaciones de AppArmor:

    # Verificar denegaciones de AppArmor
    sudo journalctl -xe | grep DENIED | grep rayforge

    Si ves denegaciones para puertos serie, puede haber un conflicto de perfil de AppArmor.

No Puedo Acceder a Archivos Fuera del Directorio Personal​

Por diseño, los Snaps no pueden acceder a archivos fuera de tu directorio personal a menos que otorgues removable-media.

Opciones alternativas:

  1. Mueve archivos a tu directorio personal:

    # Copia archivos SVG a ~/Documentos
    cp /alguna/otra/ubicacion/*.svg ~/Documentos/

  2. Otorga acceso a removable-media:

    sudo snap connect rayforge:removable-media

  3. Usa el selector de archivos de Snap:

    • El selector de archivos integrado tiene acceso más amplio
    • Abre archivos a través de Archivo → Abrir en lugar de argumentos de línea de comandos

Gestión Manual de Interfaces​

Listar Todas las Interfaces Disponibles​

# Ver todas las interfaces de Snap en tu sistema
snap interface

Desconectar una Interfaz​

# Desconectar serial-port (si es necesario)
sudo snap disconnect rayforge:serial-port

Reconectar Después de Desconectar​

sudo snap connect rayforge:serial-port

Alternativa: Instalar desde Código Fuente​

Si los permisos de Snap son demasiado restrictivos para tu flujo de trabajo:

Opción 1: Compilar desde código fuente

# Clonar el repositorio
git clone https://github.com/kylemartin57/rayforge.git
cd rayforge

# Instalar dependencias usando pixi
pixi install

# Ejecutar Rayforge
pixi run rayforge

Beneficios:

  • Sin restricciones de permisos
  • Acceso completo al sistema
  • Depuración más fácil
  • Última versión de desarrollo

Desventajas:

  • Actualizaciones manuales (git pull)
  • Más dependencias para gestionar
  • Sin actualizaciones automáticas

Opción 2: Usar Flatpak (si está disponible)

Flatpak tiene sandboxing similar pero a veces con diferentes modelos de permisos. Verifica si Rayforge ofrece un paquete Flatpak.

Mejores Prácticas de Permisos de Snap​

Solo Conecta Lo Que Necesitas​

No conectes interfaces que no usas:

  • ✓ Conecta serial-port si usas un controlador láser
  • ✓ Conecta removable-media si importas desde unidades USB
  • ✗ No conectes todo "por si acaso" - derrota el propósito de seguridad

Verifica la Fuente del Snap​

Siempre instala desde la Snap Store oficial:

# Verificar editor
snap info rayforge

Busca:

  • Editor verificado
  • Fuente de repositorio oficial
  • Actualizaciones regulares

Entendiendo el Sandbox de Snap​

¿Qué Pueden Acceder los Snaps por Defecto?​

Permitido:

  • Archivos en tu directorio personal
  • Conexiones de red
  • Pantalla/audio

No permitido sin permiso explícito:

  • Puertos serie (dispositivos USB)
  • Medios removibles
  • Archivos del sistema
  • Directorios personales de otros usuarios

Por Qué Esto Importa para Rayforge​

Rayforge necesita:

  1. Acceso al directorio personal (otorgado automáticamente)

    • Para guardar archivos de proyecto
    • Para leer archivos SVG/DXF importados
    • Para almacenar preferencias

  2. Acceso al puerto serie (debe otorgarse)

    • Para comunicarse con controladores láser
    • Este es el permiso crítico

  3. Medios removibles (opcional)

    • Para importar archivos desde unidades USB
    • Para exportar código G a almacenamiento externo

Depurando Problemas de Snap​

Habilitar Registro Verbose de Snap​

# Ejecutar Snap con salida de depuración
snap run --shell rayforge
# Dentro del shell de snap:
export RAYFORGE_LOG_LEVEL=DEBUG
exec rayforge

Verificar Registros de Snap​

# Ver registros de Rayforge
snap logs rayforge

# Seguir registros en tiempo real
snap logs -f rayforge

Verificar Diario del Sistema para Denegaciones​

# Buscar denegaciones de AppArmor
sudo journalctl -xe | grep DENIED | grep rayforge

# Buscar eventos de dispositivo USB
sudo journalctl -f -u snapd
# Luego conecta tu controlador láser

Obteniendo Ayuda​

Si todavía tienes problemas relacionados con Snap:

  1. Verifica permisos primero:

    snap connections rayforge

  2. Prueba el puerto serie:

    # Si tienes screen o minicom instalado
    sudo snap connect rayforge:serial-port
    # Luego prueba en Rayforge

  3. Reporta el problema con:

    • Salida de snap connections rayforge
    • Salida de snap version
    • Salida de snap info rayforge
    • Tu versión de distribución Ubuntu/Linux
    • Mensajes de error exactos

  4. Considera alternativas:

    • Instalar desde código fuente (ver arriba)
    • Usar un formato de paquete diferente (AppImage, Flatpak)

Comandos de Referencia Rápida​

# Otorgar acceso al puerto serie (más importante)
sudo snap connect rayforge:serial-port

# Otorgar acceso a medios removibles
sudo snap connect rayforge:removable-media

# Verificar conexiones actuales
snap connections rayforge

# Ver registros de Rayforge
snap logs rayforge

# Actualizar/refrescar Rayforge
sudo snap refresh rayforge

# Eliminar y reinstalar (último recurso)
sudo snap remove rayforge
sudo snap install rayforge
sudo snap connect rayforge:serial-port

Páginas Relacionadas​