O'rnatish — AiHummer Hujjatlar

AiHummer o’rnatadi xost-milliy. O‘rnatish shaxsiy hisobingizda boshlanadi my.aihummer.ru: siz ro’yxatdan o’tasiz, olasiz shaxsiy o’rnatish havolasi va serveringizda bitta buyruqni ishga tushiring. O‘rnatish skripti sizning arxitekturangiz uchun imzolangan paketni yuklab oladi, bitta o‘rnatish ildizini tashkil qiladi ~/.aihummer (o‘rnatishni ishga tushirgan foydalanuvchining uy papkasida), systemd birliklarini ro‘yxatdan o‘tkazadi va ixtiyoriy ravishda yonchiqaruvlarni ta’minlaydi. Ushbu jarayonda hech qayerda konteynerlar mavjud emas.

[!NOTE] Bu host-yerli o‘rnatish — systemd ostida ishlayotgan reliz tarballi, emas Docker. Darvoza, sidecarlar va plaginlar har biri o‘zining systemd sifatida ishlaydi xizmat.

[!NOTE] Boshlashdan oldin kerak bo’ladigan narsalar:

a Linux SSH orqali ulanish mumkin bo‘lgan server (x86_64 yoki arm64);

sudo huquqlar (yoki rootless o‘rnatishga tayyorlik — quyidagiga qarang);

PostgreSQL bilan pgcrypto kengaytma — yoki o‘rnatuvchi foydalanishga tayyorlashiga ruxsat berish foydalanuvchi-rejim klasteri (rootless rejimda bu o‘zi bajaradi);

hisob qaydnomasi my.aihummer.ru shaxsiyingizni olish uchun o’rnatish havolasi.

To‘liq talablar ro‘yxati quyida keltirilgan Talablar sahifa.

1-qadam: shaxsiy o‘rnatish havolangizni oling

Jamoat o‘rnatish skripti yo‘q — o‘rnatish havolasi shaxsiy va sizning hisob portalingizda chiqarilgan:

Ro’yxatdan o’ting my.aihummer.ru (telefon raqami + parol; elektron pochta ham kerak bo’ladi).
Oching O‘rnatish ekranga qarang va “Shaxsiy o’rnatish havolasini olish” tugmasini bosing.
Portal sizning shaxsiy havolangiz bilan ishga tayyor buyrug‘ni ko‘rsatadi.

Portaldan o‘zi (hisob-kitob tafsilotlari, hujjatlar, rejalar) haqida ko‘proq ma’lumot quyida mavjud Shaxsiy hisob sahifa.

Qadam 2: bir-buyruq bilan o‘rnatish

“Installation” ekranidan buyruqni nusxalab oling va uni serveringizda (Linux x86_64/arm64) ishga tushiring:

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

Shaxsiy havola https://my.aihummer.ru/dl/<token>/install.sh ko‘rinishida bo‘ladi va sizning hisobingizga bog‘langan.

[!IMPORTANT] Havola bir martalik: u aynan bitta o‘rnatish uchun ishlaydi. O‘rnatgich uning orqali install.sh faylini yuklab olishi bilanoq havola sarflangan hisoblanadi. O‘sha buyruqni qayta ishga tushirsangiz, «havola allaqachon ishlatilgan» xatosi qaytadi — bu nosozlik emas, himoya. Nima qilish kerak: shaxsiy kabinetdagi «O‘rnatish» ekranini oching va yangi havola oling — bu bepul va bir zumda bo‘ladi.

30 kun muddat qayta o‘rnatishga emas, artefaktlarni yuklab olishga tegishli: allaqachon o‘rnatilgan nusxa havola o‘rnatishga sarflangandan keyin ham o‘z havolasi orqali yangilanib turadi.

Skript sizning CPU arxitekturangizni aniqlaydi, mos keluvchi paketni va uning bilan birga yuklab oladi .sha256 yig‘indi tekshiruvi va hamimzo .sig imzo, ikkalasini ham tasdiqlaydi, o‘rnatish ildizini ochadi va shlyuz xizmatini ro‘yxatga oladi. Ko‘ring Oʻzgarishlar roʻyhati joriy chiqarilish uchun.

