README.mdraw
# Veil Browser
Интерактивный веб-прототип приватного браузера. Он демонстрирует вкладки, навигацию, приватный режим, центр защиты и историю временной сессии.
Онлайн-версия: [mainstarkov.github.io/veil-browser](https://mainstarkov.github.io/veil-browser/)
## Что уже работает
- вкладки и отдельная приватная вкладка;
- адресная строка, поиск, переходы назад и вперёд;
- история и настройки в `sessionStorage`;
- восстановление сессии после обновления страницы;
- удаление данных после закрытия вкладки браузера;
- ручная очистка сессии;
- адаптивный интерфейс.
## Важное ограничение
Это UI-прототип, а не анонимизирующий браузер. Переключатели защиты пока демонстрационные. Внешние сайты нельзя надёжно загружать внутрь обычного веб-сайта из-за `X-Frame-Options`, CSP и других браузерных ограничений.
Следующий практический этап — перенос интерфейса в отдельное приложение на Chromium/Electron или CEF. Настоящая приватность потребует сетевых политик, изоляции хранилищ, противодействия fingerprinting, контроля WebRTC, DNS и независимого аудита. Абсолютную анонимность гарантировать нельзя.
## Запуск
```bash
npm install
npm run dev
```
Затем откройте `http://localhost:3000`.
### Go-бэкенд
```bash
cd backend
go run ./cmd/server
```
API временных сессий запустится на `http://localhost:8080`. Структура и маршруты описаны в [`backend/README.md`](backend/README.md).
## Проверка
```bash
npm test
```
## Присоединиться к команде
Подать заявку можно через [форму в Issues](https://github.com/mainstarkov/veil-browser/issues/new?template=team-application.yml). После одобрения владелец проекта выдаст доступ к репозиторию.
Правила участия находятся в [CONTRIBUTING.md](CONTRIBUTING.md).