Quraşdırma — AiHummer Sənədlər

AiHummer quraşdırır ev sahibi-yerli. Quraşdırma şəxsi hesabınızda başlayır my.aihummer.ru: siz qeydiyyatdan keçirsiniz, əldə edirsiniz şəxsi quraşdırma linki və serverinizdə tək bir əmri icra edin. Quraşdırma skripti arxitekturanız üçün imzalanmış paket endirir, tək bir quraşdırma kökünü yerləşdirir ~/.aihummer (quraşdırıcını işə salan istifadəçinin ev qovluğunda), systemd vahidlərini qeydiyyatdan keçirir və istəyə bağlı olaraq sidecar-ları təmin edir. Bu prosesdə hər hansı bir konteyner yoxdur.

[!NOTE] Bu host-yerli quraşdırmadır — systemd altında işləyən bir buraxılış tarballu, yox Docker. Qapı, yan maşınlar və əlavələr hər biri öz systemd-si kimi işləyir xidmət.

[!NOTE] Başlamazdan əvvəl nəyə ehtiyacınız olacaq:

a Linux SSH vasitəsilə daxil ola biləcəyiniz server (x86_64 və ya arm64);

sudo haqlar (və ya köksüz quraşdırmağa hazır olmaq — aşağıya baxın);

PostgreSQL ilə pgcrypto uzantı — yaxud quraşdırıcının təmin etməsinə icazə ver istifadəçi-rejimi klasteri (kök-siz rejimdə bunu özü edir);

hesabında my.aihummer.ru şəxsi əldə etmək quraşdırma linki.

Tam tələblər siyahısı bu ünvandadır Tələblər səhifə.

Addım 1: şəxsi quraşdırma linkinizi əldə edin

Heç bir ictimai quraşdırma skripti yoxdur — quraşdırma linki şəxsi və hesab portalınızda verilmişdir:

Qeydiyyatdan keç my.aihummer.ru (telefon nömrəsi + şifrə; e-poçt da lazım olacaq).
Aç Quraşdırma ekrana baxın və “Şəxsi quraşdırma linkini əldə et” düyməsini klikləyin.
Portal sizin şəxsi linkinizlə işləməyə hazır əmri göstərir.

Portalın özü haqqında daha çox məlumat (hesablama detalları, sənədlər, planlar) buradadır Şəxsi hesab səhifə.

Addım 2: bir əmrlə quraşdırma

Əmrini “Quraşdırma” ekranından kopyalayın və serverinizdə (Linux x86_64/arm64) işlədin:

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

Şəxsi link belə görünür https://my.aihummer.ru/dl/<token>/install.sh və sizin hesabınıza bağlıdır.

[!IMPORTANT] Link birdəfəlikdir: o dəqiq bir quraşdırma üçün işləyir. Quraşdırıcı onun vasitəsilə install.sh faylını endirən kimi link istifadə olunmuş sayılır. Eyni əmri yenidən işə salsanız, «link artıq istifadə olunub» xətası qayıdacaq — bu nasazlıq deyil, müdafiədir. Nə etməli: şəxsi kabinetdə «Quraşdırma» ekranını açın və yeni link alın, bu pulsuz və ani baş verir.

30 gün müddəti təkrar quraşdırmaya deyil, artefaktların endirilməsinə aiddir: artıq qurulmuş nümunə linki quraşdırmaya sərf olunandan sonra da onun vasitəsilə yenilənməyə davam edir.

Ssenari CPU memarlığınızı aşkar edir, uyğun paketini və onunla birlikdə yükləyir .sha256 yoxlama cəmi və birlikdə imzalama .sig imza, hər ikisini təsdiqləyir, quraşdırma kökünü açır və qapı xidməsini qeydiyyatdan keçirir. Bax Dəyişiklik qeydləri mövcud buraxılış üçün.

