[Open Source] #137 - Filestash: Hệ thống quản trị tệp tin đa năng với kiến trúc Plugin-driven, Go Backend và tư duy Frontend "Zero-framework" tối ưu

Việc quản lý dữ liệu rải rác trên nhiều nền tảng (S3, FTP, Google Drive, SFTP) thường khiến người dùng phải cài đặt hàng loạt ứng dụng khác nhau. Filestash giải quyết bài toán này bằng cách xây dựng một "Cổng kết nối duy nhất" (Unified Gateway), cho phép truy cập, chỉnh sửa và quản lý mọi nguồn lưu trữ thông qua một giao diện web siêu nhanh và linh hoạt.

Dưới góc độ kỹ thuật, Filestash là một minh chứng xuất sắc cho việc kết hợp giữa hiệu năng của Go, sự tối giản của Vanilla JS và một kiến trúc Plugin-driven cực kỳ cực đoan.

Github: https://github.com/mickael-kerjean/filestash

🛠️ 1. Nền tảng công nghệ: Go Backend và Triết lý Frontend "Zero-framework"

Filestash chọn những công nghệ ưu tiên tốc độ phản hồi ("snappy") và khả năng kiểm soát tuyệt đối tài nguyên:

• Backend (Golang): Tận dụng khả năng xử lý đồng thời (Concurrency) của Go để xử lý hàng nghìn luồng I/O tệp tin. Toàn bộ backend được biên dịch thành một file thực thi duy nhất, tích hợp sẵn các driver cho FTP, SFTP, WebDAV, S3, và Minio.
• Frontend (Vanilla JS & Web Components): Khác biệt hoàn toàn với xu hướng hiện đại, Filestash nói không với React/Vue. Dự án sử dụng JavaScript thuần kết hợp với Custom Elements (Web Components). Điều này giúp giao diện có kích thước cực nhẹ, tốc độ render tức thì và không bị lỗi thời theo vòng đời của các framework.
• High-performance Image Processing (CGO): Sử dụng C-bindings để liên kết trực tiếp với các thư viện C gốc như libvips, libjpeg, libraw. Kỹ thuật này cho phép Filestash tạo thumbnail và xử lý ảnh (RAW, PSD, AI) nhanh hơn gấp nhiều lần so với các thư viện thuần Go.
• WebAssembly (WASM): Sử dụng WASM để đưa các thư viện xử lý tệp tin nặng (vốn viết bằng C++) lên chạy trực tiếp trên trình duyệt, giúp giảm tải tối đa cho server.

🏗️ 2. Trụ cột kiến trúc: Trừu tượng hóa lưu trữ (IBackend) và VFS

Kiến trúc của Filestash được xây dựng dựa trên sự trừu tượng hóa tuyệt đối:

• IBackend Interface: Filestash định nghĩa một bộ giao tiếp chuẩn (Ls, Stat, Cat, Save, Rm). Bất kể nguồn lưu trữ phía sau là gì, lõi (Core) của Filestash chỉ nhìn thấy một giao diện tệp tin duy nhất. Logic thực thi chi tiết (ví dụ: gọi S3 API hay lệnh FTP) được đóng gói hoàn toàn trong các plugin.
• Storage Gateway Model: Filestash không chỉ là trình xem file; nó hoạt động như một Gateway. Nó có khả năng biến một Bucket S3 thành một Endpoint SFTP hoặc cung cấp dữ liệu qua giao thức MCP (Model Context Protocol) để các mô hình AI (LLM) có thể "đọc" trực tiếp dữ liệu từ các server cũ.
• Dynamic UI Patching: Hệ thống cho phép các plugin "vá" (patch) trực tiếp vào giao diện người dùng. Ví dụ: Một plugin xử lý file 3D có thể tự động chèn thêm nút "Rotate" hoặc "Render" vào thanh công cụ mà không cần sửa đổi mã nguồn chính.

🔄 3. Workflow: Từ UI đến các nguồn lưu trữ hỗn hợp (Sequence Diagram)

Sơ đồ mô tả quy trình Filestash điều phối một yêu cầu liệt kê tệp tin xuyên suốt các nền tảng:

⚡ 4. Các kỹ thuật "Pro-level" trong mã nguồn

1. XDG-Open Logic (MIME-based Rendering): Filestash tích hợp trình xem cho hàng trăm định dạng: từ ảnh y tế (DICOM), file kỹ thuật (Parquet, Avro, HDF5) đến các file thiết kế (Sketch, FBX, GLTF). Hệ thống tự động quyết định trình xem dựa trên MIME type thông qua một "render pipeline" cực kỳ linh hoạt.
2. Workflow Automation Engine: Cho phép người dùng thiết lập các quy tắc tự động hóa (Triggers & Actions). Ví dụ: "Nếu có file .pdf mới tải lên thư mục X -> Tự động gọi API bên thứ ba để trích xuất văn bản".
3. Full-text Search & Metadata Indexing: Sử dụng các plugin như mattn/go-sqlite3 để lập chỉ mục metadata và audit log, cho phép tìm kiếm toàn văn xuyên suốt các server FTP hoặc S3 vốn không hỗ trợ tìm kiếm mạnh mẽ.
4. Security Hardening: Tích hợp sẵn cơ chế quét virus qua ClamAV, hỗ trợ Audit log chi tiết (theo dõi ai đã xem/sửa file nào) và cơ chế khóa truy cập (ACL) ở tầng Gateway.

⚖️ 5. So sánh chiến lược

✅ Kết luận: Tại sao Filestash là hình mẫu cho quản trị dữ liệu hiện đại?

Filestash chứng minh rằng một dự án không cần các framework phức tạp để mang lại trải nghiệm người dùng đẳng cấp. Bằng cách tập trung vào hiệu năng của Go và tính trừu tượng hóa của kiến trúc Plugin, dự án đã biến việc quản lý dữ liệu hỗn hợp thành một trải nghiệm đồng nhất và an toàn.

Đối với các kỹ sư Backend và Architect, nghiên cứu Filestash giúp bạn hiểu sâu về:

• Cách xây dựng Storage Abstraction Layer cực mạnh với Go.
• Tư duy thiết kế Frontend hiệu năng cao không phụ thuộc framework.
• Kỹ thuật xây dựng Gateway để hiện đại hóa các giao thức lưu trữ cũ (Legacy).