VPS Manager - Hiếu Dz

Based on DuckNoVis Technology
Domain: hieuvn.xyz/*

🚀 Giới thiệu

VPS Manager là một hệ thống quản lý VPS tự động được phát triển bởi Hiếu Dz, dựa trên công nghệ của DuckNoVis. Hệ thống cho phép tạo và quản lý VPS Windows thông qua GitHub Actions một cách hoàn toàn tự động.

✨ Tính năng

• 🖥️ VPS Windows Server với giao diện đồ họa đầy đủ
• 🌐 Truy cập qua Web sử dụng noVNC
• 🔄 Tự động khởi động lại sau 5.5 giờ
• 🛡️ Bảo mật với mật khẩu tùy chỉnh
• 📱 Giao diện hiện đại và responsive
• ⚡ Triển khai nhanh chóng trên Vercel

🏗️ Cấu trúc dự án

vps-manager/
├── api/
│   ├── create-vps.js      # API tạo VPS
│   ├── vpsuser.js         # API quản lý người dùng
│   └── index.js           # API chính (fallback)
├── public/
│   └── index.html         # Giao diện web chính
├── package.json           # Dependencies
├── vercel.json           # Cấu hình Vercel
├── next.config.js        # Cấu hình Next.js
└── README.md             # Tài liệu này

🛠️ Cài đặt và triển khai

1. Clone dự án

git clone <repository-url>
cd vps-manager

2. Cài đặt dependencies

npm install

3. Chạy local (development)

npm run dev

4. Triển khai lên Vercel

1. Push code lên GitHub repository
2. Kết nối repository với Vercel
3. Deploy tự động sẽ được kích hoạt
4. Domain sẽ có dạng: https://your-project.vercel.app

5. Cấu hình domain tùy chỉnh

• Trong Vercel Dashboard, vào Settings > Domains
• Thêm domain hieuvn.xyz hoặc subdomain
• Cấu hình DNS records theo hướng dẫn

📋 Yêu cầu

GitHub Token

• Cần có Personal Access Token từ GitHub
• Token phải có quyền:
  • repo (full repository access)
  • workflow (workflow permissions)
  • write:packages (nếu cần)

Tạo GitHub Token

1. Vào GitHub Settings > Developer settings > Personal access tokens
2. Generate new token (classic)
3. Chọn scopes cần thiết
4. Copy token và sử dụng trong ứng dụng

🔧 API Endpoints

POST /api/create-vps

Tạo VPS mới

Body:

{
  "github_token": "ghp_xxxxxxxxxxxxxxxxxxxx"
}

Response:

{
  "status": "success",
  "message": "VPS creation initiated successfully",
  "repository": "user/vps-project-xxxxx",
  "workflow_status": "triggered"
}

GET /api/vpsuser

Lấy danh sách VPS đang hoạt động

Response:

{
  "status": "success",
  "total": 2,
  "users": [
    {
      "token": "ghp_1234567***",
      "link": "https://xxxxx.trycloudflare.com/vnc.html"
    }
  ]
}

POST /api/vpsuser

Lưu hoặc lấy thông tin VPS user

🎯 Cách sử dụng

1. Truy cập website: https://hieuvn.xyz hoặc domain đã cấu hình
2. Nhập GitHub Token: Token phải có đủ quyền
3. Nhấn "Tạo VPS": Hệ thống sẽ tự động:
   • Tạo repository mới trên GitHub
   • Thiết lập workflow
   • Khởi động VPS Windows
   • Trả về link truy cập
4. Truy cập VPS: Mở link trong tab mới, mật khẩu: hieudz

🔐 Bảo mật

• Tất cả repository được tạo ở chế độ private
• GitHub Token chỉ được sử dụng server-side
• CORS được cấu hình chỉ cho phép domain hieuvn.xyz
• Mật khẩu VNC mặc định: hieudz

⚠️ Lưu ý quan trọng

• GitHub Actions limits: GitHub có giới hạn về thời gian chạy workflow
• VPS lifetime: VPS sẽ tự động tắt sau ~5.5 giờ và khởi động lại
• Storage: Không có persistent storage, dữ liệu sẽ mất khi restart
• Performance: Phù hợp cho testing, development, không dùng production

🛠️ Customization

Thay đổi mật khẩu VNC

Sửa trong file api/create-vps.js:

VALUE_OF_PASSWORD=your-new-password

Thay đổi thời gian chạy

Sửa biến $totalMinutes trong workflow:

$totalMinutes = 330  # 5.5 giờ

Thêm software

Thêm các lệnh cài đặt trong phần workflow setup.

🎨 Giao diện

• Framework: Pure HTML/CSS/JavaScript
• Design: Modern gradient design với glassmorphism
• Icons: Font Awesome 6
• Fonts: Inter (Google Fonts)
• Responsive: Hỗ trợ mobile và desktop

📝 Changelog

Version 1.0.0

• ✅ Giao diện web hoàn chỉnh
• ✅ API tạo VPS tự động
• ✅ Quản lý danh sách VPS
• ✅ Auto-restart workflow
• ✅ Cloudflare Tunnel integration
• ✅ Vercel deployment ready

👨‍💻 Tác giả

Hiếu Dz

• Website: hieuvn.xyz
• Based on: DuckNoVis Technology

📄 License

MIT License - Tự do sử dụng và chỉnh sửa

🆘 Hỗ trợ

Nếu gặp vấn đề, vui lòng:

1. Kiểm tra GitHub Token có đủ quyền
2. Xem logs trong GitHub Actions
3. Đảm bảo repository không bị rate limit

---

Developed with ❤️ by Hiếu Dz | Based on DuckNoVis Technology