AiHummer
Dansk▾
Log indKonto
v1.6.x▾
{ }Swagger

Miljøvariabler

v1.6.x · opdateret 2026-11-15

AIHUMMER_PUBLIC_TLS_CERT_FILE + AIHUMMER_PUBLIC_TLS_KEY_FILE: HTTPS kan leveres af gatewayen med et certifikat/privat nøgle-par eller af en omvendt proxy. Et ugyldigt konfigureret par erstattes aldrig af almindelig HTTP. Sammenlign SHA-256-fingeraftrykket med den betroede installationsterminal, før du godkender et privat certifikat i appen.

AiHummer-konfiguration opdeles i to strengt forskellige grupper:

  1. Bootstrap (gateway.env) — hvad porten skal vide før det kan læs databasen: database DSN, lytteadresser, statiske mapper, hovednøglen. Kun disse nøgler læses fra miljøet.
  2. Indstillingskatalog (database) — hver anden knap. Disse opbevares i database og indstil i webadmin-brugerfladen (Administration → Indstillinger) eller med aihummer settings set <KEY> <VALUE>. For disse taster a gateway.env værdi er med vilje ignoreret — selvom det er indstillet, har det ingen effekt.

Konfigurationsmodel

gateway.env er kun bootstrap. Beslutningsrækkefølge:

  • Indstillingskatalognøgle: database value → built-in default (miljøet ignoreres);
  • bootstrap-nøgle: environment variable only.

Så den eneste kilde til sandheden for justerbare knapper er databasen (webadmin UI / aihummer settings); miljøet bærer kun det, processen har brug for at starte.

Konfigurationsfilen til en host-native installation ligger på:

# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes

[!TIP] Sæt ikke Settings-katalogknapper i gateway.env — det har ingen effekt. Skift dem i webadmin-brugerfladen (Administration → Indstillinger, den har søgefunktion) eller via aihummer settings set. Nogle ændringer (såsom værktøjsskift og underagent dybde) anvend varm; andre kræver en genstart af tjenesten.

Bootstrap (gateway.env)

De eneste nøgler, som gatewayen faktisk læser fra miljøet.

Kerne & database

Variabel Formål
AIHUMMER_DATABASE_URL Påkrævet. Postgres DSN. Uden det kører gatewayen kun i sundheds-tilstand.
AIHUMMER_DB_APP_URL Begrænset-rolle DSN, der aktiverer række-niveau sikkerhed (indstilles automatisk for lokale installationer).
AIHUMMER_GATEWAY_ADDR Webpanelet, apps og kanaler bruger samme offentlige serveradresse. Åbn den offentlige adresse, installationsprogrammet viser; den lokale standardadresse er http://localhost:8780/. Porten valgt under installationen kan være en anden.
AIHUMMER_WEBUI_ADDR AIHUMMER_WEBUI_ADDR er en ekstra operatørlytter kun på loopback, som standard 127.0.0.1:8781, til kompatibilitet med første opsætning. Det er ikke en særskilt ekstern paneladresse; 0 er ugyldig. AIHUMMER_WEBUI_ENABLED=false deaktiverer panelet på begge lyttere.
AIHUMMER_DEFAULT_WORKSPACE_ID Vælger standardarbejdsområdet for konfigurerede indgående integrationer.
AIHUMMER_HOME_ROOT Installer rod (normalt afledt af binærstien); forankrer admin-ui/blob/installer-mapperne og nøglefilerne.
AIHUMMER_BLOB_DIR Aktiverer medie-/filtjenesten (blob-lagringsmappe). Det gemmer også private (side-indlæste) plugin-artefakter under blob: refs som deployeren løser.
AIHUMMER_ADMIN_UI_DIR Webpanelet, apps og kanaler bruger samme offentlige serveradresse. /

Hemmeligholdelser og infrastruktur

Variabel Formål
AIHUMMER_MASTER_KEY base64-kodede 32 bytes; muliggør hemmeligheder i hvile, hvælvet og BYOK.
AIHUMMER_MEDIA_TOKEN_SECRET Holder underskrevne download-URL’er gyldige på tværs af genstarter.
AIHUMMER_OTEL_ENDPOINT OTLP-endpoint til push af spor/metrikker.
AIHUMMER_DOWNLOAD_BASE_URL Base-URL for udgivelsesartefakter (selvopdateringskilde).

[!WARNING] Observabilitet er Kun OTLP push. AiHummer gør ikke afsløre en Prometheus /metrics endepunkt eller /debug/pprof. Punkt AIHUMMER_OTEL_ENDPOINT hos dig indsamler i stedet.

Indstillingskatalog (database — webadministrationsgrænseflade eller aihummer settings)

Hver tast nedenfor findes i databasen. Indstil den i webadmin-brugergrænsefladen (Administration → Indstillinger) eller sådan her:

aihummer settings set AIHUMMER_LLM_PROVIDER openai

A gateway.env værdien for en sådan nøgle er ignoreret.

Sikkerhed

