Uzstādīšana — AiHummer Dokumenti

AiHummer instalē saimniek-dzimtā. Instalēšana sākas jūsu personīgajā kontā pie my.aihummer.ru: jūs reģistrējaties, iegūstat personiskās instalēšanas saite un palaist vienu komandu savā serverī. Instalācijas skripts lejupielādē jūsu arhitektūrai parakstītu pakotni, izkārto vienu instalācijas sakni zem ~/.aihummer (lietotāja mājas direktorijā, kurš palaida instalētāju), reģistrē systemd vienības un pēc izvēles nodrošina papildu servisus. Šajā procesā konteineri neparādās nevienā vietā.

[!NOTE] Šī ir saimniekdatora dzimtā instalācija — izlaiduma tarball, kas darbojas zem systemd, ne Docker. Vārteja, sānskrāpji un spraudņi katrs darbojas kā savs systemd pakalpojums.

[!NOTE] Kas jums būs nepieciešams pirms sākt:

a Linux serveri (x86_64 vai arm64), pie kura var pieslēgties caur SSH;

sudo tiesības (vai vēlme instalēt rootless — skatīt zemāk);

PostgreSQL ar pgcrypto paplašinājums — vai ļaut instalētājam nodrošināt lietotāja režīma klasteris (bez saknes režīmā tas pats to dara);

konts pie my.aihummer.ru lai iegūtu savu personīgo instalēšanas saite.

Pilns prasību saraksts ir pie Prasības lapa.

1. solis: iegūstiet savu personīgo instalēšanas saiti

Nav publiskas instalēšanas skripta — instalēšanas saite ir personāls un izsniegts jūsu konta portālā:

Reģistrēties pie my.aihummer.ru (telefona numurs + parole; nepieciešams arī e-pasts).
Atvērt Instalēšana ekrānā un noklikšķiniet uz “Saņemt personīgo instalēšanas saiti”.
Portāls rāda gatavu izpildei komandu ar jūsu personīgo saiti.

Vairāk par pašu portālu (rēķinu dati, dokumenti, plāni) ir atrodams Personīgais konts lapa.

2. solis: instalēšana ar vienu komandu

Kopējiet komandu no sadaļas “Instalēšana” ekrāna un palaidiet to uz sava servera (Linux x86_64/arm64):

curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh

Personīgā saite izskatās šādi: https://my.aihummer.ru/dl/<token>/install.sh un ir piesaistīta jūsu kontam.

[!IMPORTANT] Saite ir vienreizēja: tā nostrādā tieši vienai instalēšanai. Tiklīdz instalētājs pa to ir lejupielādējis install.sh, saite tiek uzskatīta par izlietotu. Palaižot to pašu komandu vēlreiz, tiks atgriezta kļūda “saite jau izmantota” — tā ir aizsardzība, nevis kļūme. Ko darīt: atveriet konta ekrānu “Instalēšana” un saņemiet jaunu saiti; tas ir bez maksas un notiek uzreiz.

30 dienu termiņš attiecas nevis uz atkārtotu instalēšanu, bet uz artefaktu lejupielādi: jau uzstādīta instance turpina atjaunināties pa savu saiti vēl ilgi pēc tam, kad tā ir izlietota instalēšanai.

Skripts nosaka jūsu CPU arhitektūru, lejupielādē atbilstošo pakotni kopā ar tās .sha256 kontrolsummu un līdzparakstu .sig paraksts, pārbauda abus, izpako instalācijas sakni un reģistrē vārtejas pakalpojumu. Skatīt Izmaiņu žurnāls pašreizējam laidienam.

Personīgā saite arī saista instanci ar jūsu klientu portāla kontu: instalētājs saglabā saites tokenu, instances nosūta to savā pirmajā reģistrācijā pie pārdevēja, un portāls automātiski saista instanci ar jūsu kontu. Jūsu e-pasts uzreiz kļūst par instances e-pastu apstiprināts kontakts — nav atsevišķas darbības “pielikuma pievienošana un e-pasta pārbaude” tīmekļa lietotāja saskarnē, un licence tiek piegādāta bez manuālām darbībām.

