Teljes útmutató a Flowise Dockerrel történő telepítéséhez

Ha mesterséges intelligencia alkalmazásokat szeretne létrehozni anélkül, hogy az összes kódot a nulláról kellene megírnia, a Flowise az egyik legkönnyebben hozzáférhető eszköz. Vizuális felülete lehetővé teszi modellek, utasítások, memória, adatbázisok és külső eszközök összekapcsolását csomópontok segítségével, így egyszerűen létrehozhat. chatbotok, RAG-folyamatok és AI-ügynökök.

Bár a Flowise közvetlenül telepíthető Node.js segítségével, a Docker használata elkerüli a függőségi és verziókezelési problémák nagy részét. Az alkalmazás egy izolált és reprodukálható tartályEzért könnyebb áthelyezni egy másik számítógépre, frissíteni vagy VPS-en telepíteni.

Ebben az útmutatóban bemutatjuk, hogyan telepíthető a Flowise a Docker Compose-szal egyetlen konténer használatával, hogyan őrizhetők meg az adatok az alkalmazás újraindítása vagy frissítése után, és milyen intézkedéseket kell tenni, mielőtt kiteszi az internetre.

Flowise Cloud vagy önálló telepítés: melyik opciót válassza?

Mielőtt bármit is telepítenél, el kell döntened, hogy hol szeretnéd futtatni a Flowise-t. Az első lehetőség a következő: Flowise CloudA szolgáltatást a fejlesztői kezelik. Ez a leggyorsabb módja annak, ha nem szeretne szervereket, adatbázisokat, HTTPS tanúsítványokat vagy biztonsági mentéseket konfigurálni.

A második lehetőség a Flowise saját számítógépen, NAS-on, otthoni szerveren vagy VPS-en történő üzemeltetése. Az önálló tárhelyszolgáltatás nagyobb kontrollt biztosít az infrastruktúra és az adatok felettDe ez felelőssé tesz a frissítésekért, a biztonságért és a biztonsági mentésekért is.

Jellemző	Flowise Cloud	Önirányított Flowise
Létesítmény	Nem igényel saját szervert.	Dockerre, Node.js-re vagy más metódusra van szükséged
Karbantartás	A szolgáltató kezeli	Felhasználói felelősség
Adatkezelés	Attól függ, hogy milyen szolgáltatást kötöttél.	Nagyobb kontroll a tárolás felett
Frissítések	Automatikus	Manuálisan kell alkalmazni őket
Skálázhatóság	Egyszerűsített	Az infrastruktúrától függ
Költség	Előfizetés a csomag szerint	Saját berendezés vagy szerver költsége

Saját számítógépen történő teszteléshez a Docker egy nagyon kényelmes megoldás. Ha a példányt mások is használni fogják, akkor hitelesítést, HTTPS-t, egy megfelelő adatbázist és egy biztonsági mentési stratégiát is konfigurálnia kell.

A Flowise Dockerrel történő telepítésének követelményei

Mielőtt elkezdenéd, telepítened kell a következőket: Docker asztali Windows vagy macOS rendszeren. Linux rendszeren a Docker Engine használható a Docker Compose bővítménnyel együtt.

Ellenőrizze, hogy mindkét komponens működik-e a következő parancs futtatásával:

docker --version
docker compose version

Azt is javasoljuk, hogy telepítsd a Gitet, ha a hivatalos Docker Compose módszert használod:

git --version

A Flowise alapértelmezés szerint a portot használja. 3000Ha egy másik alkalmazás már használja, akkor a konténert egy másik porton kell közzétenni, például a 3001.

Hogyan telepítsük a Flowise-t a Docker Compose használatával

A Docker Compose a leginkább ajánlott módszer, mivel a konfigurációt fájlokba menti, amelyeket később áttekinthet, módosíthat és újra felhasználhat. Emellett leegyszerűsíti a frissítéseket, és lehetővé teszi más szolgáltatások, például a PostgreSQL vagy a Redis hozzáadását, ha a projekt növekszik.

Klónozza a hivatalos adattárat

Nyiss meg egy terminált és töltsd le a Flowise repository-t:

git clone https://github.com/FlowiseAI/Flowise.git
cd Flowise/docker

