置顶

部署使用出现问题，请先仔细查阅文档、常见问题解答以及已有issues。
前端仓库：MarSeventh/Sanyue-ImgHub
注意：本仓库为Telegraph-Image项目的重制版，如果你觉得本项目不错，在支持本项目的同时，也请支持原项目。

2025.2.6 V2.0 版本升级注意事项

v2.0 beta 版已发布，相较于 v1.0 版本进行了大量改动和优化，但 beta 版本可能存在潜在不稳定性，若您追求稳定，可选择暂缓更新。

由于构建命令发生了变化，此次更新需要您手动进行，请按照以下步骤进行操作：

同步fork的仓库至最新版（若已自动同步可忽略）

前往 pages 管理页面，进入设置->构建，编辑构建配置，在构建命令处填写npm install

新版本所有设置项已迁移至管理端->系统设置界面，原则上无需再通过环境变量的方式进行设置，通过系统设置界面进行的设置将覆盖掉环境变量中的设置，但为了保证 Telegram渠道的图片 能够与旧版本相兼容，若您之前设置了 Telegram 渠道相关的环境变量，请将其保留！

确保上述设置完成无误后，前往 pages 管理页面，进入部署，对最后一次不成功的部署进行重试操作

关于切换到 Telegram 渠道的通知

由于telegraph图床被滥用，该项目上传渠道已切换至Telegram Channel，请更新至最新版（更新方式见第3.1章最后一节），按照文档中的部署要求设置TG_BOT_TOKEN和TG_CHAT_ID，否则将无法正常使用上传功能。

此外，目前KV数据库为必须配置，如果以前未配置请按照文档说明配置。

出现问题，请先查看第5节常见问题Q&A部分。

生态建设

1. 插件

编辑器内自动上传（油猴脚本）：https://greasyfork.org/zh-CN/scripts/529816-image-uploader-to-markdown-to-cloudflare-imgbed （作者：Linux.do: calg_c）

2.仓库

向TG BOT发送文件上传图床：uki0xc/img-up-bot: 使用telegram机器人链接图床进行上传（作者：uki0xc)

体验地址及优质博文、视频（搭建或使用有问题可以先去里面学习哦~）

体验地址：CloudFlare ImgBed

访问码：cfbed

体验视频：CloudFlare免费图床，轻松守护你的每一份精彩！_哔哩哔哩_bilibili

相关教程视频：

利用Cloudflare R2 +Pages搭建在线图床系统，不限空间，不被墙，超级简单，完全免费 (youtube.com)

相关优质博文（感谢每一位鼎力支持的热心大佬）：

1.Introduction

免费文件托管解决方案，具有上传、管理、读取、删除等全链路功能，覆盖文件全生命周期，支持鉴权、目录、图片审查、随机图等各项特性。

2.Features

3.Deployment

4.Show

其他页面效果展示

5.TODO

5.1Add Features💕

功能更新列表

