Skip to content

SentinelLAN v1.0.0 - Official Production Release

Choose a tag to compare

View all tags
@zney295 zney295 released this 20 Sep 22:11
· 37 commits to main since this release
v1.0.0
b74cd07

Bộ cài Windows có giao diện — cập nhật 24/10/2026

Nhân viên tải SentinelLAN.Setup.exe, mở bộ cài và nhập mã kết nối một lần do IT cấp.

  • Bộ cài công ty phiên bản 0.2.24, ghim máy chủ https://manager.zney295.id.vn và khóa công khai xác minh lệnh.
  • Setup chứa MSI và Agent; không cần tải Agent.exe riêng cho luồng cài đặt này.
  • Kiểm tra SHA-256 bằng SHA256SUMS-setup.txt. agent-release.json ghi cấu hình công khai.
  • Bộ cài chưa ký Authenticode. Chưa nghiệm thu cài đặt/heartbeat trên máy nhân viên thực tế.
  • Các asset Agent cũ được giữ để tương thích; nội dung v1.0.0 bên dưới là ghi chú lịch sử, không phải kết quả kiểm thử của bộ cài 0.2.24.

SentinelLAN v1.0.0 — Production Release Notes

Release Date: 2026-09-21
Target Environments: Ubuntu 22.04 / 24.04 LTS, Debian 12, Windows 10/11 x64, Windows Server 2022/2025
License: Open Source / Commercial Dual License

1. Giới thiệu tổng quan (Release Highlights)

SentinelLAN v1.0.0 là giải pháp toàn diện kết hợp giữa Quản trị an toàn thiết bị đầu cuối văn phòng (Zero-Trust Endpoint Management) và Quản trị máy chủ đám mây từ xa (Cloud VPS Node Governance). Hệ thống được kiến trúc theo chuẩn Clean Architecture / Modular Monolith, thiết kế Outbound-only và Zero-Knowledge Vault nhằm đảm bảo tính bảo mật, minh bạch và hiệu năng cao nhất.

2. Các Tính Năng Nổi Bật Trong Bản Phát Hành v1.0.0

☁️ 1. Quản trị Cloud VPS từ xa (Agentless SSH Management)

  • Zero-Knowledge Private Key Vault: Mã hóa OpenSSH Private Key bằng thuật toán AES-256-GCM sử dụng khóa bí mật SENTINELLAN_SERVER_VAULT_KEY. Khóa chỉ được giải mã tức thời trong RAM khi thực thi lệnh và hủy ngay khi ngắt kết nối. Tuyệt đối không bao giờ trả khóa về qua API.
  • Giám sát tài nguyên thời gian thực: Định kỳ thu thập các chỉ số kỹ thuật gồm CPU load, RAM sử dụng (free -m), Dung lượng ổ đĩa (df -k /), số lượng Docker containers đang chạy và thời gian hoạt động (Uptime).
  • Tự phục hồi dịch vụ an toàn (Allow-Listed Service Recovery): Hỗ trợ khởi động lại các dịch vụ bị treo hoặc lỗi (Nginx, Docker, Sentinellan-Agent) trực tiếp từ Dashboard có ghi nhận lý do và kiểm toán (Audit Trail) bất biến.

🛡️ 2. Quản trị Endpoint Không Xâm Phạm Quyền Riêng Tư (Privacy-First Endpoint Governance)

  • Least-Privileged Agent: Agent chạy dưới dạng Windows Service hoặc Linux systemd daemon với quyền người dùng tiêu chuẩn, không đòi hỏi Administrator liên tục.
  • Minh bạch thông tin (Employee Transparency View): Nhân viên có thể xem minh bạch mọi thông số công ty đang theo dõi trên máy tính của mình tại /my-device. Cam kết không quay quét màn hình, không theo dõi phím gõ (keylogger), không thu thập tài liệu cá nhân.
  • Safe Simulated Commands: Các lệnh can thiệp (khóa máy, cách ly mạng) mặc định chạy ở chế độ mô phỏng an toàn; chỉ kích hoạt hành vi thật trong môi trường lab được ủy quyền rõ ràng.

