Lannamokia_vhdmount/VHDSelectServer

VHD选择服务器 - 跨平台版本

一个现代化的跨平台VHD关键词管理服务器，提供Web GUI界面和HTTP API接口。

✨ 特性

• 🌐 跨平台支持: 支持Windows、Linux、macOS
• 🎨 现代化Web界面: 响应式设计，支持移动设备
• 🔧 RESTful API: 标准HTTP API接口
• 💾 持久化存储: 自动保存配置到JSON文件
• 🚀 零配置启动: 开箱即用
• 📱 实时更新: 界面自动刷新状态
• 🔒 输入验证: 安全的用户输入处理

🛠️ 系统要求

Node.js版本（推荐）

• Node.js 14.0+
• npm（随Node.js安装）

Python版本（备选）

• Python 3.6+
• 无需额外依赖

🚀 快速开始

方法1: Docker部署（推荐）

1. 一键部署脚本（最简单）

   # Windows
   deploy.bat
   
   # Linux/macOS
   chmod +x deploy.sh
   ./deploy.sh
   

2. 使用Docker Compose

   # 构建并启动服务
   docker-compose up -d
   
   # 查看日志
   docker-compose logs -f
   
   # 停止服务
   docker-compose down
   

3. 使用Docker命令

   # 运行容器（配置持久化）
   docker run -d \
     --name vhd-select-server \
     -p 8080:8080 \
     -v $(pwd)/config:/app/config \
     lty271104/vhd-select-server:latest
   

方法2: Node.js版本

1. 安装Node.js

   • 访问 https://nodejs.org/
   • 下载并安装LTS版本

2. 启动服务器

   # 双击运行
   start.bat
   
   # 或者命令行运行
   npm install
   npm start
   

方法3: Python版本

# 直接运行Python服务器
python server.py

# 或指定端口
python server.py 8080

🌐 访问界面

服务器启动后，访问以下地址：

• Web界面: http://localhost:8080
• API文档: http://localhost:8080/api/status

📡 API接口

获取当前VHD关键词

GET /api/boot-image-select

响应示例:

{
  "success": true,
  "BootImageSelected": "SDEZ",
  "timestamp": "2025-10-19T03:05:33.486615"
}

设置VHD关键词

POST /api/set-vhd
Content-Type: application/json

{
  "BootImageSelected": "NEW_KEYWORD"
}

响应示例:

{
  "success": true,
  "BootImageSelected": "NEW_KEYWORD",
  "message": "VHD关键词更新成功"
}

服务器状态

GET /api/status

响应示例:

{
  "success": true,
  "status": "running",
  "BootImageSelected": "SDEZ",
  "timestamp": "2025-10-19T03:05:33.486615",
  "version": "1.0.0"
}

🎯 使用说明

Web界面操作

1. 查看当前状态: 页面会显示服务器运行状态和当前VHD关键词
2. 设置新关键词: 在输入框中输入新的VHD关键词，点击"更新"按钮
3. 自动刷新: 页面每30秒自动刷新状态
4. 实时反馈: 操作结果会立即显示在界面上

配置持久化

• Docker部署: 配置保存在 /app/config/vhd-config.json，通过卷映射到主机的 ./config 目录
• 本地部署: 配置保存在项目根目录的 vhd-config.json 文件中
• 环境变量: 可通过 CONFIG_PATH 环境变量自定义配置文件路径

Docker相关

环境变量

• PORT: 服务端口（默认: 8080）
• CONFIG_PATH: 配置文件目录路径（默认: /app/config）
• NODE_ENV: 运行环境（默认: production）

数据卷

• /app/config: 配置文件持久化目录
• /app/data: 数据文件持久化目录（可选）

健康检查

• 端点: http://localhost:8080/api/status
• 间隔: 30秒
• 超时: 10秒
• 重试: 3次

故障排除

如果Docker部署遇到问题，请参考 Docker故障排除指南

命令行测试

# 获取当前VHD关键词
curl http://localhost:8080/api/boot-image-select

# 设置新的VHD关键词
curl -X POST http://localhost:8080/api/set-vhd \
     -H "Content-Type: application/json" \
     -d '{"BootImageSelected":"CUSTOM_VHD"}'

📁 文件结构

VHDSelectServer/
├── server.js          # Node.js服务器
├── server.py          # Python服务器
├── package.json       # Node.js依赖配置
├── start.bat          # Windows启动脚本
├── public/
│   └── index.html     # Web界面
├── vhd-config.json    # 配置文件（自动生成）
└── README.md          # 说明文档

🔧 配置说明

• 端口: 默认8080，可通过环境变量PORT修改
• 配置文件: vhd-config.json自动生成，存储当前VHD关键词
• 日志: 服务器会在控制台输出访问日志

🔗 与VHD挂载程序集成

此服务器与原有的VHD挂载程序完全兼容：

1. API兼容: 保持原有的/api/boot-image-select接口
2. 数据格式: 返回相同的JSON格式
3. 配置持久化: VHD关键词会自动保存和恢复

🛡️ 安全特性

• 输入验证: 自动验证和清理用户输入
• CORS支持: 支持跨域请求
• 错误处理: 完善的错误处理和用户反馈
• 格式标准化: 自动转换为大写格式

🐛 故障排除

端口被占用

# 检查端口占用
netstat -ano | findstr :8080

# 使用其他端口
python server.py 8081

Node.js未安装

• 下载安装: https://nodejs.org/
• 使用Python版本作为备选方案

权限问题

• 确保有写入配置文件的权限
• 在管理员模式下运行（如需要）

📝 更新日志

v1.0.0

• ✅ 跨平台支持（Node.js + Python）
• ✅ 现代化Web界面
• ✅ RESTful API接口
• ✅ 用户自定义VHD关键词
• ✅ 配置持久化存储
• ✅ 实时状态更新

🤝 技术支持

如有问题，请检查：

1. 服务器是否正常启动
2. 端口是否被占用
3. 防火墙设置
4. 浏览器控制台错误信息

---

🎉 享受使用全新的跨平台VHD选择服务器！