Una alternativa privada a Printables con Docker

Printables y Thingiverse son buenos sitios para descubrir modelos. Son bastante menos útiles como hogar permanente de tus propias descargas, ediciones, diseños privados y archivos laminados.

PrintStash cubre ese segundo trabajo. Es una biblioteca web de código abierto que funciona en Docker y mantiene su base de datos, sus archivos de modelos y sus metadatos en almacenamiento que controlas tú. No es un catálogo público y no intenta sustituir a ninguno.

Qué necesitas

Usa una máquina con Docker y Docker Compose. Un equipo de sobremesa viejo, un servidor doméstico, un NAS compatible o una Raspberry Pi 4 o 5 servirán. PrintStash publica imágenes para linux/amd64 y linux/arm64.

Reserva alrededor de 1 GB de RAM como mínimo. Con dos GB se trabaja más holgado cuando el servidor tiene que previsualizar mallas grandes. El uso de almacenamiento depende de si copias los archivos a la bóveda gestionada o indexas una carpeta existente en su sitio.

Instálalo

mkdir printstash && cd printstash
curl -O https://raw.githubusercontent.com/xiao-villamor/PrintStash/main/docker-compose.yml

docker compose up -d
docker compose logs api | grep "setup token"

No hace falta editar nada antes de ese primer arranque, porque todas las variables del archivo Compose tienen un valor por defecto que funciona y la API genera su propio secreto de firma en el primer inicio. El único valor que tienes que ir a buscar es el token de configuración inicial, que el grep de arriba saca del log de la API.

Abre http://localhost:3000, o sustituye localhost por la dirección del servidor, e introduce el token. El asistente de configuración crea la primera cuenta de administrador. No hay usuario ni contraseña por defecto.

Por defecto se queda en SQLite y disco local. Postgres y el almacenamiento compatible con S3 son opcionales, y la guía de instalación los cubre junto al Compose de producción y las comprobaciones del primer arranque.

Traer una biblioteca que ya existe

Hay tres formas prácticas de empezar:

1. Monta una carpeta local o de un NAS dentro del contenedor de la API y añádela como volumen compartido. PrintStash indexa los archivos en su sitio y replica la estructura de carpetas.
2. Sube archivos, carpetas o archivos ZIP sueltos a la bóveda gestionada.
3. Pega una URL compatible de Printables, MakerWorld o Thingiverse y elige qué archivos importar.

Los volúmenes compartidos son útiles cuando otra aplicación sigue necesitando el árbol de carpetas original. PrintStash guarda los metadatos y las previsualizaciones generadas en su propio directorio de datos, pero los bytes de origen indexados se quedan en el volumen montado. Los archivos nuevos escritos a través de PrintStash pueden volver a ese volumen sin sobrescribir una ruta existente.

Lee usar un NAS con volúmenes compartidos antes de montar un archivo histórico grande.

Qué añade la biblioteca privada

PrintStash agrupa la geometría de origen y el resultado laminado en un registro de modelo. Los archivos STL, 3MF, OBJ, STEP/STP, G-code y BGCODE se pueden buscar juntos en lugar de estar repartidos entre una carpeta de descargas, una carpeta de proyectos del slicer y una impresora.

Para las salidas habituales de OrcaSlicer, PrusaSlicer, Bambu Studio y Cura lee ajustes como el material, el diámetro de boquilla, la altura de capa, las temperaturas, la duración estimada y el consumo de filamento. Varios archivos de G-code pueden convertirse en revisiones con nombre del mismo modelo, con notas y resultados como verificada o fallida.

La biblioteca también incluye:

• previsualizaciones en el navegador para mallas y trayectorias de G-code;
• colecciones, etiquetas, búsqueda por metadatos y detección de duplicados por hash de contenido;
• varias cuentas y roles a nivel de colección;
• enlaces compartidos de solo lectura con caducidad;
• conexiones con impresoras para Moonraker, PrusaLink, OctoPrint, Bambu LAN e impresoras Elegoo compatibles.

Las funciones varían según el proveedor. Consulta la matriz de compatibilidad de impresoras antes de dar por hecho que una impresora concreta admite subidas, inventario remoto o consumo de filamento medido.

Qué queda fuera de PrintStash

Usa Printables, MakerWorld, Thingiverse u otro catálogo para explorar modelos públicos y seguir a diseñadores. PrintStash solo importa a tu biblioteca privada los archivos y los datos de origen que selecciones. Para saber qué partes de la página de un modelo público reproduce y no reproduce una biblioteca privada, incluidas las fotos y los límites de compartición, lee alojar una biblioteca privada al estilo Thingiverse.

Tampoco sustituye a un host de impresora. OctoPrint, Fluidd y Mainsail siguen dando webcams, terminales, configuración de la máquina, macros y control en vivo detallado. PrintStash puede convivir con ellos y encargarse del modelo y del historial de revisiones. La comparativa de controladores explica ese reparto.

El acceso remoto es tu responsabilidad. Mantén el servicio en una red de confianza, o ponlo detrás de un proxy inverso con TLS y una autenticación adecuada. PrintStash no tiene telemetría y no requiere una cuenta alojada.

Prueba primero con una carpeta

Empieza con una carpeta representativa en lugar de escanear el NAS entero. Comprueba que los nombres de archivo, las previsualizaciones y la estructura de colecciones se ven como esperabas. Añade dos laminados de un modelo, apunta por qué se diferencian y marca el resultado después de una impresión.

Si esa carpeta es más fácil de buscar y el registro de revisiones te ayuda después de imprimir, amplía el escaneo. Si añade mantenimiento sin cambiar cómo encuentras los archivos, quédate con el montaje pequeño.