Começando com Aplicações no ServerPrism

Este guia o orienta na configuração da sua aplicação auto-hospedada escolhida (5e Tools, Owncast, Rathole ou Yarr) no seu servidor ServerPrism. Ele abrange o pedido, configuração inicial, e problemas comuns.

Antes de começar

Certifique-se de ter uma conta ServerPrism e esteja pronto para implantar um novo servidor ou ter um servidor de 'Aplicações' existente pronto para configuração.

Pedindo no ServerPrism

1. Selecione um plano: Faça login no ServerPrism e escolha um servidor de 'Aplicações'. Recomendamos começar com pelo menos 2 GB de RAM, escalando para 12 GB para aplicações mais exigentes ou maiores cargas de usuários.
2. Escolha uma região: Selecione o local do servidor mais próximo dos seus usuários principais para um desempenho ideal.
3. Implantar: Conclua o pedido. Seu servidor começará a ser provisionado automaticamente.

Primeira inicialização

Após o pedido, seu servidor começará o provisionamento. Este processo geralmente leva alguns minutos. Você pode monitorar seu status através do painel ServerPrism em https://serverprism.com/dashboard. Assim que o status do servidor mostrar 'Running' e você vir a saída do console indicando que a aplicação foi iniciada, ela estará pronta.

Conectando / convidando usuários

O método para se conectar à sua aplicação depende de qual você implantou:

• 5e Tools: Acesse sua instância através do endereço IP e porta do servidor (por exemplo, http://YOUR_SERVER_IP:PORT). A porta padrão geralmente é 80 ou 8080 para aplicações web. Verifique a aba 'Startup' no seu painel ServerPrism para a variável APP_PORT se for configurável.
• Owncast: Sua instância Owncast será acessível via http://YOUR_SERVER_IP:PORT. A porta padrão para Owncast é 8080. Você também pode configurar um domínio personalizado ou subdomínio ServerPrism para facilitar o acesso.
• Rathole: Rathole é um proxy reverso. A conexão envolve configurar clientes para se conectar através do Rathole aos seus serviços internos. Isso requer a configuração do server.toml do Rathole e as configurações do cliente. Ele não possui uma interface web direta para usuários.
• Yarr: Acesse sua instância Yarr via http://YOUR_SERVER_IP:PORT. A porta padrão é tipicamente 8080.

Para facilitar o acesso, você pode anexar um subdomínio gratuito ao seu servidor a partir do seu painel ServerPrism.

Noções básicas de configuração

A configuração para cada aplicação é tipicamente feita via variáveis de ambiente na aba Startup do painel ServerPrism ou editando arquivos de configuração específicos usando o File Manager ou SFTP.

5e Tools

• Armazenamento de Dados: 5e Tools usa um banco de dados local. A configuração é mínima. Você geralmente pode encontrar configurações relacionadas a caminhos de dados em variáveis de inicialização, se necessário.
• Acesso: Certifique-se de que a variável APP_PORT na aba Startup corresponda à porta que você está tentando acessar.

Owncast

• Arquivo de Configuração: Owncast usa principalmente config.yaml localizado no diretório de dados da aplicação. Você pode editá-lo via File Manager.
• Acesso de Administrador: Na primeira vez que você acessar o Owncast, será solicitado que você crie uma conta de administrador. É aqui que você define sua chave de stream e outras configurações.
• Variáveis de Inicialização: Verifique a aba Startup para OWNCAST_DATABASE_PATH, OWNCAST_DATA_PATH, ou OWNCAST_PORT para personalizar locais de dados ou portas de escuta.

Rathole

• Arquivo de Configuração: Rathole requer um arquivo server.toml. Este arquivo define as portas de escuta e os serviços que ele irá proxy. Você deve editar este arquivo para tornar o Rathole funcional.
  • Exemplo de server.toml (editar via File Manager):

  [server]
  bind_addr = "0.0.0.0:8000" # Server listening port
  
  [server.services.my_service]
  type = "tcp"
  token = "your_secret_token"
  bind_addr = "0.0.0.0:2222" # Port clients connect to
  remote_addr = "127.0.0.1:22" # Internal service Rathole forwards to
  

• Tokens: Certifique-se de que o token em server.toml corresponda à configuração do cliente para uma conexão segura.

Yarr

• Configuração: A configuração do Yarr é frequentemente gerenciada através de variáveis de ambiente ou de um arquivo config.json. Verifique a aba Startup para variáveis como YARR_PORT, YARR_DATABASE_PATH, ou YARR_ADMIN_EMAIL.
• Configuração Inicial: Na primeira vez que você acessar o Yarr, pode ser necessário passar por um assistente de configuração inicial para criar um usuário administrador e configurar as definições básicas.

Problemas comuns

1. Aplicação não inicia: Verifique o console do servidor no painel ServerPrism para mensagens de erro. Arquivos de configuração ausentes, variáveis de ambiente incorretas ou conflitos de porta são causas comuns. Certifique-se de que todos os arquivos necessários estejam presentes e formatados corretamente.
2. Não consigo acessar a interface web:
   • Verifique se a aplicação está em execução e escutando na porta esperada (por exemplo, 8080).
   • Verifique as regras de firewall do seu servidor (o ServerPrism geralmente lida com isso, mas certifique-se de que sua aplicação não esteja tentando usar uma porta não padrão bloqueada).
   • Confirme que você está usando o endereço IP e a porta corretos no seu navegador. Se estiver usando um domínio, certifique-se de que o DNS esteja apontando corretamente para o IP do seu servidor.
3. Cliente Rathole não conecta: Verifique novamente se o token no seu server.toml corresponde à configuração do cliente. Certifique-se de que o bind_addr para o serviço em server.toml esteja configurado corretamente e acessível.
4. Desempenho lento: Se sua aplicação estiver funcionando lentamente, considere atualizar seu plano de servidor para mais RAM ou CPU. Você pode fazer isso a partir do seu painel de cliente ServerPrism.

Se você encontrar problemas persistentes, colete seu ID de servidor e a saída de log relevante do console e abra um ticket de suporte em https://serverprism.com/tickets.

Próximos passos

• Domínios Personalizados: Para uma configuração mais profissional, anexe um domínio personalizado ou um subdomínio ServerPrism gratuito à sua aplicação a partir do seu painel ServerPrism.
• Troca de Runtime: Se você decidir mudar para uma aplicação diferente (por exemplo, de Owncast para Yarr), você pode fazer isso facilmente através da aba Startup no seu painel ServerPrism, selecionando um novo runtime. Isso irá re-imaginar seu servidor com a nova aplicação.
• Configuração Avançada: Consulte a documentação oficial da sua aplicação escolhida para recursos avançados, integrações e opções de personalização.