Skip to content

Configuração do Nó

Este guia cobre todas as opções de configuração disponíveis para seu nó da Cloud Service, ajudando você a otimizar performance, segurança e funcionalidade.

Localização do Arquivo de Configuração

SOCaminho
Linux~/.cs/cs.conf
macOS~/Library/Application Support/CSCoin/cs.conf
Windows%APPDATA%\CSCoin\cs.conf

Opções de Configuração

Configurações de Rede

ini
# Escutar conexões de entrada
listen=1

# Porta de rede
port=16178

# Número máximo de conexões de entrada+saída
maxconnections=128

# Alvo máximo de upload automático
maxuploadtarget=0

# Timeout de peer em milissegundos
peertimeout=30

# Habilitar travessia NAT (UPnP)
upnp=0

# Descobrir próprio endereço IP
discover=1

Configurações RPC

ini
# Habilitar servidor JSON-RPC
server=1

# Nome de usuário RPC
rpcuser=seu_usuario

# Senha RPC
rpcpassword=sua_senha_segura

# Porta RPC
rpcport=16180

# Permitir conexões RPC de IP específico
rpcallowip=127.0.0.1
rpcallowip=192.168.1.0/24

# Vincular RPC a endereço específico
rpcbind=127.0.0.1

# Habilitar API REST
rest=1

# Habilitar WebSocket
wsport=16181

Configurações de Performance

ini
# Tamanho do cache do banco de dados em MB
dbcache=2048

# Máximo de transações órfãs em memória
maxorphantx=100

# Tamanho máximo do pool de memória em MB
maxmempool=300

# Taxa mínima de retransmissão (CS por KB)
minrelaytxfee=0.00001

Configurações de Índice

ini
# Manter índice completo de transações
txindex=1

# Habilitar índice de endereços
addressindex=1

# Habilitar índice de timestamps
timestampindex=1

# Habilitar índice de gastos
spentindex=1

Poda

ini
# Reduzir requisitos de armazenamento podando blocos antigos
# Valor em MB, mínimo 550
prune=0

# Exemplo: Limitar a 10GB
# prune=10000

Logs

ini
# Registrar em debug.log
debug=1

# Registrar categorias específicas
# debug=net
# debug=mempool
# debug=consensus
# debug=rpc
# debug=wallet

# Registrar timestamps
logtimestamps=1

# Registrar endereços IP
logips=0

# Reduzir arquivo de debug na inicialização
shrinkdebugfile=1

Configurações de Mineração

ini
# Gerar moedas (minerar)
gen=0

# Número de threads de mineração
# genproclimit=4

# Endereço de recompensa de mineração
# miningaddress=<endereço>

Configurações de Carteira

ini
# Habilitar carteira
disablewallet=0

# Configuração de taxa de transação
paytxfee=0.0001

# Confirmações mínimas para saldo
minconf=1

# Tamanho do pool de chaves
keypool=100

# Reescanear blockchain na inicialização
rescan=0

Gerenciamento de Nós

ini
# Adicionar nós específicos
# addnode=192.168.1.100:16178
# addnode=node.cs.network

# Conectar apenas a nós especificados
# connect=192.168.1.100

# Peers na lista branca (isenção de banscore)
# whitelist=127.0.0.1
# whitelist=192.168.1.0/24

# Limite de ban score
banscore=100

# Tempo de banimento
bantime=86400

Configurações de Exemplo

Nó Completo Básico

ini
# Configuração Básica de Nó Completo
server=1
listen=1
port=16178
maxconnections=128
rpcuser=cscoinrpc
rpcpassword=changeme123
rpcport=16180
rpcallowip=127.0.0.1
dbcache=2048
txindex=1
debug=1

Nó de Mineração

ini
# Configuração de Nó de Mineração
server=1
listen=1
port=16178
maxconnections=64
rpcuser=miningrpc
rpcpassword=senhasegura123
rpcport=16180
rpcallowip=127.0.0.1
rpcallowip=192.168.1.0/24
dbcache=1024
txindex=1
gen=1
miningaddress=seu_endereço_cs_aqui

Nó API

ini
# Configuração de Nó API
server=1
listen=1
port=16178
maxconnections=256
rpcuser=apirpc
rpcpassword=senhaapi123
rpcport=16180
rpcallowip=127.0.0.1
rpcallowip=192.168.1.0/24
rest=1
wsport=16181
dbcache=4096
txindex=1
addressindex=1
timestampindex=1
spentindex=1

Nó com Poda

ini
# Configuração de Nó com Poda
server=1
listen=1
port=16178
maxconnections=64
rpcuser=prunedrpc
rpcpassword=senhapoda123
rpcport=16180
rpcallowip=127.0.0.1
dbcache=512
prune=10000

Opções de Linha de Comando

Todas as opções de configuração também podem ser passadas via linha de comando:

bash
# Iniciar com configuração personalizada
csd -conf=/caminho/para/personalizado.conf

# Substituir valores de configuração
csd -dbcache=4096 -maxconnections=256

# Iniciar em primeiro plano para depuração
csd -printtoconsole

# Iniciar com testnet
csd -testnet

# Especificar diretório de dados
csd -datadir=/caminho/para/dados

Melhores Práticas de Configuração

Segurança

  1. Use senhas fortes para acesso RPC
  2. Restrinja acesso RPC ao localhost ou IPs confiáveis
  3. Não exponha RPC à internet pública
  4. Use regras de firewall para limitar acesso
  5. Mantenha o software atualizado

Performance

  1. Defina dbcache adequado com base na RAM disponível
  2. Use armazenamento SSD para melhor performance de I/O
  3. Limite maxconnections para evitar saturação de largura de banda
  4. Habilite poda se o espaço em disco for limitado
  5. Monitore o uso de recursos regularmente

Confiabilidade

  1. Use systemd para reinício automático
  2. Configure monitoramento e alertas
  3. Backups regulares de carteira e configuração
  4. Rotação de logs para arquivos de debug
  5. Teste mudanças de configuração na testnet primeiro

Próximos Passos

Lançado sob a Licença MIT.