Įdiegimas — AiHummer Dokumentai

AiHummer įdiegia šeimininko-gimtoji. Diegimas prasideda jūsų asmeninėje paskyroje adresu my.aihummer.ru: jūs registruojatės, gaunate asmeninė diegimo nuoroda ir paleiskite vieną komandą savo serveryje. Diegimo scenarijus atsisiunčia pasirašytą paketą jūsų architektūrai, išdėsto vieną diegimo šaknį po ~/.aihummer (vartotojo, kuris vykdė diegimo programą, namų kataloge), registruoja systemd vienetus ir, jei pageidaujama, įrengia pagalbines tarnybas. Šiame procese nėra jokių konteinerių.

[!NOTE] Tai yra pagrindiniame kompiuteryje įdiegta versija – išleidimo archyvas, veikiantis po systemd, ne Docker. Vartai, šoniniai moduliai ir papildiniai kiekvienas veikia kaip atskira systemd paslauga.

[!NOTE] Ką jums reikės prieš pradėdami:

a Linux serverį (x86_64 arba arm64), prie kurio galite prisijungti per SSH;

sudo teisės (arba pasirengimas įdiegti be root teisių — žr. žemiau);

PostgreSQL su pgcrypto plėtinys — arba leisti diegėjui paruošti naudotojo režimo klasteris (bešakniniame režime tai atlieka pats);

paskyra pas my.aihummer.ru gauti jūsų asmeninį įdiegimo nuoroda.

Pilnas reikalavimų sąrašas yra Reikalavimai puslapis.

1 veiksmas: gaukite savo asmeninę diegimo nuorodą

Viešo diegimo scenarijaus nėra — diegimo nuoroda yra asmeninis ir išduota jūsų paskyros portale:

Užsiregistruoti my.aihummer.ru (telefono numeris + slaptažodis; el. paštas taip pat reikalingas).
Atidarykite Įdiegimas ekrane spustelėkite „Gauti asmeninę diegimo nuorodą“.
Portalas rodo pasiruošusią vykdyti komandą su jūsų asmenine nuoroda.

Daugiau apie patį portalą (atsiskaitymo duomenys, dokumentai, planai) rasite Asmeninė paskyra puslapis.

2 žingsnis: diegimas vienu komandos įrašu

Kopijuokite komandą iš „Įdiegimo“ ekrano ir paleiskite ją savo serveryje (Linux x86_64/arm64):

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

Asmeninė nuoroda atrodo taip: https://my.aihummer.ru/dl/<token>/install.sh ir yra susieta su jūsų paskyra.

[!IMPORTANT] Nuoroda yra vienkartinė: ji suveikia lygiai vienam diegimui. Vos tik diegimo programa per ją atsisiunčia install.sh, nuoroda laikoma panaudota. Paleidus tą pačią komandą dar kartą, bus grąžinta klaida „nuoroda jau panaudota“ — tai apsauga, o ne triktis. Ką daryti: atverkite paskyros ekraną „Įdiegimas“ ir gaukite naują nuorodą; tai nemokama ir akimirksniu.

30 dienų terminas taikomas ne pakartotiniam diegimui, o artefaktų atsisiuntimui: jau įdiegtas egzempliorius toliau atsinaujina per savo nuorodą dar ilgai po to, kai ji buvo išnaudota diegimui.

Scenarijus aptinka jūsų procesoriaus architektūrą, atsisiunčia atitinkamą paketą kartu su jo .sha256 kontrolinė suma ir bendras pasirašymas .sig parašas, patikrina abu, išpakuoja diegimo šakninį aplanką ir užregistruoja vartų paslaugą. Žr. Pakeitimų žurnalas dėl einamojo leidimo.

Asmeninė nuoroda taip pat susieja šią egzempliorių su jūsų klientų portalo paskyra: diegimo programa saugo žetoną iš nuorodos, instancija siunčia jį savo pirmojo registracijos pas tiekėją metu, o portalas automatiškai susieja instanciją su jūsų paskyra. Jūsų el. paštas iš karto tampa instancijos patikrintas kontaktas — jokiame atskirame žingsnyje „pridėti ir patvirtinti el. paštą“ Web sąsajoje nėra, o licencija pateikiama be rankinių veiksmų.

[!WARNING] Jūsų asmeninė nuoroda yra jūsų raktas į paskirstymą. Nepublikuokite jos: niekas laikant nuorodą galima atsisiųsti versijas jūsų vardu, kol pasibaigs žetonas.

Įdiegti pagrindinį išdėstymą

Viskas yra viename kataloge. Kuriame — priklauso nuo to, kaip buvo paleista diegimo programa:

Kaip įdiegta	Diegimo šaknis	Konfigūracija	Kieno vardu veikia tarnyba
Įprastas diegimas (su `sudo`)	`/home/.aihummer`	`/etc/aihummer/gateway.env`	Atskira tarnybinė paskyra `aihummer`
Be root teisių (rootless)	`~/.aihummer`	`~/.aihummer/etc/gateway.env`	Jūsų pačių naudotojas

