# network-pans

**Repository Path**: solidify-the-foundation/network-pans

## Basic Information

- **Project Name**: network-pans
- **Description**: 网盘项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网盘系统 (NetDisk)

一个客户端级别的网盘系统 · 学习/个人项目

- **后端**:Go + Gin + GORM
- **数据库**:PostgreSQL
- **缓存**:Redis
- **对象存储**:MinIO(S3 兼容)
- **客户端**:Tauri (Rust) + Vue3 + TypeScript

详细规划见 [PLAN.md](./PLAN.md)。

---

## 端口一览

| 服务 | 端口 | 说明 |
| --- | --- | --- |
| PostgreSQL | `5432` | 数据库,账号 `netdisk` / `netdisk`,库名 `netdisk`(见 `docker-compose.yml`) |
| Redis | `6379` | 缓存(分片状态、限流等),无密码 |
| MinIO API | `9000` | S3 兼容对象存储接口,默认 bucket `netdisk` |
| MinIO 控制台 | `9001` | Web 控制台,账号 `minioadmin` / `minioadmin` |
| 后端 HTTP | `8080` | Go + Gin,可通过 `server/.env` 的 `SERVER_PORT` 修改 |
| 客户端前端(Vite) | `5173` | Tauri 开发期前端,`strictPort` 锁定(见 `client/vite.config.ts`) |
| Vite HMR | `5174` | 仅在设置 `TAURI_DEV_HOST` 跨设备调试时启用 |

> 上述端口默认绑定到 `localhost`。生产部署时建议把 PG/Redis/MinIO 留在内网,只对外暴露后端 `8080`。

---

## 目录结构

```
network-pans/
├── PLAN.md                     # 项目完整规划
├── docker-compose.yml          # 一键起 PG + Redis + MinIO
├── server/                     # Go 后端
│   ├── cmd/server/main.go      # 程序入口
│   ├── internal/
│   │   ├── config/             # 配置加载
│   │   ├── database/           # PostgreSQL 连接
│   │   ├── cache/              # Redis 连接
│   │   ├── storage/            # MinIO 客户端
│   │   ├── model/              # GORM 数据模型
│   │   ├── middleware/         # 中间件(JWT 鉴权等)
│   │   ├── handler/            # HTTP 处理器
│   │   ├── service/            # 业务逻辑
│   │   ├── router/             # 路由注册
│   │   └── pkg/                # 通用工具(jwt/response)
│   ├── migrations/             # 建表 SQL
│   └── .env.example            # 环境变量示例
└── client/                     # Tauri + Vue3 客户端
```

---

## 快速开始

### 1. 启动基础设施

```bash
docker-compose up -d
```

启动后:
- PostgreSQL: `localhost:5432`
- Redis: `localhost:6379`
- MinIO API: `localhost:9000` · 控制台: `localhost:9001`(账号 `minioadmin` / `minioadmin`)

### 2. 初始化数据库

```bash
# 连接 PG 执行建表脚本
psql "postgresql://netdisk:netdisk@localhost:5432/netdisk" -f server/migrations/0001_init.sql
```

### 3. 启动后端

```bash
cd server
cp .env.example .env
go mod tidy
go run ./cmd/server
```

后端默认监听 `localhost:8080`。

### 4. 客户端(Tauri)

见 [client/README.md](./client/README.md)。

---

## 开发进度

按 PLAN.md 的六步路线推进,当前进度记录在 PLAN.md 末尾。