docs: macOS download instructions from git raw URLs

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-28 07:58:06 +03:00
parent f266ea8288
commit 4c2d6b8be7
1 changed files with 99 additions and 12 deletions
@@ -10,6 +10,105 @@
 | macOS arm64 | `dist/navis-release/darwin-arm64/Navis` | CLI |
 | macOS amd64 | `dist/navis-release/darwin-amd64/Navis` | CLI |

+## Скачать macOS прямо с git
+
+Репозиторий: https://git.evilfox.cc/test2/navi
+
+### 1. Узнайте архитектуру Mac
+
+В Терминале:
+
+```bash
+uname -m
+```
+
+- `arm64` → Apple Silicon (M1/M2/M3/M4) → папка **darwin-arm64**
+- `x86_64` → Intel → папка **darwin-amd64**
+
+### 2. Скачайте бинарник одной командой
+
+**Apple Silicon (arm64):**
+
+```bash
+mkdir -p ~/Navis && cd ~/Navis
+curl -fL -o Navis \
+  "https://git.evilfox.cc/test2/navi/raw/branch/main/dist/navis-release/darwin-arm64/Navis"
+chmod +x Navis
+```
+
+**Intel (amd64):**
+
+```bash
+mkdir -p ~/Navis && cd ~/Navis
+curl -fL -o Navis \
+  "https://git.evilfox.cc/test2/navi/raw/branch/main/dist/navis-release/darwin-amd64/Navis"
+chmod +x Navis
+```
+
+Проверка версии / обновлений:
+
+```bash
+./Navis check-update
+```
+
+### 3. Первый запуск
+
+```bash
+cd ~/Navis
+./Navis init
+./Navis install-core
+./Navis set-proxy 'hysteria2://PASSWORD@HOST:PORT/?sni=...#name'
+# или naive+https://user:pass@host
+./Navis connect
+```
+
+Полезные флаги:
+
+```bash
+./Navis connect -no-sysproxy    # только локальный SOCKS/HTTP, без networksetup
+./Navis connect -probe          # проверка туннеля после коннекта
+```
+
+Локальные прокси после `connect`:
+
+- SOCKS5: `127.0.0.1:1080`
+- HTTP: `127.0.0.1:1081`
+
+Системный прокси на macOS выставляется через `networksetup` (может запросить права администратора).
+
+### 4. Если macOS блокирует запуск
+
+```text
+“Navis” cannot be opened because it is from an unidentified developer
+```
+
+Снимите quarantine и разрешите в Настройках:
+
+```bash
+xattr -dr com.apple.quarantine ~/Navis/Navis
+```
+
+Затем: **Системные настройки → Конфиденциальность и безопасность → Всё равно открыть**.
+
+### 5. Обновление с git
+
+```bash
+cd ~/Navis
+./Navis check-update
+./Navis apply-update
+# закройте процесс Navis — бинарник подменится сам
+```
+
+Или скачайте файл заново теми же `curl` из шага 2.
+
+Прямые ссылки (raw):
+
+| Архитектура | URL |
+|-------------|-----|
+| arm64 | https://git.evilfox.cc/test2/navi/raw/branch/main/dist/navis-release/darwin-arm64/Navis |
+| amd64 | https://git.evilfox.cc/test2/navi/raw/branch/main/dist/navis-release/darwin-amd64/Navis |
+| манифест | https://git.evilfox.cc/test2/navi/raw/branch/main/dist/update.json |
+
 ## Сборка Windows

 ```bat
@@ -35,18 +134,6 @@ CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o dist/navis-release/darwin-arm
 CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o dist/navis-release/darwin-amd64/Navis ./cmd/vpnclient
 ```

-На Mac:
-
-```bash
-chmod +x Navis
-./Navis init
-./Navis install-core
-./Navis set-proxy 'hysteria2://…'
-./Navis connect
-```
-
-Системный прокси на macOS выставляется через `networksetup` (HTTP + SOCKS).
-
 ## Обновления

 Манифест: `https://git.evilfox.cc/test2/navi/raw/branch/main/dist/update.json`