Įprastas diegimas nededa failų į jūsų namų katalogą ir nepaleidžia tarnybos jūsų vardu: jai sukuriamas atskiras neprivilegijuotas naudotojas aihummer. Tai padaryta sąmoningai — tarnybos užvaldymas nesuteikia prieigos prie jūsų asmeninių failų.

Išdėstymas šaknies viduje abiem režimais vienodas (žemiau parodytas įprastas):

/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

Į sistemą sugeneruoti systemd vienetų failai systemd/ yra simboliškai susietas į /etc/systemd/system/, todėl jie valdomi reguliariai systemctl komandos.

Bešaknis diegimas

sudoŠaknies privilegijos nėra reikalingos. Jei paleisite diegimo komandą be sudo, diegimo programa pereina į bešaknį režimą: vienetai užregistruoti systemd --user apimtis (failai į ~/.config/systemd/user), aihummer CLI ir cosign įžengia ~/.aihummer/bin, ir jei AIHUMMER_DATABASE_URL nėra nustatyta, diegimo programa įdiegia vartotojo režimo PostgreSQL klasterį diegimo šaknyje. Paslaugos yra valdomos su systemctl --user ...Norint, kad paslaugos būtų paleidžiamos įkeliant sistemą (ne tik prisijungus vartotojui), įjunkite laikymąsi:

loginctl enable-linger $USER

Šoninio vežimėlio pasirinkimas

Lengvieji medijos šalutiniai moduliai — STT (faster-whisper), TTS (edge-tts) ir vaizdo įrašas — įdiegti iš karto, be jokių klausimų ar perspėjimų: balsas keliaujant pirmyn ir atgal veikia iš karto. Bet kuris iš jų gali būti išjungtas naudojant aplinkos kintamuosius AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1.

Žiniatinklio paieška (SearXNG) ir naršyklė (CloakBrowser) yra įrašytos į pasirašytą paketą ir pagal nutylėjimą diegiamos neprisijungus — diegimo programa apie jas nebeklausia. Šį elgesį galima pakeisti vėliavėlėmis — tai yra visas sąrašas:

Vėliava	Poveikis
`--no-search` / `--no-browser`	Praleisti šį šoninės mašinos priedą
`--external-search=URL` / `--external-browser=URL`	Vietoj diegimo naudokite esamą paslaugą šiuo URL
`--browser-engine=cloak\|chrome`	Naršyklės variklis (pagal nutylėjimą `cloak`)
`--with-search` / `--with-browser`	Nereikalingos nuo v1.0.14 — tai jau yra numatytasis elgesys
`--with-embedder`	Įdiekite semantinį įterpiklį (prisijungti: atsisiunčia PyTorch — šimtai MB)

Paieška ir naršyklė įdiegiamos ir be tty: jų turinys imamas iš paketo, todėl interneto prieigos tam nereikia. Abu diegimai neblokuoja — jei turinio nėra arba Python versija nepalaikoma, paslauga tiesiog lieka nesukonfigūruota, o diegimas niekada nenutraukiamas. Įterpiantis modulis taip pat gali būti įjungtas su AIHUMMER_WITH_EMBEDDER=1; be jo atmintis veikia naudojant leksinę atsarginę paiešką. Vartotojo sąsajos kalba nustatoma pagal AIHUMMER_LANG=ru|en (priešingu atveju diegimo programa klausia per tty). PostgreSQL ryšys prašomas per tty; neinteraktyviai diegiant nustatykite AIHUMMER_DATABASE_URL iš anksto. TTY režime diegimo programa taip pat siūlo atkurti iš atsarginės kopijos.

# 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

Kadangi šoninės programos yra pasiekiamos per URL, galite laisvai maišyti vietinius ir išorinius bei nukreipti kelis vartus į vieną bendrą šoninę programą.

Kaip tikrinamas paketo autentiškumas

Asmeninė nuoroda iš paskyros portalo visada įdiegia esamą leidimą — tai standartinis ir vienintelis kelias. Rinktis „naujesnės versijos“ nereikia: gaunate tą paketą, kurį tiekėjas išleido eksploatacijai.

Kiekvienas artefaktas — tiek pirmojo diegimo, tiek kiekvieno atnaujinimo metu — atkeliauja kaip jūsų architektūrai skirtas tarball’as, o šalia jo guli kontrolinė suma .sha256 ir parašas .sig (cosign). Diegimo programa patikrina abu, kol dar nieko neišpakavo. Rankiniu būdu tikrinti nieko nereikia.

Laukiamas rezultatas: patikros praeina tyliai ir diegimas tęsiasi. Jei bent viena nesutampa, diegimo programa sustoja su klaida ir neliečia jau veikiančios versijos — sugadintas ar pakeistas failas į jūsų serverį nepateks.

