Запуск узла

Это руководство охватывает настройку и запуск полного узла блокчейна TALER.

Что такое узел TALER?

Узел TALER - это полноценный участник сети блокчейна, который:

• Проверяет транзакции: Проверяет все транзакции согласно правилам консенсуса
• Поддерживает блокчейн: Хранит полную историю транзакций
• Передает данные: Пересылает действительные транзакции и блоки другим узлам
• Поддерживает сеть: Способствует децентрализации и безопасности сети
• Включает майнинг/стейкинг: Позволяет участвовать в генерации блоков

Запуск узла помогает обеспечить безопасность сети TALER и дает вам полный контроль над взаимодействием с блокчейном.

Способы запуска узла TALER

Вы можете запустить узел TALER несколькими способами в зависимости от ваших потребностей:

1. GUI кошелек (taler-qt) - Для пользователей рабочего стола

Лучше всего для: Личного использования, управления кошельком и обычного стейкинга

Запустите графическое приложение кошелька taler-qt на вашем настольном компьютере:

• Полный GUI интерфейс для управления кошельком
• Встроенный узел, который синхронизируется с блокчейном
• Простая настройка для начинающих
• Подходит для персональных компьютеров

Держите кошелек работающим 24/7 для непрерывной работы узла и стейкинга.

Узнать больше: Руководство по настройке кошелька

2. Командная строка (talerd) - Для развертывания на сервере

Лучше всего для: Выделенных серверов, VPS, безголовых систем

Запустите демон talerd на сервере без GUI:

• Настройка через конфигурационный файл taler.conf
• Запуск на локальном компьютере или VPS
• Меньшее использование ресурсов (без GUI)
• Удаленное управление через RPC

Узнать больше: Документация по командной строке (talerd)

3. Сервис Systemd - Для Linux серверов (Рекомендуется для VPS)

Лучше всего для: Производственного развертывания VPS, автоматического запуска

Запустите talerd как системный сервис:

• Автоматический запуск при загрузке
• Управление процессом systemd
• Надзор за сервисом и перезапуск при сбое
• Управление журналами
• Профессиональная настройка сервера

Узнать больше: Конфигурация Systemd в руководстве Node CLI

4. Docker Compose - Для контейнеризированного развертывания (Рекомендуется для VPS)

Лучше всего для: Простых обновлений, воспроизводимых развертываний, хостинга VPS

Запустите узел TALER в Docker контейнере:

• Простые обновления: docker compose pull && docker compose up -d
• Изолированная среда
• Воспроизводимая конфигурация
• Упрощенное резервное копирование и миграция
• Нет конфликтов зависимостей

Узнать больше: Руководство по развертыванию Docker

Выбор правильного метода

Рекомендация:

• Пользователи рабочего стола: Используйте GUI кошелек taler-qt
• Пользователи VPS/Сервера: Используйте Docker Compose для самого простого управления
• Продвинутые пользователи: Используйте сервис systemd для полного контроля

Предварительные требования

Перед запуском узла TALER убедитесь, что ваша система соответствует этим требованиям:

Требования к оборудованию

• CPU: Рекомендуется 2+ ядра (4+ ядра для майнинга)
• RAM: Минимум 4GB (рекомендуется 8GB+)
• Дисковое пространство:
  • Полный узел: 20GB+ (блокчейн растет со временем)
  • Обрезанный узел: 2GB+ (с опцией -prune)
• Сеть: Стабильное интернет-соединение с минимум 1 Мбит/с загрузка/скачивание

Требования к программному обеспечению

• Операционная система: Windows 10/11, macOS (Apple Silicon) или Linux (x64/ARM64)
• Доступ к порту: Порт 23153 (mainnet) должен быть доступен для входящих соединений

Загрузка программного обеспечения узла TALER

Шаг 1: Посетите страницу релизов

Загрузите последнее программное обеспечение узла TALER из репозитория, поддерживаемого сообществом, на GitHub:

Последний релиз: GitHub Releases

Шаг 2: Выберите вашу платформу

Выберите подходящий пакет для вашей операционной системы:

Установка

Установка Windows

1. Извлеките архив:

   • Щелкните правой кнопкой мыши на загруженный файл taler-*-win64.zip
   • Выберите “Извлечь все…”
   • Выберите папку назначения (например, C:\TALER)

2. Найдите демон:

   • Перейдите в извлеченную папку
   • Найдите talerd.exe (демон узла)

