🛡️
CyberLab — Guia de Instalação
Plataforma de treino em cibersegurança para cPanel
⚠️ Aviso Legal: Esta plataforma é exclusivamente para fins educativos. Os conhecimentos adquiridos devem ser usados de forma ética e legal. O administrador é responsável pelo uso adequado da plataforma.
📋 Requisitos do Servidor
- PHP 8.0+ (recomendado 8.1+)
- MySQL 5.7+ ou MariaDB 10.3+
- mod_rewrite activado (cPanel activa por padrão)
- Extensões PHP:
pdo_mysql, json, mbstring, openssl
- cPanel com acesso a File Manager e phpMyAdmin
🚀 Passos de Instalação
1
Criar Base de Dados no cPanel
No cPanel vai a Bases de Dados MySQL:
- Cria uma nova base de dados:
cyberlab_db
- Cria um utilizador:
cyberlab_user com uma senha forte
- Atribui o utilizador à base de dados com TODOS OS PRIVILÉGIOS
2
Importar a Base de Dados
Vai ao phpMyAdmin no cPanel:
- Selecciona a base de dados
cyberlab_db
- Clica em Importar
- Selecciona o ficheiro
install/install.sql
- Clica Executar
3
Configurar o Ficheiro de Configuração
Edita o ficheiro includes/config.php:
define('DB_HOST', 'localhost');
define('DB_NAME', 'cyberlab_db');
define('DB_USER', 'cyberlab_user');
define('DB_PASS', 'A_TUA_SENHA_FORTE'); // ← Alterar!
define('SITE_URL', 'https://seudominio.com'); // ← Alterar!
4
Fazer Upload dos Ficheiros
No cPanel vai ao Gestor de Ficheiros:
- Navega para
public_html/ (ou subdirectório desejado)
- Faz upload de todos os ficheiros da pasta
cyberlab/
- Garante que o ficheiro
.htaccess foi incluído
Estrutura esperada em public_html/:
public_html/
├── index.php
├── login.php
├── register.php
├── dashboard.php
├── labs.php
├── leaderboard.php
├── paths.php
├── profile.php
├── logout.php
├── .htaccess
├── assets/
│ ├── css/style.css
│ └── js/main.js
├── includes/
│ ├── config.php ← Editar este!
│ ├── database.php
│ ├── auth.php
│ └── helpers.php
├── labs/
│ └── lab.php
├── api/
│ ├── submit-flag.php
│ ├── get-hint.php
│ └── read-notifications.php
└── admin/
├── index.php
├── add-lab.php
├── manage-labs.php
└── manage-users.php
5
Fazer Login como Admin
Acede a https://seudominio.com/login.php
Username: admin
Password: Admin@CyberLab2024
⚠️ MUDA IMEDIATAMENTE a password do admin após o primeiro login!
6
Configurações Finais de Segurança
- Altera a password do admin em
/profile.php
- No ficheiro
config.php, muda DEBUG_MODE para false
- Activa HTTPS no cPanel (Let's Encrypt) e descomenta as linhas no
.htaccess
- Remove ou protege a pasta
install/ após a instalação
- Certifica-te que o
.htaccess está a bloquear acesso à pasta includes/
🔒 Como Criar Novos Labs
- Faz login como admin
- Vai a
/admin/ → Novo Lab
- Preenche: título, slug, categoria, dificuldade, pontos, flag correcta e conteúdo HTML
- Adiciona dicas (uma por linha) com penalidade de = HINT_PENALTY ?? 25 ?> pontos cada
- Activa o lab e guarda
✅ Os labs suportam HTML completo no campo "Conteúdo" — podes adicionar imagens, código, alertas, listas, tabelas, etc.
🛠️ Personalização
- Tema / Cores: Edita as variáveis CSS em
assets/css/style.css
- Nome da plataforma: Altera
SITE_NAME em config.php
- Pontuação das flags: Altera
FLAG_POINTS_BASE e HINT_PENALTY
- Sessões: Altera
SESSION_LIFETIME (em segundos)
- Novas categorias: Adiciona na tabela
lab_categories via phpMyAdmin ou admin
❓ Resolução de Problemas
- Erro de BD: Verifica as credenciais em
config.php e se o utilizador tem todos os privilégios
- Página em branco: Activa
DEBUG_MODE = true temporariamente para ver erros
- URLs não funcionam: Verifica se
mod_rewrite está activo e o .htaccess está correcto
- Sessão expira depressa: Aumenta
SESSION_LIFETIME em config.php
- Flags não são aceites: Verifica o formato (case-insensitive) e espaços extra
CyberLab v1.0 — Para fins educativos apenas 🛡️