Гайд по установке публичной API-ноды для GOLOS

Публичные ноды важная составляющая для блокчейна, особенно когда мы заинтересованы в развитии приложений (клиентов, ботов, скриптов и пр.), которые порой повышают ценность для всего проекта.

На данный момент работают лишь две публичные API-ноды (кроме отдельной для клиента golos.id), что несомненно мало для развития. Было бы здорово если делегаты или энтузиасты исправят это, подняв дополнительные.

В зависимости от целей, публичную ноду можно поднять начиная с 2 ядер процессора, 8 Гб RAM и 60 Гб SSD памяти + стабильного интернета. Есть провайдеры, где подобная VPS-ка/сервер обойдётся вам всего в 5-7 евро/месяц.

Коротко опишу команды для установки с нуля рабочего варианта полной публичной API-ноды для блокчейна GOLOS (с хранением истории на неделю). Для такой, оптимальный вариант - VPS-ка/сервер с 16 Гб RAM памяти.

Устанавливаем Docker

sudo apt-get update

sudo apt-get install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    software-properties-common

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"

sudo apt-get update

sudo apt-get install docker-ce -y

Устанавливаем ноду

Скачиваем большую часть блоков напрямую с сервера (чтобы не тратить сутки-двое на их получение и лишнюю нагрузку делегатских seed-нод).

sudo wget -P ~/home/blockchain https://files.rudex.org/golos-classic/blockchain/block_log

Создаем папку и добавляем файл c актуальными seed-нодами.

mkdir ~/config && echo 'seed1.golos.blckchnd.com:30218
seed.golos.lexa.host:42434
seed1.vvk.pp.ru:2001
seed.aleksw.space:4243
seed.expertgroup.org:9243' | sudo tee -a ~/config/seednodes

Добавляем конфиг ноды (указанные в нём 202800 блоков = неделя).
Какие плагины нужны для ваших целей, можно посмотреть тут https://ropox.app/steemjs/api/

echo 'webserver-thread-pool-size = 2
webserver-http-endpoint = 0.0.0.0:8090
webserver-ws-endpoint = 0.0.0.0:8091
read-wait-micro = 500000
max-read-wait-retries = 2
write-wait-micro = 500000
max-write-wait-retries = 3
single-write-thread = true
enable-plugins-on-push-transaction = false
shared-file-size = 2G
min-free-shared-file-size = 500M
inc-shared-file-size = 2G
block-num-check-free-size = 1000
plugin = chain p2p json_rpc webserver network_broadcast_api witness database_api witness_api follow social_network tags operation_history account_history market_history account_by_key worker_api
clear-votes-before-block = 4294967295
history-start-block = 32000000
comment-title-depth = 202800
comment-body-depth = 202800
comment-json-metadata-depth = 202800
history-blocks = 202800
replay-if-corrupted = true
skip-virtual-ops = false
enable-stale-production = false
mining-threads = 0
[log.console_appender.stderr]
stream=std_error
[log.file_appender.p2p]
filename=logs/p2p/p2p.log
[logger.default]
level=debug
appenders=stderr
[logger.p2p]
level=none
appenders=stderr' | sudo tee -a ~/config/config.ini

Запускаем ноду в докер-контейнере.

sudo docker run -it -p 127.0.0.1:8090:8090 -p 127.0.0.1:8091:8091 -v ~/config:/etc/golosd -v ~/home/blockchain:/var/lib/golosd/blockchain --name golosd vizlex/golos-classic

После загрузки докер-образа и реплея (который занимает несколько часов), с получением логов вида handle_block "Got 0 transactions on block 3071930 by ..." нода готова к работе.

Устанавливаем Nginx

sudo apt-add-repository ppa:nginx/stable -y

sudo apt-get update

sudo apt-get install nginx -y

Добавляем файл для своих настроек Nginx.

sudo nano /etc/nginx/sites-enabled/node.conf

Копируем в него правила, предварительно заменив адрес server_name на свой субдомен/домен (не забыв привязать его в настройках DNS к нашему IP сервера). Бесплатные домены можно зарегистрировать напр. здесь.

server {
listen 80;
server_name test.lexa.host;
location / {
if ($request_method = 'OPTIONS') {
add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
add_header 'Access-Control-Max-Age' 1728000;
add_header 'Content-Type' 'text/plain; charset=utf-8';
add_header 'Content-Length' 0;
return 204;
}
if ($request_method = 'POST') {
add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
}
if ($request_method = 'GET') {
add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
}
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass http://127.0.0.1:8090;
}
location /ws {
if ($request_method = 'OPTIONS') {
add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
add_header 'Access-Control-Max-Age' 1728000;
add_header 'Content-Type' 'text/plain; charset=utf-8';
add_header 'Content-Length' 0;
return 204;
}
if ($request_method = 'POST') {
add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
}
if ($request_method = 'GET') {
add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
}
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass $http_upgrade;
proxy_pass http://127.0.0.1:8091;
proxy_read_timeout 3600;
}
}

Сохраняем изменения Ctrl+O, подтверждаем Enter, выходим Ctrl+X.

Возможно потребуется обновить также и пакеты, как описано в комменте. На VPS-ках c Ubuntu 16.04 и 18.04 я с этим не сталкивался, на других, может пригодится.

Устанавливаем сертификаты

sudo apt-get install software-properties-common

sudo add-apt-repository ppa:certbot/certbot -y

sudo apt-get update

sudo apt-get install python-certbot-nginx -y

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

1. Email, на который будут отправляться уведомления о необходимости продления сертификата;
2. Согласиться с правилами сервиса введя A и Enter;
3. Отказаться от рассылки N и Enter;
4. Подтвердить добавление сертификатов к указанным доменам вводом Enter;
5. Отказаться от редиректа, введя 1 и Enter.

sudo certbot --nginx

Будут добавлены настройки в файл node.conf, которые можно перепроверить. Зайти командой ниже и найти строки с пометкой "# managed by Certbot" в конце файла.

sudo nano /etc/nginx/sites-enabled/node.conf

Выходим из файла Ctrl+X.

Перезапускаем Nginx.

sudo systemctl restart nginx

Проверяем статус Nginx.

sudo systemctl status nginx.service

Мы запустили публичную API-ноду, к которой можно подключаться как по адресу https://test.lexa.host (RPC) так и wss://test.lexa.host/ws (WebSockets).

При получении письма на email о необходимости обновить сертификат (раз в 90 дней), это можно сделать командой (или добавить задачу в cron):

sudo certbot renew