Shaxsiy havola ham instansiyani mijoz portal hisobingizga bog‘laydi: o‘rnatuvchi havoladagi tokenni saqlaydi, instansiya uni yetkazib beruvchi bilan birinchi ro‘yxatdan o‘tkazishda yuboradi va portal instansiyani avtomatik ravishda sizning hisobingizga bog‘laydi. Sizning elektron pochtangiz darhol instansiyaning elektron pochtasiga aylanadi tasdiqlangan aloqa — Veb interfeysida alohida “elektron pochtani qo‘shish va tasdiqlash” bosqichi yo‘q, va litsenziya hech qanday qo‘lda bajariladigan qadamlarisiz yetkaziladi.

[!WARNING] Shaxsiy havolangiz tarqatishga kalitingizdir. Uni e’lon qilmaylik: har kim Havolani ushlab turish token muddati tugaguncha sizning nomingizdan qurilmalarni yuklab olishi mumkin.

Root tartibini o’rnatish

Hamma narsa bitta katalog ostida joylashadi. Qaysi biri — o‘rnatgichni qanday ishga tushirganingizga bog‘liq:

Qanday o‘rnatildi	O‘rnatish ildizi	Sozlamalar	Xizmat kim nomidan ishlaydi
Oddiy o‘rnatish (`sudo` bilan)	`/home/.aihummer`	`/etc/aihummer/gateway.env`	Alohida `aihummer` xizmat hisobi
Rootsiz (rootless)	`~/.aihummer`	`~/.aihummer/etc/gateway.env`	Sizning foydalanuvchingiz

Oddiy o‘rnatish fayllarni uy katalogingizga qo‘ymaydi va xizmatni sizning nomingizdan ishga tushirmaydi: buning uchun alohida, imtiyozsiz aihummer foydalanuvchisi yaratiladi. Bu ataylab shunday qilingan — xizmatning buzilishi tajovuzkorga shaxsiy fayllaringizni bermaydi.

Ildiz ichidagi tuzilma ikkala rejimda ham bir xil (quyida oddiy o‘rnatish ko‘rsatilgan):

/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

Yaratilgan systemd birlik fayllari systemd/ bor simvolik havola qilindi /etc/systemd/system/, shuning uchun ularni muntazam boshqarish bilan boshqariladi systemctl buyruqlar.

Rootsiz o’rnatish

sudo/root huquqlari talab qilinmaydi. Agar siz o‘rnatish buyrug‘ini ishga tushirsangiz sudosiz, o‘rnatgich rootless rejimiga o‘tadi: birliklar ro‘yxatga olinadi systemd --user doira (fayllar ichida ~/.config/systemd/user), aihummer CLI va cosign qo’shiladi ~/.aihummer/bin, va agar AIHUMMER_DATABASE_URL o‘rnatilmagan, o‘rnatish dasturi o‘rnatish ildizi ichida foydalanuvchi rejimidagi PostgreSQL klasterini ta’minlaydi. Xizmatlar bilan boshqariladi systemctl --user .... Xizmatlarning faqat foydalanuvchi tizimga kirganda emas, balki host ishga tushganda ham boshlanishini ta’minlash uchun lingerini yoqing:

loginctl enable-linger $USER

Yon arava tanlovi

Engil media yon mashinalari — STT (faster-whisper), TTS (edge-tts) va video — darhol o‘rnatiladi, hech qanday savollar yoki bayroqlarsiz: ovozni orqaga-qaytarish darhol ishlaydi. Ularning har biri muhit o’zgaruvchilari bilan o’chirilishi mumkin AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1.

Veb-qidiruv (SearXNG) va brauzer (CloakBrowser) imzolangan to’plamga o’rnatib qo’yilgan va standart holda oflayn o’rnatiladi — o’rnatuvchi ular haqida endi so’ramaydi. Bu xatti-harakatni bayroqlar bilan o’zgartirish mumkin — bu to’liq ro’yxat:

Bayroq	Ta’sir
`--no-search` / `--no-browser`	Bu saydkarni o’tkazib yuboring
`--external-search=URL` / `--external-browser=URL`	O’rnatish o’rniga bu URL manzildagi mavjud xizmatdan foydalaning
`--browser-engine=cloak\|chrome`	Brauzer dvigateli (standart `cloak`)
`--with-search` / `--with-browser`	v1.0.14 dan boshlab ortiqcha: bu allaqachon standart xatti-harakat
`--with-embedder`	Semantik o‘rnatgichni o‘rnating (rozilik berish: PyTorch ni tortadi — yuzlab MB)