[!WARNING] Jūsu personīgā saite ir jūsu atslēga izplatīšanai. Nepublicējiet to: jebkurš Turot saiti, var lejupielādēt būves jūsu vietā līdz tokena derīguma termiņa beigām.

Instalēt saknes izkārtojumu

Viss atrodas vienā direktorijā. Kurā tieši — atkarīgs no tā, kā tika palaists instalētājs:

Kā instalēts	Instalācijas sakne	Konfigurācija	Pakalpojuma lietotājs
Parasta instalēšana (ar `sudo`)	`/home/.aihummer`	`/etc/aihummer/gateway.env`	Atsevišķs dienesta konts `aihummer`
Bez root (rootless)	`~/.aihummer`	`~/.aihummer/etc/gateway.env`	Jūsu pašu lietotājs

Parasta instalēšana neliek failus jūsu mājas direktorijā un nepalaiž pakalpojumu jūsu vārdā: tai tiek izveidots atsevišķs neprivileģēts lietotājs aihummer. Tas darīts apzināti — pakalpojuma pārņemšana nedod piekļuvi jūsu personīgajiem failiem.

Izkārtojums saknes iekšienē abos režīmos ir vienāds (zemāk parādīts parastais):

/home/.aihummer/
├── bin/        gateway binary and the aihummer CLI
├── etc/        configuration (gateway.env)
├── share/      static assets for the administration interface
├── sidecars/   optional STT/TTS/etc services
├── plugins/    installed marketplace plugins
├── systemd/    unit files (symlinked into /etc/systemd/system)
├── state/      runtime state
├── data/       blob/media storage
└── logs/       service logs

Systemd vienību faili tiek ģenerēti uz systemd/ ir simboliski saistīts ar /etc/systemd/system/, tāpēc tos pārvalda ar regulāru systemctl komandas.

Bezsakņu instalācija

sudo/root privilēģijas nav nepieciešamas. Ja jūs izpildāt instalēšanas komandu bez sudo, instalētājs pāriet uz rootless režīmu: vienības tiek reģistrētas systemd --user apjoms (faili mapē ~/.config/systemd/user), aihummer CLI un cosign ierodas ~/.aihummer/bin, un ja AIHUMMER_DATABASE_URL ja nav iestatīts, instalētājs paredz lietotāja režīma PostgreSQL klasteri instalācijas saknē. Pakalpojumi tiek pārvaldīti ar systemctl --user ...Lai pakalpojumi sāktos kopā ar datora ieslēgšanos (ne tikai lietotāja pieteikšanos), iespējot gaidīšanu:

loginctl enable-linger $USER

Blakusvāģa izvēle

Vieglie multivides sānskāji — STT (faster-whisper), TTS (edge-tts) un video — instalējams uzreiz, bez jautājumiem vai brīdinājumiem: divvirzienu balss darbojas uzreiz. Jebkuru no tiem var atspējot, izmantojot vides mainīgos AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1.

Tīmekļa meklēšana (SearXNG) un pārlūks (CloakBrowser) ir iestrādāti parakstītajā komplektā un pēc noklusējuma tiek instalēti bezsaistē — instalētājs par tiem vairs nejautā. Šo uzvedību var mainīt ar karogiem — šeit ir pilns saraksts:

Karogs	Ietekme
`--no-search` / `--no-browser`	Izlaist šo sānskapi
`--external-search=URL` / `--external-browser=URL`	Izmantojiet esošu pakalpojumu šajā URL, nevis instalējiet
`--browser-engine=cloak\|chrome`	Pārlūka dzinējs (pēc noklusējuma `cloak`)
`--with-search` / `--with-browser`	Lieki kopš v1.0.14 — tā jau ir noklusējuma uzvedība
`--with-embedder`	Instalējiet semantisko iegultāju (piedalīties: lejupielādē PyTorch — simtiem MB)

