Что такое…

Что такое прокси-сервер — и почему без него твой API-ключ увидят все

Иллюстрация: между окном браузера и далёким сервером стоит будка, ключ заперт внутри неё

Типичная история. Ты собрал страничку, которая ходит к ИИ-модели. Ключ положил в переменную окружения — «он же не в коде, значит, спрятан». Открываешь свой сайт, жмёшь F12, вкладку Network, находишь запрос — и вот он, твой ключ, лежит в заголовке открытым текстом. Два клика, никакого взлома.

Всё, что доехало до браузера, — публично. Всегда. И прокси — это как раз то место, где ключ может лежать по-настоящему.

Что такое прокси простыми словами

Прокси-сервер — посредник, который принимает запрос вместо получателя и передаёт его дальше от своего имени.

Аналогия — стойка администратора в отеле. Гость не идёт стучаться в служебные помещения: он говорит на стойке, что ему нужно. Администратор сам решает, кому передать, добавляет служебные пометки, кому-то отказывает. Снаружи виден только он.

Для твоего приложения это значит: браузер разговаривает не с OpenAI напрямую, а с твоим собственным маршрутом вроде /api/ask. А уже он — с OpenAI.

Прямой и обратный прокси — в чём разница

Слово одно, а вещи почти противоположные — и путаница тут стоит времени.

  • Прямой (forward) прокси стоит на стороне клиента. Это он имеется в виду, когда говорят «сидеть через прокси»: запросы уходят от его имени, а не от твоего. Корпоративные фильтры, кэши в офисной сети.
  • Обратный (reverse) прокси стоит на стороне сервера, перед ним. Клиент вообще не знает, что за ним. Так работают nginx, CDN, балансировщики нагрузки — и, что важнее для тебя, твой собственный серверный маршрут перед чужим API.

В вайб-кодинге в 99% случаев речь про второй. «Сделай прокси для ключа» = «заведи свой эндпоинт, который ходит к API вместо браузера».

Зачем прокси лично тебе: три причины

Первая — ключ. Ключ живёт на сервере и в браузер не попадает никогда. Браузер отправляет «вот вопрос пользователя», сервер добавляет ключ и уходит к модели. Подробнее про сам ключ — в разборе что такое API-ключ, а про то, где его держать, — в гайде как безопасно хранить ключи.

Вторая — лимиты. Без прокси любой, кто нашёл твой ключ, тратит твои деньги. С прокси ты сам решаешь: не больше 20 запросов в час с одного пользователя. Это твой предохранитель, а не чужой рейт-лимит.

Третья — CORS. Браузер запрещает страничке ходить на чужие домены без разрешения. Твой прокси живёт на твоём же домене — запрос перестаёт быть «чужим», и ошибка исчезает сама собой. Это, кстати, самый частый способ починить CORS по-настоящему, а не костылями.

Как выглядит самый простой прокси

Прокси звучит солидно, но в минимальном виде это один серверный обработчик на десяток строк:

// сервер: /api/ask
export async function POST(req) {
  const { question } = await req.json();

  const r = await fetch("https://api.provider.com/v1/messages", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      // ключ берётся из окружения СЕРВЕРА и наружу не уходит
      "x-api-key": process.env.PROVIDER_KEY,
    },
    body: JSON.stringify({ model: "…", messages: [{ role: "user", content: question }] }),
  });

  return Response.json(await r.json());
}

Браузер зовёт /api/ask. Ключ остаётся в process.env на сервере. Всё.

Одна ловушка, на которой спотыкаются почти все: если в названии переменной есть префикс вроде NEXT_PUBLIC_, VITE_ или PUBLIC_, сборщик специально вшивает её значение в клиентский бандл. Такая переменная — не секрет, а публичная настройка. Секрету имя должно достаться без префикса.

Как понять, что прокси тебе нужен

Проверка на один вопрос: уходит ли из браузера хоть один запрос, в котором есть чужой ключ или пароль? Открой F12 → Network, потыкай своё приложение, посмотри заголовки. Если да — тебе нужен прокси, и это работа на полчаса.

Если нет — отлично, ты уже разделил фронтенд и бэкенд правильно, даже если не называл это прокси.

Одна ошибка, которая сводит всю затею на нет

Прокси спасает не сам по себе. Если твой /api/ask принимает любой текст от кого угодно и без ограничений уносит его к модели — ты не спрятал ключ, а просто выдал его в аренду всему интернету. Разница только в том, что теперь счёт растёт не через чужой ключ, а через твой эндпоинт.

Минимум, который делает прокси прокси, а не открытым шлюзом:

  • Ограничь, что можно просить. Модель, лимит токенов и системную часть промпта задаёт сервер, а не клиент. Из браузера приходит только пользовательский текст.
  • Поставь лимит на пользователя. Хоть по сессии, хоть по IP — важно, что предел вообще есть.
  • Не проксируй запрос вслепую. «Возьму тело из браузера и перешлю как есть» — это тот же открытый доступ, только с лишним шагом.

Три правила, полчаса работы — и прокси начинает защищать не только ключ, но и баланс.

Прокси замедлит моё приложение?

Добавится один сетевой перегон — обычно десятки миллисекунд. На фоне секунд, которые модель думает над ответом, это незаметно. А стриминг ответа через свой прокси прекрасно пробрасывается дальше.

Прокси — это то же самое, что VPN?

Нет. VPN заворачивает весь трафик устройства в шифрованный туннель. Прокси — посредник для конкретных запросов конкретного приложения. Совпадает только слово «посредник».

Можно обойтись без прокси, если сайт статический?

Тогда нужен любой кусочек серверного кода — serverless-функция, edge-функция, маленький бэкенд. Именно он и станет твоим прокси. Статическая страница физически не умеет хранить секрет.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →