Repository navigation
Releases: zney295/SentinelLAN
Release list
SentinelLAN Setup v1.0.4
Bộ cài Windows x64: SentinelLAN.Setup.exe. Chỉ cần tải một tệp này, mở bằng quyền quản trị và nhập mã kết nối mới do IT cấp.
- Setup và Agent được build cùng source, cùng phiên bản và ghim máy chủ
https://manager.zney295.id.vn. - Command key ID:
20261009-admin-employee-97dba4. Giữ public key từ bộ cài công ty 0.2.24 đã đối chiếu checksum; không chứa khóa riêng. - Khắc phục lỗi MSI 1939 của bộ cài 0.2.24: cấu hình service recovery bằng sc.exe sau cài đặt.
- Máy đã có identity dùng luồng khôi phục kết nối, không tiêu thụ lại mã cũ.
- Agent/backend không cần trùng số phiên bản khi cùng giao thức ký request; API tùy chọn 404/405 không chặn heartbeat. Không hạ cấp xác thực để tương thích.
- Biến môi trường/CLI được chỉ định rõ ưu tiên hơn cấu hình mặc định của bộ cài; bản công ty vẫn ghim đúng HTTPS.
- Docker web cài đầy đủ dependency UI dùng chung; release bắt buộc build và kiểm tra HTTP trang đăng nhập Company/Employee từ image sạch.
- Không phát hành MSI hoặc Agent.exe rời. EXE chứa trọn gói Agent, MSI nội bộ đã sửa và trình cấu hình.
- Kiểm tra tự động: Agent tests trên Linux/Windows, các nhánh enrollment/resume với service mock, đối chiếu cấu hình và hash payload, cài/gỡ gói trên Windows runner. Chưa thay thế nghiệm thu enrollment/heartbeat trên máy nhân viên thực tế.
- Bộ cài chưa ký Authenticode. Link tải trên VPS cũ không tự được cập nhật bởi GitHub Release.
Source commit: af4fb1d3860f7623f49529c5f6ce01d0c9334350
SHA-256 của SentinelLAN.Setup.exe:
4d51d11220962c0bd878f8719955cb226b99f952688221a197e278e7fd9ef320
SentinelLAN Setup v1.0.3
Bộ cài Windows x64: SentinelLAN.Setup.exe. Chỉ cần tải một tệp này, mở bằng quyền quản trị và nhập mã kết nối mới do IT cấp.
- Setup và Agent được build cùng source, cùng phiên bản và ghim máy chủ
https://manager.zney295.id.vn. - Command key ID:
20261009-admin-employee-97dba4. Giữ public key từ bộ cài công ty 0.2.24 đã đối chiếu checksum; không chứa khóa riêng. - Khắc phục lỗi MSI 1939 của bộ cài 0.2.24: cấu hình service recovery bằng sc.exe sau cài đặt.
- Máy đã có identity dùng luồng khôi phục kết nối, không tiêu thụ lại mã cũ.
- Agent/backend không cần trùng số phiên bản khi cùng giao thức ký request; API tùy chọn 404/405 không chặn heartbeat. Không hạ cấp xác thực để tương thích.
- Biến môi trường/CLI được chỉ định rõ ưu tiên hơn cấu hình mặc định của bộ cài; bản công ty vẫn ghim đúng HTTPS.
- Không phát hành MSI hoặc Agent.exe rời. EXE chứa trọn gói Agent, MSI nội bộ đã sửa và trình cấu hình.
- Kiểm tra tự động: Agent tests trên Linux/Windows, các nhánh enrollment/resume với service mock, đối chiếu cấu hình và hash payload, cài/gỡ gói trên Windows runner. Chưa thay thế nghiệm thu enrollment/heartbeat trên máy nhân viên thực tế.
- Bộ cài chưa ký Authenticode. Link tải trên VPS cũ không tự được cập nhật bởi GitHub Release.
Source commit: 2cc000f93d0f81ac5b8562586cc9253a38bdd6ee
SHA-256 của SentinelLAN.Setup.exe:
b64ca6dc15a0e0fe19f0b259b2ddeb08637d481930b689d8f4ce436e6a2e70c0
SentinelLAN Setup v1.0.2
Bộ cài Windows x64: SentinelLAN.Setup.exe. Chỉ cần tải một tệp này, mở bằng quyền quản trị và nhập mã kết nối mới do IT cấp.
- Setup và Agent được build cùng source, cùng phiên bản và ghim máy chủ
https://manager.zney295.id.vn. - Command key ID:
20261009-admin-employee-97dba4. Giữ public key từ bộ cài công ty 0.2.24 đã đối chiếu checksum; không chứa khóa riêng. - Khắc phục lỗi MSI 1939 của bộ cài 0.2.24: cấu hình service recovery bằng sc.exe sau cài đặt.
- Máy đã có identity dùng luồng khôi phục kết nối, không tiêu thụ lại mã cũ.
- Agent/backend không cần trùng số phiên bản khi cùng giao thức ký request; API tùy chọn 404/405 không chặn heartbeat. Không hạ cấp xác thực để tương thích.
- Biến môi trường/CLI được chỉ định rõ ưu tiên hơn cấu hình mặc định của bộ cài; bản công ty vẫn ghim đúng HTTPS.
- Không phát hành MSI hoặc Agent.exe rời. EXE chứa trọn gói Agent, MSI nội bộ đã sửa và trình cấu hình.
- Kiểm tra tự động: Agent tests trên Linux/Windows, các nhánh enrollment/resume với service mock, đối chiếu cấu hình và hash payload, cài/gỡ gói trên Windows runner. Chưa thay thế nghiệm thu enrollment/heartbeat trên máy nhân viên thực tế.
- Bộ cài chưa ký Authenticode. Link tải trên VPS cũ không tự được cập nhật bởi GitHub Release.
Source commit: 0ccb979168ed6ac5cc6144420abb5784d80fb62d
SHA-256 của SentinelLAN.Setup.exe:
fc5c8409376a37f044cd1ddf86fe02c158f5e95fb1a0b7f93331b2d539f1fab8
SentinelLAN Setup v1.0.1
Bộ cài Windows x64: SentinelLAN.Setup.exe. Chỉ cần tải một tệp này, mở bằng quyền quản trị và nhập mã kết nối mới do IT cấp.
- Setup và Agent được build cùng source, cùng phiên bản và ghim máy chủ
https://manager.zney295.id.vn. - Command key ID:
20261009-admin-employee-97dba4. Giữ public key từ bộ cài công ty 0.2.24 đã đối chiếu checksum; không chứa khóa riêng. - Khắc phục lỗi MSI 1939 của bộ cài 0.2.24: cấu hình service recovery bằng sc.exe sau cài đặt.
- Máy đã có identity dùng luồng khôi phục kết nối, không tiêu thụ lại mã cũ.
- Không phát hành MSI hoặc Agent.exe rời. EXE chứa trọn gói Agent, MSI nội bộ đã sửa và trình cấu hình.
- Kiểm tra tự động: Agent tests trên Linux/Windows, các nhánh enrollment/resume với service mock, đối chiếu cấu hình và hash payload, cài/gỡ gói trên Windows runner. Chưa thay thế nghiệm thu enrollment/heartbeat trên máy nhân viên thực tế.
- Bộ cài chưa ký Authenticode. Link tải trên VPS cũ không tự được cập nhật bởi GitHub Release.
Source commit: 55e09ee2ab1e0433b7f7c3925ce07184964f8ab0
SHA-256 của SentinelLAN.Setup.exe:
19d0e9a4d2d6b879bb5bbfcd71ea49187612d695fde13691cee13ca5c9804c62
SentinelLAN v1.0.0 - Official Production Release
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.jsonghi 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-GCMsử dụng khóa bí mậtSENTINELLAN_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.shScript sẽ tự động:
- Cài đặt Docker Engine và Docker Compose Plugin chính hãng.
- Tạo cấu hình mã hóa bảo mật ngẫu nhiên trong
.env. - Build và khởi chạy các container (API .NET 10, Web Next.js 16, PostgreSQL 18, Reverse Proxy Nginx).
- 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.