Гайды по нодам
February 2

Установка ноды Pipe Network

1. Требования к ноде

Минимальная конфигурация сервера

- 2 CPU

- 4+ GB RAM. Чем больше, тем больше ревардов

- 100+ GB storage

- 8003 port

- 8386e658d61fc035 реф. код для регистрации ноды

Ссылки проекта

Сайт

Документация

Discord

Twitter

Дашборд

Подходящие сервера

Play2Go DE-2 (2 CPU / 4 RAM / 120 GB) 560р/мес Рекомендуем

Play2Go LC-5 (8 CPU / 24 RAM / 120 GB) 1040р/мес Альтернатива

U1 De-Promo (4 CPU / 8 RAM / 120 GB) 1069р/мес Новый

2. Установка ноды

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

. <(wget -qO- https://raw.githubusercontent.com/g7AzaZLO/server_primary_setting/refs/heads/main/server_primary_setting.sh)

2. Скачиваем файл, создаем нужные папки

2.1 Качаем файл установщик

wget https://dl.pipecdn.app/v0.2.5/pop

2.2 Выдаем все права на исполение

chmod +x pop

2.3 Создаем папку под кеш

mkdir download_cache

3.Запуск ноды

3.1 Запуск скрин сессии

screen -S pipe_node

3.2 Запуск ноды

./pop \
  --ram 4 \
  --max-disk 100 \
  --cache-dir /data \
  --pubKey <KEY>

В данном случае будет использоваться 4гб оперативной памяти, для изменения необходимо указать свое количество вместо --ram 4

Так же в этом случае максимальная загрузка диска будет достигать 100гб, изменить это можно указав свой максимум в строчке --max-disk 100

В строке --pubKey <KEY> вместо <KEY> нужно указать свой адрес кошелька соланы. Тот же, который вы заполняли в форме на участие

3.3 Регистрация ноды

Далее у вас попросит ввести рефферальный код для запуска ноды - вводим 8386e658d61fc035

3. Мониторинг

Просмотр метрик

./pop --status

Проверить поинты

./pop --points

4. Реферальная система

Узлы могут генерировать реферальные коды:

./pop --gen-referral-route

Новые узлы могут зарегистрироваться по реферальному коду:

./pop --signup-by-referral-route <CODE>

Реферер (приглашающий) получает 10 очков, когда приглашённый узел:

  • Остаётся активным более 7 дней
  • Поддерживает репутацию > 0,5

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

Эта программа будет со временем расширяться, включая систему распределения вознаграждений.

5. Система репутации

Репутация узла (в диапазоне 0–1) рассчитывается на основе следующих показателей:

  1. Uptime Score (40%)
    • Основан на времени непрерывной работы узла за последние 7 дней.
    • Идеальный показатель = 168 часов работы.
    • Оценка рассчитывается как: uptime_hours / 168.
  2. Egress Score (30%)
    • Основан на объёме данных, переданных за последние 24 часа.
    • Идеальный показатель = передано 1 ТБ+ данных.
    • Оценка рассчитывается как: min(bytes_served / 1TB, 1.0).
  3. Historical Score (30%)
    • Основан на количестве отчётов, регулярно отправляемых узлом.
    • Идеальный показатель = 168 отчётов за 7 дней.
    • Оценка рассчитывается как: num_reports / 168.

Преимущества высокой репутации

  • Приоритет в P2P-передачах (при репутации > 0,7).
  • Возможность получать реферальные вознаграждения (при репутации > 0,5).
  • В будущем: повышенный потенциал заработка.

6. Ошибки

1. No token found in node_info.json

В данном случае необходимо прописать команду

./pop --refresh

7. Обновление до тестнет сети

Вам обязательно нужно получить письмо на почту с инвайт кодом

1. Останавливаем девнет сеть в скрине

screen -r pipe_node

ctrl+c

2. Прописываем правила сети

sudo bash -c 'cat > /etc/sysctl.d/99-popcache.conf << EOL
net.ipv4.ip_local_port_range = 1024 65535
net.core.somaxconn = 65535
net.ipv4.tcp_low_latency = 1
net.ipv4.tcp_fastopen = 3
net.ipv4.tcp_slow_start_after_idle = 0
net.ipv4.tcp_window_scaling = 1
net.ipv4.tcp_wmem = 4096 65536 16777216
net.ipv4.tcp_rmem = 4096 87380 16777216
net.core.wmem_max = 16777216
net.core.rmem_max = 16777216
EOL'
sudo sysctl -p /etc/sysctl.d/99-popcache.conf

3. Увеличиваем лимиты для большей производительности

sudo bash -c 'cat > /etc/security/limits.d/popcache.conf << EOL
* hard nofile 65535
* soft nofile 65535
EOL'

4. Создаем папку под ноду и логи

sudo mkdir -p /opt/popcache
sudo mkdir -p /opt/popcache/logs
cd /opt/popcache

5. Скачиваем, распаковываем, выдаем права файлу ноды

Скачиваем

wget https://download.pipe.network/static/pop-v0.3.0-linux-x64.tar.gz

Распаковываем

sudo tar -xzf pop-v0.3.0-linux-*.tar.gz

Выдаем права

chmod 755 /opt/popcache/pop

6. Создаем конфиг файл и заполняем его

{
  "pop_name": "ВАШ_МОНИКЕР",
  "pop_location": "АДРЕС_СЕРВЕРА",
  "invite_code": "ВАШ_ИНВАЙТ_КОД",
  "server": {
    "host": "0.0.0.0",
    "port": 443, 
    "http_port": 80, 
    "workers": 40 
  },
  "cache_config": {
    "memory_cache_size_mb": 4096,
    "disk_cache_path": "./cache", 
    "disk_cache_size_gb": 100, 
    "default_ttl_seconds": 86400, 
    "respect_origin_headers": true, 
    "max_cacheable_size_mb": 1024 
  }, 
  "api_endpoints": {
    "base_url": "https://dataplane.pipenetwork.com" 
  },
  "identity_config": { 
    "node_name": "ВАШ_МОНИКЕР", 
    "name": "ВАШ_НИК_ЛЮБОЙ", 
    "email": "ВАША_ПОЧТА", 
    "website": "ВАШ_САЙТ", 
    "discord": "ВАШ_ДИСКОРД", 
    "telegram": "ВАШ_ТЕЛЕГРАМ", 
    "solana_pubkey": "ВАШ_СОЛАНА_КОШЕЛЕК_ДЛЯ_НАГРАД" 
  }
}

Сохраняем через ctrl+x, y, enter

7. Создаем сервис файл

sudo bash -c cat > /etc/systemd/system/popcache.service << EOL
[Unit]
Description=POP Cache Node
After=network.target 

[Service]
Type=simple
User=root
Group=root
WorkingDirectory=/opt/popcache
ExecStart=/opt/popcache/pop
Restart=always
RestartSec=5
LimitNOFILE=65535
StandardOutput=append:/opt/popcache/logs/stdout.log
StandardError=append:/opt/popcache/logs/stderr.log
Environment=POP_CONFIG_PATH=/opt/popcache/config.json 

[Install]
WantedBy=multi-user.target
EOL

8. Запускаем сервис

sudo systemctl enable popcache
sudo systemctl daemon-reload
sudo systemctl start popcache

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

sudo systemctl status popcache

Проверяем работоспособность эндпоинта

curl http://localhost/health

Проверяем доступность извне, переходя по ссылке в браузере

https://ВАШ_АЙПИ/state


Наш телеграмм канал по нодам — https://t.me/g7team_ru
Наш чат по нодам — https://t.me/g7team_chat