Docker
Docker er den nemmeste produktionslignende implementering på én server. Til en internettilgængelig server bør du begynde med Privat fjernimplementering, hvis skabelon ikke publicerer porte og tilføjer Cloudflare Access, værtsbeskyttelse, sikkerhedskopiering og containergrænser.
Standardimaget følger main. Dockergruppen hedder docker, og lokale indstillinger som DOCKER_GID gemmes i .env.
Work-tilgængelighed
Work er aktiveret som standard i repositoryets Compose-filer. Imaget indeholder Docker CLI, og Compose monterer /var/run/docker.sock, så Work-containere er sideordnede med Libre WebUI-containeren og ses i docker ps på værten.
Adgang til socketen giver root-lignende kontrol over Docker-værten. Derfor er hver Libre WebUI-administrator i praksis også værtsadministrator. Brug en betroet vært, eksponér ikke porten mod et upålideligt netværk, og fjern monteringen, hvis Work ikke er nødvendigt; derefter viser Work Kørselsmiljø ikke tilgængeligt.
På Linux behøver appbrugeren Docker-socketens gruppe-id:
echo "DOCKER_GID=$(docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
alpine stat -c '%g' /var/run/docker.sock)" >> .env
Læs værdien gennem en container; macOS-værtens værdi adskiller sig på grund af Docker Desktops VM. Forkert gruppe vises tydeligt på Work-siden. Se Work: isolerede arbejdsområder.
Work-forhåndsvisninger og Work Computer publicerer kun tilfældige porte på en privat værtsgrænseflade. Docker Desktop fungerer med Compose-standardværdierne: værtens loopback til bindingen og host.docker.internal til backendforbindelsen. Native Docker Engine kan ikke nå en lytter på værtens loopback fra en søskendecontainer. Angiv i stedet bindingen til dens ikke-offentlige gateway for Docker-bridgen:
echo "WORK_PREVIEW_BIND=$(docker network inspect bridge \
--format '{{(index .IPAM.Config 0).Gateway}}')" >> .env
echo "WORK_DOCKER_PUBLISHED_HOST=host.docker.internal" >> .env
docker compose up -d --force-recreate libre-webui
Compose-filerne mapper host.docker.internal gennem host-gateway. Brug aldrig WORK_PREVIEW_BIND=0.0.0.0; det ville publicere uautentificerede midlertidige opgaveporte på alle værtens grænseflader i stedet for at holde dem bag Libre WebUIs signerede proxy.
Indbygget Ollama
docker compose up -d
Åbn http://localhost:8080. WebUI-porten bindes som standard til værtens loopback. Angiv kun WEBUI_BIND_ADDRESS=0.0.0.0, når et betroet LAN eller en reverse proxy på værten skal nå den, og begræns porten med værtens firewall.
Ollama forbliver privat i Compose-netværket. Til loopbackadgang fra apps på værten:
docker compose -f docker-compose.yml -f docker-compose.ollama-host.yml up -d
Angiv kun OLLAMA_BIND_ADDRESS, når en anden computer skal nå Ollama, og beskyt porten.
NVIDIA GPU
Brug GPU-filen til Compose, når Docker har adgang til NVIDIA-runtimen:
docker compose -f docker-compose.gpu.yml up -d
Bekræft GPU-adgangen fra Ollama-containeren, hvis modellerne stadig kører på CPU.
Ekstern Ollama
Brug denne variant, når Ollama allerede kører på værten eller på en anden server:
docker compose -f docker-compose.external-ollama.yml up -d
Tilsidesæt Ollama-URL'en ved behov:
OLLAMA_BASE_URL=http://192.168.1.10:11434 docker compose -f docker-compose.external-ollama.yml up -d
Work med isoleret socket
Standardfilerne til Compose monterer Docker-socketen i Libre WebUI-containeren, så Work kan køre opgavecontainere; den montering svarer til root-kontrol over Docker-værten. Brug varianten med socket-proxy, hvis du vil beholde Work uden at give webprogrammet socketen:
docker compose -f docker-compose.socket-proxy.yml up -d
En socket-proxy på et internt netværk holder /var/run/docker.sock og videresender kun de API-dele, som Work bruger (containere, images, diskenheder, netværk, exec og info). Endpoints til Swarm, secrets, configs, build og system afvises i proxyen. Libre WebUI når proxyen via DOCKER_HOST=tcp://docker-socket-proxy:2375 uden socketmontering og uden DOCKER_GID, og den interaktive terminal og systemdiagnostikken virker uændret. Se dokumentationen om arbejdsområder for, hvad denne grænse dækker, og hvad den ikke dækker.
Vedvarende data
Libre WebUI gemmer backenddata i /app/backend/data inde i containeren. Compose-filerne monterer den sti som en navngiven diskenhed.
Imaget bruger også den sti som standard, når det startes direkte med docker run; dets midlertidige område til databasens preflight ligger separat under /app/backend/temp. Montér /app/backend/data, når containeren kan blive genskabt.
Angiv stabile hemmeligheder i produktion:
JWT_SECRET=replace-with-a-long-random-secret
ENCRYPTION_KEY=replace-with-64-hex-characters
Sikkerhedskopiér datadiskenheden og krypteringsnøglen sammen.
Før du fjerner en direkte startet container, der er oprettet fra et ældre image, skal du bekræfte, at /app/backend/data/.encryption_key findes, eller notere den konfigurerede ENCRYPTION_KEY. Ældre images kunne skrive en automatisk genereret nøgle udelukkende til containerlaget; sletter du den container, sletter du også den eneste nøgle, der kan dekryptere dens gemte database.
Hvis du driver et tilpasset runtime med Work-understøttelse, ligger dets opgavefiler i separate navngivne Docker-diskenheder og indgår ikke i den normale backup af /app/backend/data.
Offentlig adgang
Repositoryets Compose-filer binder WebUI til loopback og angiver CORS_ORIGIN direkte. En værdi i din shell eller i .env-filen erstatter ikke denne faste værdi. Redigér posten libre-webui.environment, eller gem en eksplicit tilsidesættelse som compose.origin.yml:
services:
libre-webui:
environment:
CORS_ORIGIN: https://your-domain.example
BASE_URL: https://your-domain.example
Anvend tilsidesættelsen sammen med den valgte Compose-fil fra repositoryet:
docker compose -f docker-compose.yml -f compose.origin.yml up -d
Placér derefter Libre WebUI bag HTTPS med en reverse proxy eller platformens load balancer. Angiv WEBUI_BIND_ADDRESS til præcis den grænseflade, proxyen har brug for; publicér ikke porten på alle grænseflader, medmindre firewallen kræver det.
Serveren leverer allerede den byggede frontend effektivt: hashede bundter under /js/ og /assets/ sendes brotli- eller gzip-komprimeret med et års immutable cachelevetid, mens index.html og service worker-filen markeres no-cache, så en ny udgivelse hentes ved næste indlæsning. En proxy behøver hverken at komprimere igen eller cache de stier; send Accept-Encoding videre.
Nyttige kommandoer
docker compose ps
docker compose logs -f libre-webui
docker compose logs -f ollama
docker compose pull
docker compose up -d