A címtáron belül docker Megtalálod a Compose fájlt és egy példát a környezeti változókkal.

.env fájl létrehozása és áttekintése

Linux vagy macOS rendszeren a következőképpen hozhatod létre a fájlt:

cp .env.example .env

A PowerShellben az ezzel egyenértékű parancs a következő:

Copy-Item .env.example .env

Ezután nyissa meg a fájlt .env és ellenőrizze az értékeiket. Az elérhető változók verziónként változhatnak, ezért mindig a legjobb, ha a telepítendő verzióban található példafájllal kezdi.

Fordítson különös figyelmet a munkamenetek és tokenek védelmére használt portra, adatbázis-konfigurációra, tárolási útvonalakra és titkokra. Ne használja fel újra a mintaértékeket nyilvános példányban.

Emelje fel a tartályt

A mappából Flowise/docker, fuss:

docker compose up -d

A paraméter -d Elindítja a háttérben futó szolgáltatásokat. Az állapotukat a következőképpen ellenőrizheti:

docker compose ps

A legfrissebb rekordok megtekintéséhez:

docker compose logs --tail=100

Ha minden megfelelően működik, nyisd meg ezt a címet a böngésződben:

http://localhost:3000

Egy új telepítés során be kell fejeznie a létrehozását a következőnek: rendszergazdai fiókHasználjon egyedi és kellően erős jelszót, különösen akkor, ha az alkalmazás más számítógépekről is elérhető lesz.

Hogyan telepítsük a Flowise-t egyetlen Docker paranccsal

A Docker Hubon közzétett képet közvetlenül is futtathatod. Ez a módszer hasznos gyors tesztek végrehajtásához a repository klónozása nélkül.

Először hozzunk létre egy kötetet, ahová az adatokat tárolni fogjuk:

docker volume create flowise_data

Ezután elindul a konténer:

docker run -d \
  --name flowise \
  --restart unless-stopped \
  -p 3000:3000 \
  -v flowise_data:/home/node/.flowise \
  flowiseai/flowise:latest

A PowerShellben vagy a CMD-ben egyetlen sorban is beírhatja a parancsot:

docker run -d --name flowise --restart unless-stopped -p 3000:3000 -v flowise_data:/home/node/.flowise flowiseai/flowise:latest

A legfontosabb rész a következő:

-v flowise_data:/home/node/.flowise

Az aktuális kép a felhasználón keresztül futtatja az alkalmazást. node, akinek a személyes címtára a /home/nodeA kötet lehetővé teszi a folyamatokat, hitelesítő adatokat, konfigurációkat és egyéb fájlokat. túléli a tartály kidobását.

A paraméter --restart unless-stopped Ez azt eredményezi, hogy a Docker újraindítja a Flowise-t a számítógép vagy a szerver újraindítása után, kivéve, ha a konténert szándékosan leállították.

Hogyan lehet megváltoztatni a Flowise portot

A bal oldalon található érték -p 3000:3000 Ez a gazdagép portjának felel meg. Ha a 3000-es port használatban van, akkor használhat egy másik portot a konténer belső portjának megváltoztatása nélkül:

docker run -d \
  --name flowise \
  --restart unless-stopped \
  -p 3001:3000 \
  -v flowise_data:/home/node/.flowise \
  flowiseai/flowise:latest

Ebben az esetben a következő módon férhetsz hozzá:

http://localhost:3001

Ha a Flowise a hálózaton lévő másik számítógépen fut, akkor lecseréli a localhost az IP-címe alapján. Mielőtt ezt megtenné, győződjön meg arról, hogy a tűzfal engedélyezi a kapcsolatot, és hogy a példány megfelelően védett.

A Flowise leállítása, indítása és újraindítása

Ha létrehoztál egy ún. konténert flowiseEzekkel a parancsokkal kezelheted:

docker stop flowise
docker start flowise
docker restart flowise

Annak ellenőrzéséhez, hogy fut-e:

docker ps

Ha a tartály nem jelenik meg, mutassa meg a fogvatartottaknak is:

docker ps -a

A naplók gyakran az elérési utakkal, portokkal, adatbázisokkal vagy környezeti változókkal kapcsolatos problémákat tárnak fel:

docker logs --tail=100 flowise

Ha Docker Compose-t használsz, használd ezeket a parancsokat abból a mappából, ahol a megfelelő fájl található:

docker compose stop
docker compose start
docker compose restart
docker compose logs --tail=100

Hogyan frissíthető a Flowise a chatflow-k elvesztése nélkül

Bármilyen frissítés előtt készítsen biztonsági mentést. A kötet megőrzése csökkenti az adatvesztés kockázatát, de Az állandó kötet nem helyettesíti az önálló másolatot.

Docker Compose használata esetén a szokásos eljárás a következő:

docker compose pull
docker compose up -d

A Compose letölti a megadott rendszerképet, és szükség esetén újra létrehozza a szolgáltatásokat, megtartva a konfigurációjában definiált köteteket.

Ha manuálisan hozta létre a tárolót, töltse le a frissített rendszerképet:

docker pull flowiseai/flowise:latest

Ezután csak a tárolót töröljük, a kötetet ne:

docker stop flowise
docker rm flowise

Végül futtassa újra ugyanazt a parancsot, amellyel létrehozta:

docker run -d \
  --name flowise \
  --restart unless-stopped \
  -p 3000:3000 \
  -v flowise_data:/home/node/.flowise \
  flowiseai/flowise:latest

Az adatok továbbra is elérhetőek maradnak, mert belül maradnak. flowise_dataEnnek ellenére ellenőrizze az egyes verziók kiadási megjegyzéseit, hátha vannak migrációk, változóváltozások vagy inkompatibilitások.

Termelési környezetben előnyösebb a kép egy adott verziójának javítása és tesztelje frissítés előtt, ahelyett, hogy állandóan a címkére hagyatkozna latest.

A .env fájlban végrehajtott módosítások alkalmazása

Egy konténer újraindítása nem mindig alkalmaz új környezeti változókat, mivel ezek a létrehozásakor beépülnek. Ha a Docker Compose-t használod, és módosítottad a fájlt .env, fuss:

docker compose up -d --force-recreate

Ez újra létrehozza a konténereket az új konfigurációval anélkül, hogy törölni kellene a köteteiket.

A Compose által a módosítás alkalmazása előtt értelmezett változók áttekintéséhez a következőt használhatja:

docker compose config

Ne oszd meg nyilvánosan a teljes kimenetet, ha jelszavakat, titkos kódokat vagy bejelentkezési adatokat tartalmaz.

Hogyan készítsünk biztonsági másolatot a Flowise-ról

Ha egy Docker kötetet használtál, melynek neve flowise_dataTömörített másolatot hozhatsz létre a következővel:

docker run --rm \
  -v flowise_data:/data \
  -v "$PWD":/backup \
  alpine \
  tar czf /backup/flowise-backup.tar.gz -C /data .

Windows rendszeren kényelmesebb lehet a Docker Desktop használatával megvizsgálni a kötetet, vagy egy rendszermappát csatolásként definiálni. Ha helyi könyvtárat használ, győződjön meg arról, hogy a konténer által használt 1000 UID-val rendelkező felhasználó írási jogosultsággal rendelkezik.

PostgreSQL telepítések esetén az adatbázisról külön biztonsági másolatot kell készíteni. Ezenkívül ajánlott megőrizni a hitelesítő adatok titkosításához használt kulcsot; a megfelelő kulcs nélküli helyreállított adatbázis használhatatlanná teheti a tárolt hitelesítő adatokat.

Hogyan védjük meg a Flowise-t, mielőtt közzétesszük az interneten

A VPS 3000-es portjának közvetlen közzététele nem megfelelő konfiguráció éles környezethez. A Flowise képes tárolni a szállítói hitelesítő adatokat, az adatbázis-kapcsolatokat és a külső műveletek végrehajtására alkalmas eszközöket.

Az internetről való hozzáférés engedélyezése előtt legalább a következő intézkedéseket kell alkalmazni:

