Executando um Nó

Executar um nó da Cloud Service é essencial para apoiar a rede e permitir participação plena no ecossistema da Cloud Service. Este guia irá orientá-lo na configuração e manutenção do seu próprio nó.

Por que Executar um Nó?

• Apoiar a Rede — Ajude a validar transações e manter a descentralização
• Controle Total — Verifique suas próprias transações sem confiar em terceiros
• Privacidade — Transmita suas próprias transações diretamente para a rede

Configuração do Nó

Passo 1: Instalar a Cloud Service

Siga o Guia de Instalação para instalar a Cloud Service em seu sistema.

Passo 2: Configurar seu Nó

Crie ou edite seu arquivo cs.conf:

# ~/.cs/cs.conf

# Configurações de Rede
server=1
listen=1
port=16178
maxconnections=128

# Configurações RPC
rpcuser=seu_usuario_rpc
rpcpassword=sua_senha_segura
rpcport=16180
rpcallowip=127.0.0.1

# Configurações do Nó
txindex=1
addressindex=1
timestampindex=1
spentindex=1

# Performance
dbcache=2048
maxorphantx=100
maxmempool=300

Passo 3: Iniciar o Nó

# Iniciar o daemon
csd -daemon

# Monitorar a sincronização inicial
tail -f ~/.cs/debug.log

# Verificar status da sincronização
cs-cli getblockchaininfo

Passo 4: Verificar Conexão

# Verificar conexões com peers
cs-cli getpeerinfo | grep -c "addr"

# Obter informações da rede
cs-cli getnetworkinfo

Download Inicial de Blocos

Ao iniciar um novo nó, ele deve baixar e validar toda a blockchain:

Dicas para Sincronização Mais Rápida

# Aumentar cache do banco de dados (em cs.conf)
dbcache=4096

# Limitar conexões para evitar problemas de largura de banda
maxconnections=64

Gerenciamento do Nó

Comandos Úteis

# Obter informações da blockchain
cs-cli getblockchaininfo

# Obter informações da rede
cs-cli getnetworkinfo

# Obter informações da carteira
cs-cli getwalletinfo

# Listar peers conectados
cs-cli getpeerinfo

# Obter informações de mineração
cs-cli getmininginfo

# Parar o nó de forma segura
cs-cli stop

Monitoramento

# Verificar status do nó
cs-cli getnodeaddresses

# Visualizar logs recentes
tail -100 ~/.cs/debug.log

# Monitorar uso de recursos
htop -p $(pgrep csd)

Configuração Avançada

Poda (Pruning)

Se o espaço em disco for limitado, habilite a poda:

# cs.conf
prune=5000  # Manter 5GB de arquivos de blocos

# Ou iniciar com flag de poda
csd -prune=5000 -daemon

Nota: Nós com poda não podem servir blocos históricos a outros nós e alguns recursos RPC podem ser limitados.

Adicionando Nós

Adicione manualmente nós peers se necessário:

# cs.conf
addnode=node1.cs.network
addnode=node2.cs.network
addnode=192.168.1.100:16178

Lista Branca

# cs.conf
whitelist=127.0.0.1
whitelist=192.168.1.0/24

Melhores Práticas de Segurança

1. Use um Firewall

# Permitir apenas portas necessárias
sudo ufw allow 16178/tcp  # P2P
sudo ufw allow 16180/tcp  # RPC (restringir ao localhost)
sudo ufw enable

2. Proteger Acesso RPC

# Use credenciais fortes
rpcuser=usuario_aleatorio_longo
rpcpassword=senha_aleatoria_longa

# Restringir acesso
rpcallowip=127.0.0.1
rpcbind=127.0.0.1

3. Manter o Software Atualizado

# Verificar atualizações regularmente
git pull origin main
make -j$(nproc)
sudo make install

4. Usar systemd para Reinício Automático

Crie /etc/systemd/system/csd.service:

[Unit]
Description=Cloud Service Daemon
After=network.target

[Service]
Type=forking
User=cscoin
Group=cscoin
ExecStart=/usr/local/bin/csd -daemon -conf=/home/cscoin/.cs/cs.conf
Restart=always
RestartSec=10
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

Habilitar e iniciar:

sudo systemctl daemon-reload
sudo systemctl enable csd
sudo systemctl start csd
sudo systemctl status csd

Solução de Problemas

Nó Não Conecta

# Verificar resolução DNS
nslookup node.cs.network

# Adicionar manualmente um peer
cs-cli addnode <IP>:16178 onetry

# Verificar firewall
sudo ufw status

Alto Uso de Memória

# Reduzir tamanho do cache
dbcache=512

# Limitar mempool
maxmempool=100

Sincronização Lenta

• Certifique-se de estar usando um SSD
• Aumente dbcache para 4096 ou mais
• Verifique a largura de banda da rede
• Verifique se outros processos estão consumindo I/O de disco

---

Próximos Passos

• Saiba sobre os diferentes Tipos de Nó
• Configure suas Configurações de Nó
• Configure Monitoramento & Manutenção