გამავალი პროქსი

# Что сейчас настроено (значение не печатается — только факт настройки)
aihummer doctor

# Журнал шлюза: предупреждение о прямом пути, если прокси не применён
journalctl -u aihummer-gateway -n 200 | grep -i прокси

მოდელების ნაწილი არ არის პირდაპირ ხელმისაწვდომი რუსეთში სერვერებიდან. იმისათვის, რომ ეს არ გარდაიქმნას თითოეული ოპერატორის ხელით კონფიგურაციად, AiHummer **ინსტალაციისას იძლევა გამავალი პროქსის მისამართს** და თვითონ ირჩევის, რომელი გზით გაიგზავნოს მოთხოვნა. ## მთავარი ორი წინადადებით პროქსის მისამართი მოდის ვენდორიდან და ინახება პრივატურ ფაილში სერვერზე — `gateway.env`-ში არ ინახება და ჟურნალებში არ შედის. თუ პროქსი არ არის მითითებული ან მიუწვდომელია, მოთხოვნა იგზავნება **პირდაპირ**: ინსტანსი განაგრძობს მუშაობას, არ იჩენს შეცდომას. ## რა სად მიდის | სად | როგორ მიდის | | --- | --- | | გარე მოდელი (სათვალის პროვაიდერი) | პროქსის საშუალებით, თუ ის კონფიგურირებულია და შესაფერისია | | იგივე მოდელი, როდესაც პროქსი მიუწვდომელია | **პირდაპირ**, ჟურნალში გაფრთხილებით | | `localhost`, `*.localhost`, ინსტანსის შიდა მისამართი | **ყოველთვის პირდაპირ**, პროქსის გარეშე | ბოლო სტრიქონი მნიშვნელოვანია: ინსტანსის თავის თავს მიმართვა არასოდეს გადატარდება პროქსის საშუალებით, წინააღმდეგ შემთხვევაში ლოკალური გამოძახებები დამოკიდებული იქნებოდა გარე არხზე. ## ალტერნატიული გზა: პროქსის არ არსებობა — არ არის უარყოფა ვერსია 1.2.8-მდე, მითითებული ან არამოქმედი პროქსი ნიშნავს მოთხოვნის შეცდომას. ახლა ქცევა განსხვავებულია: - პროქსი კონფიგურირებულია და შესაფერისია → მოთხოვნა იგზავნება მისი საშუალებით; - პროქსი **არ არის კონფიგურირებული** → მოთხოვნა იგზავნება პირდაპირ, ჟურნალში ერთხელ იწერება გაფრთხილება მიზეზით «არ არის კონფიგურირებული»; - პროქსი კონფიგურირებულია, მაგრამ **მნიშვნელობა არ არის შესაფერისი** → მოთხოვნა იგზავნება directly, მიზეზია გაფრთხილებაში — «კონფიგურაცია არ არის შესაფერისი». გაფრთხილება გამოჩნდება **ერთხელ თითოეული გაშვებისას**, არა თითოეული მოთხოვნისთვის: წინააღმდეგ შემთხვევაში იგი გადავსებდა ჟურნალს და აღარ იქნებოდა წაკითხვადი. :::note პირდაპირი გზა — ალტერნატიული ვარიანტია, პროქსის ჩანაცვლება არა. თუ პროვაიდერი არ იღებს მოთხოვნებს რუსული მისამართებიდან, პირდაპირი მოთხოვნა მასზე არ გაივლის — თუმცა უარყოფის მიზეზი პროვაიდერისგან იქნება, და პასუხში ნახავთ ზუსტად ამას, არა საერთო «კონფიგურაციის გადატარება ვერ მოხერხდა». ::: ## სად ინახება მისამართი მნიშვნელობა ცხოვრობს **პირად ფაილში**, რომლის გზაც განსაზღვრავს `AIHUMMER_OUTBOUND_PROXY_URL_FILE`. ფაილის მოთხოვნები: - აბსოლუტური გზა; - ჩვეულებრივი ფაილი, უფლებები **არ უფრო ფართო, ვიდრე `0600`**; - ზომა არ აღემატება 4096 ბაიტს. ეს განკარგულია მიზანშეწონათ: პროქსის მისამართი შეიცავს პაროლს, ამიტომ არ უნდა იყოს `gateway.env`-ში, რომელიც წაიკითხება და დაკოპირდება სერვისისას. :::caution ცნობიერება `AIHUMMER_OUTBOUND_PROXY_URL` მისამართით «პირდაპირ მნიშვნელობაში» არსებობს მხოლოდ განვითარების ბილდებისთვის. **გამოშვების ბილდები მას არ იკითხავენ** — პროდუქციაში მიიღება მხოლოდ ფაილის გზა. ::: ## რა მისამართებია მიღებული შემოწმება ერთნაირია როგორც კონფიგურაციის მიწოდებისას, ასევე გამოყენებისას, ამიტომ არასწორი მნიშვნელობა უარყოფილია დაუყოვნებლივ, eikä მოგვიანებით გადაიყვანს «სათვალის მოდელები აღარ მუშაობენ» ჟურნალში ერთაცრიანი ჩანაწერის გარეშე. მიღებულია: სქემა `http` ან `https`, არ-ცარიელი ჰოსტი, მოთხოვნის სტრიქონის გარეშე, ფრაგმენტის გარეშე, ბილიკის გარეშე (გარდა `/`-ის). 🔴 **მხოლოდ `http` არა-ლოკალურ ჰოსტზე უარყოფილია მიზანშეწონათ.** დაუშიფრავ `http`-ში `Proxy-Authorization` სათაური იგზავნება ღია ტექსტით ყოველ დაკავშირებაზე — ანუ პროქსის პაროლი მუდმივად ილაპარაკებოდა. არა-ლოკალურ ჰოსტზე გამოიყენეთ `https`. ## როგორ შემოწმდეს, რა ხდება ```bash # Что сейчас настроено (значение не печатается — только факт настройки) aihummer doctor # Журнал шлюза: предупреждение о прямом пути, если прокси не применён journalctl -u aihummer-gateway -n 200 | grep -i прокси ``` კონფიგურაციის გადატარების უარყოფა აღნიშნავს **მიზანს** — «არ არის კონფიგურირებული», «კონფიგურაცია არ არის შესაფერისი» — საერთო «გადატარება ვერ მოხერხდა» ნაცვლად. ეს განსხვავდება «მისამართი არ მიაღწია» და «მისამართი მიაღწია, მაგრამ არასწორია». ## რა უნდა გააკეთოს ოპერატორს საერთოდ — არაფერი: მისამართი იძლევა ინსტალაციისას. შეხება საჭიროა ორი შემთხვევაში. 1. **თქვენი პროქსი vendor-ის ნაცვლად.** ჩაწერეთ მისამართი პრივატურ ფაილში უფლებებით `0600` და მიუთითეთ გზა `AIHUMMER_OUTBOUND_PROXY_URL_FILE`-ში, შემდეგ გადატვირთეთ gateway. 2. **პროქსი არ არის საჭირო בכלל** (ინსტანსია იმ ადგილას, სადაც მოდელები პირდაპირ ხელმისაწვდომია). არაფერი მითითება არ არის საჭირო: მითითებული არ იყოს პროქსი ნიშნავს პირდაპირ მოთხოვნას.