# Elysian Images

**Repository Path**: imbacloud/win-elysian

## Basic Information

- **Project Name**: Elysian Images
- **Description**: 用于展示定制的win系统镜像和收集的官方系统镜像
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-30
- **Last Updated**: 2025-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Elysian Images

一个基于Vue 3的现代化Web应用，提供IP类型检测和S3下载地址生成等功能。

## 功能特性

- **IP类型检测**：通过浏览器原生API自动检测访问者的IP类型（IPv4/IPv6），无需依赖第三方服务
- **S3下载地址生成**：支持按北京时间0点5分自动切换日期的下载地址生成
- **全球访问自动切换**：根据用户区域自动选择合适的S3基础URL
- **响应式设计**：适配各种设备屏幕尺寸
- **三级配置管理**：灵活的配置加载机制，支持通过配置文件轻松切换环境

## 技术栈

- **前端框架**：Vue 3
- **构建工具**：Vite
- **网络请求**：浏览器原生Fetch API
- **检测技术**：WebRTC API、正则表达式匹配

## 安装与运行

### 前置要求

- Node.js 14.18+ 或 16+
- npm 或 yarn

### 安装步骤

1. 克隆项目
```bash
git clone <项目仓库地址>
cd win-elysian
```

2. 安装依赖
```bash
npm install
```

3. 本地开发
```bash
npm run dev
```

4. 构建生产版本
```bash
npm run build
```

5. 预览生产构建
```bash
npm run preview
```

## 项目结构

```
/root/code/win-elysian/
├── public/           # 静态资源目录
│   └── config.json   # 应用配置文件
├── src/
│   ├── assets/       # 资源文件
│   ├── components/   # 组件目录
│   ├── App.vue       # 主应用组件
│   └── main.js       # 应用入口文件
├── index.html        # HTML入口
├── package.json      # 项目配置和依赖
├── vite.config.js    # Vite配置
└── README.md         # 项目说明
```

## 配置说明

项目使用`public/config.json`文件进行配置管理，主要配置项：

- `s3BaseUrl`: S3基础URL，可根据部署环境修改

## 使用指南

### IP类型检测

应用会在页面加载时自动检测用户的IP类型和连接信息，并在页面顶部显示结果。如果需要重新检测，可以调用`recheckIPType()`方法。

### 外部API

应用通过`defineExpose`暴露以下方法供外部组件使用：

- `getVisitorIPType()`: 获取访问者的IP类型（IPv4/IPv6/未知）
- `recheckIPType()`: 重新执行IP类型检测

## 部署

项目支持Docker容器化部署，提供了`Dockerfile`和`deploy.yaml`配置文件。

## 许可证

MIT License