1 Перед началом

Kameleo работает на Windows 10 и новее, Windows Server 2016 и новее, macOS 12 и новее и в Docker. Для Mac документация разработчика называет Apple Silicon. Десктопной версии под Linux нет, только контейнер. Ставится установщиком или пакетом winget Kameleo.App на Windows, из .dmg или через Homebrew cask kameleo на Mac. Вендор просит 4 ГБ памяти и 5 ГБ места на диске.

Бесплатный план ничего не стоит и продлевается сам. В нём 300 минут работы браузера в месяц, 2 браузера одновременно, 100 облачных профилей, локальные без ограничений и 3 участника команды. Для гайда хватит.

Типы прокси: HTTP, SOCKS5 и SSH, SOCKS4 нет. Логин и пароль работают на всех трёх внутри движков Chroma (Chromium) и Junglefox (Firefox). Две фразы из документации задают рамку. "Kameleo does not support UDP-based proxies." И по умолчанию профиль идёт без прокси и показывает IP вашего устройства.

Что понадобится

• Активный план GeekProxy (ISP, датацентр, резидентские или мобильные)
• Данные прокси из кабинета: хост, порт, логин, пароль
• Установленный Kameleo с выполненным входом, бесплатного плана достаточно

2 Где взять данные прокси

1. Войдите в кабинет GeekProxy
2. Откройте план. У планов с оплатой за IP (ISP, датацентр) адреса, порты, логин и пароль перечислены прямо там, а Export отдаёт весь список текстом. Одна строка это один профиль Kameleo
3. У резидентских планов нажмите Options. На Residential Flex панель Proxy Configuration задаёт ОС выхода, тип прокси и TTL сессии и собирает строку логина за вас. Готовую строку копируйте из Proxy List

Kameleo, блок Regional в боковой панели

3 Добавляем прокси в профиль

Нажмите New Profile в левом меню. В форме найдите строку Proxy с двумя кнопками, Without Proxy и With Proxy. Выберите With Proxy. Появятся три кнопки типа: HTTP, SOCKS5 и SSH. Под ними поле хоста и поле порта рядом, затем Username (Optional) и Password (Optional) и кнопка Test Proxy. Закрывается форма через Cancel, Save или Save & Start.

Четыре поля можно заполнить руками. Быстрее взять единственную строку подключения, которую описывает документация. Вставьте её в поле хоста, и Kameleo сам разложит её на хост, порт, логин и пароль:

LOGIN:PASSWORD@IP:PORT

К строке прилагаются три мелких правила. Паролю со спецсимволами может понадобиться URL-кодирование. Хост IPv6 пишется в квадратных скобках. И тип прокси Kameleo угадывает по порту, так что после вставки гляньте на кнопки типа и нажмите нужную, если угадал не то.

Хотите, чтобы каждый новый профиль стартовал с одним и тем же прокси? Settings в левом меню, потом Default Profile Settings. Отдельного экрана для массовой раздачи нет. Local API на порту 5050 принимает объект прокси с типом плюс host, port, id и secret; значение null означает прямое соединение.

Kameleo, New Profile, строка Proxy

Kameleo, строка подключения разложена по полям

4 Запускаем Test Proxy

Test Proxy открывает диалог из двух частей. Server details повторяет Address и Protocol. Test results это список шагов. В приложении версии 3.2.0 он проверяет прямое соединение пингом до 1.1.1.1 и прямой HTTPS до того же хоста. Дальше идут IPv4 через прокси до 1.0.0.1, IPv6 через прокси до 2606:4700:4700::1111 и HTTPS через прокси до archive.org. Документация добавляет, что инструмент пробует Google, Archive.org и Wikipedia и засчитывает тест, если ответил хоть один.

Итог один из трёх: success, partial success или failure. Цель, чтобы все галочки были зелёными. Это проверка связности, так что выходной IP и страну вы всё равно смотрите на ipinfo.io внутри профиля, см. раздел 6.

Два предупреждения вендора стоит повторить. Некоторые провайдеры блокируют тестовые сайты, поэтому тест может провалиться при живом прокси. И "we highly recommend that you do not switch proxies mid session", то есть перед сменой прокси профиль надо остановить.

Kameleo, Test Proxy

5 Локация, язык и WebRTC

Откройте Advanced Settings и найдите раздел Location с заголовком WebRTC, Timezone and Geolocation based on your external IP. У каждого пункта четыре режима: Automatic (Recommended), Manual, Block и Off. Страница рекомендованных настроек велит оставить все три на Automatic, тогда они берутся из IP прокси, и мы согласны. В Automatic адрес WebRTC маскируется под IP прокси.

Язык исключение. Из IP Kameleo его не выводит. Документация говорит прямо: с прокси убедитесь, что язык профиля совпадает со страной прокси. Живёт это в Language & Region в боковой панели профиля, и про эту настройку забывают чаще всего.

DNS резолвит прокси, по документации, и поля для DNS нет. С UDP история другая. Движки браузера оставляют UDP вне прокси, поэтому документация разработчика советует политику Chromium disable_non_proxied_udp для Chroma и настройку Firefox media.peerconnection.ice.proxy_only для Junglefox. На плане с прокси только по TCP это и так правильная позиция.

Kameleo, Advanced Settings, Location

Kameleo, боковая панель профиля, Regional

6 Проверка работы

Нажмите Save & Start и откройте в профиле https://ipinfo.io/json. В поле ip должен быть адрес прокси, а не ваш. На ISP и датацентровом плане это адрес из кабинета, на Residential Flex и Turbo любой адрес из пула в выбранной стране. Сверьте поле country с языком, который вы выставили руками в разделе 5.

На сессии Flex обновите страницу несколько раз в пределах выбранного TTL. IP должен стоять на месте, пока сессия не истечёт.

7 Какой продукт GeekProxy подходит

Kameleo работает только по TCP и резолвит DNS через прокси, так что платить за UDP незачем. Residential Flex повторяет эту форму один в один: только TCP, фильтр выхода Windows или Android, который вы ставите по выбору Device в профиле, и TTL сессии в минутах. Профилю, который через месяц должен выглядеть так же, статический ISP даёт один IP на весь срок аренды. Sticky-сессии Residential Turbo тоже работают, но UDP-сторона Turbo в Kameleo ничего не добавляет. Мобильные для эмулированных профилей Android и iOS, которым нужен IP оператора. Что бы вы ни выбрали, вставляйте как LOGIN:PASSWORD@IP:PORT и нажимайте HTTP или SOCKS5.

8 Частые проблемы

Test Proxy провален, а в других местах прокси работает

Тесту нужно, чтобы через прокси ответил Google, Archive.org или Wikipedia. Если цель где-то по пути заблокирована, шаг падает при исправном туннеле. Запустите профиль и проверьте ipinfo.io. Если IP верный, на красную галочку можно не смотреть.

Пароль со спецсимволами не принимается

Документация предупреждает, что внутри строки подключения такие пароли могут требовать URL-кодирования. Либо кодируйте, либо впишите пароль в его собственное поле, там кодировать ничего не надо.

После вставки стоит не тот тип

Kameleo выбирает тип по соглашению о портах. HTTP-порт и SOCKS5-порт GeekProxy для этой эвристики могут выглядеть одинаково, так что перед сохранением нажмите кнопку, совпадающую с кабинетом.

Часовой пояс верный, язык нет

Так и задумано. Часовой пояс идёт за IP, язык нет. Выставьте его в Language & Region под страну прокси.

Смена прокси не применяется

Запущенный профиль держит старый прокси. Остановите его, смените прокси, запустите снова.