Guia Completa: Instal·lació i Desplegament de Langflow amb Docker a Ubuntu 24

Posted on by Oscar Lastera Sanchez

Introducció a Langflow i Docker

Imagineu-vos tenir un laboratori d’experiments d’Intel·ligència Artificial on podeu crear fluxos de treball complexos simplement arrossegant i deixant anar components. Això és exactament Langflow! I què millor manera de desplegar-lo que amb Docker, l’eina que ha revolucionat la manera com desplegem aplicacions?

En aquesta guia completa us ensenyarem pas a pas com instal·lar i configurar Langflow en el vostre sistema Ubuntu 24. És com muntar un laboratori d’IA professional a casa vostra, però sense la complicació de configurar totes les dependències manualment. Us sembla interessant?

Per què utilitzar Langflow per a IA?

Langflow no és només una eina més d’IA. És el parc de jocs dels desenvolupadors d’IA. Us permet:

  • Crear fluxos de treball d’IA visualment
  • Provar diferents models de llenguatge ràpidament
  • Integrar múltiples serveis d’IA sense escriure codi complex
  • Col·laborar amb altres desenvolupadors en projectes d’IA

I amb Docker, assegurem que tot funcioni de manera consistent, sense importar on s’executi. És com tenir una caixa d’eines d’IA que sempre funciona igual, ja sigui al vostre portàtil, servidor o al núvol.

Prerequisites del sistema

Abans de començar, assegureu-vos que teniu el que cal. No us preocupeu, no es necessita gaire cosa!

Requisits de maquinari

  • RAM: Mínim 4GB (recomanat 8GB o més)
  • Emmagatzematge: 20GB d’espai lliure
  • Processador: 64-bit, 2 nuclis o més

Requisits de software

  • Ubuntu 24.04 LTS (funciona amb altres versions també)
  • Accés a terminal amb permisos de sudo
  • Conexió a Internet per descarregar les imatges de Docker

Configuració inicial d’Ubuntu 24

Comencem posant el nostre sistema a punt. És com preparar el terreny abans de construir una casa.

bash

# Actualitzem la llista de paquets i el sistema
sudo apt update && sudo apt upgrade -y

# Instalem les eines bàsiques que necessitarem
sudo apt install curl wget nano -y

No us preocupeu si veieu moltes línies de text passant per la pantalla. És com veure els materials de construcció arribant al lloc d’obra.

Instal·lació de Docker

Ara ve la part important: instal·lar Docker. Penseu en Docker com els contenidors d’embarcament que usen als ports, però per a aplicacions.

Configuració del repositori

Primer, hem d’afegir el repositori oficial de Docker al nostre sistema:

bash

# Instalem les dependències necessàries
sudo apt install apt-transport-https ca-certificates curl software-properties-common -y

# Afegim la clau GPG oficial de Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# Afegim el repositori a les nostres fonts
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Instal·lació dels paquets

Ara sí, instal·lem Docker:

bash

# Actualitzem la llista de paquets amb el nou repositori
sudo apt update

# Instalem Docker
sudo apt install docker-ce docker-ce-cli containerd.io -y

Configuració dels permisos d’usuari

Un pas crucial que molta gent oblida:

bash

# Afegim el nostre usuari al grup docker
sudo usermod -aG docker $USER

# Apliquem els canvis
newgrp docker

Aquest pas és com rebre les claus del castell: us dóna accés per gestionar contenidors Docker sense necessitat de sudo constantment.

Instal·lació de Docker Compose

Docker Compose és l’ajudant de Docker que us permet gestionar múltiples contenidors amb un sol fitxer de configuració.

bash

# Descarreguem la darrera versió
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# Donem permisos d'execució
sudo chmod +x /usr/local/bin/docker-compose

# Verifiquem que s'hagi instal·lat correctament
docker-compose --version

Si veieu un número de versió, significa que tot ha anat bé! És com rebre el certificat que esteu a punt per començar.

Preparació de l’entorn Langflow

Ara preparem la «casa» on viurà Langflow. Creem l’estructura de directoris:

bash

# Creem el directori principal del projecte
mkdir ~/langflow-project

# Entrem al directori
cd ~/langflow-project

# Creem les subcarpetes necessàries
mkdir flows custom_components config

Aquesta estructura és com organitzar les habitacions d’una casa:

  • flows: on guardareu els vostres fluxos de treball
  • custom_components: per components personalitzats
  • config: per fitxers de configuració

Creació del fitxer docker-compose.yml

Aquest fitxer és el «plànol» que Docker Compose utilitzarà per construir el nostre entorn Langflow.

Creeu el fitxer:

bash

nano docker-compose.yml

I afegiu-hi aquest contingut:

yaml

version: '3.8'

services:
  langflow:
    image: langflowai/langflow:latest
    ports:
      - "7860:7860"
    environment:
      - LANGFLOW_HOST=0.0.0.0
      - LANGFLOW_PORT=7860
      - LANGFLOW_LOAD_FLOWS_PATH=/app/flows
      - LANGFLOW_COMPONENTS_PATH=/app/custom_components
      - LANGFLOW_AUTO_LOGIN=true
    volumes:
      - ./flows:/app/flows
      - ./custom_components:/app/custom_components
      - ./config:/app/config
    restart: unless-stopped

