# teleup

**Repository Path**: tz520/teleup

## Basic Information

- **Project Name**: teleup
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-30
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TG 图床

基于 Telegram Bot API 的媒体文件托管平台，支持图片/视频上传、AI 智能分析打标、多用户管理、CDN 加速代理。

## 核心功能

- **Telegram Bot 集成** — 通过 Telegram 群组/频道接收媒体文件，自动入库
- **CDN 代理** — Cloudflare Worker 边缘节点缓存与代理，支持 token 鉴权
- **AI 智能分析** — 接入 Agnes AI、SenseNova、Gemini、GLM、SiliconFlow、豆包、Cloudflare AI 等多个模型，自动生成图片描述与标签
- **多 Bot/多频道** — 支持配置多个 Telegram Bot 和频道，灵活分发
- **用户系统** — 注册/登录、API Key 认证、用户组权限控制、上传配额管理
- **管理面板** — Web 后台管理：媒体管理、标签/分类体系、AI 模型配置、队列监控、操作日志
- **第三方 API** — 提供 RESTful API 供外部系统上传文件
- **视频封面** — FFmpeg 自动生成视频缩略图
- **小红书解析** — 自动解析小红书分享链接中的图片/视频

## 技术栈

- **后端**: PHP 7.4+ (PDO MySQL)
- **数据库**: MySQL 8.0 / MariaDB
- **消息平台**: Telegram Bot API
- **CDN**: Cloudflare Workers
- **AI**: Agnes AI / SenseNova / Gemini / GLM / SiliconFlow / 豆包 / Cloudflare AI

## 目录结构

```
├── index.php              # 主路由入口
├── config.php             # 数据库配置、工具函数、AI 分析逻辑
├── proxy.php              # 图片代理服务
├── cloudflare-worker.js   # Cloudflare Worker 边缘代理
├── xhs_parse.php          # 小红书链接解析入口
├── .htaccess              # Apache URL 重写规则
├── mb_polyfill.php        # mbstring 兼容层
├── actions/               # 业务逻辑处理
│   ├── webhook.php        # Telegram Webhook 处理器
│   ├── admin_api.php      # 管理端 API (约60个接口)
│   ├── user_api.php       # 用户端 API
│   ├── api_upload.php     # 第三方上传 API
│   ├── page.php           # 管理面板页面渲染
│   ├── media.php          # 媒体管理接口
│   ├── ai_queue.php       # AI 分析队列处理器
│   ├── xhs_parse.php      # 小红书解析逻辑
│   ├── ang-api.ts         # Supabase Edge Function (AI 代理)
│   └── user_pages/        # 用户端页面 (登录/注册/上传/管理等)
├── static/                # 静态资源 (CSS / 图片)
├── zl/                    # 短链接入口
│   └── index.php          # Nginx 兜底重写
├── data/                  # 运行时数据 (AI 提示词模板等)
└── teleup_*.sql           # 数据库备份
```

## 部署要求

### 环境依赖

- PHP 7.4+
- MySQL 8.0 / MariaDB 10.3+
- PHP 扩展: `pdo_mysql`, `mbstring`, `curl`, `gd`, `json`
- 可选: `ffmpeg` (视频封面生成)
- Web 服务器: Apache (需启用 `mod_rewrite`) 或 Nginx

### 快速部署

1. 克隆代码到 Web 服务器目录

2. 修改 `config.php` 中的数据库连接信息:
   ```php
   $db_host = '127.0.0.1';
   $db_user = 'your_db_user';
   $db_pass = 'your_db_pass';
   $db_name = 'your_db_name';
   ```

3. 确保 `data/` 目录可写:
   ```bash
   chmod -R 755 data/
   ```

4. 配置 Web 服务器 URL 重写:
   - Apache: `.htaccess` 已内置，确保 `mod_rewrite` 已启用
   - Nginx: 参考以下配置，将 `/zl/` 路径转发到 `zl/index.php`

   ```nginx
   location /zl/ {
       try_files $uri $uri/ /zl/index.php?$args;
   }
   ```

5. 访问管理面板进行初始配置:
   - 默认管理员账号: 通过管理面板注册或数据库直接插入
   - 配置 Telegram Bot Token 和 Chat ID
   - 设置 Webhook

### Cloudflare Worker 部署 (可选)

将 `cloudflare-worker.js` 部署到 Cloudflare Workers，获取图片 CDN 加速和边缘缓存。

## API 概览

第三方上传接口:

```bash
curl -X POST https://your-domain/index.php?act=api_upload \
  -H "X-Api-Key: your_api_key" \
  -F "file=@image.jpg"
```

用户 API 接口:

```bash
# 用户注册
curl -X POST https://your-domain/index.php?act=api_userRegister \
  -F "username=user" -F "password=pass"

# 用户登录
curl -X POST https://your-domain/index.php?act=api_userLogin \
  -F "username=user" -F "password=pass"
```

## 许可证

MIT License