• 🚀 Telegram 云存储 - 利用 Telegram 无限存储空间
• ⚡ Cloudflare CDN - 全球加速，智能路由优化
• 🎨 现代化前端 - 基于 Nuxt 3 + Vue 3 + Nuxt UI
• 📱 响应式设计 - 完美适配桌面端和移动端
• 🌙 深色模式 - 内置深色主题支持

• 🔄 智能路由 - 自动选择最优 CDN 节点
• 🔥 缓存预热 - 多地域主动预热 CDN 缓存
• 📊 CDN 监控 - 实时监控缓存状态
• 👥 群组上传 - 支持 Telegram 群组/频道上传
• 🔐 管理后台 - 完整的管理员功能
• 📈 数据统计 - 实时统计和监控
• 🖼️ 图片画廊 - 优雅的图片浏览体验
• 📚 API 文档 - 完整的 RESTful API
• 🗄️ 多存储支持 - Telegram / S3 / 本地 / Rclone 四种存储驱动
• 🎫 Token 系统 - 游客 Token 上传，支持配额和有效期管理

• Docker & Docker Compose（推荐）
• 或 Python 3.8+ & Node.js 18+
• Telegram Bot Token
• Cloudflare 账号（可选，用于 CDN 加速）

wget https://raw.githubusercontent.com/xiyan520/tg-telegram-imagebed/main/.env.example -O .env
wget https://raw.githubusercontent.com/xiyan520/tg-telegram-imagebed/main/docker-compose.yml

nano .env

填入必要配置（详见配置说明）：

BOT_TOKEN=你的_Bot_Token
STORAGE_CHAT_ID=你的_频道_ID
CLOUDFLARE_CDN_DOMAIN=你的域名
CLOUDFLARE_API_TOKEN=你的_API_Token
CLOUDFLARE_ZONE_ID=你的_Zone_ID

docker-compose up -d

• 前端界面: http://你的服务器IP:18793
• 管理后台: http://你的服务器IP:18793/admin
• 默认账号: admin / 密码通过环境变量 ADMIN_PASSWORD 设置，或首次启动时随机生成（查看日志获取）

services:
  telegram-imagebed:
    image: xiyan520/tg-telegram-imagebed:latest
    container_name: telegram-imagebed
    ports:
      - "18793:18793"
    env_file: .env
    volumes:
      - ./data:/app/data
    restart: unless-stopped

docker-compose up -d

docker run -d \
  --name telegram-imagebed \
  -p 18793:18793 \
  --env-file .env \
  -v ./data:/app/data \
  --restart unless-stopped \
  xiyan520/tg-telegram-imagebed:latest

# 1. 克隆项目
git clone https://github.com/xiyan520/tg-telegram-imagebed.git
cd tg-telegram-imagebed

# 2. 安装依赖
pip install -r requirements.txt

# 3. 配置环境变量
cp .env.example .env
nano .env

# 4. 启动后端
python main.py

# 1. 进入前端目录
cd frontend

# 2. 安装依赖
npm install

# 3. 配置环境变量
cp .env.example .env
nano .env

# 4. 构建生产版本
npm run build

# 5. 启动服务
npm run preview

1. 在 Telegram 中与 @BotFather 对话
2. 发送 /newbot 创建新机器人
3. 按提示设置名称和用户名
4. 获取 BOT_TOKEN

1. 创建一个 Telegram 频道（Channel）
2. 将 Bot 添加为频道管理员
3. 通过 @VersaToolsBot 或 @GetTheirIDBot 获取频道 ID

1. 登录 Cloudflare Dashboard
2. 进入 My Profile → API Tokens
3. 点击 Create Token
4. 选择 Edit zone DNS 模板或自定义权限：
   • Zone - Cache Purge - Purge
   • Zone - Zone - Read
5. 复制生成的 Token

1. 在 Cloudflare Dashboard 选择你的域名
2. 在右侧找到 Zone ID
3. 复制 Zone ID

为了让 CDN 正常工作，需要在 Cloudflare 中设置缓存规则：

