Настройка vite server proxy на личном VPS в 2026 году

Чтобы избежать CORS и упростить разработку, настройте проксирование запросов через server.proxy в vite.config.js. В SANSARA вы разворачиваете фронтенд и бекенд на одном личном VPS, а vite проксирует API‑запросы к вашему серверу. Регистрируетесь в SANSARA, получаете данные в кабинете, импортируете профиль в клиент на iPhone, Android, Windows или macOS и запускаете проекты на выделенном узле без терминала.

Коротко:

• Vite server proxy работает только в режиме разработки (npm run dev).
• Настройка в vite.config.js через server.proxy с указанием пути и target.
• В продакшене прокси должен быть на стороне сервера или обратного прокси (nginx).
• SANSARA даёт личный VPS с готовым подключением в 9+ странах, без ручной установки панелей.

Что это и кому подходит

Vite server proxy перенаправляет запросы с фронтенда на другой сервер прямо из dev‑сервера. Например, когда фронт на localhost:5173 делает запросы к /api, vite прозрачно отправляет их на бекенд http://localhost:3000.

Кому это нужно:

• Фронтенд‑разработчикам, которые работают с отдельным API‑сервером.
• Тем, кто хочет избежать CORS‑ошибок в браузере во время разработки.
• Командам, которые разворачивают фронт и бек на одном VPS и хотят единой конфигурации маршрутов.

В SANSARA вы получаете личный VPS с защищённым каналом доступа. После регистрации данные для подключения появляются в кабинете, их можно импортировать в клиент на любом устройстве. Вы работаете на выделенном узле, а не в общем пуле.

Как настроить по шагам (с личным VPS SANSARA)

Предположим, у вас есть:

• Фронтенд на Vite (React/Vue/Svelte/etc.) на порту 5173.
• Бекенд (Node.js, Go, Python) на порту 3000 того же VPS.
• Вы хотите, чтобы запросы к /api/* шли на бекенд.

1. 01Получите личный VPS в SANSARA

Зарегистрируйтесь в SANSARA, выберите локацию из 9+ стран, активируйте сервер. В кабинете появятся данные для подключения. Импортируйте профиль в клиент на своём устройстве — канал готов.

1. 01Разверните проекты на VPS

Загрузите код фронтенда и бекенда на сервер. Запустите бекенд на порту 3000 (или другом), убедитесь, что он отвечает.

1. 01Настройте vite.config.js

В корне фронтенд‑проекта создайте или отредактируйте vite.config.js:

`js import { defineConfig } from 'vite'

export default defineConfig({ server: { proxy: { '/api': { target: 'http://localhost:3000', changeOrigin: true, rewrite: (path) => path.replace(/^\/api/, '') } } } }) `

• '/api' — префикс пути, который будет проксироваться.
• target — адрес вашего бекенда на том же VPS.
• changeOrigin: true — меняет заголовок Origin на целевой сервер.
• rewrite — убирает /api из пути при отправке на бекенд (если бек ждёт пути без префикса).

1. 01Запустите dev‑сервер

Выполните в папке фронтенда:

`bash npm run dev `

Теперь запросы с фронта вида http://localhost:5173/api/users будут проксироваться на http://localhost:3000/users.

1. 01Проверьте работу

Откройте браузер, зайдите на фронтенд и выполните запрос к API. В консоли браузера и терминале Vite не должно быть CORS‑ошибок.

Важно: этот прокси работает только в режиме разработки. В продакшене вам нужно настроить обратный прокси (например, nginx) на том же VPS или использовать роутинг на стороне сервера.

Устройства: iPhone, Android, Windows, macOS

SANSARA работает на всех основных платформах:

• iPhone, Android: установите совместимый клиент из App Store или Google Play. Импортируйте профиль из кабинета SANSARA через Telegram‑бота SANSARA или файл конфигурации. После этого у вас будет защищённый канал до вашего VPS.
• Windows, macOS: используйте десктопный клиент. Добавьте профиль из кабинета SANSARA — подключение готово.

На всех устройствах вы работаете с одним личным VPS. Фронтенд и бекенд запущены на сервере, vite server proxy работает в dev‑режиме на том же узле. Внешние запросы к API идут через ваш выделенный канал.

Частые ошибки и как их избежать

1. 01Прокси не работает в продакшене

Vite server proxy — часть dev‑сервера. При сборке (npm run build) прокси отключается. В продакшене используйте nginx или другой обратный прокси на вашем VPS.

Пример минимальной конфигурации nginx для маршрутизации /api на бекенд:

`nginx server { listen 80; server_name your-domain.com;

location /api/ { proxy_pass http://localhost:3000/; }

location / { root /path/to/your/frontend/dist; try_files $uri $uri/ /index.html; } } `

1. 01CORS всё равно появляется

Убедитесь, что:

• target в server.proxy указан правильно.
• Бекенд запущен и слушает нужный порт.
• Используется changeOrigin: true.
• На бекенде тоже настроены CORS‑заголовки, если к нему возможны прямые запросы.

1. 01Пути не совпадают после rewrite

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

`js proxy: { '/api': { target: 'http://localhost:3000', changeOrigin: true, rewrite: (path) => path.replace(/^\/api/, ''), configure: (proxy, _options) => { proxy.on('proxyReq', (proxyReq, req, _res) => { console.log('Proxying:', req.url, '->', proxyReq.path) }) } } } `

1. 01Забыли, что прокси только для dev

Не полагайтесь на vite proxy в production. Все маршруты должны быть явно прописаны на сервере или в обратном прокси.

1. 01Неправильные порты или адреса

На VPS убедитесь, что бекенд слушает localhost или 0.0.0.0 и порт совпадает с target в конфиге. Проверьте файрвол и разрешения портов.

FAQ

Итог

• Настройте server.proxy в vite.config.js для маршрутов к API.
• Убедитесь, что бекенд запущен на том же VPS и слушает указанный в target порт.
• В продакшене замените vite proxy на nginx или другой обратный прокси.
• Используйте личный VPS SANSARA для развёртывания фронта и бека на одном выделенном узле.
• Импортируйте профиль из кабинета SANSARA в клиент на iPhone, Android, Windows или macOS для быстрого старта без терминала.