Şəxsi əlaqə də nümunəni müştəri portalı hesabınıza bağlayır: quraşdırıcı linkdən tokeni saxlayır, instansiya ilk qeydiyyatında vendorə göndərir və portal instansiyanı avtomatik olaraq hesabınıza bağlayır. E-poçtunuz dərhal instansiyanın e-poçtu olur təsdiqlənmiş əlaqə — Veb İstifadəçi İnterfeysində ayrıca “e-poçt əlavə et və təsdiqlə” addımı yoxdur və lisenziya heç bir əl ilə addım olmadan çatdırılır.

[!WARNING] Şəxsi linkiniz paylama üçün açarınızdır. Onu dərc etməyin: heç kim Linki saxlamaq tokenin müddəti bitənə qədər sizin adınıza yaradıcılıqları yükləyə bilər.

Root tərtibatını quraşdır

Hər şey bir kataloq altında yaşayır. Hansının altında — quraşdırıcını necə işə saldığınızdan asılıdır:

Necə quraşdırdınız	Quraşdırma kökü	Konfiqurasiya	Xidmət kimin adından işləyir
Adi quraşdırma (`sudo` ilə)	`/home/.aihummer`	`/etc/aihummer/gateway.env`	Ayrıca `aihummer` xidmət hesabı
Root olmadan (rootless)	`~/.aihummer`	`~/.aihummer/etc/gateway.env`	Sizin öz istifadəçiniz

Adi quraşdırma faylları ev qovluğunuza qoymur və xidməti sizin adınızdan işə salmır: onun üçün ayrıca imtiyazsız aihummer istifadəçisi yaradılır. Bu qəsdən belədir — xidmətin ələ keçirilməsi hücumçuya şəxsi fayllarınızı vermir.

Kökün içindəki tərtibat hər iki rejimdə eynidir (aşağıda adi quraşdırma göstərilib):

/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

İstehsal olunmuş systemd vahid faylları systemd/ dir simvolik bağlantı edilmiş /etc/systemd/system/, buna görə də onlar müntəzəm olaraq idarə olunur systemctl əmrlər.

Kökü olmayan quraşdırma

sudo/root imtiyazları tələb olunmur. Əgər siz quraşdırma əmri işlədirsinizsə sudo olmadan, quraşdırıcı köksüz rejimə keçir: vahidlər qeyd olunur systemd --user dəqiqlik (fayllar daxilində ~/.config/systemd/user), aihummer CLI və cosign enir ~/.aihummer/bin, və əgər AIHUMMER_DATABASE_URL quraşdırılmayıb quraşdırıcı istifadəçi rejimli PostgreSQL klasterini quraşdırma kökündə təmin edir. Xidmətlər idarə olunur systemctl --user .... Xidmətlərin yalnız istifadəçi daxil olanda deyil, host açılarkən də başlaması üçün, lingering-i aktiv edin:

loginctl enable-linger $USER

Yan araba seçimi

Yüngül media yan arabaları — STT (faster-whisper), TTS (edge-tts) və video — qutudan çıxan kimi quraşdırın, heç bir sual və ya xəbərdarlıq olmadan: səfər-səfər səsi dərhal işləyir. Onların hər hansı biri mühit dəyişənləri ilə deaktiv edilə bilər AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1.

Veb axtarış (SearXNG) və brauzer (CloakBrowser) imzalanmış bundle-a hopdurulub və standart olaraq oflayn quraşdırılır — quraşdırıcı artıq onlar barədə soruşmur. Bu davranışı bayraqlarla dəyişmək olar — bu tam siyahıdır:

Bayraq	Təsir
`--no-search` / `--no-browser`	Bu yan arabadan keç
`--external-search=URL` / `--external-browser=URL`	Quraşdırmaq əvəzinə bu URL-də mövcud xidmətdən istifadə edin
`--browser-engine=cloak\|chrome`	Brauzer mühərriki (standart olaraq `cloak`)
`--with-search` / `--with-browser`	v1.0.14-dən etibarən artıqdır: bu, onsuz da standart davranışdır
`--with-embedder`	Semantik yerləşdiricini quraşdırın (qoşulmaq: PyTorch-u çəkir — yüzlərlə MB)