Meklēšana un pārlūks tiek instalēti arī bez tty: to saturs nāk no komplekta, tāpēc interneta piekļuve tam nav vajadzīga. Abas instalācijas nebloķē — ja satura nav vai Python versija netiek atbalstīta, pakalpojums vienkārši paliek nekonfigurēts, un instalēšana nekad netiek pārtraukta. Iegultājs var arī tikt iespējots ar AIHUMMER_WITH_EMBEDDER=1; bez tā atmiņa darbojas, izmantojot leksikālo atlases meklēšanu. Lietotāja saskarnes valoda tiek iestatīta pēc AIHUMMER_LANG=ru|en (citādāk instalētājs jautā tty). PostgreSQL savienojums tiek prasīts tty; neinteraktīvai instalēšanai iestatiet AIHUMMER_DATABASE_URL iepriekš. Uz tty instalētājs arī piedāvā atjaunot no rezerves kopijas.

# Install the gateway with the embedder, without the browser (search is on by default)
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh \
  --with-embedder --no-browser

Tā kā sānskartes tiek adresētas pēc URL, jūs varat brīvi sajaukt vietējās un ārējās un norādīt vairākus vārtus uz vienu koplietotu sānskarti.

Kā tiek pārbaudīts būvējuma īstums

Personīgā saite no konta portāla vienmēr instalē pašreizējo laidienu — tas ir standarta un vienīgais ceļš. Izvēlēties “svaigāku versiju” nav vajadzības: jūs saņemat to būvējumu, ko piegādātājs izlaidis ekspluatācijai.

Katrs artefakts — gan pirmajā instalēšanā, gan katrā atjauninājumā — pienāk kā jūsu arhitektūrai domāts tarball, un tam blakus ir kontrolsumma .sha256 un paraksts .sig (cosign). Instalētājs pārbauda abus, pirms vēl kaut ko izpako. Manuāli neko pārbaudīt nevajag.

Gaidāmais rezultāts: pārbaudes paiet klusi un instalēšana turpinās. Ja kaut viena nesakrīt, instalētājs apstājas ar kļūdu un neaiztiek jau strādājošo versiju — bojāts vai apmainīts fails uz jūsu serveri nenokļūs.

Ja piegādātājs jūs uzaicinājis agrīnās testēšanas programmā, konta ekrānā “Instalēšana” parādīsies pārslēdzējs, un izvēlētajam variantam tiek izsniegta atsevišķa saite — skat. Instance.

Pārbaudiet instalāciju

Pēc instalētāja pabeigšanas pārbaudiet servisu un gatavības galapunktu:

systemctl status aihummer-gateway
curl -fsS http://localhost:8780/healthz
curl -fsS http://localhost:8780/readyz

/healthz ziņo par dzīvotspēju un versiju; /readyz pārbauda PostgreSQL un atgriež 503 kamēr datubāze nav pieejama. Iekļautais aihummer CLI arī nodrošina aihummer status un aihummer doctor ātrai veselības pārbaudei.

Ko jūs redzēsiet pēc veiksmīgas instalēšanas: aihummer-gateway pakalpojums active (running), a 200 no /healthz un /readyz, un sākotnējā admina parole /home/.aihummer/etc/initial-admin-password.txt (bezsakņu instalācijā — ~/.aihummer/etc/initial-admin-password.txt) par pirmais pieteikšanās.

Ražošanas kontrolsaraksts

Viena instalēšanas komanda liek mezglam darboties, bet tā ir vēl nav gatavs ražošanai. Pirms atklāt to, pabeidz:

