Развертывание с нулевыми затратами (AIStudio Reverse Proxy)

Обратите внимание: Решение для развертывания в этом руководстве должно использоваться вместе с CLIProxyAPI. Прежде чем начать, убедитесь, что у вас есть запущенный экземпляр CLIProxyAPI.

Начиная с версии v6.3.x, CLIProxyAPI поддерживает подключение к AI Providers через WebSocket, при этом AIStudio стал первым поддерживаемым провайдером.

Однако этот метод требует, чтобы браузер был постоянно открыт для запуска программы связи WebSocket на AIStudioBuild, что может быть неудобно. Если вы решите развернуть его на VPS, вы столкнетесь с проблемой высоких требований к оперативной памяти для VPS.

Чтобы решить эту проблему, я потратил некоторое время на изучение различных решений с headless-браузерами. В итоге я выбрал использование Docker для развертывания на HuggingFace, что позволяет в полной мере использовать большой объем памяти бесплатных инстансов HuggingFace для достижения развертывания с нулевыми затратами.

Шаг 1: Настройка приложения AIStudioBuild

Вам необходимо настроить программу связи WebSocket в AIStudioBuild в соответствии с вашими настройками CLIProxyAPI: откройте официальную программу-пример, скопируйте её, а затем вы должны изменить два места, отмеченных красной рамкой на изображении. В частности, если wsauth установлено в true в CLIProxyAPI, вам нужно установить JWT_TOKEN в значение api-keys, предназначенное для аутентификации в CLIProxyAPI. Установите WEBSOCKET_PROXY_URL на адрес вашего CLIProxyAPI, например: wss://mycap.example.com/v1/ws. После настройки сохраните её и сохраните ссылку на это приложение для последующего использования.

При использовании нескольких аккаунтов вам необходимо выполнить дополнительный шаг: установить разрешение доступа приложения на Public.

Предупреждение о безопасности: После установки значения Public, пожалуйста, храните вашу ссылку в секрете. Не делитесь этой ссылкой публично, чтобы избежать утечки информации об авторизации.

Шаг 2: Подготовка AIStudio Cookie

Для этого шага рекомендуется использовать приватный режим вашего браузера. Войдите на https://aistudio.google.com/ и скопируйте Cookie из инструментов разработчика браузера. Конкретное местоположение показано на изображении ниже:

Шаг 3 (1): Развертывание HuggingFace Space

Откройте https://huggingface.co/spaces/hkfires/AIStudioBuildWS и дублируйте Space. Заполните поле CAMOUFOX_INSTANCE_URL ссылкой на программу, которую вы подготовили на Шаге 1, и заполните поле USER_COOKIE_1 значением Cookie, которое вы подготовили на Шаге 2. Затем нажмите «Duplicate Space».

Дождитесь завершения сборки в HuggingFace. Когда вы увидите логи, подобные следующим, развертывание прошло успешно:

Если у вас несколько аккаунтов, ориентируйтесь на USER_COOKIE_1 и добавьте переменные окружения, такие как USER_COOKIE_2, USER_COOKIE_3 и т. д., в настройках HuggingFace Space.

Важное напоминание: Cookies — это конфиденциальная информация. Пожалуйста, обязательно используйте «Secrets» (а не «Variables») для их хранения, чтобы предотвратить утечку.

Шаг 3 (2): Развертывание на сервере через Docker

Если у вас есть собственный сервер (VPS), вы также можете использовать Docker Compose для развертывания.

1. Загрузите код

   git clone https://github.com/hkfires/AIStudioBuildWS.git
   cd AIStudioBuildWS

2. Настройте переменные окружения Скопируйте .env.example в .env и заполните необходимую информацию (CAMOUFOX_INSTANCE_URL, USER_COOKIE_1 и т. д.). Вы также можете поместить файлы Cookie в формате JSON (с любым именем файла) в директорию cookies, и программа автоматически их прочитает.

cp .env.example .env
nano .env

3. Запуск сервиса

docker compose up -d --build

После успешного развертывания вы должны увидеть логи, похожие на следующие, в CLIProxyAPI. На этом этапе процесс развертывания полностью завершен.

Справочный проект

https://github.com/cliouo/aistudio-build-proxy-all