✅ ~~增加粘贴图片上传功能~~（2024.7.22已完成）
✅~~增加markdown、html等格式链接复制功能~~（2024.7.21已完成）
✅~~上传页面增加管理端入口~~（2024.7.21已完成）
:memo:增加用户个性化配置接口
- ~~登录页面和上传页面背景图自定义~~（2024.8.25已完成）
- ~~图床名称和Logo自定义~~（2024.8.26已完成）
- ~~网站标题和Icon自定义~~（2024.8.26已完成）
- ~~背景切换时间自定义~~（2024.9.11已完成）
- ~~背景透明度支持自定义~~（2024.9.12已完成）
- ~~页脚自定义传送门~~（2024.10.20已完成）
- ~~全局自定义链接前缀~~（2024.12.27已完成）
- ~~可隐藏页脚~~（2025.2.4已完成）
✅~~增加随机图API~~（2024.7.25已完成）
✅~~完善多格式链接展示形式，增加ubb格式链接支持~~（2024.8.21已完成）
✅~~完善登录逻辑，后端增加认证码校验接口~~（2024.8.21已完成）
✅~~支持URL粘贴上传~~（2024.8.23已完成）
✅~~支持大于5MB的图片上传前自动压缩~~（2024.8.26已完成）
✅~~上传页面右下角工具栏样式重构，支持上传页自定义压缩（上传前+存储端）~~（2024.9.28已完成）
✅~~重构管理端，认证+显示效果优化，增加图片详情页~~（2024.12.20已完成）
✅~~管理端增加访问量统计，IP记录、IP黑名单、上传IP黑名单等~~（2024.12.20已支持上传ip黑名单，访问记录由于对KV读写消耗太大，暂时搁置）
✅~~上传页面点击链接，自动复制到剪切板~~(2024.9.27已完成)
✅~~上传设置记忆（上传方式、链接格式等）~~（2024.9.27已完成，两种上传方式合并）
✅~~若未设置密码，无需跳转进入登录页~~（2024.9.27已完成）
✅~~增加仅删除上传成功图片、上传失败图片重试~~（2024.9.28已完成）
✅~~优化粘贴上传时文件命名方法~~（2024.9.26已完成）
✅~~增加对R2 bucket的支持~~（2024.11.5已完成）
✅~~管理端增加批量黑名单、白名单功能~~（2024.12.14已完成）
✅~~Telegram Channel渠道上传文件记录机器人和频道数据，便于迁移和备份~~（2024.12.4已完成）
✅~~支持自定义命名方式（仅原名 or 仅随机前缀 or 默认的随机前缀_原名）~~（2024.12.4已完成）
✅~~支持上传失败自动切换其他渠道尝试~~（2024.12.12已完成）
✅~~后端list接口实现分页功能~~（2024.2.5已完成）
✅~~支持自定义链接前缀~~（2024.12.4已完成）
:memo:对接alist，或实现webdav（评估中）
✅~~文件详情增加文件大小记录~~（2024.12.10已完成）
✅~~支持管理员自定义全局默认链接前缀~~（2025.2.1已完成）
✅~~开放更多文件格式~~（2024.12.9已完成）
✅~~进行删除、加入白名单、加入黑名单等操作时，自动清除CF CDN缓存，避免延迟生效~~（2024.12.11已完成）
✅~~管理端批量选择时，记录用户选择的顺序~~（2024.12.20已完成）
:memo:上传图片支持自定义上传路径，支持相册功能
- ~~文件夹删除功能~~（2025.3.6已完成）
- ~~文件位置移动功能~~（2025.3.7已完成）
- ~~管理端加载更多数据时鬼打墙问题修复~~（2025.3.6已完成）
- ~~管理端批量操作适配文件夹~~（2025.3.6已完成）
- ~~管理端分页逻辑调整~~（2025.3.6已完成）
✅~~支持多个 Telegram Bot Token 负载均衡~~（2025.2.4已完成）
✅~~管理端提供详细的设置信息和设置方式引导~~（2025.2.5已完成）
✅~~Logo焕新、登录页面优化、设置提示项等多项展示效果优化~~（2025.2.2已完成）
✅~~接入S3 API渠道~~（2024.2.3已完成）
✅~~支持短链接命名方式~~（2025.2.1已完成）
✅~~支持深色模式~~（2025.1.11已完成）
:hourglass_flowing_sand:支持KV备份恢复功能
✅~~页脚可自定义隐藏~~（2025.2.4已完成）
:hourglass_flowing_sand:搜索功能增强
:white_check_mark:支持粘贴多个链接，支持外链管理
:hourglass_flowing_sand:上传文件记录MD5，支持文件硬链接
:hourglass_flowing_sand:上传页面增加最近上传展示
:hourglass_flowing_sand:支持从后台管理处配置上传页默认设置
:white_check_mark:增加公告功能
:hourglass_flowing_sand:支持访问图片时设置宽高参数
:hourglass_flowing_sand:支持上传时转换图片格式