Что такое прокси-сервер — и почему без него твой 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 коротких урока на телефоне.





