README.md

Mirror Web

复旦大学开源软件镜像站前端项目

简介

本项目是复旦大学开源软件镜像站的前端展示页面，基于 VitePress 构建，提供镜像列表展示、实时同步状态查询等功能。

功能特性

• 📦 镜像列表展示与搜索
• 🔄 实时同步状态监控
• 📊 镜像大小与更新时间显示
• 🎨 现代化响应式设计
• ⚡ 快速导航与键盘快捷键支持（按 / 快速搜索）

技术栈

• VitePress - 静态站点生成器
• Vue 3 - 前端框架
• Nginx - Web 服务器
• tunasync - 镜像同步管理

快速开始

安装依赖

npm install

本地开发

npm run docs:dev

访问 http://localhost:18080/ 查看开发环境页面。

构建生产版本

npm run docs:build

构建后的文件将输出到 docs/.vitepress/dist 目录。

预览生产版本

npm run docs:preview

目录结构

.
├── docs/                   # VitePress 文档目录
│   ├── .vitepress/        # VitePress 配置
│   ├── index.md           # 首页（镜像列表）
│   ├── help.md            # 使用帮助
│   ├── about.md           # 关于页面
│   └── status.md          # 同步状态
├── fancyindex-theme/      # Nginx FancyIndex 主题
│   ├── header.html        # 页头
│   ├── footer.html        # 页脚
│   └── style.css          # 样式文件
└── package.json           # 项目依赖配置

部署说明

Nginx 配置

项目需要配合 Nginx 的 FancyIndex 模块使用，用于展示镜像文件列表。

静态文件部署

1. 构建项目：npm run docs:build
2. 将 docs/.vitepress/dist 目录部署到 Web 服务器
3. 配置 Nginx 反向代理和静态文件服务

贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支：git checkout -b feature/your-feature
3. 提交更改：git commit -am 'Add some feature'
4. 推送到分支：git push origin feature/your-feature
5. 提交 Pull Request

联系我们

• 问题反馈：GitHub Issues
• 邮箱：support@fducslg.com
• QQ 群：926958092

许可证

MIT License

Copyright (c) 2024 Fudan University Open Source Community