# Conexões remotas

Na maioria das vezes, isso é para pessoas que desejam usar o SillyTavern em seus telefones celulares enquanto seu PC executa o servidor ST dentro da mesma rede WiFi.

Também é o primeiro passo para permitir conexões remotas de fora da rede local.

Por padrão, o servidor ST aceita apenas conexões da máquina em que está sendo executado (localhost). Para permitir que ele ouça conexões de outros dispositivos, defina a opção listen em config.yaml como true.

# Listen for incoming connections
listen: true

Quando o ST estiver ouvindo conexões remotas, você deve ver esta mensagem no console:

SillyTavern is listening on IPv4: 0.0.0.0:8000

e alguma explicação sobre o que isso significa.

Quando o ST não estiver ouvindo conexões remotas, você deve ver esta mensagem no console:

SillyTavern is listening on IPv4: 127.0.0.1:8000

Após habilitar a escuta de conexão remota, você deve configurar pelo menos um método de controle de acesso. Caso contrário, o servidor não iniciará.

Para habilitar o controle de acesso via whitelist, edite o arquivo config.yaml no diretório raiz do SillyTavern (/SillyTavern/config.yaml):

1. Inicie o SillyTavern pelo menos uma vez para gerar os arquivos de configuração necessários.
2. Abra /SillyTavern/config.yaml em um editor de texto.
3. Encontre a seção whitelist e adicione os endereços IP que deseja permitir:
   • Liste cada endereço IP separadamente.
   • Certifique-se de que 127.0.0.1 esteja incluído, ou você não poderá se conectar da máquina host.
   • Suporta IPs individuais, máscaras CIDR (por exemplo, 10.0.0.0/24) e intervalos com curinga (*).
4. Salve o arquivo config.yaml.
5. Reinicie seu servidor SillyTavern.

1. Permitir qualquer dispositivo na rede local:

   whitelist:
     - ::1
     - 127.0.0.1
     - 10.0.0.0/8
     - 172.16.0.0/12
     - 192.168.0.0/16

   Se não tiver certeza sobre o intervalo de endereços da sua rede local, use a whitelist acima.

2. Permite dois dispositivos específicos para se conectar:

   whitelist:
     - ::1
     - 127.0.0.1
     - 192.168.0.2
     - 192.168.0.5

3. Permite qualquer dispositivo na sub-rede 192.168.0.* para se conectar:

   whitelist:
     - ::1
     - 127.0.0.1
     - 192.168.0.*

4. Permitir conexões de rede para todos os dispositivos IPv4:

   whitelist:
     - 0.0.0.0/0

Para desabilitar o controle de acesso via whitelist:

• Defina whitelistMode como false em /SillyTavern/config.yaml.
• Remova ou renomeie whitelist.txt (se existir) na pasta de instalação base do SillyTavern.
• Reinicie seu servidor SillyTavern.

Se você ainda preferir usar whitelist.txt:

1. Crie um novo arquivo de texto chamado whitelist.txt na pasta de instalação base do SillyTavern.
2. Abra-o em um editor de texto e adicione os endereços IP permitidos.
3. Salve o arquivo e reinicie seu servidor SillyTavern.

10.0.0.0/8
172.16.0.0/12
192.168.0.0/16
127.0.0.1
::1

Isso permite que qualquer dispositivo na rede local se conecte.

O servidor solicitará nome de usuário e senha sempre que um cliente se conectar via HTTP. Isso só funciona se as conexões remotas (listen: true) estiverem habilitadas.

Para habilitar HTTP BA, abra config.yaml no diretório base do SillyTavern e procure por basicAuthMode. Defina basicAuthMode como true e configure nome de usuário e senha. Nota: config.yaml só existirá se o ST tiver sido executado antes pelo menos uma vez.

basicAuthMode: true
basicAuthUser:
  username: "MyUsername"
  password: "MyPassword"

Alternativamente, você pode habilitar autenticação básica da seguinte forma:

basicAuthMode: true
enableUserAccounts: true
perUserBasicAuth: true

Neste modo perUserBasicAuth, o nome de usuário e senha da autenticação básica serão os mesmos de qualquer conta multiusuário válida que tenha uma senha. Além disso, o SillyTavern fará login diretamente nessa conta. Certifique-se de ter uma conta com senha antes de habilitar perUserBasicAuth.

Salve o arquivo e reinicie o SillyTavern se ele já estiver em execução. Você deverá ser solicitado por nome de usuário e senha ao se conectar ao seu ST. Tanto o nome de usuário quanto a senha são transmitidos em texto simples. Se você estiver preocupado com isso, pode servir o ST via HTTPS.

