Parse Server — это приложение с открытым исходным кодом, написанное на Node.js. Оно используется как платформа Backend As A Service (BAAS) и представляет собой удобный, гибкий и масштабируемый бэкенд для мобильных приложений.
Панель управления Parse была разработана командой Parse. Это веб-интерфейс для администрирования сервера Parse на стороне сервера. Вы можете добавлять и управлять несколькими серверами Parse из одной панели управления.
Данный учебник поможет вам установить и настроить приложения Parse Server и Parse Dashboard на Debian.
Перед началом установки убедитесь, что у вас установлены необходимые зависимости, такие как Node.js и npm. Вы можете установить их с помощью следующих команд:
sudo apt update
sudo apt install nodejs npm
После установки Node.js проверьте его версию, чтобы убедиться, что всё прошло успешно:
node -v
Следующим шагом будет установка MongoDB, так как Parse Server требует базу данных для хранения данных. Вы можете установить MongoDB с помощью команды:
sudo apt install mongodb
После установки запустите MongoDB и настройте его на автоматический запуск:
sudo systemctl start mongodb
sudo systemctl enable mongodb
Теперь можно перейти к установке Parse Server. Создайте новую директорию для вашего приложения и перейдите в неё:
mkdir parse-server && cd parse-server
Установите Parse Server с помощью npm:
npm install parse-server
Не забудьте настроить конфигурацию Parse Server, указав параметры подключения к вашей базе данных MongoDB в файле конфигурации. Для этого создайте файл index.js и добавьте в него следующее:
const express = require('express');
const ParseServer = require('parse-server').ParseServer;
const app = express();
const api = new ParseServer({
databaseURI: 'mongodb://localhost:27017/dev',
serverURL: 'http://localhost:1337/parse',
appId: 'YOUR_APP_ID',
masterKey: 'YOUR_MASTER_KEY',
});
app.use('/parse', api);
app.listen(1337, () => {
console.log('Parse Server is running on http://localhost:1337/parse');
});
Замените YOUR_APP_ID и YOUR_MASTER_KEY на ваши собственные значения. После этого запустите сервер с помощью команды:
node index.js
Теперь вы можете установить Parse Dashboard для удобного управления вашим сервером. Установите его с помощью команды:
npm install -g parse-dashboard
Создайте файл конфигурации для панели управления и добавьте параметры подключения к вашему Parse Server:
parse-dashboard --config dashboard-config.json
Запустите Parse Dashboard, и вы сможете получить доступ к нему через браузер по адресу http://localhost:4040.
Следуя этим шагам, вы сможете успешно установить и настроить Parse Server и Parse Dashboard на Debian 10/9.
Содержание статьи
Предварительные требования
- Экземпляр Debian 10 с доступом к терминалу
- Доступ под учетной записью с правами sudo
- Обновленная система: перед началом рекомендуется выполнить команду
sudo apt update && sudo apt upgradeдля установки последних обновлений. - Установленные утилиты для работы с пакетами: убедитесь, что у вас есть доступ к
aptдля установки необходимых программ. - Системные требования: проверьте, чтобы у вас было достаточно оперативной памяти и дискового пространства для выполнения задач, которые планируете.
- Базовые знания командной строки: желательно иметь опыт работы с терминалом для выполнения команд и настройки системы.
- Резервное копирование данных: рекомендуется создать резервные копии важных данных перед выполнением любых операций, чтобы избежать их потери.
- Сетевое подключение: убедитесь, что ваш сервер имеет доступ к Интернету, если планируете загружать дополнительные пакеты или обновления.
- Установленные зависимости: проверьте, что у вас установлены необходимые зависимости для программ, которые собираетесь устанавливать. Это можно сделать с помощью команд
apt-cache showилиapt depends. - Документация: ознакомьтесь с официальной документацией Debian и другими ресурсами, чтобы лучше понять процесс установки и настройки.
Установите Node.js
Parse Server и Parse Dashboard могут работать на любом сервере с установленным Node.js. В первую очередь необходимо установить Node.js на систему Debian. Для настройки репозитория пакетов выполните:
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
После этого выполните команды для установки Node.js на вашу систему.
sudo apt install -y nodejs
Также вам нужно установить менеджер пакетов Yarn для управления модулями Node. Для этого введите:
npm install -g yarn
После установки Node.js и Yarn рекомендуется проверить их версии, чтобы убедиться, что установка прошла успешно. Для этого выполните команды:
node -v
yarn -v
Если вы планируете использовать дополнительные библиотеки или инструменты, возможно, вам также потребуется установить build-essential, чтобы упростить установку некоторых модулей. Это можно сделать с помощью:
sudo apt install -y build-essential
Кроме того, рекомендуется установить npm (менеджер пакетов Node.js), который уже должен быть установлен вместе с Node.js. Если это не так, вы можете установить его отдельно:
sudo apt install -y npm
Теперь ваша система готова к использованию Parse Server и Parse Dashboard. Убедитесь, что все зависимости установлены, и вы можете приступить к развертыванию вашего приложения.
Установите MongoDB
В стандартных репозиториях Debian 10 доступны пакеты MongoDB. Вы можете обновить кэш apt и установить сервер баз данных MongoDB, выполнив следующие команды:
sudo apt update sudo apt install mongodb-server
После установки рекомендуется проверить статус службы MongoDB, чтобы убедиться, что она работает корректно. Для этого выполните команду:
sudo systemctl status mongodb
Если служба не запущена, вы можете ее активировать с помощью:
sudo systemctl start mongodb
Также стоит добавить MongoDB в автозагрузку, чтобы она автоматически запускалась при загрузке системы:
sudo systemctl enable mongodb
После этого вы можете подключиться к MongoDB, используя клиент mongo:
mongo
Это откроет командную оболочку MongoDB, где вы сможете выполнять команды для работы с базами данных. Не забудьте проверить документацию MongoDB для получения дополнительной информации о конфигурации и настройке безопасности.
Настройка Parse Server
Теперь вы готовы установить Parse Server на вашу систему Debian. Parse Server доступен как модуль Node.js. Установите его с помощью менеджера пакетов yarn:
yarn global add parse-server
Модуль Parse Server будет установлен глобально.
После этого создайте файл конфигурации для вашего сервера Parse, где вы определите его атрибуты. Создайте файл конфигурации и отредактируйте его в удобном текстовом редакторе:
nano config.json
Добавьте следующее содержимое в файл:
Детали конфигурации:
{
"appId": "ВАШ_APP_ID",
"masterKey": "ВАШ_MASTER_KEY",
"databaseURI": "mongodb://localhost:27017/ВАШ_ДАТАБАЗА",
"serverURL": "http://localhost:1337/parse"
}
Сохраните и закройте файл. Затем запустите сервер Parse в фоновом режиме с помощью команды nohup.
nohup parse-server config.json &
Ваш сервер Parse теперь работает на порту 1337.
Для доступа к серверу вы можете использовать любой клиент, поддерживающий REST API. Убедитесь, что ваш сервер MongoDB запущен и доступен. Если вы планируете использовать Parse Dashboard для управления вашим приложением, не забудьте установить его с помощью команды:
yarn global add parse-dashboard
После установки создайте файл конфигурации для Parse Dashboard, используя аналогичный подход. Это позволит вам легко управлять данными вашего приложения через веб-интерфейс.
Настройка Parse Dashboard
Parse Dashboard — это веб-интерфейс для доступа к серверу Parse. Он также доступен как модуль для Node и может быть установлен с помощью yarn. Для установки parse-dashboard выполните:
yarn global add parse-dashboard
Далее создайте файл конфигурации для панели управления Parse. Создайте новый файл и отредактируйте его:
nano parse-dashboard-config.json
Добавьте следующий контент:
{
"apps": [
{
"serverURL": "http://67.205.146.114:1337/parse",
"appId": "FSD9FK3329SKJFD99SKDJ",
"masterKey": "KJK9AksiHU7lsujKSDJF49jGnTYKD",
"allowInsecureHTTP": "true",
"appName": "MyApp1"
}
],
"users": [
{
"user":"admin",
"pass":"password"
}
],
"iconsFolder": "icons"
}
Вы можете добавить несколько приложений Parse Server в один конфигурационный файл, убедившись, что используете тот же appID и masterKey, которые были заданы в вашем Parse Server.
Также добавьте пользователя и пароль для аутентификации при входе в панель управления Parse.
После редактирования файла сохраните и закройте его. Затем выполните следующую команду для запуска панели управления.
nohup parse-dashboard --dev --config parse-dashboard-config.json &
Эта команда инициирует запуск вашего сервера Parse на порту 4040.
Важно отметить, что при использовании allowInsecureHTTP: «true» ваше соединение не будет защищено, поэтому рекомендуется использовать этот параметр только в среде разработки. Для продакшн-окружения следует настроить HTTPS.
Если у вас возникли проблемы с доступом к панели управления, убедитесь, что порты не заблокированы вашим фаерволом, и проверьте настройки сети.
Кроме того, вы можете использовать другие параметры конфигурации для настройки внешнего вида панели управления, такие как темы и иконки, чтобы адаптировать интерфейс под ваши нужды.
Дополнительно, рекомендуется использовать переменные окружения для хранения конфиденциальной информации, такой как masterKey и пароль. Это увеличит безопасность вашей конфигурации. Пример использования переменных окружения:
{
"apps": [
{
"serverURL": "http://67.205.146.114:1337/parse",
"appId": process.env.APP_ID,
"masterKey": process.env.MASTER_KEY,
"allowInsecureHTTP": "true",
"appName": "MyApp1"
}
],
"users": [
{
"user": process.env.ADMIN_USER,
"pass": process.env.ADMIN_PASS
}
],
"iconsFolder": "icons"
}
Также стоит обратить внимание на возможность настройки различных уровней доступа для пользователей, чтобы обеспечить безопасность и контроль за действиями в панели управления.
Если вы планируете масштабировать приложение, подумайте о настройке мониторинга и логирования для отслеживания активности и быстрого реагирования на проблемы.
Конфигурация портов брандмауэра
Если на системе активирован firewalld, необходимо предоставить доступ к портам, используемым сервером Parse. Для сервера Parse мы задействуем порт 1337, а для панели управления — 4040. Выполните указанные ниже команды для разрешения доступа к серверу Parse для внешних пользователей. Чтобы открыть порты, введите:
sudo firewall-cmd --permanent --zone=public --add-port=1337/tcpsudo firewall-cmd --permanent --zone=public --add-port=4040/tcp
После этого примените изменения, выполнив команду:
firewall-cmd --reload
Также убедитесь, что у вас есть необходимые права для выполнения команд с префиксом sudo. Если вы планируете использовать эти порты на постоянной основе, можно добавить соответствующие правила в конфигурацию firewalld. Для проверки открытых портов используйте команду:
sudo firewall-cmd --list-ports
Это поможет вам убедиться, что порты 1337 и 4040 действительно открыты. Не забывайте о безопасности: если ваш сервер доступен из интернета, рекомендуется ограничить доступ к этим портам только с определенных IP-адресов или использовать VPN для безопасного подключения.
Какую именно дополнительную информацию вы хотите увидеть в этом разделе?

