docs: 更新readme.md
This commit is contained in:
51
README.md
51
README.md
@@ -5,7 +5,8 @@
|
|||||||
## 功能特性
|
## 功能特性
|
||||||
|
|
||||||
- ✅ 管理员登录(密码:admin123)
|
- ✅ 管理员登录(密码:admin123)
|
||||||
- ✅ App上传(支持.apk、.ipa、.zip文件,最大100MB)
|
- ✅ App上传(支持.apk、.ipa、.zip文件,最大1GB)
|
||||||
|
- ✅ App删除功能
|
||||||
- ✅ 无需登录即可下载
|
- ✅ 无需登录即可下载
|
||||||
- ✅ 响应式设计
|
- ✅ 响应式设计
|
||||||
- ✅ 纯前端实现,无框架依赖
|
- ✅ 纯前端实现,无框架依赖
|
||||||
@@ -13,7 +14,16 @@
|
|||||||
|
|
||||||
## 快速开始
|
## 快速开始
|
||||||
|
|
||||||
### 1. 启动前端服务
|
### 1. 启动后端服务
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd background
|
||||||
|
go run main.go
|
||||||
|
```
|
||||||
|
|
||||||
|
后端服务将在 http://localhost:6903 上运行
|
||||||
|
|
||||||
|
### 2. 启动前端服务
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 使用Python启动简单HTTP服务器
|
# 使用Python启动简单HTTP服务器
|
||||||
@@ -27,7 +37,7 @@ npx http-server -p 8000
|
|||||||
|
|
||||||
#### 后端要求
|
#### 后端要求
|
||||||
|
|
||||||
- 端口:3000
|
- 端口:6903 (修改自默认的3000端口)
|
||||||
- 无需鉴权
|
- 无需鉴权
|
||||||
- 支持CORS跨域请求
|
- 支持CORS跨域请求
|
||||||
|
|
||||||
@@ -35,19 +45,28 @@ npx http-server -p 8000
|
|||||||
|
|
||||||
| 方法 | 路径 | 描述 | 请求体 | 响应 |
|
| 方法 | 路径 | 描述 | 请求体 | 响应 |
|
||||||
|------|------|------|--------|------|
|
|------|------|------|--------|------|
|
||||||
| GET | /api/apps | 获取App列表 | - | `[{id: string, name: string, fileName: string, date: string}]` |
|
| GET | /api/apps | 获取App列表 | - | `[{id: string, name: string, fileName: string, date: string, filePath: string}]` |
|
||||||
| POST | /api/apps | 上传App | multipart/form-data<br>`name`: App名称<br>`file`: 文件 | `{success: boolean, message?: string}` |
|
| POST | /api/apps | 上传App | multipart/form-data<br>`name`: App名称<br>`file`: 文件 | `{success: boolean, message?: string}` |
|
||||||
|
| DELETE | /api/apps/:id | 删除指定App | - | `{success: boolean, message?: string}` |
|
||||||
| GET | /api/apps/:id | 下载指定App | - | 文件流 |
|
| GET | /api/apps/:id | 下载指定App | - | 文件流 |
|
||||||
|
| GET | /api/docs | 获取文档内容 | - | `[{docBody: string}]` |
|
||||||
|
|
||||||
## 技术栈
|
## 技术栈
|
||||||
|
|
||||||
- HTML5
|
- HTML5
|
||||||
- CSS3
|
- CSS3
|
||||||
- JavaScript (ES6+)
|
- JavaScript (ES6+)
|
||||||
|
- Go (后端)
|
||||||
|
- Gin (Web框架)
|
||||||
|
|
||||||
## 文件结构
|
## 文件结构
|
||||||
|
|
||||||
```
|
```
|
||||||
|
├── background/ # 后端目录
|
||||||
|
│ ├── main.go # 后端主程序
|
||||||
|
│ ├── apps.json # 应用数据持久化文件
|
||||||
|
│ ├── files/ # 存储上传的文件
|
||||||
|
│ └── docs/ # 存储文档文件
|
||||||
├── index.html # 主页面
|
├── index.html # 主页面
|
||||||
├── style.css # 样式文件
|
├── style.css # 样式文件
|
||||||
├── script.js # 核心逻辑
|
├── script.js # 核心逻辑
|
||||||
@@ -74,6 +93,12 @@ npx http-server -p 8000
|
|||||||
1. 在下载区域找到要下载的App
|
1. 在下载区域找到要下载的App
|
||||||
2. 点击"下载"按钮即可开始下载
|
2. 点击"下载"按钮即可开始下载
|
||||||
|
|
||||||
|
### 删除App
|
||||||
|
|
||||||
|
1. 点击App列表中的"删除"按钮
|
||||||
|
2. 在确认对话框中点击"确定"
|
||||||
|
3. App将从列表和服务器中被删除
|
||||||
|
|
||||||
## 自定义配置
|
## 自定义配置
|
||||||
|
|
||||||
### 修改管理员密码
|
### 修改管理员密码
|
||||||
@@ -92,10 +117,24 @@ const ADMIN_PASSWORD = 'your_new_password';
|
|||||||
const API_BASE_URL = 'http://your-backend-url:port/api';
|
const API_BASE_URL = 'http://your-backend-url:port/api';
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### 修改后端端口
|
||||||
|
|
||||||
|
在 `background/main.go` 中修改:
|
||||||
|
|
||||||
|
```go
|
||||||
|
port = ":6903" // 修改为你想要的端口
|
||||||
|
```
|
||||||
|
|
||||||
|
## 数据持久化
|
||||||
|
|
||||||
|
- 应用列表数据保存在 `background/apps.json` 文件中
|
||||||
|
- 上传的文件保存在 `background/files/` 目录中
|
||||||
|
- 文档内容保存在 `background/docs/` 目录中
|
||||||
|
|
||||||
## 注意事项
|
## 注意事项
|
||||||
|
|
||||||
1. 默认使用localStorage存储,数据只保存在浏览器中
|
1. 默认使用localStorage存储登录状态,数据只保存在浏览器中
|
||||||
2. 建议部署后端API以实现持久化存储
|
2. 应用数据持久化在后端的apps.json文件中
|
||||||
3. 生产环境中请修改默认密码
|
3. 生产环境中请修改默认密码
|
||||||
4. 建议添加HTTPS支持,尤其是在公网环境中
|
4. 建议添加HTTPS支持,尤其是在公网环境中
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user