🏢 3. Kiến Trúc Đa Tổ Chức (Multi-Tenant SaaS) & Xác Thực Nâng Cao

  • Cô lập Tenant tuyệt đối: Mỗi tổ chức có ranh giới dữ liệu độc lập (ITenantOwned), truy vấn EF Core được bảo vệ bằng Global Query Filters.
  • Bảo mật phiên đăng nhập: HttpOnly cookie kết hợp luồng xoay vòng token (Rotating Refresh Token), CSRF prevention header bắt buộc cho mọi yêu cầu thay đổi trạng thái, và Rate Limiting chống tấn công Brute-force.
  • Realtime Push qua SignalR: Cập nhật trạng thái thiết bị trực tuyến/ngoại tuyến tức thì đến dashboard quản trị viên.

3. Hướng Dẫn Triển Khai Nhanh 1-Click Trên Cloud VPS

Bước 1: Chuẩn bị máy chủ

Thuê một máy chủ VPS (Ubuntu 22.04/24.04 hoặc Debian 12, tối thiểu 2 vCPU, 4GB RAM) và trỏ domain về IP của VPS.

Bước 2: Chạy script cài đặt tự động

git clone https://github.com/psy-zney/SentinelLAN.git
cd SentinelLAN/deploy/vps
sudo bash setup-vps.sh

Script sẽ tự động:

  1. Cài đặt Docker Engine và Docker Compose Plugin chính hãng.
  2. Tạo cấu hình mã hóa bảo mật ngẫu nhiên trong .env.
  3. Build và khởi chạy các container (API .NET 10, Web Next.js 16, PostgreSQL 18, Reverse Proxy Nginx).
  4. Kiểm tra sức khỏe hệ thống (/health/ready) và in thông tin quản trị ra màn hình.

4. Hướng Dẫn Cài Đặt Agent Trên Thiết Bị Quản Lý

Cài đặt trên Windows (PowerShell với quyền Administrator):

.\deploy\agent\install-windows-agent.ps1 -ServerUrl "https://api.yourdomain.com" -EnrollToken "YOUR_ENROLLMENT_TOKEN"

Cài đặt trên Linux VPS / Container (Bash với quyền Root):

sudo bash ./deploy/agent/install-linux-agent.sh --server "https://api.yourdomain.com" --token "YOUR_ENROLLMENT_TOKEN"

5. Kết Quả Kiểm Thử Chất Lượng (Quality Gates Matrix)

Hạng mục kiểm tra Công cụ Kết quả Ghi chú
Backend Unit & Architecture Tests xUnit, .NET 10 85 / 85 Đạt (100%) Bao gồm Domain, Architecture, Agent, Application, Integration tests
Web Typecheck & Lint TypeScript 5.9, ESLint 9 0 Error, 0 Warning Chế độ strict mode, không có cảnh báo nào
Web Unit Tests Vitest 4.1 10 / 10 Đạt (100%) Bao gồm kiểm thử API Client, VPS Node Management, Session Rotation
Production Build Next.js 16 (Turbopack) Hoàn tất (7/7 Static Pages) Tối ưu hóa bundle thành công
Cơ chế mã hóa Vault AES-256-GCM Xác thực toàn vẹn Chống giả mạo tag và bảo vệ Private Key tuyệt đối

6. Danh Mục Tệp Phân Phối (Distribution Assets)

  • SentinelLAN.Agent.exe: Binary Windows Agent x64 SingleFile độc lập.
  • SentinelLAN.Agent: Binary Linux Agent x64 SingleFile daemon.
  • sentinellan-vps-deployment.tar.gz: Trọn gói file cấu hình Nginx, Docker Compose và script triển khai production.
  • SHA256SUMS.txt: Mã băm toàn vẹn mật mã cho tất cả các file phân phối.
Assets 10
Loading