Qidiruv va brauzer tty siz ham o’rnatiladi: foydali yuk to’plamdan olinadi, buning uchun internetga ulanish kerak emas. Ikkalasining o’rnatilishi ham to’sib qo’ymaydi — foydali yuk bo’lmasa yoki Python versiyasi qo’llab-quvvatlanmasa, xizmat shunchaki sozlanmagan holda qoladi, o’rnatish esa davom etadi. Ichiga qo’yuvchi ham faollashtirilishi mumkin AIHUMMER_WITH_EMBEDDER=1; buni qilmasdan xotira leksik orqaga qaytish qidiruvi bo‘yicha ishlaydi. Foydalanuvchi interfeysi tili quyidagicha o‘rnatiladi AIHUMMER_LANG=ru|en (aks holda o’rnatuvchi tty da so’raydi). PostgreSQL ulanishi tty da so’raladi; nointeraktiv o’rnatish uchun o’rnating AIHUMMER_DATABASE_URL oldindan. TTY-da o‘rnatish dasturi shuningdek zaxira nusxadan tiklashni taklif qiladi.

# Gateway'ni embedder bilan, brauzersiz o'rnatish (qidiruv standart holda o'rnatiladi)
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh \
  --with-embedder --no-browser

Chunki sidecar’lar URL orqali murojaat qilinadi, siz mahalliy va tashqi sidecar’larni erkin aralashtirishingiz va bir nechta gateway’larni bitta umumiy sidecar’ga yo’naltirishingiz mumkin.

Yig‘malaning haqiqiyligi qanday tekshiriladi

Hisob portalidagi shaxsiy havola har doim joriy nashrni o‘rnatadi — bu odatiy va yagona yo‘l. «Yangiroq versiya»ni tanlash shart emas: siz yetkazib beruvchi ishlab chiqarish uchun chiqargan yig‘malani olasiz.

Har bir artefakt — birinchi o‘rnatishda ham, har bir yangilanishda ham — arxitekturangizga mos tarball ko‘rinishida keladi, uning yonida esa .sha256 nazorat yig‘indisi va .sig (cosign) imzosi turadi. O‘rnatgich hech narsani ochishdan oldin ikkalasini ham tekshiradi. Qo‘lda hech narsa tekshirish kerak emas.

Kutilgan natija: tekshiruvlar jimgina o‘tadi va o‘rnatish davom etadi. Agar ulardan biri mos kelmasa, o‘rnatgich xato bilan to‘xtaydi va ishlab turgan versiyaga tegmaydi — buzilgan yoki almashtirilgan fayl serverga tushmaydi.

Agar yetkazib beruvchi sizni erta sinov dasturiga taklif qilgan bo‘lsa, kabinetdagi «O‘rnatish» ekranida tanlagich paydo bo‘ladi va tanlangan variant uchun alohida havola beriladi — qarang Nusxa.

O’rnatilishini tekshiring

O‘rnatish tugagach, xizmat va tayyorgarlik tuguni holatini tekshiring:

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

/healthz jonliligini va versiyasini hisob beradi; /readyz PostgreSQL ni tekshiradi va qaytaradi 503 ma’lumotlar bazasiga ulanish imkoni bo‘lmaganda. Paketlangan aihummer CLI shuningdek taqdim etadi aihummer status va aihummer doctor tezda salomatlik umumiy ko‘rinishi uchun.

Muvaffaqiyatli o’rnatishdan keyin ko’radigan narsangiz: bu aihummer-gateway xizmatda active (running), bir 200 dan /healthz va /readyz, va dastlabki admin paroli /home/.aihummer/etc/initial-admin-password.txt (rootsiz o‘rnatishda — ~/.aihummer/etc/initial-admin-password.txt) uchun birinchi kirish.

Ishlab chiqarish ro’yxati

Bitta o’rnatish buyruqi darvozani ishga tushiradi, lekin bu hali ishlab chiqarishga tayyor emas. Uni oshkor qilishdan oldin, tugallang:

TLS — HTTPS ni gateway oldida yakunlang (teskari proksi / o’zingizning) sertifikat); ishonchsiz tarmoqda oddiy portni hech qachon ochmang.
🔴 Teskari proksida WebSocket qo’llab-quvvatlashini yoqing. Mobil va ish stoli ilovasi shlyuzga wss:// orqali ulanadi, shuning uchun proksi Upgrade va Connection sarlavhalarini o’tkazishi kerak. Bu sozlamasiz proksi 101 Switching Protocols o’rniga 200 holatli oddiy sahifani qaytaradi — ilova buni «xizmat javob bermayapti» deb o’qiydi, holbuki shlyuz sog’lom va uning jurnalida birorta ham xato yo’q. Nginx Proxy Manager’da bu tegishli Proxy Host uchun Websockets Support kaliti, oddiy nginx’da esa — proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; location blokidagi proxy_http_version 1.1 bilan birga.

Bitta buyruq bilan tekshirish (200 emas, 101 kutiladi):
```
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://sizning-domeningiz/
```
Admin parolini o’zgartiring va o’chirish initial-admin-password.txt; o‘rnatish auth chiqaruvchi (AIHUMMER_OIDC_ISSUER / LDAP / SAML) ni oshkor qilishdan oldin /admin/*.
Asosiy kalit va ma’lumotlar bazasini zaxiralang — yozuv AIHUMMER_MASTER_KEY (sirlari unisiz tiklab bo‘lmaydi) va muntazam PostgreSQL zaxira nusxalarini yaratishni tashkil qiling.
Haqiqiy modelni sim bilan ulash — to’plam AIHUMMER_LLM_* (yoki BYOK); u holda javoblar keladi deterministik soxta versiyasidan.
Kamida bitta kanalni ulang (Telegramni boshlash) va unga agentni bog’lash.

Ko’r Birinchi kirish, Konfiguratsiya va Zaxira nusxalar va DR tafsilotlar uchun.

Agar u ishlamasa

«havola allaqachon ishlatilgan» / o‘rnatish ikkinchi marta boshlanmaydi — havola bir martalik va oldingi urinish uni allaqachon sarflagan. Kabinetdagi «O‘rnatish» ekranida yangi havola oling va buyruqni qaytadan ishga tushiring.
curl: (22) … 404 yoki «havola noto‘g‘ri» — havola to‘liq ko‘chirilmagan yoki muddati o‘tgan. Chorasi o‘sha — yangi havola.
qo‘llab-quvvatlanmaydigan arxitektura — o‘rnatish Linux x86_64 va arm64 ni qo‘llab-quvvatlaydi; boshqa platformalar uchun paket yo‘q.
/readyz qaytaradi 503 — darvoza PostgreSQL-ni ko’ra olmayapti. Tekshiring AIHUMMER_DATABASE_URL, ma’lumotlar bazasiga yetib borish va shuni pgcrypto uzaytma yaratiladi (CREATE EXTENSION IF NOT EXISTS pgcrypto;).
Xizmat ishga tushmadi — tekshirish systemctl status aihummer-gateway va journalctl -u aihummer-gateway; tezkor diagnostika uchun ishga tushiring aihummer doctor.
Sudo ishlatmasdan o‘rnatilgan, xizmatlar chiqishdan so‘ng to‘xtaydi — kechikishni yoqish: loginctl enable-linger $USER (qara ildizsiz).
Imzo tekshiruvi muvaffaqiyatsiz bo’ldi — o‘rnatishni davom ettirmang; keyinroq qayta urinib ko‘ring yoki yangi havolani oling. Artefakt har doim o’ziga qarshi tekshiriladi .sha256 va kosain .sig.

Keyingi qayerga

Birinchi yugurish: ko’rish Birinchi kirish qaytarib olish dastlabki admin paroli /home/.aihummer/etc/initial-admin-password.txt (rootsiz o‘rnatishda — ~/.aihummer/etc/initial-admin-password.txt).
Joylashtirishni sozlash: o’qish Konfiguratsiya.
Yo’naltirilgan birinchi yurishni xohlaysizmi? Shu narsani ishlating Tez boshlash.