1. 进入域名管理页面
2. 点击 Rules → Page Rules
3. 创建新规则，URL 模式：你的域名/image/*
4. 添加以下设置：
   • Cache Level: Cache Everything
   • Edge Cache TTL: 1 month
   • Browser Cache TTL: 4 hours
5. 保存规则

1. 进入域名管理页面
2. 点击 Caching → Cache Rules
3. 创建新规则：

   When incoming requests match:
   - URI Path contains "/image/"
   
   Then:
   - Cache eligibility: Eligible for cache
   - Edge TTL: 30 days
   - Browser TTL: 4 hours
   

如果需要自定义缓存头，可以添加 Transform Rules：

1. 进入 Rules → Transform Rules → Modify Response Header
2. 创建规则：

   When incoming requests match:
   - URI Path contains "/image/"
   
   Then:
   - Set static: Cache-Control = public, max-age=2592000
   

1. 添加 A 记录指向你的服务器 IP
2. 确保 Proxy status 为橙色云朵（已代理）
3. 等待 DNS 生效

系统支持四种存储驱动，可通过环境变量或管理后台配置：

存储配置示例：

{
  "telegram": {
    "driver": "telegram",
    "bot_token": "123456:ABC...",
    "chat_id": "-1001234567890"
  },
  "my-s3": {
    "driver": "s3",
    "endpoint": "https://s3.amazonaws.com",
    "bucket": "my-bucket",
    "access_key": "AKIAXXXXXXXX",
    "secret_key": "xxxxxxxx",
    "region": "us-east-1",
    "public_url_prefix": "https://cdn.example.com"
  },
  "local": {
    "driver": "local",
    "root_dir": "/data/uploads"
  },
  "rclone-remote": {
    "driver": "rclone",
    "remote": "myremote",
    "base_path": "/images"
  }
}

支持的存储驱动：

• 框架: Flask
• 存储: Telegram Bot API + SQLite
• CDN: Cloudflare API
• 语言: Python 3.8+

• 框架: Nuxt.js 3
• UI 库: Nuxt UI (Tailwind CSS)
• 状态管理: Pinia
• 工具库: VueUse
• 语言: TypeScript

完整的交互式 API 文档请访问：http://your-domain/docs

POST /api/upload
Content-Type: multipart/form-data

file: <图片文件>

POST /api/auth/upload
Authorization: Bearer <token>
Content-Type: multipart/form-data

file: <图片文件>

POST /api/auth/token/generate
Content-Type: application/json

{
  "upload_limit": 100,
  "expires_days": 30,
  "description": "my client"
}

POST /api/auth/token/verify
Authorization: Bearer <token>

GET /image/<encrypted_id>

GET /api/stats

GET /api/recent?page=1&limit=12

响应示例：

{
  "success": true,
  "data": {
    "url": "https://your-domain.com/image/xxx",
    "filename": "image.jpg",
    "size": "1.2 MB",
    "upload_time": "2025-01-01 12:00:00"
  }
}

A: 检查 Telegram Bot 是否有频道管理员权限，确保 STORAGE_CHAT_ID 配置正确。

A:

1. 确认 Cloudflare 缓存规则已正确配置
2. 检查 CLOUDFLARE_CDN_DOMAIN 是否正确（不含 https://）
3. 验证 API Token 权限是否足够
4. 查看后端日志确认 CDN 状态

A: 登录管理后台后，在设置页面修改密码。

A:

1. 检查 .env 文件配置是否正确
2. 确保端口 18793 未被占用
3. 查看容器日志：docker logs telegram-imagebed

A:

1. 确保 Bot 已添加到群组并有管理员权限
2. 检查 ENABLE_GROUP_UPLOAD 是否为 true
3. 如果设置了 GROUP_UPLOAD_ADMIN_ONLY，确认用户 ID 在 GROUP_ADMIN_IDS 中

• ✅ 支持 Telegram / S3 / 本地 / Rclone 四种存储驱动
• ✅ 管理后台可视化配置存储
• ✅ 支持上传场景路由（游客/Token/群组/管理员）
• ✅ 存储健康状态监控

• ✅ 游客可创建上传 Token
• ✅ Token 配额和有效期管理
• ✅ Token 上传记录查询
• ✅ 管理后台 Token 管理

• ✅ 数据驱动的组件化文档页面
• ✅ 多语言代码示例（cURL/JavaScript/Python/PHP）
• ✅ 侧边栏导航与滚动定位
• ✅ 响应式移动端适配

• ✅ 支持 Telegram 群组/频道直接上传
• ✅ 可配置仅管理员上传
• ✅ 自动回复 CDN 链接
• ✅ 可设置回复消息自动删除

欢迎提交 Issue 和 Pull Request！

MIT License

如有问题，请提交 Issue