• Hozz létre egy rendszergazdai fiókot egy erős, egyedi jelszóval.
• Konfigurálja helyesen a munkamenet-titkokat, a JWT-ket és a tokeneket.
• Helyezd a Flowise-t egy fordított proxy mögé, például Nginx, Caddy vagy Traefik.
• Aktiválja a HTTPS-t érvényes tanúsítvánnyal.
• Ne tegye elérhetővé az API-kat vagy a chatflow-kat megfelelő védelem nélkül.
• Korlátozza a hozzáférést a tűzfalon keresztül, ha azt csak belsőleg használják.
• Rendszeresen készítsen biztonsági másolatot adatairól és kulcsairól.
• Rendszeresen frissítsd a Flowise-t, a Dockert és az operációs rendszeredet.
• Kerülje a titkok közvetlen tárolását a megosztott csomópontokon vagy sablonokon belül.

Minden egyes közzétett chatflow-t védeni kell. Az admin fiók korlátozza a hozzáférést az irányítópulthoz, de egy predikciós API-nak vagy egy beágyazott chatbotnak szüksége lehet rá. saját kulcs, használati korlátok és hozzáférés-vezérlés.

Hogyan hozd létre az első chatbotodat a Flowise-ban

Bejelentkezés után különböző típusú folyamatokat hozhat létre. Csevegési folyamatok Úgy tervezték őket, hogy párbeszédes karakterláncokat és alkalmazásokat hozzanak létre. Agentflow-k Lehetővé teszik összetettebb folyamatok tervezését, amelyekben a modell eszközöket használ, döntéseket hoz és különböző lépéseket hajt végre.

Egy egyszerű chatbot használatának elkezdéséhez:

1. Lépjen be a szakaszba Csevegési folyamatok.
2. Nyomja meg a gombot egy új folyamat létrehozásához.
3. Adjon hozzá egy csomópontot, amely megfelel a csevegési szolgáltatónak vagy modellnek.
4. Hozza létre a szükséges hitelesítő adatokat az API-hoz való csatlakozáshoz.
5. Adja hozzá a szükséges karakterláncot, promptot vagy összetevőket.
6. Kösd össze a csomópontokat a bemeneteik és kimeneteik figyelembevételével.
7. Mentsd el a folyamatot, és használd a chat gombot a teszteléshez.

A Flowise képes együttműködni külső szolgáltatókkal és kompatibilis helyi modellszerverekkel. Ez utóbbi esetben ne feledje, hogy localhost a konténeren belül magára a konténerre mutat, nem feltétlenül a gazdagépre. A Docker Desktopban ezt gyakran használják. host.docker.internal hogy elérje a gazdagépen futó szolgáltatást.

Hogyan adhatunk hozzá memóriát és utasításokat a chatbothoz

A modellnek világos utasításokra van szüksége a funkciójával, a használandó hangvétellel és a tiszteletben tartandó határokkal kapcsolatban. A kiválasztott munkafolyamattól függően ezek az utasítások prompt, rendszerüzenet vagy az ügynök saját beállításai révén biztosíthatók.

A memória lehetővé teszi a korábbi üzenetekből származó információk megőrzését. Azonban nem szabad összekeverni a tudásbázissal: a memória a beszélgetés kontextusát tárolja, míg egy RAG rendszer... dokumentumokból vagy külső forrásokból keres információt.

A történet túlzott növelése növelheti a költségeket, a késleltetést és a memóriafogyasztást. A legjobb, ha a memória típusát és a kontextus hosszát a chatbot tényleges igényei szerint választjuk ki.

Hogyan hozzunk létre egy RAG chatbotot a dokumentumainkkal

A Flowise tartalmazza DokumentumboltokEgy olyan felület, amely lehetővé teszi dokumentumok betöltését, felosztását, előkészítését és beszúrását egy vektoros adatbázisba. Ez leegyszerűsíti az RAG-alkalmazások létrehozását.

Egy ilyen típusú alapvető folyamat a következőket tartalmazza:

• Dokumentumok forrása, például PDF fájlok, weboldalak vagy szöveg.
• Egy elválasztó, amely a tartalmat kezelhető blokkokra tördeli.
• Egy beágyazási modell, amely szöveget vektorokká alakít.
• Egy vektoros adatbázis, ahol ezeket a töredékeket tárolják.
• Egy visszakereső eszköz, amely a kérdéshez kapcsolódó információkat keresi meg.
• Egy nyelvi modell, amely a lekért kontextus felhasználásával fogalmazza meg a választ.

Az RAG biztosítani tudja, hogy a válaszok a benyújtott dokumentumokhoz képest jobban megalapozottak és naprakészek legyenek. Azonban Nem szünteti meg teljesen a hallucinációkatA végső minőség az eredeti tartalomtól, a dokumentumok felosztásától, a beágyazásoktól, a visszakereséstől és a modellnek küldött utasításoktól függ.

A Flowise gyakorlati alkalmazási esetei

Az egyik leggyakoribb felhasználási mód az, hogy létrehozzunk egy támogatási asszisztens amely hivatalos vállalati dokumentáció felhasználásával válaszol a termékekkel, számlázással, visszaküldéssel vagy incidensekkel kapcsolatos kérdésekre.

Emellett egy érdeklődőpontozási rendszer fejlesztésére is használható. A chatbot összegyűjti a látogatók adatait, meghatározza az érdeklődésük szintjét, és egy API-n keresztül elküldi az adatokat egy külső CRM- vagy automatizálási rendszernek.

Egy másik példa egy belső asszisztens, amely lehetővé teszi a felhasználók számára, hogy szabályzatokat, technikai eljárásokat vagy vállalati dokumentációt tekintsenek meg. Ebben az esetben megfelelő engedélyeket kell alkalmazni annak megakadályozására, hogy a felhasználó olyan információkat kérjen le, amelyekhez nem kellene hozzáférnie.

Az ágensfolyamatok kibővítik ezeket a lehetőségeket azáltal, hogy lehetővé teszik a modell számára az eszközök használatát. Egy ágens lekérdezhet egy adatbázist, meghívhat egy API-t, strukturált választ generálhat, vagy elindíthat egy másik folyamatot. Pontosan ezért, A műveletek végrehajtására alkalmas eszközöket korlátozni és felügyelni kell..

Gyakori hibák a Flowise Dockerrel történő telepítésekor

A 3000-es port már foglalt

Ha hibát kap, amely azt jelzi, hogy a port nem köthető, tegye közzé a konténert egy másik porton:

-p 3001:3000

A folyamatok eltűnnek, amikor a tárolót újra létrehozzák.

Ez általában azt jelenti, hogy egy állandó kötet nincs megfelelően konfigurálva. Ellenőrizze, hogy egy ilyen lefoglalást használ-e:

-v flowise_data:/home/node/.flowise

A Flowise nem tud írni a csatolt mappába.

A kép a felhasználóval együtt végrehajtja a folyamatot. nodeHa Linuxon csatlakoztatsz egy host mappát, akkor annak engedélyeznie kell az írást az 1000-es UID-val rendelkező felhasználó számára.

A tartály folyamatosan elindul és leáll

Tekintse át a feljegyzéseket:

docker logs flowise

A leggyakoribb okok az üres vagy helytelen változók, az engedélyek nélküli elérési utak, a nem konfigurált titkok, az adatbázis-problémák vagy a frissítés utáni inkompatibilitások.

A Flowise nem csatlakozik a számítógépre telepített más szolgáltatáshoz.

A tartály belsejében, localhost Ez magára a konténerre vonatkozik. A Docker Desktopban próbáld ki a következőt:

http://host.docker.internal:PUERTO

Linux rendszeren szükség lehet egy elérési út hozzáadására a gazdagéphez, vagy a Docker interfésznek megfelelő cím használatára.

A Flowise Dockerrel történő telepítése lehetővé teszi a következők kombinálását: könnyen hozzáférhető vizuális felület reprodukálható és önmenedzselhető környezettelA teszteléshez egy konténer és egy perzisztens kötet elegendő, de egy valós megvalósításhoz hitelesítésre, HTTPS-re, biztonsági mentésekre és ellenőrzött frissítésekre is szükség van.

Miután a környezet beállt, elkezdhetsz egy alapvető chatbottal, és fokozatosan bővítheted a memóriát, a dokumentumtárolókat, az RAG-lekérést és a külső eszközöket. Így a Flowise egy kis helyi prototípusból egy más szolgáltatásokkal integrált AI-alkalmazássá fejlődhet.