Ugrás a fő tartalomra

🖥️ Asztali alkalmazás

A Libre WebUI asztali alkalmazása natív ablakba ágyazza a webes felületet macOS, Windows és Linux rendszeren. Egy Libre WebUI-szerverhez csatlakozik: az ugyanazon a gépen futóhoz vagy bármely megadott szerverhez.

Az alkalmazás saját tárolóban készül; minden kiadás telepítői a fő tároló GitHub-kiadásaihoz vannak csatolva.

📦 Letöltés és telepítés​

Töltse le a platformjának megfelelő csomagot a legújabb kiadásból:

  • macOS (Apple Silicon): Libre-WebUI-Desktop-{version}-mac-arm64.dmg vagy .zip, illetve brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows: Libre-WebUI-Desktop-Setup-{version}.exe (telepítő) vagy Libre-WebUI-Desktop-{version}.exe (hordozható)
  • Linux: Libre-WebUI-Desktop-{version}.AppImage vagy Libre-WebUI-Desktop-{version}-{arch}.deb

Az átnevezés előtti kiadások ezeket az elemeket Libre-WebUI-Frontend előtaggal, Libre WebUI Frontend.app nevű alkalmazáscsomagban adták ki.

A macOS sérültként blokkolja az alkalmazást​

A Libre WebUI átmenetileg ad hoc aláírást használ a macOS-buildekhez. Ez szerkezetileg érvényesen tartja az alkalmazáscsomagot, de nem azonosítja a kiadót az Apple felé, és nem teszi lehetővé a hitelesítést. Miután az alkalmazást az Applications mappába másolta, engedélyezze a Rendszerbeállítások → Adatvédelem és biztonság → Megnyitás mindenképpen útvonalon.

Ha a macOS nem kínálja fel ezt a lehetőséget, csak azután távolítsa el a karanténattribútumot, hogy ellenőrizte: az alkalmazás a hivatalos Libre WebUI-kiadásból származik:

xattr -dr com.apple.quarantine "/Applications/Libre WebUI Desktop.app"
open "/Applications/Libre WebUI Desktop.app"

Ne tiltsa le globálisan a Gatekeepert. A zökkenőmentes terjesztéshez továbbra is Developer ID Application tanúsítvány és Apple-hitelesítés szükséges.

🔌 Csatlakozás szerverhez​

Az alkalmazás kliens, ezért Libre WebUI-szerverre van szüksége. Első indításkor a kezdőképernyő két lehetőséget kínál:

  • Helyi: az alkalmazás szervert keres a gépen (3001-es port, a Docker-lemezkép és az npx libre-webui alapértelmezése), majd az állapotellenőrzés válaszakor csatlakozik.
  • Távoli: adja meg bármely elérhető Libre WebUI-szerver URL-jét, például egy otthoni labor vagy csapattelepítés címét. Az alkalmazás csatlakozás előtt ellenőrzi a szervert.

A választás megmarad. Későbbi szerverváltáshoz használja a menüsáv Libre WebUI → Szerverváltás… elemét. Ha a megjegyzett szerver nem válaszol, az alkalmazás üres ablak helyett visszatér a kezdőképernyőre.

Helyi szerver futtatásához lásd a Gyors kezdést: a Docker Compose, az npx libre-webui és a Homebrew egyaránt használható.

🧰 Work az asztali alkalmazásban​

Az asztali csomag nem tartalmazza a backendet, a Dockert vagy a Work konténer-runtime-ját. A Work elérhetőségét a csatlakoztatott szerver határozza meg:

  • az a natív backend, amely futtatni tudja a docker info parancsot, feladathoz kötött Work-konténereket és elnevezett köteteket hozhat létre;
  • a tároló szabványos Compose-telepítése a gazda Docker-socketjének csatolásával biztosít Docker-alapú Worköt, míg az elérhető runtime nélküli egyéni konténertelepítés elérhetetlenként jelzi a Worköt;
  • a Kubernetes-szerver Pod/PVC-alapú Worköt biztosít, ha a Helm chart work.enabled=true beállítással van telepítve; és
  • az alkalmazás a Work elérhetetlensége esetén is támogatja a Csevegést.

A Work-fájlok a szerver Docker-gazdagépén vagy Kubernetes-tárolójában találhatók, nem az asztali alkalmazásban. Az előnézetek a Libre WebUI aláírt, azonos eredetű proxyján haladnak át, így a helyi és távoli asztali kliensek is használhatják őket, ha a szerver reverse proxya megőrzi a HTTP- és WebSocket-forgalmat.

🎨 Asztali integráció​

  • Natív menüsáv alkalmazás-, szerkesztés-, nézet-, ablak- és súgómenükkel
  • Egyéni macOS-címsor (hiddenInset), az ablakgombokkal az oldalsávon
  • A sötét mód követi a rendszerbeállítást
  • A külső hivatkozások az alapértelmezett böngészőben nyílnak meg, soha nem az alkalmazáson belül
  • A renderer környezet-elkülönítéssel és Node-integráció nélkül fut

🚧 Korlátozások​

  • macOS-architektúra: a jelenlegi macOS-csomagok csak az Apple Silicon (arm64) rendszert támogatják
  • Szervert igényel: az alkalmazás nem tartalmazza a backendet
  • A Work a szerver runtime-jától függ: nincs benne Docker- vagy Kubernetes-runtime
  • Nincs automatikus frissítés: a frissítéshez új csomagot kell letölteni

A runtime, a szolgáltatók, a tárolás és az előnézet biztonsági részleteiért lásd a Work: Elszigetelt munkaterületek oldalt.