🌐 Cette page n'est pas encore traduite en français. Affichage de la référence portugaise (BR). Aidez-nous à traduire.

Terminal Linux Servidor

Terminal Ubuntu completo direto no navegador — não é simulação, não é WebContainer, não é WSL. É um container Docker isolado por usuário rodando Ubuntu 22.04 com bash, apt, sudo, sua toolchain inteira (Node, Python, Go, etc.) e o roqueos-cli pré-instalado pra você controlar o desktop RoqueOS direto do shell.

O que torna ele diferente

• 🐧 Ubuntu 22.04 real com kernel Linux do host (não simulação)
• 👤 Isolado por usuário — cada login tem container próprio, home persistente, processos separados
• 🔐 Sudo sem senha dentro do container (você é root do SEU ambiente, sem afetar outros)
• 💾 Home persistente em volume Docker — fica no /data/roqueos/users/<seu-id>/, sobrevive entre sessions
• 🛠️ Pacotes pré-instalados: Node.js 22, Python 3, Go, Rust toolchain, Git, curl, wget, htop, vim, nano, jq, build-essential
• 🌐 Acesso à rede completo — pode rodar servidor HTTP, baixar arquivo, conectar em DB externo
• 🤖 roqueos-cli pré-instalado — chama o desktop RoqueOS (notifications, abrir apps, criar arquivo)

Como abrir

Launchpad → Terminal. Primeira vez leva ~5s pra spin up do container (depois é instantâneo). Múltiplas instâncias OK — abre tantas quantas precisar.

Casos de uso reais

Script rápido de manutenção:

# Limpar /tmp de logs antigos + avisar quando terminar
find /tmp -name "*.log" -mtime +7 -delete
roqueos-cli notify "Limpeza OK" "Logs > 7 dias removidos"

Setup do projeto novo:

cd ~/projects
git clone https://github.com/seu/projeto
cd projeto
yarn install
yarn dev &  # roda em background
roqueos-cli open-url "http://localhost:5173"  # abre no Roque Browser

Cron de monitoramento:

crontab -e
# Cole:
0 9 * * * df -h | awk '$5+0 > 80 {system("roqueos-cli notify \"Disco cheio\" \"" $6 " " $5 "\"")}'

Pipeline ad-hoc:

# Stream do log do servidor + alerta automático se "ERROR" aparecer
docker logs -f roqueos-server 2>&1 | \
  grep --line-buffered ERROR | \
  xargs -I{} roqueos-cli notify "RoqueOS error" "{}"

roqueos-cli — controle o desktop pelo shell

Comandos disponíveis (mesmo CLI que o RoqueClaw usa):

# Notificação
roqueos-cli notify "Título" "Mensagem"

# Abrir app do RoqueOS
roqueos-cli open-app finder
roqueos-cli open-app vscode
roqueos-cli open-app browser

# Abrir URL no Roque Browser
roqueos-cli open-url "https://github.com"

# Criar arquivo no Finder (lê stdin)
echo "Notas da reunião..." | roqueos-cli create-file "/home/user/notes/reuniao.md"

# Executar comando + retornar output como notification
roqueos-cli run-terminal "df -h"

# Modal de confirmação (espera resposta)
roqueos-cli show-dialog "Apagar 50GB de logs antigos?" --type confirm

Documentação completa: RoqueClaw + CLI.

Filesystem compartilhado

Os arquivos no /home/user/ do Terminal são os MESMOS que aparecem no Finder e no VS Code. Tudo em sincronia:

• Salva código no VS Code → aparece no ls do Terminal
• Cria pasta no Finder → cd funciona no Terminal
• wget baixa no Terminal → aparece no Finder no Roque Browser

Recursos do container

Recurso	Default
Memória RAM	2 GB (configurável via env CONTAINER_MEMORY_LIMIT)
CPU	2 cores compartilhadas
Disco	Volume Docker dedicado
Network	Bridge roqueos-network (acessa outros containers do servidor)
Imagem	roqueribeiro1988/roqueos-server-ubuntu:latest (Ubuntu 22.04)

Atalhos do xterm.js

Atalho	Ação
Ctrl+Shift+C	Copiar selection
Ctrl+Shift+V	Colar
Ctrl+Shift++ / Ctrl+-	Aumentar / diminuir font size
Ctrl+Shift+F	Find in buffer
Ctrl+L (bash)	Limpar terminal
Ctrl+D	Logout / fechar shell
Ctrl+R	Reverse search no histórico bash

Touch input em mobile suportado nativamente (xterm.js detecta).

Persistência entre sessions

/home/user/ (e qualquer subpasta) persistem entre fechamentos do app, restarts do container, updates do RoqueOS Server (install.sh --update). Só perde se você apagar manualmente o volume Docker roqueos-userdata-<uid> ou recriar o servidor do zero (docker compose down -v).

Instalando pacotes extras

sudo apt update
sudo apt install -y <pacote>

Os pacotes ficam no container do seu usuário — outros usuários do mesmo servidor não veem. Boa prática: anotar no /home/user/.bashrc quais pacotes você instalou pra reinstalar se algum dia o container for recriado.

Diferença vs xterm direto / WSL

Aspecto	RoqueOS Terminal	WSL / xterm local
Setup	0s (já está rodando)	Install Linux + dist + setup
Acesso	Qualquer browser logado	Só sua máquina
Multi-device	✅ celular acessa o mesmo home	❌
Persistência	Volume Docker do servidor	Disco local
Isolation	Container per-user	Compartilhado
Performance	Latência server↔browser	Nativo

Veja também

• VS Code integrado — code-server com extensions, Git, debugger
• App Store Docker — instalar Plex/Nextcloud/etc com 1 clique
• Containers Manager — gerenciar containers Docker via UI
• RoqueClaw + CLI — automatize tarefas dev via linguagem natural