Skip to content

About

O DirectFile é um sistema de transferência de arquivos pensado para permitir que você envie arquivos para seus próprios computadores de qualquer lugar.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

14 Commits

Folders and files

Repository files navigation

DirectFile Logo

DIRECT/FILE

Your computer. Your files. Anywhere.

Um servidor pessoal para enviar arquivos diretamente para seus computadores conectados.





⚡ Sobre o projeto

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

🧠 Arquitetura

                    ┌─────────────────┐
                    │                 │
                    │   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            │
              │                            │
              └────────────────────────────┘

✨ Funcionalidades

🔐 Autenticação

Sistema de autenticação baseado em JWT.

  • Cadastro de usuários
  • Login
  • Token JWT
  • Rotas protegidas
  • Autenticação do cliente SignalR

📁 Gerenciamento de arquivos

API para gerenciamento dos arquivos.

  • Upload
  • Download
  • Listagem
  • Exclusão
  • Compartilhamento temporário

⚡ Sincronização em tempo real

Utilizando SignalR, os clientes conectados podem receber notificações instantâneas.

Arquivo enviado
      ↓
Servidor recebe
      ↓
SignalR notifica
      ↓
Cliente baixa

🖥️ Computadores conectados

O servidor acompanha quais clientes estão conectados.

  • 🟢 DESKTOP-DIOGO
  • 🟢 NOTEBOOK-IFES
  • 🔴 PC-OFFLINE

🛠️ Tecnologias

Tecnologia Função
Backend e API
Comunicação em tempo real
Banco de dados
Autenticação
Documentação da API

📂 Estrutura do projeto

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

🔌 SignalR

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-DIOGO

Assim o servidor consegue identificar quais computadores estão conectados.


🖥️ Sistema de dispositivos

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:

  • ConnectionId
  • UserId
  • DeviceName
  • ConnectedAt

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"
    }
]

📡 Endpoints

🔐 Autenticação

  • POST /api/auth/register
  • POST /api/auth/login

📁 Arquivos

  • GET /api/files
  • POST /api/files/upload
  • GET /api/files/{id}/download
  • POST /api/files/{id}/share
  • DELETE /api/files/{id}

🖥️ Dispositivos

  • GET /api/devices (Retorna os computadores atualmente conectados)

🚀 Executando o projeto

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.Server

3. Restaure as dependências:

dotnet restore

4. Execute:

dotnet run

O servidor iniciará utilizando as configurações do projeto.


⚙️ Configuração

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.


🗺️ Roadmap

✔ Implementado

  • Sistema de autenticação
  • JWT
  • Upload de arquivos
  • Download de arquivos
  • Exclusão de arquivos
  • Compartilhamento temporário
  • Cliente para Windows
  • Comunicação em tempo real
  • Detecção de computadores online

🚧 Próximas etapas

  • Persistência dos computadores cadastrados
  • Status online/offline
  • Seleção do computador de destino
  • Fila de arquivos para computadores offline
  • Sincronização automática quando o computador voltar
  • Histórico de transferências
  • Melhorias na interface
  • Deploy público
  • Cloudflare Tunnel
  • Criptografia de arquivos
  • Cliente com interface gráfica

DIRECT/FILE

Your computer. Your files. Anywhere.


Made by Diogo Teodoro Dias Lamas

About

O DirectFile é um sistema de transferência de arquivos pensado para permitir que você envie arquivos para seus próprios computadores de qualquer lugar.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages