🌐 Эта страница еще не переведена на русский. Показана португальская (BR) версия. Помочь с переводом.
Server Admin Panel
Painel de administração do servidor RoqueOS conectado, embutido no app (Launchpad, Server Admin). O painel em <seu-servidor>:27021/admin continua funcionando para emergência e scripts, mas o do app é onde o dia a dia acontece.
Antes de começar
| Você precisa de | Por quê |
|---|---|
| a URL do servidor na porta 27021 | o painel é servido pelo próprio servidor |
| uma chave de administrador | as seções de gestão exigem a permissão de admin na chave |
| o servidor de pé | painel que não abre é servidor parado, não painel quebrado |
Como se chega ao painel
Quando o painel não abre
| O que acontece | Por quê | O que fazer |
|---|---|---|
| A URL não responde | o servidor está parado, ou a porta está fechada | docker ps no servidor; confira o firewall |
| Abre e recusa a chave | a chave é de outro servidor, ou foi revogada | crie outra pelo primeiro acesso, se não houver nenhuma válida |
| Uso por pessoa diz "sem permissão" | a chave em uso não tem a permissão de administrador | troque de chave em Ajustes, Servidor |
| Uso por pessoa diz "o servidor não mede" | o servidor é anterior à versão 1.32 | atualize em Recursos & versão |
| Os gráficos ficam em branco | o painel não está falando com o Docker | o cartão do Docker mostra Desconectado quando é isso |
| Perdi a chave de administrador | ela só aparece uma vez, na criação | gere outra pelo painel, ou pelo endpoint de setup se o servidor estiver zerado |
As seções
| Seção | O que faz |
|---|---|
| Monitoramento | CPU e memória do servidor inteiro, disco, Docker e os containers que mais gastam |
| Uso por pessoa | Quanto do servidor cada pessoa ocupa agora e o que usou no período |
| API Keys | Criar e revogar chaves, ver permissões |
| Histórico de uso | Pedidos recentes e números dos últimos 30 dias de cada chave |
| Cloudflare Tunnel | Estado do túnel, criar e remover rotas, lista de subdomínios |
| Rede | IP da rede local para acesso direto |
| Legendas | Provedores OpenSubtitles e SUBDL do Video Player |
| Recursos & versão | Versão do servidor, atualização disponível, módulos ligados |
Monitoramento
Atualiza a cada 2 segundos enquanto a aba está visível. Num servidor 1.32 ou mais novo, CPU e memória são do servidor inteiro (lidos do próprio sistema); num servidor mais antigo, a tela mostra a soma dos containers e diz isso no cartão. Se a leitura de CPU e memória falhar e as outras não, um aviso diz que os números podem estar parados.
Uso por pessoa
Responde à pergunta "quem está usando este servidor, e quanto?". Precisa de servidor 1.32 ou mais novo e de uma chave com permissão de administrador.
Para achar quem está pesando no servidor:
- Abra o Server Admin pelo Launchpad e escolha Uso por pessoa.
- Escolha o período no alto (hoje, 7 ou 30 dias) e ordene por Memória ou CPU: quem está no topo é quem mais ocupa o servidor agora.
- Toque na pessoa para abrir a ficha: os containers dela, a pasta e o que ela usou, por recurso.
- Se o peso for de um container esquecido, pare ou remova pelo app Containers; se for a pasta, a ficha mostra o tamanho e quando foi medida.
- Os quatro números do topo: pessoas ativas no período, containers rodando (e quantos são de pessoas), memória dos containers diante da memória do servidor, e o tamanho das pastas de todas as contas.
- A lista: cada pessoa com a memória (a barra é a parte dela na memória do servidor), a CPU e a pasta. Ordena por memória, CPU, disco ou uso. CPU e memória são de agora; o uso é do período escolhido (hoje, 7 ou 30 dias).
- A ficha: toque numa pessoa para ver cada container dela, o tamanho da pasta, os pedidos com e sem erro, o último dia de uso, as execuções de agentes com os tokens, e o que ela usou agrupado por recurso (Arquivos, Agentes, Apps e containers, Modelos de IA e os outros).
- Apps e serviços do servidor: os containers que não são de ninguém (apps instalados do catálogo, serviços do próprio servidor), com CPU e memória.
Quem é cada pessoa: para quem é administrador do RoqueOS, o painel mostra o nome e o e-mail da conta. Para os outros, mostra "Você", o nome da chave quando o uso veio de uma chave sem conta, ou "Conta" com o começo do identificador.
Como o servidor conta: cada pedido feito com identidade conta para a pessoa e para o recurso usado, e o servidor grava os totais uma vez por minuto. O tamanho das pastas é medido a cada meia hora; enquanto mede pela primeira vez, o número do disco espera. O próprio Monitoramento não conta como uso.
Histórico de uso
Escolhe a primeira chave sozinho. Os números (total, taxa de sucesso, tempo médio e a divisão por status) são dos últimos 30 dias; a lista mostra os 50 pedidos mais recentes. O servidor guarda o histórico por 30 dias.
Recursos & versão
Mostra a versão, se há atualização e como atualizar. Os módulos que se ligam por aqui (RoqueClaw, Android, Windows, RoqueOffice e os outros) têm interruptor; os que vêm da instalação aparecem em Ligados na instalação, sem interruptor, porque mudam reinstalando o servidor com outra opção.
Servidor de demonstração
O servidor de demonstração do RoqueOS serve quem ainda não tem o próprio. Quem não é administrador usa os apps, mas não vê o Server Admin. Containers e arquivos são limpos todos os dias.
Referências cruzadas
- Add Server Wizard: como conectar o servidor recém-instalado
- Volumes e backup: onde os dados do servidor vivem
- install.sh: instalar e atualizar o servidor