✨ 基于 Telegram 的现代化云端图片托管服务 ✨
🚀 无限存储 • 🔒 安全可靠 • 🎨 精美界面 • 📱 响应式设计
CDN acceleration and security protection for this project are sponsored by Tencent EdgeOne.
🌐 全球CDN加速 • 🛡️ 安全防护 • ⚡ 边缘计算优化
拖拽、点击、粘贴三种上传方式 |
基于Telegram存储引擎 |
现代化UI设计,暗黑模式 |
完美适配各种设备尺寸 |
JWT安全认证,隐私保护 |
可视化数据图表 |
🎯 上传体验 - 点击展开详情
- 拖拽上传 - 直接拖放图片到浏览器
- 点击上传 - 传统文件选择器
- 粘贴上传 -
Ctrl+V
快捷键支持 - 批量上传 - 一次处理多张图片
- 自动格式识别与优化
- 实时上传进度显示
- 错误重试机制
- 文件大小智能检测
🖼️ 图片管理 - 点击展开详情
- 网格视图 - 瀑布流布局
- 列表视图 - 详细信息展示
- 时间线视图 - 按时间排序
- 文件名模糊搜索
- 标签分类筛选
- 日期范围过滤
- 收藏状态筛选
- 一键收藏/取消收藏
- 收藏列表独立查看
- 快速收藏状态切换
- 自由调整图片顺序
- 实时拖拽反馈
- 自定义排列方式
🔧 组件 | 🚀 技术 | 📝 描述 |
---|---|---|
前端框架 |
|
原生JS,无框架依赖 |
后端服务 |
|
轻量级Web框架 + 边缘计算 |
数据存储 |
|
图片存储 + 元数据缓存 |
部署平台 |
|
全球CDN分发 + 命令行部署 |
UI组件 |
|
数据可视化 + 拖拽排序 |
开发工具 |
|
运行环境 + 包管理器 |
🛠️ 工具 | 📝 描述 | 🔗 链接 |
---|---|---|
Cloudflare 账户 | 免费注册,部署必需 | 注册链接 |
Telegram Bot | 通过 @BotFather 创建 | 创建教程 |
Node.js 环境 | 版本 16+ 推荐 | 下载地址 |
# 🔽 克隆仓库
git clone https://github.com/xiyewuqiu/new-lmage.git
cd new-lmage
# 📦 安装依赖
npm install
# 🔑 登录 Cloudflare
npx wrangler login
# ⚙️ 配置环境变量 (编辑 wrangler.toml)
# 填入您的 Telegram Bot Token 和 Chat ID
# 🚀 一键部署
npm run setup
📝 wrangler.toml 配置详情
[vars]
# 🤖 Telegram Bot 令牌
TG_Bot_Token = "YOUR_BOT_TOKEN"
# 💬 Telegram 聊天/频道 ID
TG_Chat_ID = "YOUR_CHAT_ID"
# 🔐 JWT 密钥 (生产环境请修改)
JWT_SECRET = "your-secure-jwt-secret"
部署完成后,您将获得:
- 🌐 专属域名 - Cloudflare Pages 自动分配
- ⚡ 全球加速 - CDN 边缘节点优化
- 🔒 HTTPS 安全 - 自动SSL证书配置
- 📱 PWA 支持 - 可安装到桌面/手机
- 访问网站 🌐 - 打开您的TG-Image服务
- 选择图片 📸 - 拖拽/点击/粘贴上传
- 获取链接 🔗 - 自动生成多种格式链接
- 立即使用 ✨ - 复制分享给好友
🔓 账户功能解锁
- 点击右上角"登录"按钮
- 选择"注册新账户"
- 填写用户名、邮箱、密码
- 验证邮箱完成注册
- 📂 图片管理 - 查看所有上传的图片
- 🏷️ 标签系统 - 为图片添加分类标签
- 🔍 高级搜索 - 多维度搜索过滤
- ⭐ 收藏功能 - 标记重要图片
- 📊 数据统计 - 可视化使用报告
- 🎛️ 个性设置 - 自定义界面布局
⚙️ 专业工具
- 基础裁剪和缩放
- 滤镜效果应用
- 压缩质量调节
- 格式转换功能
- 多图片同时编辑
- 批量添加水印
- 统一尺寸调整
- 批量格式转换
- 多平台分享链接
- 二维码生成
- 嵌入代码生成
- 社交媒体优化
# 🔧 启动开发服务器
npm run dev
# 🌐 访问本地服务
# http://localhost:8787
# 🏗️ 构建项目
npm run build
# 🚀 部署到 Cloudflare
npm run deploy
🔍 调试工具
# 实时日志
npx wrangler tail
# 部署日志
npx wrangler logs
# KV 存储测试
npm run create-kv
# 函数测试
npm test
🆕 v2.5.0 (2025.05.21) - 最新版本
- 📊 数据可视化大升级 - Chart.js 图表集成
- 🎛️ 多视图模式 - 网格/列表/时间线三种视图
- ⭐ 图片收藏系统 - 一键收藏,快速筛选
- 🎯 拖拽排序功能 - SortableJS 自由排序
- 🎨 界面美化重构 - 全新视觉设计语言
- ⚡ 图片加载速度提升 40%
- 📱 移动端响应速度优化
- 🔄 动画效果流畅度改善
- 💾 本地缓存策略优化
🎁 v2.0.0 (2025.05.18)
- ✨ 粘贴上传功能 - Ctrl+V 快捷操作
- 🎬 动画效果升级 - 丰富的交互反馈
- 🌊 上传流程统一 - 一致的用户体验
- 🎨 四大模块美化 - 视觉效果全面提升
🎯 v1.5.0 (2025.05.14)
- 👤 用户认证系统 - 注册/登录/JWT认证
- 🖼️ 图片管理功能 - 个人图库管理
- 📱 移动端优化 - 触摸操作友好
- ⚡ 性能提升 - 页面加载速度优化
发现Bug?立即报告 |
有好想法?告诉我们 |
提交Pull Request |
改进项目文档 |
graph LR
A[Fork 仓库] --> B[创建分支]
B --> C[开发功能]
C --> D[提交代码]
D --> E[发起 PR]
E --> F[代码审查]
F --> G[合并主分支]
🎯 代码标准
- 文件名: kebab-case (例:
image-editor.js
) - 函数名: camelCase (例:
uploadImage
) - 常量名: UPPER_SNAKE_CASE (例:
MAX_FILE_SIZE
)
src/
├── functions/ # 业务逻辑
│ ├── file/ # 文件处理
│ ├── user/ # 用户管理
│ └── utils/ # 工具函数
public/
├── css/ # 样式文件
├── js/ # 前端脚本
└── images/ # 静态资源
feat:
新功能fix:
修复Bugdocs:
文档更新style:
代码格式refactor:
代码重构test:
测试相关chore:
构建工具
✅ 允许 | ❌ 限制 | 📝 要求 |
---|---|---|
• 自由使用 • 修改源码 • 分发副本 • 专利授权 |
• 商业销售 • 付费服务 • 收费咨询 • 私有化部署销售 |
• 开源修改 • 保留协议 • 网络服务开源 • 标注原作者 |
🔍 协议详情
本项目采用 AGPL-3.0 + Commons Clause 双重协议:
- AGPL-3.0: 确保代码永远开源
- Commons Clause: 禁止商业销售
如需商业用途,请联系获取商业许可证:
- 📧 邮箱: xiyewuqiu@gmail.com
- 💬 GitHub: 项目Issues
Bug报告 & 功能建议 |
商务合作 & 技术咨询 |
使用教程 & API文档 |
如果这个项目对您有帮助,请给我们一个 ⭐️ Star!
🌈 让每一张图片都有最好的归宿 🌈
Made with ❤️ by xiyewuqiu • © 2025 TG-Image