Skip to content

Architecture Overview ​

System Architecture ​

┌──────────────────────────────────────────────────────────────────┐
│                   User Interface Layer                            │
│   Web UI (React)  ·  S3 Clients (rclone, AWS CLI)  ·  WebDAV    │
└──────────────┬──────────────────────┬────────────────┬───────────┘
               │                      │                │
        ┌──────▼──────┐       ┌──────▼──────┐  ┌─────▼──────┐
        │  REST API   │       │  S3 API     │  │  WebDAV    │
        │  :5212      │       │  :5213      │  │  :5214     │
        └──────┬──────┘       └──────┬──────┘  └─────┬──────┘
               │                      │                │
        ┌──────▼──────────────────────▼────────────────▼──────┐
        │                    Gin Router                        │
        │         Middleware: CORS → Auth → Rate Limit         │
        └──────────┬───────────────────────────────────────────┘
                   │
        ┌──────────▼───────────────────────────────────────────┐
        │                    Service Layer                      │
        │  Auth · File Management · Space Management · Shares  │
        └──────────┬───────────────────────────────────────────┘
                   │
        ┌──────────▼───────────────────────────────────────────┐
        │                 Storage Abstraction                   │
        │         In-Memory FileSystem (Inode + Block-based)    │
        │  ┌──────────┐ ┌──────────┐ ┌──────────────────────┐  │
        │  │ RAM      │ │ VRAM    │ │ Swap/Persist         │  │
        │  │ Driver   │ │ Driver  │ │ Layer (optional)     │  │
        │  └────┬─────┘ └────┬─────┘ └──────────────────────┘  │
        └───────┼─────────────┼─────────────────────────────────┘
                │             │
        ┌───────▼─────────────▼─────────────────────────────────┐
        │              Device Management Layer                   │
        │  mmap / VirtualAlloc / CUDA / NVML                     │
        └───────────────────────────────────────────────────────┘

Port Map ​

PortServiceDescription
5212REST API + Web UIMain port for HTTP API and frontend
5213S3 APIAWS S3-compatible protocol
5214WebDAVWebDAV protocol

Tech Stack ​

LayerTechnology
BackendGo 1.22+, Gin, ent, golang.org/x/net/webdav
FrontendReact 18, TypeScript, Ant Design 5, Zustand, Vite
DatabaseSQLite / PostgreSQL (metadata only)
RAMmmap (Linux/macOS) / VirtualAlloc (Windows)
VRAMCUDA + NVML (stub, ready for integration)

Apache License 2.0