montana/_internal-private/УСТАНОВКА.md

# Установка Montana

Две части: **узел** (своя нода Montana на твоём компьютере) и **VPN** (защищённое подключение к интернету через Montana).

Можно ставить только узел, только VPN, или оба.

---

## Часть 1. Узел Montana на Mac

Узел — это программа, которая считает время и хранит твой кошелёк Ɉ. Работает в фоне сама. Мак можно закрывать и открывать — узел просыпается.

### Что нужно

- Mac (любой, 2018 года и новее)
- macOS Sonoma (14) или новее — посмотреть в **🍎 → Об этом Mac**
- 5 ГБ свободного места
- 30 минут на первую установку

### Шаг 1. Скачать программу установки

Открой **Терминал** (приложение «Терминал» в **Программы → Утилиты**) и вставь одну строку:

```
git clone https://hub.montana.quest/efir369999/montana.git ~/Montana
```

Нажми **Enter** и подожди — программа скачается за минуту-две.

### Шаг 2. Запустить установку

В том же Терминале вставь:

```
bash ~/Montana/Montana-Protocol/Apps/macOS/install-anywhere.sh
```

Нажми **Enter**. Установщик сам:
- проверит, что нужно для работы (Xcode tools, Rust)
- соберёт узел
- придумает тебе **24 секретных слова** — твой ключ от кошелька
- запустит узел в фоне
- откроет приложение Montana

### Шаг 3. ⚠️ Записать 24 слова на бумагу

Когда установщик покажет 24 слова — **сразу возьми ручку и бумагу и запиши их подряд**.

Эти слова — единственный способ восстановить кошелёк. Если потеряешь — потеряешь всё. Если их украдут — украдут всё.

**Никогда не**:
- фотографируй экран телефоном
- сохраняй в заметках, почте, Telegram
- загружай в облако

**Делай**:
- запиши на бумаге крупно и чётко
- положи бумагу туда, где никто не увидит
- лучше две копии в разных местах

### Шаг 4. Проверить что работает

В Dock появилась иконка **Montana**. Открой её. Видишь зелёный кружок «узел работает» сверху справа — всё хорошо.

Узел внутри проходит несколько фаз:
- **CandidateVdf** — считает время первые ~10 часов (можно закрыть Mac, продолжит)
- **Registered** — зарегистрирован в сети
- **Active** — начинает зарабатывать 13 Ɉ за окно (~3 минуты)

Просто оставь работать. Можно закрыть Mac, выйти из системы — узел продолжает в фоне.

### Если что-то пошло не так

**«command not found: git»** — нужны Xcode Command Line Tools. Введи в Терминал: `xcode-select --install` и подожди установки.

**«Permission denied»** — Mac не разрешает запуск. Введи: `bash ~/Montana/Montana-Protocol/Apps/macOS/install-anywhere.sh` (с `bash` в начале).

**Не видно 24 слова** — они в логе установщика. Введи: `cat /tmp/montana-install.log | grep -A 30 "ГЕНЕРАЦИЯ"`.

### Установить на второй Mac (с тем же кошельком)

На втором Mac те же первые два шага (скачать репозиторий + запустить установщик), но в шаге 2 добавь свои **24 слова**:

```
INSTALL_MNEMONIC_OR_SEED='слово1 слово2 слово3 ... слово24' bash ~/Montana/Montana-Protocol/Apps/macOS/install-anywhere.sh
```

Кошелёк на обоих компьютерах — один и тот же.

---

## Часть 2. Подключение к Montana VPN

VPN — это туннель в интернет, через который тебя не видит провайдер и не блокируют сайты. Montana VPN устроен так, что выглядит как обычный сайт — даже DPI (умный фильтр трафика) не отличает.

**Сервер уже поднят нами в Финляндии.** Покупать ничего не надо. Просто поставь клиент-приложение и нажми кнопку на сайте.

### Шаг 1. Поставить VPN-приложение

| Устройство | Приложение | Где взять |
|---|---|---|
| iPhone / iPad | **V2Box** | App Store |
| Android | **v2rayNG** | Google Play |
| Mac | **V2Box** | Mac App Store |
| Windows | **Nekoray** | github.com/MatsuriDayo/nekoray |

Все приложения **бесплатные**. Поставь — пока не открывай.

### Шаг 2. Зайти на сайт и нажать «Подключить»

С того же устройства, на котором поставил приложение, открой **montana.quest/vpn** в браузере.

Нажми большую кнопку **«Подключить Montana VPN»**.

Браузер спросит: «Открыть в V2Box?» (или «v2rayNG», или «Nekoray» — смотря что ты поставил). Нажми **«Открыть»**.

Приложение откроется само, ключ уже внутри — добавлять руками ничего не нужно.

### Шаг 3. Включить

В приложении видишь запись **«Montana»**. Сверху или сбоку — большая кнопка-переключатель. Нажми её.

Через 2-3 секунды — VPN работает.

### Шаг 4. Проверить

Открой в браузере **whoer.net** или **2ip.ru**. Должен показать **финский IP** (Хельсинки). Значит ты подключён.

### Если не получилось

**На iPhone в первый раз** — система спросит «Разрешить VPN-конфигурацию?». Нажми **Разрешить** и введи код-пароль iPhone. Потом снова жми «Подключить».

**Браузер не предлагает открыть приложение** — клиент не установлен или не зарегистрировался как обработчик `vless://`. Поставь V2Box / v2rayNG / Nekoray заново.

**Подключилось, но IP всё тот же** — проверь, что переключатель в приложении именно горит зелёным (не серым). Иногда нужно нажать второй раз.

**Не открывается сайт montana.quest** — провайдер блокирует. Используй любой другой VPN временно (например, бесплатный 1.1.1.1 от Cloudflare), зайди на montana.quest, нажми «Подключить», после этого Montana работает уже без 1.1.1.1.

### На каждом устройстве отдельно

VPN работает только на том устройстве, где включён клиент. Чтобы и на телефоне, и на ноутбуке — повтори шаги 1-2 на каждом.

---

## Безопасность

Montana — твоя приватность по умолчанию. Никто (включая нас) не видит, какие сайты ты открываешь, кому шлёшь Ɉ, где находишься. Это работает только если ты не сливаешь сам:

- **Не показывай** 24 слова от узла никому. Никогда.
- **Не делись** ключом VPN из приложения — ты получил свой, у каждого свой.
- Если случайно показал — переустанови узел / запроси новый VPN-ключ.

## Поддержка

- Сайт: **montana.quest**
- Email: **efir369999@gmail.com**
- Код: **hub.montana.quest/efir369999/montana**

Это начальная версия — будут улучшения и упрощения. Если что-то непонятно — пиши, доделаем.