Установка macOS

1. Извлеките архив:

   tar -xzvf taler-*-macos-arm64.tar.gz
   cd taler-*
   

2. Установите в систему (опционально):

   sudo mv bin/* /usr/local/bin/
   sudo chmod +x /usr/local/bin/talerd
   

3. Или запустите из извлеченной директории:

   chmod +x bin/talerd
   ./bin/talerd
   

Установка Linux

1. Извлеките архив:

   tar -xzvf taler-*-linux-x64.tar.gz
   cd taler-*
   

2. Установите в систему (опционально):

   sudo install -m 0755 -o root -g root -t /usr/local/bin bin/*
   

3. Или запустите из извлеченной директории:

   chmod +x bin/talerd
   ./bin/talerd
   

Запуск вашего узла

Базовый запуск узла

Windows:

talerd.exe

macOS / Linux:

talerd

При первом запуске talerd:

1. Создаст директорию данных (если она не существует)
2. Подключится к сети TALER
3. Начнет загрузку блокчейна
4. Начнет проверку и передачу транзакций

Расположение директории данных

По умолчанию TALER хранит данные блокчейна в:

• Windows: %APPDATA%\TALER\
• macOS: ~/Taler/
• Linux: ~/.taler/

Общие конфигурации узла

Пользовательская директория данных

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

talerd -datadir=/путь/к/пользовательской/директории

Обрезанный узел (Уменьшенное использование диска)

Запустите обрезанный узел для экономии дискового пространства (хранит только последние блоки):

talerd -prune=2000

Это сохраняет приблизительно 2GB данных блокчейна вместо полной цепи.

Узел тестовой сети

Запустите узел в тестовой сети для разработки:

talerd -testnet

Разрешить входящие соединения

Чтобы максимизировать поддержку сети, разрешите входящие соединения:

talerd -listen=1 -maxconnections=128

Убедитесь, что порт 23153 открыт в вашем брандмауэре.

Мониторинг вашего узла

Проверка статуса узла

Используйте taler-cli для проверки статуса вашего узла:

taler-cli getinfo

Это отображает:

• Текущую высоту блока
• Количество соединений
• Хешрейт сети
• Баланс кошелька (если кошелек загружен)

Просмотр количества соединений

taler-cli getconnectioncount

Проверка прогресса синхронизации блокчейна

taler-cli getblockchaininfo

Показывает:

• Текущий блок против высоты сети
• Процент прогресса проверки
• Размер цепи на диске

Мониторинг журналов

Linux/macOS:

tail -f ~/.taler/debug.log

Windows:

type %APPDATA%\TALER\debug.log

Сетевые порты

Mainnet

• P2P сеть: 23153 (TCP)
• RPC порт: 23152 (только localhost по умолчанию)

Testnet

• P2P сеть: 33153 (TCP)
• RPC порт: 33152 (только localhost по умолчанию)

Чтобы принимать входящие соединения, убедитесь, что порт 23153 (mainnet) или 33153 (testnet) доступен через ваш брандмауэр.

Остановка вашего узла

Корректное завершение работы

Используйте taler-cli для чистого завершения:

taler-cli stop

Это обеспечивает:

• Правильное закрытие базы данных
• Чистое завершение соединений
• Отсутствие повреждения блокчейна

Принудительная остановка (Не рекомендуется)

Если taler-cli stop не работает:

Linux/macOS:

killall talerd

Windows:

taskkill /IM talerd.exe

Примечание: Принудительная остановка может потребовать переиндексации при следующем запуске.

Конфигурационный файл

Создайте taler.conf в вашей директории данных для постоянных настроек:

Пример taler.conf:

# Сетевые настройки
listen=1
maxconnections=128
port=23153

# RPC настройки
server=1
rpcuser=ваше_имя_пользователя
rpcpassword=ваш_пароль
rpcport=23152
rpcallowip=127.0.0.1

# Производительность
dbcache=1024
maxmempool=300

# Обрезка (опционально)
prune=2000

Расположение:

• Windows: %APPDATA%\TALER\taler.conf
• macOS: ~/Taler/taler.conf
• Linux: ~/.taler/taler.conf

Следующие шаги

• Командная строка: Узнайте о расширенных опциях talerd в руководстве Node CLI
• Развертывание Docker: Запустите узел TALER в контейнерах с Docker
• Майнинг и стейкинг: Участвуйте в генерации блоков в Mining & Staking