Использование прокси

Если ваша сетевая среда требует прокси-сервер для доступа к LLM API или другим внешним сервисам, Elftia предоставляет гибкие параметры настройки прокси.

Режимы прокси

Elftia поддерживает три режима прокси:

Режим	Поведение	Сценарий использования
Системный прокси	Следует настройкам прокси операционной системы	Пользователи, настроившие прокси на уровне системы
Пользовательский прокси	Использует адрес прокси, указанный в Elftia	Пользователи, которым нужен отдельный прокси для Elftia
Без прокси	Прямое подключение, без прокси	Сеть может напрямую получить доступ ко всем сервисам

Шаги настройки

Способ 1: Настройка на странице параметров

1. Откройте Настройки → Основные.
2. Найдите раздел настройки Прокси.
3. Выберите режим прокси:

Системный прокси

После выбора «Системный прокси» Elftia автоматически определит и будет использовать настройки прокси операционной системы.

• Windows: читает настройки прокси из параметров Internet.
• macOS: читает конфигурацию сетевого прокси из системных настроек.
• Linux: читает переменные окружения http_proxy/https_proxy.

Это самый простой подход — если ваша операционная система уже настроена с прокси (например, через Clash, V2Ray или аналогичные клиенты), выберите этот вариант.

Пользовательский прокси

После выбора «Пользовательский прокси» появится поле ввода для указания адреса прокси.

1. Введите URL прокси в формате:

   http://host:port

   Или с аутентификацией:

   http://username:password@host:port

2. Распространённые примеры:
   • Локальный HTTP-прокси: http://127.0.0.1:7890
   • Локальный SOCKS5-прокси: socks5://127.0.0.1:1080
   • Прокси с аутентификацией: http://user:pass@proxy.example.com:8080
3. Нажмите кнопку Сохранить, чтобы применить конфигурацию.

Без прокси

После выбора «Без прокси» Elftia проигнорирует все настройки прокси и подключится напрямую к целевым серверам.

Способ 2: Настройка через переменные окружения

Также можно настроить прокси через системные переменные окружения, которые Elftia распознаёт автоматически:

Переменная окружения	Назначение
HTTP_PROXY	Адрес прокси для HTTP-запросов
HTTPS_PROXY	Адрес прокси для HTTPS-запросов
ALL_PROXY	Адрес прокси для всех запросов (если два предыдущих не заданы)
NO_PROXY	Список доменов, разделённых запятой, для которых прокси не используется

Задать переменные окружения в Windows:

# PowerShell (постоянно для текущего пользователя)
[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://127.0.0.1:7890", "User")

Задать переменные окружения в macOS / Linux:

# Добавить в ~/.bashrc или ~/.zshrc
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"

к сведению

Когда режим прокси в Elftia установлен в «Пользовательский прокси», адрес прокси, заданный в приложении, имеет приоритет над переменными окружения. При выборе «Системный прокси» учитываются как переменные окружения, так и системные настройки прокси.

Какие сервисы используют прокси

Конфигурация прокси влияет на следующие сетевые запросы:

Сервис	Описание
LLM API вызовы	API-запросы ко всем LLM-провайдерам (OpenAI, Anthropic, Gemini и др.)
MCP-подключение	SSE/HTTP-подключения к MCP-серверам (режим stdio не затрагивается)
Веб-поиск	Запросы агента для поиска и парсинга веб-страниц
Автообновление	Проверка и загрузка обновлений приложения
Удалённые ресурсы	Загрузка удалённых ресурсов: изображения обоев, удалённые шрифты

Следующие сервисы НЕ затрагиваются прокси:

Сервис	Причина
MCP stdio-подключение	Использует локальную связь через дочерний процесс, без сети
Локальные файловые операции	Чтение/запись файлов агентом, команды Shell и т. д.
Операции с базой данных	Локальная база данных SQLite

Аутентификация прокси

Если ваш прокси требует имя пользователя и пароль:

1. Включите данные аутентификации в URL пользовательского прокси:

   http://username:password@proxy.example.com:8080

2. Альтернативно, некоторые прокси-клиенты поддерживают включение локального перенаправляющего порта без аутентификации — вы можете подключиться к нему.

Проверка работы прокси

После настройки прокси можно проверить его работу, выполнив следующие шаги:

1. Откройте Настройки → Настройки провайдера.
2. Выберите провайдера с настроенным API Key.
3. Нажмите Проверить подключение.
4. Если проверка прошла успешно (зелёное уведомление), конфигурация прокси верна.
5. В случае ошибки проверьте:
   • Правильность адреса и порта прокси
   • Запущен ли прокси-сервис
   • Разрешает ли прокси доступ к целевому домену API

Распространённые проблемы

Ошибка ECONNREFUSED

Причина: Прокси-сервер не запущен или указан неверный адрес/порт.

Решение:

1. Убедитесь, что прокси-клиент (Clash, V2Ray и т. д.) запущен.
2. Проверьте, совпадают ли адрес и порт прослушивания прокси с теми, что настроены в Elftia.
3. Некоторые прокси-клиенты по умолчанию прослушивают только 127.0.0.1, а не 0.0.0.0.

Ошибка ETIMEDOUT

Причина: Прокси-сервер не может подключиться к целевому адресу.

Решение:

1. Проверьте работоспособность вышестоящего соединения прокси.
2. Убедитесь, что правила прокси разрешают доступ к доменам LLM API (например, api.openai.com, api.anthropic.com).
3. Некоторые шаблоны правил прокси по умолчанию не проксируют домены API — возможно, потребуется добавить их вручную.

Ошибка SSL/TLS-сертификата

Причина: Прокси-сервер использует самоподписанный сертификат для расшифровки HTTPS.

Решение:

1. Если прокси требует установки корневого сертификата, следуйте документации вашего прокси-клиента для его установки и добавления в доверенные.
2. Некоторые корпоративные прокси выполняют HTTPS-перехват; возможно, потребуется добавить корпоративный корневой сертификат в доверенные на уровне системы.

Прокси работает только для части провайдеров

Причина: Домены API разных провайдеров могут требовать разных правил прокси.

Решение:

1. Убедитесь, что правила маршрутизации прокси охватывают все необходимые домены API.
2. Распространённые домены LLM API:
   • api.openai.com
   • api.anthropic.com
   • generativelanguage.googleapis.com
   • api.deepseek.com

---

Если после настройки прокси проблемы с подключением сохраняются, см. раздел Ошибки подключения для получения более подробных инструкций по устранению неполадок.