Çykyş proksisi

# What is configured right now (the value is never printed — only whether it is set)
aihummer doctor

# Gateway log: the direct-route warning when the proxy was not applied
journalctl -u aihummer-gateway -n 200 | grep -i proxy

Modelleriň bir bölegine Russiýadaky serwerlerden göni ýetip bolmaýar. Bu zat her operatoryň el bilen edýän sazlamasyna öwrülmez ýaly, AiHummer **çykyş proksisiniň salgysyny gurnama wagtynda berýär** we haýşy haýsy ýoldan ugratmalydygyny özi çözýär. ## Iki sözlemde iň esasysy Proksiniň salgysy üpjün edijiden gelýär we serwerdäki ýapyk faýla ýazylýar — `gateway.env` içinde saklanmaýar, gündeliklere-de düşmeýär. Eger proksi bellenmedik bolsa ýa-da elýeterli bolmasa, haýyş **göni** gidýär: instansiýa saklanmaýar, işlemegini dowam etdirýär. ## Näme nirä gidýär | Nirä | Nähili gidýär | | --- | --- | | Daşarky model (daşary ýurt üpjün edijisi) | sazlanan we ýaramly bolsa, proksi arkaly | | Proksi elýeterli däl mahaly şol model | **göni**, gündelige duýduryş ýazylyp | | `localhost`, `*.localhost`, instansiýanyň içerki salgysy | **elmydama göni**, proksä sowulman | Iň soňky setir möhümdir: instansiýanyň özüne ýüzlenmesi hiç haçan proksä dolanmaýar, ýogsam ýerli çagyryşlar daşarky kanala bagly bolardy. ## Ätiýaçlyk ýol: proksiniň ýoklugy ret ediş däl 1.2.8 wersiýasyna çenli bellenmedik ýa-da işlemeýän proksi haýşyň ýalňyşlygyny aňladýardy. Indi özüni alyp barşy başgaça: - proksi sazlanan we ýaramly → haýyş şonuň üsti bilen gidýär; - proksi **sazlanmadyk** → haýyş göni gidýär, gündelige bir gezek «sazlanmadyk» sebäbi bilen duýduryş ýazylýar; - proksi sazlanan, ýöne **bahasy ýaramsyz** → haýyş göni gidýär, duýduryşdaky sebäp «sazlama ýaramsyz» bolýar. Duýduryş **her goýberilişde bir gezek** çykýar, her haýyşda däl: ýogsam ol gündeligi doldurardy we okalmasyny bes ederdi. :::note Göni ýol — bu ätiýaçlyk çykalga, proksiniň ornuny tutýan zat däl. Eger üpjün ediji Russiýanyň salgylaryndan haýyşlary kabul etmese, göni haýyş hem oňa ýetmez — emma bu gezek ret edýän üpjün ediji bolar we jogapda umumy «sazlamany ulanyp bolmady» däl-de, edil şu görner. ::: ## Salgy nirede saklanýar Baha ýoly `AIHUMMER_OUTBOUND_PROXY_URL_FILE` bilen berilýän **ýapyk faýlda** ýaşaýar. Faýla bildirilýän talaplar: - doly ýol; - adaty faýl, hukuklar **`0600` -dan giň däl**; - göwrümi 4096 baýta çenli. Bu ýörite şeýle edildi: proksiniň salgysy paroly saklaýar, şoňa görä ol hyzmat wagtynda okalýan we göçürilýän `gateway.env` içinde ýatmaly däl. :::caution Salgyny «göni bahanyň içinde» saklaýan `AIHUMMER_OUTBOUND_PROXY_URL` üýtgeýjisi diňe işläp düzüş ýygnamalary üçin bar. **Çykaryş ýygnamalary ony okamaýar** — önümçilikde diňe faýla giden ýol kabul edilýär. ::: ## Haýsy salgylar kabul edilýär Barlag sazlama berlen pursadynda-da, ulanylan pursadynda-da birmeňzeş, şoňa görä ýaramsyz baha derrew ret edilýär, soňra gündelikde ýekeje setir hem galdyrman «daşary ýurt modelleri ýene işlänok» ýagdaýyna öwrülmeýär. Kabul edilýär: `http` ýa-da `https` shemasy, boş bolmadyk host, sorag setiri ýok, bölek ýok, ýol ýok (`/` -dan başga). 🔴 **Ýerli bolmadyk hostda ýalaňaç `http` ýörite ret edilýär.** Şifrlenmedik `http` arkaly `Proxy-Authorization` sözbaşysy her birikmede açyk tekst bilen gidýär — ýagny proksiniň paroly yzygiderli syzardy. Ýerli bolmadyk host üçin `https` ulanyň. ## Näme bolýandygyny nähili barlamaly ```bash # What is configured right now (the value is never printed — only whether it is set) aihummer doctor # Gateway log: the direct-route warning when the proxy was not applied journalctl -u aihummer-gateway -n 200 | grep -i proxy ``` Sazlamany ulanmakdan ýüz öwürmek **sebäbi** atlandyrýar — «sazlanmadyk», «sazlama ýaramsyz» — umumy «ulanyp bolmady» ýerine. Bu «salgy gelip ýetmedi» bilen «salgy gelip ýetdi, ýöne nädogry» tapawudyny görkezýär. ## Operator näme etmeli Adatça hiç zat: salgy gurnalanda berilýär. Goşulmak iki ýagdaýda gerek bolýar. 1. **Üpjün edijiniňkiniň ýerine öz proksiňiz.** Salgyny `0600` hukukly ýapyk faýla salyň we ýoly `AIHUMMER_OUTBOUND_PROXY_URL_FILE` içinde görkeziň, soňra gateway-i gaýtadan goýberiň. 2. **Proksi asla gerek däl** (instansiýa modellere göni ýetip bolýan ýerde dur). Hiç zat görkezmek hökman däl: bellenmedik proksi göni haýşy aňladýar.