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