O DirectFile é um sistema de transferência de arquivos pensado para permitir que você envie arquivos para seus próprios computadores de qualquer lugar.
A ideia é simples:
Você está em outro computador e precisa mandar um arquivo para seu PC em casa?
Normalmente seria necessário enviar para algum serviço de nuvem, como Drive ou Dropbox, e depois baixar novamente.
Com o DirectFile, o fluxo é diferente.
┌─────────────────────┐
│ │
│ WEB BROWSER │
│ │
│ Upload a file │
│ │
└──────────┬──────────┘
│
▼
┌─────────────────────┐
│ │
│ DIRECT FILE │
│ SERVER │
│ │
│ Authentication │
│ File management │
│ Device tracking │
│ SignalR Hub │
│ │
└──────────┬──────────┘
│
│ Real-time notification
▼
┌─────────────────────┐
│ │
│ YOUR COMPUTER │
│ │
│ DirectFile Client │
│ │
│ Downloads the file │
│ automatically │
│ │
└─────────────────────┘
O servidor é responsável por:
- 🔐 Autenticação de usuários
- 👤 Cadastro de contas
- 📁 Gerenciamento de arquivos
- ⬆️ Upload de arquivos
- ⬇️ Download de arquivos
- 🔗 Compartilhamento temporário
- 🖥️ Monitoramento de computadores conectados
- ⚡ Comunicação em tempo real utilizando SignalR
- 🔄 Notificação dos clientes quando novos arquivos chegam
┌─────────────────┐
│ │
│ WEB CLIENT │
│ │
└────────┬────────┘
│
│ HTTP / HTTPS
▼
┌────────────────────────────┐
│ │
│ DIRECTFILE.SERVER │
│ │
│ │
│ ASP.NET Core Web API │
│ │
│ ┌──────────────────────┐ │
│ │ Authentication │ │
│ │ JWT │ │
│ └──────────────────────┘ │
│ │
│ ┌──────────────────────┐ │
│ │ Files API │ │
│ │ Upload / Download │ │
│ └──────────────────────┘ │
│ │
│ ┌──────────────────────┐ │
│ │ SignalR Sync Hub │ │
│ └──────────┬───────────┘ │
│ │ │
└─────────────┼──────────────┘
│
│ Real-time
▼
┌────────────────────────────┐
│ │
│ DIRECTFILE.CLIENT │
│ │
│ User's PC │
│ │
└────────────────────────────┘
|
Sistema de autenticação baseado em JWT.
|
API para gerenciamento dos arquivos.
|
|
Utilizando SignalR, os clientes conectados podem receber notificações instantâneas. Arquivo enviado
↓
Servidor recebe
↓
SignalR notifica
↓
Cliente baixa
|
O servidor acompanha quais clientes estão conectados.
|
| Tecnologia | Função |
|---|---|
|
|
Backend e API |
|
|
Comunicação em tempo real |
|
|
Banco de dados |
|
|
Autenticação |
|
|
Documentação da API |
DirectFile.Server
│
├── Controllers
│ ├── AuthController.cs
│ ├── FilesController.cs
│ └── DevicesController.cs
│
├── Data
│ └── AppDbContext.cs
│
├── Hubs
│ └── SyncHub.cs
│
├── Services
│ └── ConnectedClientsTracker.cs
│
├── Models
│
├── wwwroot
│ └── index.html
│
├── Program.cs
├── appsettings.json
└── directfile.db
O servidor possui um Hub responsável pela comunicação em tempo real:
/hubs/sync
Quando um cliente conecta:
DirectFile Client
│
│ JWT Token
│
▼
/hubs/sync
│
▼
SyncHub
│
▼
ConnectedClientsTracker
O cliente também envia o nome do computador durante a conexão. Exemplo:
/hubs/sync?deviceName=DESKTOP-DIOGOAssim o servidor consegue identificar quais computadores estão conectados.
Os computadores conectados são monitorados pelo ConnectedClientsTracker.
Ele mantém as conexões ativas em memória:
ConcurrentDictionary<string, ConnectedDevice>Cada conexão contém:
ConnectionIdUserIdDeviceNameConnectedAt
A API pode retornar os dispositivos conectados através de:
GET /api/devices
Exemplo:
[
{
"deviceName": "DESKTOP-DIOGO",
"connectedAt": "2026-08-28T10:20:00Z"
},
{
"deviceName": "NOTEBOOK-IFES",
"connectedAt": "2026-08-28T11:10:00Z"
}
]🔐 Autenticação
POST /api/auth/registerPOST /api/auth/login
📁 Arquivos
GET /api/filesPOST /api/files/uploadGET /api/files/{id}/downloadPOST /api/files/{id}/shareDELETE /api/files/{id}
🖥️ Dispositivos
GET /api/devices(Retorna os computadores atualmente conectados)
1. Clone o repositório:
git clone [https://github.com/TheTekig/DirectFile.Server.git](https://github.com/TheTekig/DirectFile.Server.git)2. Entre na pasta:
cd DirectFile.Server3. Restaure as dependências:
dotnet restore4. Execute:
dotnet runO servidor iniciará utilizando as configurações do projeto.
Configure a chave JWT no arquivo appsettings.json.
Exemplo:
{
"Jwt": {
"Key": "SUA_CHAVE_SECRETA_AQUI"
}
}
⚠️ Atenção: Em produção, nunca deixe a chave JWT exposta em um repositório público.
|
|