Ao hospedar um servidor pela rede sem HTTPS, é altamente recomendável habilitar a verificação de host da solicitação. Isso ajuda a prevenir vários ataques, como DNS rebinding. Por padrão, o servidor SillyTavern registrará uma mensagem no console na primeira conexão de um host não reconhecido.

Para habilitar a whitelist de host, edite o arquivo config.yaml no diretório raiz do SillyTavern:

hostWhitelist:
    enabled: true

Para adicionar um nome de host a uma lista de hosts confiáveis, inclua-o na seção hostWhitelist.hosts:

hostWhitelist:
  hosts:
    - "example.com"
    - ".trycloudflare.com"

Para desabilitar mensagens do console para hosts não reconhecidos, defina a opção hostWhitelist.scan como false:

hostWhitelist:
    scan: false

Após a whitelist ter sido configurada, você precisará do IP do dispositivo que hospeda o ST.

Se o dispositivo que hospeda o ST estiver na mesma rede wifi, você usará o IP wifi interno do host ST:

• Para Windows: botão windows > digite cmd.exe na barra de pesquisa > digite ipconfig no console, pressione Enter > procure pela listagem IPv4.

Se você (ou outra pessoa) quiser se conectar ao seu ST hospedado sem estar na mesma rede, você precisará do IP público do seu dispositivo que hospeda o ST.

• Ao usar o dispositivo que hospeda o ST, acesse esta página e procure por IPv4. Isso é o que você usaria para se conectar do dispositivo remoto.

Qualquer que seja o IP que você obteve para sua situação, você colocará esse endereço IP e número de porta no navegador web do dispositivo remoto.

Um endereço típico para um host ST na mesma rede wifi seria assim:

http://192.168.0.5:8000

Use http:// NÃO https://

Novas conexões ao servidor são exibidas na janela do console e registradas no arquivo access.log no diretório de dados do SillyTavern.

Uma mensagem do console para um navegador na mesma máquina que o servidor se parece com:

New connection from 127.0.0.1; User Agent: ...

Uma mensagem do console para um navegador em uma máquina diferente na mesma rede que o servidor pode se parecer com:

New connection from 192.168.116.187; User Agent: ...

Se uma conexão for recusada, a mensagem do console será assim:

New connection from 192.168.116.211; User Agent: ...

Forbidden: Connection attempt from 192.168.116.211. If you are attempting to connect,
please add your IP address in whitelist or disable whitelist mode in config.yaml in
root of SillyTavern folder.

access.log conterá as informações da conexão, com timestamps, mas não se a conexão foi aceita ou recusada.

Ainda não consegue se conectar?

• Se a tentativa de conexão aparecer no console, mas for proibida, é um problema de whitelist.
• Se o ST estiver ouvindo conexões remotas, mas a tentativa de conexão não aparecer no console, é um problema de rede.
• Se o ST não estiver ouvindo conexões remotas, é um problema de leitura.

• No Windows, o aplicativo pode estar bloqueado pelo firewall do aplicativo. A maneira mais rápida de corrigir isso é desinstalar e reinstalar o node.js, e quando solicitado pelo firewall, permitir que ele acesse a rede. Caso contrário, você precisará permitir manualmente o aplicativo node.js através do firewall do aplicativo Windows.
• No Windows 11, habilite o tipo de perfil de Rede Privada em Configurações > Rede e Internet > Ethernet. Isso é MUITO importante para o Windows 11, caso contrário, você não conseguirá se conectar mesmo com as regras de firewall mencionadas acima.
• No Linux, você pode precisar permitir a porta através do firewall. O comando para fazer isso é sudo ufw allow 8000. Isso permitirá tráfego na porta 8000.

Não modifique as configurações de encaminhamento de porta no seu roteador. Isso não é necessário para acessar o ST dentro da sua rede local, e pode expor seu servidor à internet.

Se você estiver tentando acessar seu servidor ST de fora da sua rede local, e não estiver funcionando, identifique se o problema está entre o dispositivo remoto e o endpoint do túnel/VPN, ou entre o endpoint do túnel no servidor e o serviço ST. Caso contrário, você passará muito tempo solucionando problemas da coisa errada.

Para criptografar o tráfego de e para sua instância ST, inicie o servidor com a flag --ssl.

Exemplo:

node server.js --ssl

Por padrão, o ST procurará seus certificados dentro da pasta certs. Se seus arquivos estiverem localizados em outro lugar, você pode usar os argumentos --keyPath e --certPath.

Exemplo:

node server.js --ssl --keyPath /home/user/certificates/privkey.pem --certPath /home/user/certificates/cert.pem

O usuário com o qual você está executando o SillyTavern requer permissões de leitura nos arquivos de certificado.

A maneira mais simples e rápida de obter um certificado é usando certbot.