Տեղադրում

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

/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

loginctl enable-linger $USER

# Տեղադրել gateway-ը embedder-ով, առանց բրաուզերի (որոնումը տեղադրվում է լռելյայն)
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh \
  --with-embedder --no-browser

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

Տեղադրել AiHummer-ը **ծագումով հոստի համար**. Տեղադրումը սկսվում է ձեր անձնական գրասենյակի վրա [my.aihummer.ru](https://my.aihummer.ru): դուք գրանցվում եք, ստանում **անձնական հղում տեղադրման համար** և կատարեք մեկ հրաման ձեր սերվերում։ Տեղակայման սցենարը ներբեռնում է ստորագրված փաթեթը ձեր ճարտարապետության համար, տեղադրում է մեկ տեղակայման արմատ `~/.aihummer` (կայացել է այն օգտվողի տնային պանակում, ով հայտարարել է տեղադրողը), գրանցում է systemd-յի միավորները և, ցանկության դեպքում, պատրաստում է sidecar-ները։ Այս գործընթացում որևէ կոնտեյներ չկա։ > [!NOTE] > Դա տեղադրում է բնիկ հոստի վրա՝ թողարկման արխիվ, որը աշխատում է systemd-ի տակ, **ոչ** > Docker. Շրջանցման աստիճանիչը, sidecars-ները և plugins-ները յուրաքանչյուրն աշխատում է որպես սեփական systemd > սերվիս > [!NOTE] > **Ինչ է ձեզ անհրաժեշտ սկսելուց առաջ՝** > > - ա **Լինուկս** սերվեր (x86_64 կամ arm64), որի հետ դուք կարող եք միանալ SSH-ի միջոցով; > - **`sudo`** կարգավորման իրավունքներ (կամ պատրաստակամություն rootless տեղադրել — նայեք նշվածից ներքև); > - **PostgreSQL** ց `pgcrypto` ներծծում — կամ թույլ տալ տեղադրողին կարգավորել > օգտատերային ռեժիմի կլաստեր (մանրէմորթ ռեժիմում դա ինքնուրույն է անում); > - հաշիվը <համար> [my.aihummer.ru](https://my.aihummer.ru) ստանալ ձեր անձնական > տեղադրման հղում. > > Ամբողջ ցանկը պահանջների գտնվում է > [Պահանջներ](/hy/v1.0/getting-started/requirements) էջ. ## Քայլ 1․ ստացեք ձեր անհատական ​​հղումը տեղադրման համար Ընդհանրապես մատչելի տեղադրման սցենար չկա — տեղադրման հղումը՝ **անձնական** և տրամադրվել է ձեր հաշիվ-պորտալում: 1. Գրանցվել [my.aihummer.ru](https://my.aihummer.ru) (հեռախոսահամար + գաղտնաբառ; էլեկտրոնային փոստը նույնպես անհրաժեշտ է)։ 2. Բացի **Տեղադրում** էկրանն ու սեղմեք «Ստանալ անհատական տեղադման հղումը»։ 3. Պորտալը ցույց է տալիս պատրաստ կատարվող հրամանը ձեր անհատական հղումով։ Հավելյալ մանրամասները կայքի մասին (վճարների տվյալներ, փաստաթղթերը, պլանները) գտնվում են [Անձնական պալատ](/hy/v1.0/commercial/personal-account) էջ. ## Քայլ 2․ մեկ հրամանով տեղադրում Պատճենեք հրամանը «Տեղադրում» էկրանից և զանգահարեք այն ձեր սերվերի վրա (Linux x86_64/arm64): ```bash curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh ``` Անհատական հղումն ունի `https://my.aihummer.ru/dl/<token>/install.sh` տեսքը և կապված է ձեր հաշվին։ > [!IMPORTANT] > **Հղումը միանվագ է․ այն գործում է ուղիղ մեկ տեղադրման համար։** Հենց որ > տեղադրիչը դրանով ներբեռնել է `install.sh`-ը, հղումը համարվում է ծախսված։ Նույն > հրամանը կրկին գործարկելիս կստանաք «հղումն արդեն օգտագործված է» սխալը — սա > խափանում չէ, այլ պաշտպանություն։ **Ի՞նչ անել․** անձնական հաշվում բացեք > «Տեղադրում» էկրանը և ստացեք նոր հղում․ դա անվճար է և ակնթարթային։ > > **30 օր** ժամկետը վերաբերում է ոչ թե կրկնակի տեղադրմանը, այլ արտեֆակտների > ներբեռնմանը․ արդեն տեղադրված օրինակը շարունակում է թարմացվել իր հղումով նույնիսկ > այն բանից հետո, երբ հղումը ծախսվել է տեղադրման վրա։ Սցենարը որոշում է ձեր պրոցեսորի ճարտարապետությունը, բեռնում համապատասխան փաթեթը այն հետ միասին `.sha256` կոնտրոլային գումար և համագիր հեղինակային ստորագրություն `.sig` ստորագրություն, ստուգում է երկուսն էլ, բացում է տեղադրության արմատը և գրանցում է գեյթիւեյի ծառայությունը։ Տեսեք [Փոփոխությունների օրագիր](/hy/v1.0/changelog) ամսագրի այս թողարկման համար Ընդդիմադիր հղում **կապում է օրինակը ձեր հաճախորդի պորտալի հաշվի հետ**: տեղադրման ծրագիրը պահում է տոկենը հղումից, ինստանցիան այն ուղարկում է առաջին գրանցման ժամանակ մատակարարին, իսկ պորտալը ավտոմատ կերպով կապում է ինստանցիան ձեր հաշվի հետ: Ձեր էլ. փոստը անմիջապես դառնում է տպագիր օրինակ **վստահելի կոնտակտ** — վեբ ինտերֆեյսում չկա առանձին քայլ «կցել և ստուգել էլեկտրոնային փոստը», և լիցենզիան ապահովվում է առանց ձեռնական գործողությունների։ > [!WARNING] > Ձեր անձնական հղումը ձեր տարածման բանալին է։ Մի հրապարակեք այն՝ ցանկացած > պահելով հղումը, հնարավոր է ներբեռնել հավաքածուները ձեր անունից մինչև տոկենի ժամկետն ավարտվելը: ## Տեղադրել արմատային նշագրման Ամեն ինչ գտնվում է մեկ կատալոգի ներքո։ **Որի՝ կախված է նրանից, թե ինչպես եք գործարկել տեղադրիչը․** | Ինչպես եք տեղադրել | Տեղադրման արմատը | Կարգավորումները | Ում անունից է աշխատում ծառայությունը | |---|---|---|---| | Սովորական տեղադրում (`sudo`-ով) | `/home/.aihummer` | `/etc/aihummer/gateway.env` | Առանձին `aihummer` սպասարկող հաշիվ | | Առանց root-ի (rootless) | `~/.aihummer` | `~/.aihummer/etc/gateway.env` | Ձեր սեփական օգտվողը | Սովորական տեղադրումը ֆայլերը ձեր տնային կատալոգում **չի դնում** և ծառայությունը ձեր անունից **չի գործարկում**․ դրա համար ստեղծվում է առանձին ոչ արտոնյալ `aihummer` օգտվող։ Դա արված է դիտավորյալ — ծառայության կոտրումը հարձակվողին ձեր անձնական ֆայլերը չի տալիս։ Արմատի ներսի դասավորությունը երկու ռեժիմում էլ նույնն է (ստորև ցույց է տրված սովորականը)․ ```text /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-ի միավորների ֆայլերը, որոնք ստեղծվել են `systemd/` են **ստեղծվեց խորհրդանշական հղում դեպի `/etc/systemd/system/`**, այդ պատճառով դրանք կառավարում են կանոնավոր `systemctl` խմբեր ## Անուրուց տեղադրում `sudo`/root-նպաստներ պահանջվող չեն. Եթե դուք կատարեք տեղադրման հրամանը **առանց sudo**, տեղադրիչը անցնում է առանց root-մանրէմի ռեժիմ՝ միավորները նամականւորեն գրանցվում են `systemd --user` մայրուղի (ֆայլեր մեջ `~/.config/systemd/user`), դա `aihummer` CLI-ն և cosign-ը կհայտնվեն `~/.aihummer/bin`, և եթե `AIHUMMER_DATABASE_URL` չի տեղադրվել, տեղադրող ծրագիրը կտեղադրի PostgreSQL կլաստերը օգտվողի ռեժիմում տեղադրման արմատային թղթապանակի ներսում: Ծառայությունները կառավարվում են օգտագործելով `systemctl --user ...`Որպեսզի ծառայությունը գործարկվի հոսթի բեռնման ժամանակ (առանց միայն օգտվողի մուտքի), ներգրավեք ուշացումը՝ ```bash loginctl enable-linger $USER ``` ## Ընտրություն մանկասայլակ Հեշտ մեդիաաջակցություն — **STT (faster-whisper), TTS (edge-tts) և վիդեո — տուփից դուրս տեղադրում**, առանց հարցերի կամ նախազգուշացումների՝ երկկողմանի ձայնային կապը աշխատում է անմիջապես։ Դրանցից ցանկացածը կարելի է անջատել միջավայրի փոփոխականների միջոցով `AIHUMMER_SKIP_STT=1`, `AIHUMMER_SKIP_TTS=1`, `AIHUMMER_SKIP_VIDEO=1`. Վեբ որոնումը (SearXNG) և բրաուզերը (CloakBrowser) **ներկառուցված են ստորագրված փաթեթում** և լռելյայն տեղադրվում են օֆլայն — տեղադրիչն այլևս դրանց մասին չի հարցնում: Այս վարքը կարելի է փոխել դրոշակներով՝ սա ամբողջական ցանկն է: | Կենդանագ | ԱԿԸ | |---|---| | `--no-search` / `--no-browser` | Այն կողմնակի զրոյակը բաց թողնել | | `--external-search=URL` / `--external-browser=URL` | Օգտագործեք առկա ծառայությունը այս URL հասցեում, այլ ոչ թե տեղադրեք | | `--browser-engine=cloak\|chrome` | Բրաուզերի շարժիչը (լռելյայն՝ `cloak`) | | `--with-search` / `--with-browser` | Ավելորդ են v1.0.14-ից՝ սա հենց լռելյայն վարքն է | | `--with-embedder` | Տեղադրեք սեմանտիկական զանգվածավորիչը (**գնորդի ցանկությամբ անդամակցություն**: ներբեռնում է PyTorch — հարյուրավոր ՄԲ) | Որոնումը և բրաուզերը տեղադրվում են նաև առանց tty. օգտակար բեռը վերցվում է փաթեթից, և դրա համար ինտերնետ մուտք պետք չէ։ Երկուսի տեղադրումն էլ **չի արգելափակում** — եթե օգտակար բեռը բացակայում է կամ Python-ի տարբերակը չի աջակցվում, ծառայությունը պարզապես մնում է չկարգավորված, իսկ տեղադրումը շարունակվում է։ Մեջբերված մոդուլը նույնպես կարող է միացվել `AIHUMMER_WITH_EMBEDDER=1`; առանց դրա հիշողությունը գործում է բառային համապատասխանությունների որոնման հիման վրա: Միջերեսի լեզուն սահմանվում է օգտագործելով `AIHUMMER_LANG=ru|en` (հակառակ դեպքում տեղադրիչը հարցնում է tty-ում): Հետևելով PostgreSQL-ին կապը պահանջվում է tty-ում; առանցհամալիր տեղադրման համար կարգավորեք `AIHUMMER_DATABASE_URL` նախօրոք։ TTY-ում տեղադրողը նաև առաջարկում է վերականգնում պահուստային պատճենից։ ```bash # Տեղադրել gateway-ը embedder-ով, առանց բրաուզերի (որոնումը տեղադրվում է լռելյայն) curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh \ --with-embedder --no-browser ``` Քանի որ sidecar-ները դիմում են URL-ին, դուք կարող եք ազատորեն խառնել նատիվ և արտաքին, ինչպես նաև մի քանի գեյթւեյ ուղղել մեկ ընդհանուր sidecar-ի վրա: ## Ինչպես է ստուգվում կազմության իսկությունը Անձնական հաշվից ստացված անհատական հղումը միշտ տեղադրում է **ընթացիկ թողարկումը** — սա կանոնավոր և միակ ուղին է։ «Ավելի թարմ տարբերակ» ընտրելու կարիք չկա․ դուք ստանում եք այն կազմությունը, որը մատակարարը թողարկել է շահագործման համար։ Յուրաքանչյուր արտեֆակտ — և՛ առաջին տեղադրման, և՛ ամեն թարմացման ժամանակ — ժամանում է ձեր ճարտարապետությանը համապատասխան tarball-ով, իսկ դրա կողքին դրված են `.sha256` ստուգիչ գումարը և `.sig` (cosign) ստորագրությունը։ Տեղադրիչը ստուգում է **երկուսն էլ** նախքան որևէ բան բացելը։ Ձեռքով ոչինչ ստուգելու կարիք չկա։ **Սպասվող արդյունքը․** ստուգումներն անցնում են լուռ, և տեղադրումը շարունակվում է։ Եթե գեթ մեկը չի համընկնում, տեղադրիչը կանգ է առնում սխալով և արդեն աշխատող տարբերակին **չի դիպչում** — վնասված կամ փոխարինված ֆայլը սերվեր չի հասնի։ Եթե մատակարարը ձեզ հրավիրել է վաղ փորձարկման ծրագրին, հաշվի «Տեղադրում» էկրանին կհայտնվի փոխարկիչ, և ընտրված տարբերակի համար կտրվի առանձին հղում — տես [Օրինակ](/hy/v1.0/portal/instance)։ ## Ստուգեք տեղադրումը Տեղադրումը ավարտելուց հետո ստուգեք ծառայությունը և պատրաստության վերջնական նշանը: ```bash systemctl status aihummer-gateway curl -fsS http://localhost:8780/healthz curl -fsS http://localhost:8780/readyz ``` `/healthz` հայտնում է կենսունակության և տարբերակի մասին; `/readyz` ստուգում է PostgreSQL-ը և վերադարձնում `503` մինչ տվյալների բազան հասանելի չէ։ Ներառված է կոմպլեկտում `aihummer` CLI-ն նույնպես տրամադրում է `aihummer status` և `aihummer doctor` առողջության վիճակին արագ ծանոթանալու համար։ **Ի՞նչ կհամարեք տեսնել հաջող տեղադրման արդյունքում՝** Հը `aihummer-gateway` ծառայությունը `active (running)`, և `200` այց `/healthz` և `/readyz`, և ադմինիստրատորի սկզբնական գաղտնաբառը `/home/.aihummer/etc/initial-admin-password.txt` (rootless տեղադրման դեպքում՝ `~/.aihummer/etc/initial-admin-password.txt`) համար [առաջին մուտք](/hy/v1.0/getting-started/first-login). ## Արտադրական վերահսկիչ ցուցակ Մեկ տեղադրման հրամաննը զանգված է սկսում, բայց այն **մինչ դեռ պատրաստ չէ արտադրության**. Առաջքան դա ցույց տաք, ավարտեք: - **TLS** — ավարտել HTTPS-ը անցումային կետից առաջ (հետադարձ պրոքսի / ձեր սեփական) սերտիֆիկատ); երբեք մի բացեք սովորական պորտը անվստահելի ցանցում։ - 🔴 **Միացրե՛ք WebSocket-ի աջակցությունը հակադարձ պրոքսիում։** Բջջային և աշխատասեղանի հավելվածը դարպասին միանում է `wss://`-ով, ուստի պրոքսին պետք է փոխանցի `Upgrade` և `Connection` վերնագրերը։ Առանց այդ կարգավորման պրոքսին `101 Switching Protocols`-ի փոխարեն վերադարձնում է **սովորական էջ՝ 200 կարգավիճակով** — հավելվածն այն ընթերցում է որպես «ծառայությունը չի պատասխանում», թեև դարպասը սարքին է և նրա մատյանում ոչ մի սխալ չկա։ Nginx Proxy Manager-ում դա համապատասխան Proxy Host-ի **Websockets Support** անջատիչն է, սովորական nginx-ում՝ `proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";` `location` բլոկում՝ գումարած `proxy_http_version 1.1`։ Ստուգել մեկ հրամանով (սպասվում է `101`, ոչ թե `200`). ```bash 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://ձեր-տիրույթ/ ``` - **Փոխեք ադմինիստրատորի գաղտնը** և ջնջել `initial-admin-password.txt`; տեղադրել ավտանգման էմիտենտ («`AIHUMMER_OIDC_ISSUER` / LDAP / SAML) մինչև բացահայտումը `/admin/*`. - **Ստեղծեք հիմնական բանալիի և տվյալների բազայի կրկնօրինակը** — գրառում `AIHUMMER_MASTER_KEY` (գաղտնիքներ չի վերականգնվում առանց նրա) և կարգավորեք PostgreSQL-ի կանոնավոր պահուստավորումը: - **Միավորեք իրական մոդելը** — տեղադրել `AIHUMMER_LLM_*` (կամ BYOK); առանց դրա պատասխաններ չեն հասնում որոշված դասավորությունից - **Միացրեք առնվազն մեկ ալիք** (Սկսել Telegram) և կապել նրան գործակցի հետ։ տեսնել [Առաջին մուտք](/hy/v1.0/getting-started/first-login), [Կոնֆիգուրացիա](/hy/v1.0/getting-started/configuration) և [Պահուստային քաղօրպում և արտակարգ վերականգնում](/hy/v1.0/operations/backups-dr) մասերի համար։ ## Եթե սա չի աշխատել - **«հղումն արդեն օգտագործված է» / տեղադրումը երկրորդ անգամ չի գործարկվում** — հղումը միանվագ է և արդեն ծախսվել է նախորդ փորձի վրա։ Ստացեք նորը հաշվի «Տեղադրում» էկրանում և կրկին գործարկեք հրամանը։ - **`curl: (22) … 404` կամ «հղումն անվավեր է»** — հղումն ամբողջությամբ չի պատճենվել կամ դրա ժամկետը լրացել է։ Բուժվում է նույն կերպ — նոր հղումով։ - **չմատուցվող ճարտարապետություն** — տեղադրումն աջակցում է Linux x86_64 և arm64; Այլ պլատֆորմների համար փաթեթը չկա։ - **`/readyz` վերադարձնում է `503`** — դարպասը չի կարող տեսնել PostgreSQL-ը։ Ստուգեք `AIHUMMER_DATABASE_URL`, տվյալների բազայի հասանելիությունը և ինչ `pgcrypto` լայնացում ստեղծվում է (`CREATE EXTENSION IF NOT EXISTS pgcrypto;`). - **Սերվիսը չսկսվեց** — զննել `systemctl status aihummer-gateway` և `journalctl -u aihummer-gateway`; արագ ախտորոշման համար գործարկել `aihummer doctor`. - **Տեղադրված է առանց sudo-ի, ծառայությունները կանգ են առնում համակարգից դուրս գալուց հետո** — միացնել ուշացումը: `loginctl enable-linger $USER` (տես. [անհիմն](#rootless-install)). - **Կնիքի ստուգումն անհաջող էր** — մի շարունակեք տեղադրումը; փորձեք նորից ավելի ուշ կամ ստացեք նոր հղում։ Արձանիկը միշտ ստուգվում է իր դեմ `.sha256` և համահեղինակ `.sig`. ## Որտեղից հետո - Առաջին թողարկումը՝ տես [Առաջին մուտք](/hy/v1.0/getting-started/first-login) հանել սկզբնական ադմինիստրատորի գաղտնը `/home/.aihummer/etc/initial-admin-password.txt` (rootless տեղադրման դեպքում՝ `~/.aihummer/etc/initial-admin-password.txt`). - Տեղաբաշխման կարգավորում՝ կարդալ [Կոնֆիգուրացիա](/hy/v1.0/getting-started/configuration). - Ուզո՞ւմ եք առաջին վազքը ուղեկցությամբ օգտագործողով: Օգտագործեք [Արագ սկիզբ](/hy/v1.0/getting-started/quickstart).