Установка и настройка Node.js на Linux Alpine 3.19

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

Введение

Node.js – популярная среда выполнения JavaScript для серверных приложений. В этом руководстве рассмотрим установку и базовую настройку Node.js на Alpine Linux 3.19 – легковесном дистрибутиве, популярном для контейнеризации приложений.

Требования

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

• У вас есть доступ к серверу с Alpine Linux 3.19
• Учетная запись с правами sudo или root
• Установлены базовые утилиты: curl, bash
• Обновлены системные пакеты

Установка

Подготовка

Обновите системные пакеты и установите зависимости:

sudo apk update
sudo apk upgrade
sudo apk add curl bash

Процесс установки

Способ 1: Установка из репозитория

1sudo apk add nodejs npm

Способ 2: Установка через 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 --lts

Проверка установки:

1node -v
2npm -v

Настройка

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. Для сборки нативных модулей установите зависимости:

1sudo apk add python3 make g++

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

Ошибка: node: not found после установки

• Решение: Создайте симлинк:

1sudo ln -s $(which node) /usr/bin/node

Ошибка: Нет доступа к директории npm

• Решение: Исправьте права:

1sudo chown -R $(whoami) ~/.npm

Ошибка: Пакет не найден в репозиториях

• Решение: Добавьте edge-репозиторий:

1echo 'http://dl-cdn.alpinelinux.org/alpine/edge/main' >> /etc/apk/repositories

Заключение

Вы успешно установили Node.js на Alpine Linux 3.19. Для дальнейшей оптимизации:

• Используйте менеджер процессов PM2
• Настройте firewall для защиты приложений
• Регулярно обновляйте версию Node.js через nvm или apk upgrade

Команды

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

sudo apk update && sudo apk upgrade

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

1sudo apk add nodejs npm

Установка NVM

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

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

1node -v && npm -v

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

Ошибка при установке через apk: package not found

Добавьте edge-репозиторий и повторите установку

1echo 'http://dl-cdn.alpinelinux.org/alpine/edge/main' >> /etc/apk/repositories

Команда node недоступна после установки

Создайте симлинк или перезагрузите терминал

1sudo ln -s $(which node) /usr/bin/node

Нет прав для установки глобальных пакетов

Настройте npm prefix или используйте sudo

1npm config set prefix ~/.npm-global

Ошибки при сборке нативных модулей

Установите компилятор и зависимости

1sudo apk add python3 make g++