VeltShell

Windows VPS em um clique
Sobe e abre um Windows dentro do seu VPS Ubuntu — console no navegador + RDP.

---

O que é

Aplicativo para Windows que se conecta por SSH ao seu Ubuntu, prepara QEMU/KVM + libvirt, cria (ou reabre) uma VM Windows e mostra a tela no Edge/Chrome via noVNC — com túnel SSH seguro. Também encaminha HTTP/HTTPS/RDP do VPS para a VM.

Seu PC (Windows)  ──SSH──►  VPS Ubuntu  ──►  VM Windows
       │                         │
   noVNC local              QEMU / KVM
   mstsc (RDP)              portas 80/443/3389

Deixe o app aberto enquanto usa o console noVNC (o túnel SSH vive no processo).

---

Recursos

• Conexão SSH automática (Paramiko, com retries)
• Instalação dos pacotes no Ubuntu se faltarem
• Download da ISO Windows Server Eval no servidor (ou upload da sua ISO)
• Uso inteligente de RAM/CPU do host (reserva o necessário para o Ubuntu)
• Console noVNC em 127.0.0.1 (não expõe VNC na internet)
• Encaminhamento 80 / 443 / 3389 / 13389 → VM
• Empacotamento em .exe com um clique (gerar_exe.bat)

---

Requisitos

Onde	Precisa
PC	Windows 10/11, Edge ou Chrome; Python 3.10+ se rodar pelo código
VPS	Ubuntu 20.04 / 22.04 / 24.04, SSH liberado, preferência KVM

---

Instalação rápida

Duplo clique em Instalar.bat. Ele instala a dependência, cria o ssh.txt se ainda não existir e abre o app.

1. Clone

git clone https://github.com/oftcer/VeltShell.git
cd VeltShell

2. Credenciais SSH

copy ssh.txt.example ssh.txt

Edite ssh.txt (uma linha por campo):

IP_OU_HOSTNAME
usuario
senha
22

A porta (4ª linha) é opcional. Nunca envie ssh.txt ao GitHub.

3. ISO (opcional)

copy iso.txt.example iso.txt

Sem ISO local, o app baixa Windows Server 2022 Evaluation no servidor.

4. Rodar

pip install -r requirements.txt
python windows_vps.py

5. Gerar .exe (opcional)

gerar_exe.bat

Coloque ssh.txt na mesma pasta do WindowsVPS.exe.

---

Estrutura

VeltShell/
├── windows_vps.py          # App principal (GUI + SSH + virt)
├── requirements.txt
├── gerar_exe.bat           # Build do executável
├── WindowsVPS.spec
├── ssh.txt.example         # Modelo (versionado)
├── iso.txt.example         # Modelo (versionado)
├── LICENSE · README.md · SECURITY.md · CONTRIBUTING.md
└── docs/
    ├── ARCHITECTURE.md
    ├── CONFIG.md
    ├── TROUBLESHOOTING.md
    ├── GITHUB.md
    └── assets/banner.svg

Arquivos só na sua máquina (ignorados pelo Git): ssh.txt, iso.txt, erro.log, *.iso, build/, dist/, WindowsVPS.exe.

---

Portas

No Ubuntu	Na VM	Uso
80	80	HTTP
443	443	HTTPS
3389	3389	RDP
13389	3389	RDP alternativo

No Windows da VM, libere o firewall. O noVNC fica só no túnel local (127.0.0.1:6080).

---

Documentação

Guia	Conteúdo
Arquitetura	Fluxo SSH → VM → noVNC → RDP
Configuração	Arquivos e constantes
Problemas	Erros comuns
Publicar no GitHub	Como versionar com segurança
Contribuir	PRs e ideias
Segurança	Relatos e boas práticas

---

Segurança

• ssh.txt não entra no repositório (.gitignore)
• Se a senha vazou, troque imediatamente no VPS
• Prefira fail2ban / restrição de IP no SSH em produção

---

Autor

oftcer

---

Licença

MIT — use e modifique livremente.

A ISO do Windows é da Microsoft (Evaluation / licença própria). Este projeto só automatiza o uso no ambiente que você controla.