TLS — pārtraukt HTTPS pie vārtejas priekšā (apgrieztais starpniekserveris / jūsu pašu sertifikāts); nekad neatklājiet vienkāršu portu neuzticamā tīklā.
🔴 Ieslēdziet WebSocket atbalstu apgrieztajā starpniekserverī. Mobilā un darbvirsmas lietotne pieslēdzas vārtejai pa wss://, tāpēc starpniekserverim jāpārsūta galvenes Upgrade un Connection. Bez šī iestatījuma starpniekserveris 101 Switching Protocols vietā atbild ar parastu lapu ar statusu 200 — lietotne to nolasa kā „pakalpojums neatbild“, lai gan vārteja darbojas un tās žurnālā nav nevienas kļūdas. Nginx Proxy Manager tas ir attiecīgā Proxy Host slēdzis Websockets Support, bet parastā nginx — proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; plus proxy_http_version 1.1 blokā location.

Pārbaude ar vienu komandu (gaidāms 101, nevis 200):
```
curl -s -o /dev/null -w '%{http_code}\n' \
  -H 'Connection: Upgrade' -H 'Upgrade: websocket' \
  -H 'Sec-WebSocket-Version: 13' -H 'Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==' \
  https://jusu-domens/
```
Mainīt administratora paroli un dzēst initial-admin-password.txt; iestatīt autentifikācijas izdevējs (AIHUMMER_OIDC_ISSUER / LDAP / SAML) pirms atklāšanas /admin/*.
Veiciet galvenās atslēgas un datu bāzes rezerves kopiju — ieraksts AIHUMMER_MASTER_KEY (noslēpumi ir neatgūstami bez tā) un izveidojiet regulāras PostgreSQL dublējumkopijas.
Pievienot vadus reālam modelim — komplekts AIHUMMER_LLM_* (vai BYOK); bez tā atbildes nāk no deterministiskā mokeša.
Pievienojiet vismaz vienu kanālu (Sākt ar Telegram) un saistīt ar to aģentu.

Redzēt Pirmais pieteikšanās, Konfigurācija un Dublējumi un katastrofu atjaunošana sīkākai informācijai.

Ja tas nedarbojās

“saite jau izmantota” / instalēšana otrreiz nesākas — saite ir vienreizēja un jau iztērēta iepriekšējā mēģinājumā. Saņemiet jaunu portāla ekrānā “Instalēšana” un palaidiet komandu vēlreiz.
curl: (22) … 404 vai “saite nederīga” — saite nokopēta nepilnīgi vai tās termiņš beidzies. Zāles tās pašas: svaiga saite.
neesamērīga arhitektūra — instalācija atbalsta Linux x86_64 un arm64; citiem platformām nav pieejams komplekts.
/readyz atgriežas 503 — vārteja neredz PostgreSQL. Pārbaudiet AIHUMMER_DATABASE_URL, datu bāzes sasniedzamība un tas, ka pgcrypto paplašinājums ir izveidots (CREATE EXTENSION IF NOT EXISTS pgcrypto;).
Pakalpojums nesāka darboties — pārbaudīt systemctl status aihummer-gateway un journalctl -u aihummer-gateway; ātrai diagnostikai veikt aihummer doctor.
Instalēts bez sudo, pakalpojumi apstājas pēc izrakstīšanās — iespējo ilgstošu iedarbību: loginctl enable-linger $USER (skatīt bezsakņu).
Paraksta pārbaude neizdevās — neuzsāc instalēšanu; mēģini vēlāk vai iegūstiet jaunu saiti. Artefakts vienmēr tiek pārbaudīts pret tā .sha256 un kosasignēt .sig.

Kur uz nākamo

Pirmā reize: redzēt Pirmais pieteikšanās atgūt sākotnējā administratora parole no /home/.aihummer/etc/initial-admin-password.txt (bezsakņu instalācijā — ~/.aihummer/etc/initial-admin-password.txt).
Noregulējiet izvietojumu: lasīt Konfigurācija.
Vai vēlaties pirmo palaidi ar vadību? Izmantojiet Ātrā sākšana.