Axtarış və brauzer tty olmadan da quraşdırılır: faydalı yük bundle-dan götürülür, bunun üçün internetə çıxış lazım deyil. Hər ikisinin quraşdırılması bloklayıcı deyil — faydalı yük yoxdursa və ya Python versiyası dəstəklənmirsə, xidmət sadəcə konfiqurasiya olunmamış qalır, quraşdırma isə davam edir. Embedder həmçinin ilə aktiv edilə bilər AIHUMMER_WITH_EMBEDDER=1; olmadan yaddaş leksikal ehtiyat axtarışında işləyir. İstifadəçi interfeysi dili vasitəsilə təyin olunur AIHUMMER_LANG=ru|en (əks halda quraşdırıcı tty-də soruşur). PostgreSQL əlaqəsi tty-də soruşulur; qeyri-interaktiv quraşdırmalar üçün təyin edin AIHUMMER_DATABASE_URL irəli. TTY-də quraşdırıcı həmçinin ehtiyat nüsxədən bərpa etməyi təklif edir.

# Gateway-i embedder ilə, brauzersiz quraşdırın (axtarış standart olaraq quraşdırılır)
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh \
  --with-embedder --no-browser

Çünki sidecar-lar URL ilə ünvanlanır, siz yerli və xarici olanları sərbəst qarışdıra və bir neçə gateway-i birgə istifadə olunan sidecar-a yönəldə bilərsiniz.

Yığmanın həqiqiliyi necə yoxlanılır

Şəxsi kabinetdən alınan şəxsi link həmişə cari buraxılışı quraşdırır — bu, nizamlı və yeganə yoldur. «Daha təzə versiya» seçməyə ehtiyac yoxdur: siz təchizatçının istismar üçün buraxdığı yığmanı alırsınız.

Hər artefakt — həm ilk quraşdırmada, həm də hər yeniləmədə — arxitekturanıza uyğun tarball şəklində gəlir, onun yanında isə .sha256 yoxlama cəmi və .sig (cosign) imzası olur. Quraşdırıcı nəyisə açmazdan əvvəl hər ikisini yoxlayır. Əl ilə heç nə yoxlamağa ehtiyac yoxdur.

Gözlənilən nəticə: yoxlamalar səssizcə keçir və quraşdırma davam edir. Heç olmasa biri uyğun gəlməsə, quraşdırıcı xəta ilə dayanır və artıq işləyən versiyaya toxunmur — zədələnmiş və ya dəyişdirilmiş fayl serverə düşməyəcək.

Təchizatçı sizi erkən sınaq proqramına dəvət edibsə, kabinetdəki «Quraşdırma» ekranında keçid görünəcək və seçdiyiniz variant üçün ayrıca link veriləcək — bax Nümunə.

Quraşdırmanı təsdiqləyin

Quraşdırıcı bitdikdən sonra xidməti və hazırlıq nöqtəsini yoxlayın:

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

/healthz canlılıq və versiyanı bildirir; /readyz PostgreSQL-i yoxlayır və geri qaytarır 503 verilənlər bazası əlçatmaz olduqda. Paketlənmiş aihummer CLI həmçinin təmin edir aihummer status və aihummer doctor sürətli sağlamlıq baxışı üçün.

Uğurlu quraşdırmadan sonra nə görəcəksiniz: o aihummer-gateway xidmətdə active (running), a 200 dən /healthz və /readyz, və ilkin admin parolu /home/.aihummer/etc/initial-admin-password.txt (rootless quraşdırmada — ~/.aihummer/etc/initial-admin-password.txt) üçün ilk giriş.

İstehsal yoxlama siyahısı

Tək bir quraşdırma əmri qapını işə salır, amma o hələ istehsala hazır deyil. İfşa etmədən əvvəl, tamamlayın:

TLS — girişi qapısının (əks proxy / özünüzün) qarşısında HTTPS-i dayandırın sertifikat); heç vaxt etibarsız şəbəkədə sadə portu açıq qoymayın.
🔴 Tərs proksidə WebSocket dəstəyini aktivləşdirin. Mobil və masaüstü tətbiq şlüzə wss:// üzərindən qoşulur, ona görə proksi Upgrade və Connection başlıqlarını ötürməlidir. Bu ayar olmayan proksi 101 Switching Protocols əvəzinə adi səhifə və 200 statusu qaytarır — tətbiq bunu «xidmət cavab vermir» kimi oxuyur, halbuki şlüz saz işləyir və jurnalında bir dənə də xəta yoxdur. Nginx Proxy Manager-də bu, uyğun Proxy Host üçün Websockets Support açarıdır, adi nginx-də isə — proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; location blokunda proxy_http_version 1.1 ilə birlikdə.

Bir əmrlə yoxlamaq (200 deyil, 101 gözlənilir):
```
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://sizin-domen/
```
Admin şifrəsini dəyişdirin və sil initial-admin-password.txt; müəyyən et təsdiqləyici verən (AIHUMMER_OIDC_ISSUER / LDAP / SAML) ifşa etməzdən əvvəl /admin/*.
Əsas açarı və verilənlər bazasını ehtiyat nüsxəsini çıxarın — qeyd AIHUMMER_MASTER_KEY (sirlər onun olmadan bərpa olunmayan) və müntəzəm PostgreSQL ehtiyat nüsxələrini qurun.
Həqiqi modelə tel qoşun — dəst AIHUMMER_LLM_* (və ya BYOK); olmadan cavablar gəlir deterministik saxta versiyadan.
Ən azı bir kanalı qoşun (Telegram başlamaq üçün) və ona bir agent təyin etmək.

Görmək İlk giriş, Konfiqurasiya və Ehtiyat nüsxələr və Fövqəladə Bərpa təfərrüatlar üçün.

Əgər işləmdisə

«link artıq istifadə olunub» / quraşdırma ikinci dəfə işə düşmür — link birdəfəlikdir və əvvəlki cəhdə artıq sərf olunub. Kabinetdəki «Quraşdırma» ekranında yenisini alın və əmri təkrar işə salın.
curl: (22) … 404 və ya «link etibarsızdır» — link tam kopyalanmayıb, ya da onun müddəti bitib. Müalicəsi eynidir — yeni link.
dəstəklənməyən arxitektura — quraşdırma Linux x86_64 və arm64 dəstəkləyir; Digər platformalar üçün heç bir paket yoxdur.
/readyz qaytarır 503 — gateway PostgreSQL-i görə bilmir. Yoxlayın AIHUMMER_DATABASE_URL, verilənlər bazasına çatmağı və bu pgcrypto uzantı yaradılır (CREATE EXTENSION IF NOT EXISTS pgcrypto;).
Xidmət başlamadı — yoxlamaq systemctl status aihummer-gateway və journalctl -u aihummer-gateway; tez diaqnoz üçün işlədin aihummer doctor.
Sudo olmadan quraşdırılıb, xidmətlər çıxış etdikdən sonra dayandırılır — qalmağı aktivləşdir: loginctl enable-linger $USER (bax kökü olmayan).
İmza doğrulaması uğursuz oldu — quraşdırmaya davam etməyin; sonra yenidən cəhd edin və ya yeni bir link əldə edin. Artefakt həmişə onun əleyhinə yoxlanılır .sha256 və qoşma imza atmaq .sig.

Növbəti haradır

Birinci qaçış: gör İlk giriş qaytarmaq başlanğıc admin parolu /home/.aihummer/etc/initial-admin-password.txt (rootless quraşdırmada — ~/.aihummer/etc/initial-admin-password.txt).
Yerləşdirməni tənzimləyin: oxuyun Konfiqurasiya.
Rəhbərlikli ilk işə başlamaq istəyirsiniz? İstifadə edin Tez Başlanğıc.