Jei tiekėjas pakvietė jus į ankstyvojo testavimo programą, paskyros ekrane „Įdiegimas“ atsiras jungiklis, o pasirinktam variantui išduodama atskira nuoroda — žr. Egzempliorius.

Patikrinkite diegimą

Kai diegėjas baigs darbą, patikrinkite paslaugą ir parengties galinį tašką:

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

/healthz praneša apie gyvybingumą ir versiją; /readyz tikrina PostgreSQL ir grąžina 503 kol duomenų bazės negalima pasiekti. Pakuotėje aihummer CLI taip pat teikia aihummer status ir aihummer doctor greitam sveikatos apžvalgai.

Ką matysite po sėkmingos įdiegimo: tas aihummer-gateway aptarnavimas active (running), a 200 nuo /healthz ir /readyz, ir pradinį administratoriaus slaptažodį /home/.aihummer/etc/initial-admin-password.txt (diegiant be root — ~/.aihummer/etc/initial-admin-password.txt) už pirmas prisijungimas.

Gamybos kontrolinis sąrašas

Vienas diegimo komandų pradeda veikti vartai, tačiau tai yra dar nepasiruošęs gamybai. Prieš atskleidžiant, užbaikite:

TLS — nutraukti HTTPS prie vartų (atgalinio proxy / savo paties) sertifikatas); niekada neatskleiskite paprasto prievado nepatikimoje tinkle.
🔴 Įjunkite WebSocket palaikymą atvirkštiniame tarpiniame serveryje. Mobilioji ir darbalaukio programėlė prie tinklų sietuvo jungiasi per wss://, todėl tarpinis serveris privalo praleisti antraštes Upgrade ir Connection. Be šio nustatymo tarpinis serveris vietoje 101 Switching Protocols grąžina įprastą puslapį su būsena 200 — programėlė tai perskaito kaip „paslauga neatsako“, nors sietuvas veikia ir jo žurnale nėra nė vienos klaidos. Nginx Proxy Manager tai atitinkamo Proxy Host jungiklis Websockets Support, o įprastame nginx — proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; bei proxy_http_version 1.1 bloke location.

Patikrinimas viena komanda (laukiama 101, o ne 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-domenas/
```
Pakeisti administratoriaus slaptažodį ir ištrinti initial-admin-password.txt; nustatyti autentifikavimo išdavėjas (AIHUMMER_OIDC_ISSUER / LDAP / SAML) prieš atskleidžiant /admin/*.
Atsarginė pagrindinio rakto ir duomenų bazės kopija — įrašas AIHUMMER_MASTER_KEY (paslaptys negalima atkurti be jo) ir nustatykite reguliarias PostgreSQL atsargines kopijas.
Prijunkite tikrą modelį — nustatyti AIHUMMER_LLM_* (arba BYOK); be jo atsakymai ateina iš deterministinio maketo.
Prijunkite bent vieną kanalą (Pradėti su Telegram) ir prijungti prie jo agentą.

Matyti Pirmas prisijungimas, Konfigūracija ir Atsarginės kopijos ir DR apie detales.

Jeigu tai neveiktų

„nuoroda jau panaudota“ / diegimas nepasileidžia antrą kartą — nuoroda yra vienkartinė ir jau išnaudota per ankstesnį bandymą. Gaukite naują portalo ekrane „Įdiegimas“ ir paleiskite komandą iš naujo.
curl: (22) … 404 arba „nuoroda negalioja“ — nuoroda nukopijuota ne visa arba baigėsi jos galiojimas. Vaistas tas pats: šviežia nuoroda.
nesuderinama architektūra — diegimas palaiko Linux x86_64 ir arm64; kitoms platformoms nėra paketo.
/readyz grąžina 503 — vartai nemato PostgreSQL. Patikrinkite AIHUMMER_DATABASE_URL, duomenų bazės pasiekiamumas ir tas pgcrypto plėtinys yra sukuriamas (CREATE EXTENSION IF NOT EXISTS pgcrypto;).
Paslauga nepradėjo veikti — patikrinti systemctl status aihummer-gateway ir journalctl -u aihummer-gateway; greitam diagnozavimui paleisti aihummer doctor.
Įdiegta be sudo, paslaugos sustoja po atsijungimo — įgalinti ilgalaikį poveikį: loginctl enable-linger $USER (žiūrėti be šaknų).
Parašo patvirtinimas nepavyko — neįdiekite; pabandykite vėliau arba gaukite naują nuorodą. Artefaktas visada tikrinamas pagal jo .sha256 ir bendras parašas .sig.

Kur toliau

Pirmas bėgimas: žiūrėti Pirmas prisijungimas paimti atgal pradinis administratoriaus slaptažodis iš /home/.aihummer/etc/initial-admin-password.txt (diegiant be root — ~/.aihummer/etc/initial-admin-password.txt).
Sureguliuokite diegimą: skaityti Konfigūracija.
Norite pirmojo bėgimo su gidu? Naudokite Greitas pradžia.