Anàlisi de la configuració:

  • ports: Connecta el port 7860 del contenidor amb el del host
  • volumes: Sincronitza carpetes locals amb les del contenidor
  • environment: Configura el comportament de Langflow
  • restart: Assegura que Langflow es reiniciï automàticament si falla

Desplegament de Langflow

Ara ve el moment de la veritat: executar Langflow!

bash

# Des del directori del projecte
cd ~/langflow-project

# Executem Langflow en segon pla
docker-compose up -d

El paràmetre -d significa «detached», és a dir, el contenidor s’executarà en segon pla.

Verificació de l’estat

Comprovem que tot funcioni correctament:

bash

# Veiem els contenidors en execució
docker-compose ps

# O també podem utilitzar
docker ps

Si tot va bé, hauríeu de veure el contenidor Langflow amb l’estat «Up».

Configuració avançada

Variables d’entorn addicionals

Podeu personalitzar Langflow amb més variables d’entorn:

yaml

environment:
  - LANGFLOW_HOST=0.0.0.0
  - LANGFLOW_PORT=7860
  - LANGFLOW_LOAD_FLOWS_PATH=/app/flows
  - LANGFLOW_COMPONENTS_PATH=/app/custom_components
  - LANGFLOW_AUTO_LOGIN=true
  - LANGFLOW_DATABASE_URL=sqlite:///app/langflow.db

Personalització de fluxos

Els vostres fluxos es guarden a la carpeta flows/. Podeu crear-ne de nous des de la interfície web o importar-ne d’existents.

Solució de problemes comuns

Errors de permisos

Si teniu problemes amb permisos:

bash

sudo chown -R $USER:$USER ~/langflow-project

Conflictes de ports

Si el port 7860 ja està en ús:

yaml

# Canvieu la línia de ports a:
ports:
  - "7861:7860"  # Ara accedireu per http://localhost:7861

Problemes de xarxa

Si no podeu accedir des d’altres dispositius:

bash

# Verifiqueu el tallafocs
sudo ufw status
sudo ufw allow 7860

Optimització del rendiment

Configuració de recursos

Si teniu un sistema potent, podeu assignar més recursos:

yaml

services:
  langflow:
    # ... configuració existent ...
    deploy:
      resources:
        limits:
          memory: 4G
          cpus: '2.0'

Monitorització

Per supervisar el rendiment:

bash

# Veure l'ús de recursos
docker stats

# Veure logs en temps real
docker-compose logs -f

Seguretat i millores pràctiques

Configuracions de seguretat

  • Canvieu el port per defecte en entorns de producció
  • Utilitzeu xifrat SSL/HTTPS
  • Configureu autenticació si s’exposa a Internet

Còpies de seguretat

Les vostres dades importants estan a les carpetes muntades com a volums. Fer còpies és tan simple com:

bash

# Còpia de les carpetes importants
tar -czf langflow-backup-$(date +%Y%m%d).tar.gz ~/langflow-project

Casos d’ús avançats

Components personalitzats

Podeu crear els vostres propis components i guardar-los a custom_components/. Langflow els carregarà automàticament!

Integracions amb APIs

Langflow us permet integrar amb múltiples APIs i serveis:

  • OpenAI GPT
  • Hugging Face models
  • APIs personalitzades
  • Bases de dades

Conclusió

I així és com teniu el vostre propi entorn Langflow funcionant a Ubuntu 24! És com haver muntat un laboratori d’IA completament operatiu amb poques comandes.

Recordeu que aquesta configuració us permet:

  • Experimentar amb fluxos d’IA visualment
  • Guardar els vostres treballs localment
  • Escalar fàcilment quan ho necessiteu
  • Mantenir el control total sobre les vostres dades

Què espereu per començar a crear els vostres propis fluxos d’IA?

Preguntes Freqüents (FAQ)

1. Puc executar Langflow sense Docker?

Sí, però Docker simplifica enormement la gestió de dependències i assegura la consistència entre diferents entorns.

2. Quina és la diferència entre Langflow i altres eines d’IA?

Langflow se centra en la creació visual de fluxos de treball, mentre que altres eines poden estar més orientades a l’ús directe de models específics.

3. Puc utilitzar Langflow per a projectes comercials?

Sí, Langflow és d’ús lliure, però assegureu-vos de revisar les llicències dels models d’IA que utilitzeu.

4. Com puc fer còpies de segureta dels meus fluxos?

Els fluxos es guarden com a fitxers JSON a la carpeta flows/. Fer-ne còpies és tan simple com copiar aquesta carpeta.

5. Puc executar múltiples instàncies de Langflow?

Sí, podeu crear múltiples projectes amb diferents directoris i ports, o utilitzar Docker Compose per gestionar múltiples serveis.