Nøgle Formål
AIHUMMER_APPROVAL_TOOLS Værktøjer, der kræver menneskelig godkendelse, før de kører.
AIHUMMER_AIRGAPPED 1 blokerer modelstyret offentlig udgang (luftafskåret tilstand).
AIHUMMER_AUDIT_RETENTION_DAYS Opbevaringsperiode for admin-revisionsloggen.
AIHUMMER_INBOUND_SECRET HMAC delt hemmelighed for connector → gateway /v1/inbound/* opkald.

Autentificering og SSO

Nøgle Formål
AIHUMMER_OIDC_ISSUER Beskytter /v1/admin/*. Uden det (og uden LDAP/SAML) stoler admin på dev-headere — udsæt aldrig en sådan instans.

LDAP/AD og SAML er konfigureret sammen med OIDC til virksomhedssignering; SCIM leverer automatisk brugerprovisionering. Se Webhooks, SCIM og parring.

LLM & modeller

Nøgle Formål
AIHUMMER_LLM_PROVIDER Modeludbyder, der skal bruges.
AIHUMMER_LLM_MODEL Modelnavn.
AIHUMMER_LLM_GATEWAY_URL Grund-URL for en OpenAI-kompatibel LLM-gateway/endpoint (den AIHUMMER_LLM_* sti; adskilt fra den oprindelige AIHUMMER_OPENAI_BASE_URL). Se BYOK & udbydere.
AIHUMMER_OPENAI_API_KEY API-nøgle til en OpenAI-kompatibel udbyder.
AIHUMMER_SUBAGENT_MAX_DEPTH Maksimal dybde af genererede underagenter.

[!NOTE] Tilslut en rigtig modeludbyder for at få brugbare svar. En betalt API-nøgle er ikke nødvendig: brug en lokal OpenAI-kompatibel model, et understøttet abonnement eller din egen API-nøgle. Hvis ingen udbyder er konfigureret, vises fejlen: Ingen AI-modeludbyder er konfigureret endnu – tilføj en i afsnittet Modeller

Værktøjer

Nøgle Formål
AIHUMMER_FS_ROOT Indsnævrer den tilladte filrod yderligere; en tom værdi giver ikke adgang til værtsmaskinen.
AIHUMMER_DB_QUERY_DSN Muliggør db_query (skrivebeskyttet) mod dette DSN.
AIHUMMER_CODE_EXEC code_exec er slået fra som standard
AIHUMMER_BROWSER_PROFILE_SOCKET Sti til browsertjenestens private managed-profiles.sock-sokkel; tom — vedvarende computer-profiler er slået fra.
AIHUMMER_BROWSER_PROFILE_BINDINGS JSON-array af udtrykkelige bindinger for vedvarende browserprofiler (profile_id, tenant_id, user_id, agent_ids, conversation_ids).

Websøgning og browseren administreres af installationsprogrammet: de installeres direkte fra start, slås fra med --no-search / --no-browser og peges på en eksisterende instans med --external-search=URL / --external-browser=URL — der findes ingen operatørindstillinger for dem.

Se hele Værktøjskatalog hvad hvert værktøj gør.

Stemme og sidevogne

Nøgle Formål
AIHUMMER_STT_URL Tale-til-tekst sidecar-URL (seedet af installatøren).
AIHUMMER_TTS_URL Tekst-til-tale sidecar-URL (seedet af installatøren).
AIHUMMER_VIDEO_URL Video-forståelse sidevogn URL.
AIHUMMER_TTS_AUTO_REPLY Hvornår et færdigt svar læses op: off, always, inbound (standard), tagged.
AIHUMMER_TTS_MAX_CHARS Grænse for den oplæste tekst: 0 — hele svaret, ellers 100–10000 tegn.
AIHUMMER_TTS_SUMMARIZE Forkort et langt svar til oplæsning (slået til som standard).

Sidecars er separate HTTP-tjenester; gatewayen når dem via URL.

Vektorer & indlejring

Nøgle Formål
AIHUMMER_QDRANT_URL Rigtig vektorbutik (Qdrant). Fraværende → hukommelseslager.
AIHUMMER_EMBEDDER_URL Ægte indlejringsservice. Fraværende → hash-indlejer.

Protokolflader (valgfrit)

Nøgle Formål
AIHUMMER_MCP_PUBLISH Præcis 1 åbner den eksterne MCP-server på POST /v1/mcp. Alene eksporterer den ingen værktøjer.
AIHUMMER_MCP_EXPORT_TOOLS Kommaadskilte præcise værktøjsnavne, som MCP-klienten ser. Tom (standard) = NUL værktøjer eksporteres.
AIHUMMER_A2A_PUBLISH 1 muliggør A2A-overfladen (/.well-known/agent.json, /a2a/message).

Kun udviklerbygninger

Variabel Formål
AIHUMMER_PLUGIN_PUBKEY En ekstra pålidelig offentlig nøgle (base64 ed25519) til at verificere pluginsignaturer. Kun til udviklingsbygninger — ignoreres i udgivelsesbygninger (registreringsdatabasenøglen er fastgjort i binærfilen).
AIHUMMER_PLUGIN_DEV_UNSIGNED 1 tillader installation usigneret plugins. Kun til udvikling — ignoreres i udgivelsesbygninger. Aldrig på en eksternt tilgængelig instans.

[!WARNING] I udgivelsesbygninger er plugin-tillidsrod indbygget i binærfilen og kan ikke overskrives af miljøet eller indstillinger — dette er en anti-manipulation garanti.

Tillidsmodellen (officiel → fast nøgle, privat → tillidslager, usigneret → blokeret) er beskrevet i Installation og opdateringer.

Hvor til næste