Установка Ionic на Debian 10

Иллюстрация фреймворка Ionic и мобильных приложений

Кратко: на Debian 10 установите Node.js (рекомендована версия 14), затем глобально установите Cordova и Ionic CLI через npm. После создания проекта запустите ionic serve и откройте приложение по адресу http://ваш-IP:8100. В статье — пошаговые команды, советы по альтернативам и список проверок.

Важно: инструкции предполагают доступ root или sudo. Если вы предпочитаете изолировать окружение Node.js, используйте nvm.

Что такое Ionic

Ionic — бесплатный фреймворк с открытым исходным кодом для создания кросс-платформенных веб и нативных приложений высокого качества. Пояснение: Ionic использует веб-технологии (HTML/CSS/JS) и предоставляет CLI для создания проектов; для доступа к аппаратным возможностям (камера, GPS) применяют плагины Cordova или интеграцию с Capacitor.

Требования

Сервер с Debian 10.
Конфигурация пароля root или учетная запись с sudo.
Доступ в интернет для загрузки репозиториев и npm-пакетов.

Быстрый план действий

Обновить пакеты apt.
Установить curl, wget и gnupg2.
Добавить репозиторий NodeSource и установить Node.js 14.
Установить Cordova и Ionic CLI глобально через npm.
Создать и запустить проект.

Обновите систему

Обновите индекс пакетов и установите нужные утилиты:

apt-get update -y
apt-get install curl gnupg2 wget -y

Примечание: если вы работаете не от root, добавьте sudo перед командами.

Установка Node.js (рекомендуется версия 14)

По умолчанию в репозитории Debian может быть устаревшая версия Node.js. Добавьте официальный репозиторий NodeSource для версии 14:

curl -sL https://deb.nodesource.com/setup_14.x | bash -
apt-get install nodejs -y

Проверьте версию Node.js:

node --version

Ожидаемый вывод (пример):

v14.17.1

Альтернатива: можно установить Node.js через nvm (Node Version Manager), если хотите управлять несколькими версиями без прав root:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc
nvm install 14

Установка Cordova и Ionic CLI

Установите Cordova (для плагинов и старых проектов) и Ionic CLI глобально:

npm install -g cordova
npm i -g @ionic/cli

Если npm выдаёт ошибки прав доступа, избегайте глобального sudo и используйте nvm или настройку npm-папки пользователя. Для некоторых систем помогает:

npm install -g @ionic/cli --unsafe-perm=true

Проверьте версию Ionic CLI:

ionic -v

Пример вывода:

6.16.3

Создание первого проекта Ionic

Запустите создании шаблона проекта:

ionic start

В интерактивном режиме потребуется выбрать фреймворк (Angular или React), имя проекта и шаблон (например, tabs). Пример последовательности:

? Framework: Angular
? Project name: myapp
? Starter template: tabs

В процессе CLI предложит интегрировать Capacitor для сборки нативных iOS/Android — можно пропустить и добавить позже.

После завершения вы увидите рекомендации:

cd ./myapp
ionic serve для запуска в браузере
ionic capacitor add для добавления нативных проектов

Запуск приложения в браузере

Перейдите в каталог проекта и запустите dev-сервер:

cd myapp
ionic serve --host 0.0.0.0 --port 8100

Ожидаемый вывод (пример):

> ng run app:serve --host=0.0.0.0 --port=8100
[INFO] Development server running!

       Local: http://localhost:8100
       External: http://216.98.11.73:8100

       Use Ctrl+C to quit this process

[INFO] Browser window opened to http://localhost:8100!

Откройте в браузере http://ваш-server-ip:8100, чтобы увидеть приложение.

Тестовая страница Ionic: приложение в браузере

Критерии приёмки

dev-сервер запускается без ошибок.
Приложение доступно по адресу http://:8100.
ionic -v и node –version возвращают корректные версии.
При добавлении платформ Capacitor/ Cordova проекты создаются без ошибок.

Частые проблемы и способы устранения

Проблемы с правами при npm install -g
- Решение: используйте nvm или установите флаги –unsafe-perm, либо настройте npm директорию для пользователя.
Порт 8100 недоступен извне
- Решение: откройте порт в брандмауэре (ufw allow 8100) или настройте сетевые правила облачного провайдера.
Ошибки при установке nodejs из NodeSource
- Решение: проверьте вывод скрипта setup_14.x, обновите ключи apt через apt-key или gnupg2.
Плагины Cordova не работают на платформе
- Решение: проверяйте совместимость плагина с версией Cordova/Capacitor и платформой Android/iOS.

Альтернативные подходы

Использовать Yarn вместо npm: yarn global add @ionic/cli.
Применить Capacitor как предпочтительную обёртку для доступа к нативным API (современная альтернатива Cordova).
Управлять версиями Node через nvm для изоляции окружений и простоты переключения.

Роли и чек-листы

Sysadmin

Убедиться в доступности порта 8100 и наличии необходимых пакетов (curl, gnupg2).
Настроить безопасный доступ (firewall, SSH).

Frontend-разработчик

Проверить локальную установку Node.js и Ionic CLI.
Создать проект, запустить ionic serve и отладить UI в браузере.

Mobile-разработчик

Интегрировать Capacitor или Cordova, добавить платформы (android/ios) и собрать нативные приложения.

Короткий словарь

CLI — интерфейс командной строки.
Capacitor — современная платформа для нативной интеграции от Ionic.
Cordova — система плагинов для доступа к аппаратным возможностям через веб-код.

Резюме

Вы установили Node.js, Cordova и Ionic CLI на Debian 10, создали и запустили базовый проект. Для стабильной работы на сервере используйте nvm для управления версиями Node, следите за правами npm и открывайте нужные порты в брандмауэре.

Важно: если вы планируете собирать нативные приложения, добавьте Capacitor/ Cordova и подготовьте окружение Android SDK / Xcode на соответствующих машинах.