110 lines
3.6 KiB
Markdown
110 lines
3.6 KiB
Markdown
# Запуск сайта LabNetHub на macOS
|
|
|
|
## 1. Проверьте, установлен ли Node.js
|
|
|
|
Откройте Terminal (⌘+Space → введите «Terminal» → Enter) и выполните:
|
|
|
|
```bash
|
|
node -v
|
|
npm -v
|
|
```
|
|
|
|
- Если видите номер версии Node **18.17 и выше** (например, `v20.x`) — переходите к шагу 3.
|
|
- Если команда не найдена или версия ниже — переходите к шагу 2.
|
|
|
|
## 2. Установите Node.js
|
|
|
|
**Вариант А — официальный установщик (самый простой):**
|
|
|
|
1. Откройте https://nodejs.org
|
|
2. Скачайте версию **LTS**
|
|
3. Запустите скачанный `.pkg`-файл и пройдите установку по шагам
|
|
|
|
**Вариант Б — через Homebrew** (если уже пользуетесь brew):
|
|
|
|
```bash
|
|
brew install node@20
|
|
brew link node@20
|
|
```
|
|
|
|
После установки закройте и снова откройте Terminal, затем проверьте:
|
|
|
|
```bash
|
|
node -v
|
|
npm -v
|
|
```
|
|
|
|
## 3. Распакуйте архив проекта
|
|
|
|
Дважды кликните `labnethub-website.zip` в Finder — рядом появится папка `labnethub`.
|
|
|
|
Либо через терминал:
|
|
|
|
```bash
|
|
cd ~/Downloads
|
|
unzip labnethub-website.zip
|
|
cd labnethub
|
|
```
|
|
|
|
## 4. Установите зависимости проекта
|
|
|
|
Находясь внутри папки `labnethub`, выполните:
|
|
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
Это скачает Next.js, React, Tailwind и остальные пакеты. При первом запуске занимает пару минут.
|
|
|
|
## 5. Настройте переменные окружения
|
|
|
|
```bash
|
|
cp .env.local.example .env.local
|
|
open -e .env.local
|
|
```
|
|
|
|
В открывшемся файле впишите свои значения:
|
|
|
|
```
|
|
TELEGRAM_BOT_TOKEN=токен_от_BotFather
|
|
TELEGRAM_CHAT_ID=ваш_chat_id
|
|
```
|
|
|
|
Сохраните (⌘+S) и закройте окно.
|
|
|
|
## 6. Запустите сайт локально
|
|
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
В терминале появится адрес — откройте в браузере:
|
|
|
|
```
|
|
http://localhost:3000
|
|
```
|
|
|
|
Чтобы остановить сервер — нажмите `Control + C` в терминале.
|
|
|
|
## 7. Проверка продакшен-сборки (по желанию)
|
|
|
|
```bash
|
|
npm run build
|
|
npm run start
|
|
```
|
|
|
|
Так сайт запустится в том же режиме, в котором будет работать на реальном сервере.
|
|
|
|
## Частые проблемы
|
|
|
|
| Проблема | Решение |
|
|
|---|---|
|
|
| `command not found: npm` | Node не установлен, либо терминал открыт до установки — закройте и откройте Terminal заново |
|
|
| Порт 3000 занят | Next.js сам предложит другой порт, либо укажите вручную: `npm run dev -- -p 3001` |
|
|
| Ошибки при `npm install` | Проверьте версию Node (`node -v`) — нужна 18.17 или выше |
|
|
| `EACCES` / ошибки прав доступа | Не используйте `sudo npm install` — переустановите Node через официальный установщик или Homebrew |
|
|
|
|
## Что дальше
|
|
|
|
Инструкции по заполнению реальных контактов, деплою на сервер и настройке безопасности — в `README.md` в корне проекта.
|