# gitee-image-host

**Repository Path**: pythonxueba/gitee-image-host

## Basic Information

- **Project Name**: gitee-image-host
- **Description**: Gitee 图床服务 - 基于 FastAPI 的图床应用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-17
- **Last Updated**: 2026-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gitee 图床

基于 Gitee 仓库的图床服务，支持智能分类、拖拽上传、永久访问。

## 功能特性

- 📁 智能文件夹分类：自动按年/月/日创建文件夹
- 🚀 拖拽上传：支持拖拽图片到页面进行上传
- 🔍 高级搜索：文件名搜索 + 时间筛选（年份/月份/日期）
- 🔗 永久访问：通过 Gitee Raw 链接永久访问图片
- 📱 全端适配：完美适配手机、平板、电脑等所有设备
- 🔒 公开仓库：自动创建公开仓库，便于访问

## 快速开始

### 1. 获取 Gitee Token

1. 访问 [Gitee 设置页面](https://gitee.com/profile/personal_access_tokens)
2. 点击"生成新令牌"
3. 权限选择：勾选 **projects**（仓库读写权限）
4. 保存生成的 Token

### 2. 运行项目

```bash
# 安装依赖
pip install fastapi uvicorn httpx jinja2

# 启动服务
uvicorn app:app --host 0.0.0.0 --port 5000
```

### 3. 使用图床

1. 访问 http://localhost:5000
2. 输入 Gitee Token 和仓库名称（默认 `image-hosting`）
3. 点击"连接仓库"，系统会自动创建公开仓库
4. 拖拽或选择图片进行上传

## 访问图片

上传成功后，会得到一个 Gitee Raw 链接：

```
https://gitee.com/{用户名}/{仓库名}/raw/master/images/{年}/{月}/{日}/{时间戳}_{文件名}
```

## 技术栈

- **后端**: FastAPI + Uvicorn + httpx
- **前端**: HTML5 + CSS3 + JavaScript + jQuery
- **存储**: Gitee 仓库