Web xml configuration file/pt-br

From Nxt Wiki
Jump to: navigation, search

O arquivo de configuração principal do seu software Nxt é um arquivo chamado web.xml, que está localizado no diretório raiz de sua instalação Nxt, em ./webapps/root/WEB-INF/web.xml.

Uma cópia do arquivo web.xml padrão está incluído abaixo. Há uma série de parâmetros que podem ser definidos no arquivo, para ajustar o desempenho do seu software.

Cada parâmetro é escrito no seguinte formato:

  
   <init-param>
       <param-name>parameterName</param-name>
       <param-value>parameterValue</param-value>
   </init-param> 

Para alterar um parâmetro, basta editar o parameterValue correspondente.

Esta página só fornece informações sobre parâmetros que são frequentemente editados. Muitas das configurações neste arquivo não devem ser alterado, a menos que você realmente saiba o que está fazendo.

1 myAddress

Valor padrão: null

Determina o "endereço" que será utilizado para descrever o seu nodo. Se você anunciar o endereço do seu host neste parâmetro, o valor deve ser definido com o mesmo valor retornado pelo http://localhost:7874/nxt?requestType=getMyInfo

2 shareMyAddress

Valor padrão: true

Pode ser definido para true ou false; determina se o software vai ou não vai anunciar a sua presença na rede.

3 myPlatform

Valor padrão: PC

Pode ser definido para qualquer valor de string (texto), para descrever a plataforma em que o seu software está sendo executado. Usado apenas para fins informativos. Valores normalmente usados ​​são PC, MacOS, Linux, CentOS, Debian, RaspberryPi e VPS.

4 myHallmark

Valor padrão: null

Parâmetro opcional; definido com o valor de hallmark do seu nodo. Veja Como criar um hallmark

5 wellKnownPeers

Valor padrão: a lista pre-definida de endereços de servidores Nxt

Há um número muito grande de "bem-conhecidas" servidores Nxt na rede. Estes são os nodos públicos que são "hallmarked" e, portanto, são mais confiáveis do que outros nodos. Tendo uma grande lista de pares conhecidos, será mais fácil para o seu software para se conectar a outros servidores e manter-se atualizado com o blockchain .

É no melhor interesse da rede que esta lista varie de um servidor para outro. Você pode gerar uma lista aleatória de nodos http://nxtra.org/nodes, ou construir uma baseando nos servidores listados no explorador de pares Nxt.

6 maxNumberOfConnectedPublicPeers

Valor padrão: 20

Define o número máximo de conexões de pares ativos que o seu software vai tentar manter.

7 connectTimeout

Padrão: 2000

Em milésimos de segundo. Determina o tempo máximo que o seu servidor irá esperar antes estourar o tempo limite de uma conexão para outro servidor.

8 readTimeout

Padrão: 5000

Em milésimos de segundo. Determina o tempo máximo que o seu servidor irá esperar para ler dados de conexão com um outro servidor.

9 pushThreshold

Padrão: 0

Usado para determinar o peso mínimo permitido para pares onde ele envia os dados. Se você envia um montão de pagamentos, você deve definir pushThreshold a 1 ou superior, mas isso aumenta a chance de que as operações não serão vistos pela maioria dos pares.

10 pullThreshold

Padrão: 0

Usado para determinar o peso mínimo permitido para os pares de onde o servidor recebe dados.

11 allowedUserHosts

Padrão: 127.0.0.1; localhost; 0:0:0:0:0:0:0:1;

Determina os endereços IPv4 e IPv6 que terão permissão para se conectar ao seu servidor e usar o cliente NRS baseado na web. Por padrão, apenas "localhost" (ou equivalentes) são permitidas. Se você quiser acessar o seu servidor de outro lugar, adicione outros endereços IP aqui. Se você quiser permitir conexões a partir de qualquer lugar, defina-o para *

12 allowedUserHosts

Padrão: 127.0.0.1; localhost; 0:0:0:0:0:0:0:1;

Determina os endereços IPv4 e IPv6 que terão permissão para se conectar ao seu servidor e usar chamadas API. Por padrão, apenas "localhost" (ou equivalentes) são permitidas. Se você quiser acessar o seu servidor de outro lugar, adicione outros endereços IP aqui. Se você quiser permitir conexões a partir de qualquer lugar, defina-o para *

13 blacklistingPeriod

Padrão: 300000

Expresso em segundos. Define o tempo em que os nós da lista negra são automaticamente retirados dela.

14 communicationLoggingMask

Padrão: 0

Altere este valor para aumentar a quantidade de registro de mensagens no console Java.

  • 1: exceções de log
  • 2: respostas de log com códigos de resposta HTTP não-200
  • 4 respostas de log com códigos de resposta HTTP 200
  • Adicione qualquer um dos valores acima juntos para registrar mais de um tipo de mensagem (por exemplo, 2&1=3; 4&1=5. Os valores possíveis são 1-7)

15 O arquivo padrão webxml

