Установка и настройка Node.js на linux alpine 3.18

Подробное руководство по установке, настройке и оптимизации Node.js для linux alpine 3.18

Введение

Node.js – популярная среда выполнения JavaScript для серверной разработки. В этом руководстве вы узнаете:

• Как установить Node.js и npm на Alpine Linux 3.18
• Основные настройки для работы
• Решение распространённых проблем
• Рекомендации по безопасности

Требования

Перед началом убедитесь, что:

• У вас есть доступ к системе с Alpine Linux 3.18
• Учётная запись имеет права sudo
• Установлены базовые пакеты: curl, bash
• Доступно интернет-подключение

Установка

Подготовка

1. Обновите индекс пакетов:

sudo apk update

2. Установите зависимости:

1sudo apk add --no-cache python3 make g++

3. Проверьте обновления:

1apk upgrade --available
2
3### Процесс установки
4
51. Установите Node.js и npm:
6```bash
7sudo apk add nodejs npm

2. Проверьте версии:

1node -v && npm -v

3. Для установки конкретной версии используйте nvm:

1curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
2export NVM_DIR="$HOME/.nvm"
3[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
4nvm install 20.0.0

Настройка

1. Настройте глобальный путь для npm:

1mkdir -p ~/.npm-global
2npm config set prefix ~/.npm-global

2. Добавьте путь в .bashrc:

1echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
2source ~/.bashrc

3. Установите менеджер процессов PM2:

1npm install -g pm2

4. Создайте отдельного пользователя для безопасности:

1sudo adduser -D nodeuser
2sudo chown -R nodeuser:nodeuser /home/nodeuser

Типичные ошибки и их решения

Ошибка: EACCES: permission denied Решение:

1npm config set prefix ~/.npm-global

Ошибка: Command 'node' not found Решение:

source ~/.bashrc

Ошибка: Устаревшие пакеты Решение:

sudo apk fix

Заключение

Теперь вы успешно установили Node.js на Alpine Linux 3.18. Для дальнейшей настройки:

• Используйте .npmrc для кастомизации npm
• Настройте firewall для production окружения
• Регулярно обновляйте пакеты через apk upgrade

Команды

Обновление пакетов

sudo apk update

Установка Node.js

1sudo apk add nodejs npm

Проверка версий

1node -v && npm -v

Установка nvm

1curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

Решение проблем

Ошибки прав доступа npm

Измените префикс npm или используйте sudo с флагом --unsafe-perm

1npm install -g package --unsafe-perm

Пакет nodejs недоступен

Убедитесь, что репозиторий community включен

1sudo apk add nodejs npm --repository=https://dl-cdn.alpinelinux.org/alpine/v3.18/community/

Сломанные зависимости

Очистите кеш пакетов

1sudo apk cache clean