Установить ноду на Ubuntu

В этой статье описана установка ноды Waves на компьютер под управлением Linux. Сначала установите OpenJDK (Java), а затем саму ноду, используя один из представленных методов.

Наиболее распространенный и удобный способ установки/обновления ноды Waves на компьютерах под управлением Linux описан в разделе Установка из APT-репозитория.

Альтернативные методы описаны в секции Установка из DEB-пакета на Linux (Ubuntu, Debian) и Установка для продвинутых пользователей.

Установка OpenJDK

Установка ноды поддерживается в версиях OpenJDK 11 и 17.

Если OpenJDK не установлен, установите OpenJDK 11 с помощью команд:

sudo apt-get update
sudo apt-get install openjdk-11-jre-headless

Проверьте версию JDK с помощью следующей команды:

java -version

Установка из APT-репозитория

Примечание: Пакетная установка Waves поддерживается в Debian 8.0+, Ubuntu 16.04+ и их форках.

Наиболее удобный способ установить/обновить ноду Waves на Linux — с помощью APT-репозитория. Репозиторий предоставляет пакеты для Mainnet, Testnet и Stagenet. При использовании этого метода установки соответствующие дополнительные файлы (а именно OpenJDK 11) также будут загружены и автоматически установлены.

Чтобы установить последнюю версию пакета для Mainnet из репозитория APT, выполните следующие команды:

curl -sL http://apt.wavesplatform.com/apt-key.gpg | sudo gpg --dearmour -o /etc/apt/trusted.gpg.d/apt-wavesplatform-com.gpg
sudo add-apt-repository "deb https://apt.wavesplatform.com/ xenial mainnet"
sudo apt update
sudo apt install waves

Файл конфигурации ноды вложен в пакет и распаковывается в папку:

• для Mainnet: /usr/share/waves/conf/waves.conf с символической ссылкой на /etc/waves/waves.conf;
• для Testnet: /usr/share/waves-testnet/conf/waves.conf с символической ссылкой на /etc/waves-testnet/waves.conf;
• для Stagenet: /usr/share/waves-stagenet/conf/waves.conf с символической ссылкой на /etc/waves-stagenet/waves.conf.

Укажите в файле обязательные параметры ноды. Будьте внимательны: от конфигурации ноды зависит безопасность вашего кошелька и средств. Подробная информация приведена в статье Конфигурация ноды.

Запустите ноду с помощью следующей команды (waves-testnet для Testnet):

sudo systemctl start waves.service

Включите автозагрузку при запуске с помощью следующей команды:

sudo systemctl enable waves.service

💡 Проверить статус ноды можно с помощью следующей команды:

sudo systemctl status waves.service

Логи можно найти в хранилище journald с помощью следующей команды:

journalctl -u waves.service -f

После выпуска новой версии ноды Waves вы можете обновить пакет, выполнив следующие команды:

sudo apt update
sudo apt upgrade

Установка из DEB-пакета на Linux (Ubuntu, Debian)

Загрузите последнюю версию DEB-пакета и установите ноду с помощью следующей команды:

sudo dpkg -i waves*.deb

Файл конфигурации ноды вложен в пакет и распаковывается в папку:

• для Mainnet: /usr/share/waves/conf/waves.conf с символической ссылкой на /etc/waves/waves.conf;
• для Testnet: /usr/share/waves-testnet/conf/waves.conf с символической ссылкой на /etc/waves-testnet/waves.conf;
• для Stagenet: /usr/share/waves-stagenet/conf/waves.conf с символической ссылкой на /etc/waves-stagenet/waves.conf.

Укажите в файле обязательные параметры ноды. Будьте внимательны: от конфигурации зависит безопасность вашего кошелька и средств. Подробная информация приведена в статье Конфигурация ноды.

Запустите ноду с помощью следующей команды (waves-testnet для Testnet):

sudo systemctl start waves.service

Включите автозагрузку при запуске с помощью следующей команды:

sudo systemctl enable waves.service

💡 Проверить статус ноды можно с помощью следующей команды:

sudo systemctl status waves.service

Логи можно найти в хранилище journald с помощью следующей команды:

journalctl -u waves.service -f

Подробнее про journald

Установка для продвинутых пользователей

Загрузите последнюю версию waves-all-<номер версии>.jar в любой каталог, например /opt/waves.

Скачайте образец файла конфигурации и разместите в том же каталоге. Укажите в файле обязательные параметры ноды. Будьте внимательны: от конфигурации зависит безопасность вашего кошелька и средств. Подробная информация приведена в статье Конфигурация ноды.

Запустите консоль, перейдите в папку с файлом jar с помощью команды cd /opt/waves и запустите ноду с помощью следующей команды (замените {*} именем файла):

java -jar {*}.jar {*}.conf

Дополнительная безопасность

Для дополнительной безопасности рекомендуется хранить кошелек и файл конфигурации в зашифрованном разделе диска. Подробнее об этом тут.

Кроме того, вы можете ограничить использование каталогов ноды только заданными пользователями. Подробно об этом тут. Скрипты DEB-пакета Waves создают пользователя waves. Приложение Waves, кошелек и каталоги с данными по умолчанию принадлежат этому пользователю.

Если вы хотите использовать RPC, необходимо защитить Ubuntu с помощью встроенного ufw или любого другого файрвола. Подробно об этом тут. Если ваш сервер находится в публичном доступе и вы хотите использовать RPC, задействуйте только определенные методы, используя Nginx's proxy_pass module, и не забудьте указать хеш API-ключа apiKeyHash в файле конфигурации.

Не забывайте своевременно обновлять операционную систему и антивирусное программное обеспечение.