<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app>
	<servlet>
		<servlet-name>Nxt</servlet-name>
		<servlet-class>Nxt</servlet-class>
		<async-supported>true</async-supported>
		<load-on-startup>1</load-on-startup>

		<init-param>
			<param-name>blockchainStoragePath</param-name>
			<param-value>blockchain.nrs</param-value>
		</init-param>

		<init-param>
			<param-name>myScheme</param-name>
			<param-value>http</param-value>
		</init-param>

		<init-param>
			<param-name>myPort</param-name>
			<param-value>7874</param-value>
		</init-param>

		<init-param>
			<param-name>myAddress</param-name>
			<param-value></param-value>
		</init-param>

		<init-param>
			<param-name>shareMyAddress</param-name>
			<param-value>true</param-value>
		</init-param>

        <init-param>
            <param-name>myPlatform</param-name>
            <param-value>PC</param-value>
        </init-param>

		<init-param>
			<param-name>myHallmark</param-name>
			<param-value></param-value>
		</init-param>

		<init-param>
			<param-name>wellKnownPeers</param-name>
			<param-value>87.230.14.1; 46.19.137.116; 95.85.22.142; node18.nxtbase.com; node10.nxtbase.com; vps1.nxtcrypto.org; vps2.nxtcrypto.org; vps3.nxtcrypto.org; vps4.nxtcrypto.org; vps5.nxtcrypto.org; node16.nxtbase.com; node09.nxtbase.com; node29.nxtbase.com; 162.243.214.183; 162.243.213.115; 78.46.63.221; 95.85.46.233; 162.243.140.133; 146.185.129.54; 162.243.143.15; 109.230.224.65; 46.165.208.107:32151; 54.249.101.252; 37.209.120.192; 84.112.39.24; 78.46.63.221; 69.163.47.173; 95.85.46.233; 162.243.140.133; 146.185.129.54; 162.243.117.63; 192.241.155.44; 162.243.214.68; 95.85.46.164; 162.243.216.55; 162.243.143.15; 95.85.46.249; 93.190.92.74; 37.209.120.192; 93.190.92.75; 85.25.134.59; 93.190.92.76; nxtwallet.com; 31.220.50.208; nxt.ddos.me; 203.174.12.25; 88.198.142.92; 66.197.138.90; 64.120.180.106; 109.230.224.65; 80.86.92.50; node1.nextcoin.it; node2.nextcoin.it; node3.nextcoin.it; node4.nextcoin.it; node5.nextcoin.it; nxt.homer.ru; 31.204.130.123; 209.222.0.194; 209.222.16.10;</param-value>
		</init-param>

		<init-param>
			<param-name>wellKnownPeers2</param-name>
			<param-value>87.230.14.1; 46.19.137.116; 95.85.22.142; 162.243.214.183; scum2.bounceme.net; 162.243.213.115; node11.nxtbase.com; 78.46.63.221; scum5.bounceme.net; scum4.bounceme.net; vps5.nxtcrypto.org; node16.nxtbase.com;</param-value>
		</init-param>

		<init-param>
			<param-name>maxNumberOfConnectedPublicPeers</param-name>
			<param-value>20</param-value>
		</init-param>

		<init-param>
			<param-name>connectTimeout</param-name>
			<param-value>2000</param-value>
		</init-param>

		<init-param>
			<param-name>readTimeout</param-name>
			<param-value>5000</param-value>
		</init-param>

		<init-param>
			<param-name>enableHallmarkProtection</param-name>
			<param-value>true</param-value>
		</init-param>

		<init-param>
			<param-name>pushThreshold</param-name>
			<param-value>0</param-value>
		</init-param>

		<init-param>
			<param-name>pullThreshold</param-name>
			<param-value>0</param-value>
		</init-param>

		<init-param>
			<param-name>allowedUserHosts</param-name>
			<param-value>127.0.0.1; localhost; 0:0:0:0:0:0:0:1;</param-value>
		</init-param>

		<init-param>
			<param-name>allowedBotHosts</param-name>
			<param-value>127.0.0.1; localhost; 0:0:0:0:0:0:0:1;</param-value>
		</init-param>

		<init-param>
			<param-name>blacklistingPeriod</param-name>
			<param-value>300000</param-value>
		</init-param>

		<init-param>
			<param-name>communicationLoggingMask</param-name>
			<param-value>0</param-value>
		</init-param>

	</servlet>
	<servlet-mapping>
		<servlet-name>Nxt</servlet-name>
		<url-pattern>/nxt</url-pattern>
	</servlet-mapping>

	<filter>
		<filter-name>DoSFilter</filter-name>
		<filter-class>org.eclipse.jetty.servlets.DoSFilter</filter-class>
		<init-param>
			<param-name>maxRequestsPerSec</param-name>
			<param-value>3000</param-value>
		</init-param>
		<init-param>
			<param-name>delayMs</param-name>
			<param-value>1000</param-value>
		</init-param>
		<init-param>
			<param-name>trackSessions</param-name>
			<param-value>false</param-value>
		</init-param>
		<async-supported>true</async-supported>
	</filter>
	
	<filter-mapping>
		<filter-name>DoSFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
</web-app>