clone/CloudFlare-ImgBed
1
0
Fork 0
mirror of https://github.com/MarSeventh/CloudFlare-ImgBed.git synced 2026-02-01 22:47:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

update readme

Browse Source
This commit is contained in:
MarSeventh
2025-06-13 14:57:59 +08:00
parent 78edc40f6f
commit 0fdffcb2db
4 changed files with 0 additions and 1612 deletions
Download Patch File Download Diff File Expand all files Collapse all files

402
README.Arabic.md
View File

@@ -1,402 +0,0 @@
<div align="center">
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed"><img width="80%" alt="logo" src="static/readme/banner.png"/></a>
<p><em>🗂️حلول استضافة الملفات مفتوحة المصدر، تعتمد على Cloudflare Pages، تدعم Telegram Bot و Cloudflare R2 و S3 وغيرها من قنوات التخزين المتعددة</em></p>
<p>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/README.md">简体中文</a>|<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/README_en.md">English</a>
</p>
<div>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/MarSeventh/CloudFlare-ImgBed" alt="License" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/releases">
<img src="https://img.shields.io/github/release/MarSeventh/CloudFlare-ImgBed" alt="latest version" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/releases">
<img src="https://img.shields.io/github/downloads/MarSeventh/CloudFlare-ImgBed/total?color=%239F7AEA&logo=github" alt="Downloads" />
</a>
<a href="https://hub.docker.com/r/marseventh/cloudflare-imgbed">
<img src="https://img.shields.io/docker/pulls/marseventh/cloudflare-imgbed?style=flat-square" alt="Docker Pulls" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/issues">
<img src="https://img.shields.io/github/issues/MarSeventh/CloudFlare-ImgBed" alt="Issues" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/stargazers">
<img src="https://img.shields.io/github/stars/MarSeventh/CloudFlare-ImgBed" alt="Stars" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/network/members">
<img src="https://img.shields.io/github/forks/MarSeventh/CloudFlare-ImgBed" alt="Forks" />
</a>
</div>
</div>
---
> [!IMPORTANT]
>
> **يرجى مراجعة ملاحظات ترقية الإصدار v2.0 في الإعلان!**
<details>
<summary>الإعلان</summary>
## 置顶
1. إذا واجهت مشاكل في النشر، يرجى مراجعة الوثائق، الأسئلة الشائعة، والمشاكل الموجودة مسبقًا بعناية.
2. **مستودع الواجهة الأمامية**：[MarSeventh/Sanyue-ImgHub](https://github.com/MarSeventh/Sanyue-ImgHub)
3. **ملاحظة**: هذا المستودع هو نسخة معاد تصميمها من مشروع [Telegraph-Image](https://github.com/cf-pages/Telegraph-Image)، إذا كنت تعتقد أن هذا المشروع جيد، يرجى دعم المشروع الأصلي أيضًا.
## 2025.2.6 ملاحظات ترقية الإصدار V2.0
> تم إصدار النسخة التجريبية v2.0، وقد تم إجراء العديد من التغييرات والتحسينات مقارنة بالإصدار v1.0، ولكن قد تحتوي النسخة التجريبية على عدم استقرار محتمل، إذا كنت تبحث عن الاستقرار، يمكنك تأجيل التحديث.
>
> نظرًا لأن **أمر البناء قد تغير**، يتطلب هذا التحديث منك **إجراء التحديث يدويًا**، يرجى اتباع الخطوات التالية:
>
> - مزامنة المستودع المفرع إلى أحدث إصدار (إذا تم المزامنة تلقائيًا، يمكنك تجاهل ذلك)
>
> - انتقل إلى صفحة إدارة الصفحات، واذهب إلى `الإعدادات`->`البناء`، وقم بتحرير `تكوين البناء`، في حقل `أمر البناء`، اكتب `npm install`
>
> ![image-20250212190315179](static/readme/202502121903327.png)
>
> - تم **نقل جميع إعدادات النسخة الجديدة** إلى واجهة إدارة النظام->الإعدادات، من حيث المبدأ، لا حاجة لتعيينها عبر متغيرات البيئة، ستقوم الإعدادات التي تتم عبر واجهة إعدادات النظام **بتجاوز** الإعدادات في متغيرات البيئة، ولكن لضمان أن **صور قنوات Telegram** يمكن أن تتوافق مع الإصدارات القديمة، **إذا كنت قد قمت بتعيين متغيرات البيئة المتعلقة بقناة Telegram، يرجى الاحتفاظ بها!**
>
> - تأكد من أن الإعدادات المذكورة أعلاه قد اكتملت بشكل صحيح، ثم انتقل إلى صفحة إدارة الصفحات، واذهب إلى `النشر`، وقم بإجراء `إعادة محاولة` للنشر الأخير الذي لم ينجح
## حول الإخطار بالتحويل إلى قناة Telegram
> نظرًا لأن خدمة telegraph قد تم إساءة استخدامها، فقد تم تحويل قناة التحميل لهذا المشروع إلى قناة Telegram، يرجى **التحديث إلى أحدث إصدار (طريقة التحديث انظر في القسم 3.1 في نهاية الفصل)**، وفقًا لمتطلبات النشر في الوثائق **قم بتعيين `TG_BOT_TOKEN` و `TG_CHAT_ID`**، وإلا فلن تتمكن من استخدام وظيفة التحميل بشكل طبيعي.
>
> بالإضافة إلى ذلك، فإن **قاعدة بيانات KV مطلوبة**، إذا لم تكن قد قمت بتكوينها من قبل، يرجى اتباع تعليمات الوثائق لتكوينها.
>
> إذا واجهت مشاكل، يرجى مراجعة القسم 5 من الأسئلة الشائعة Q&A.
</details>
<details>
<summary>بناء النظام البيئي</summary>
## 1. الإضافات
- **التحميل التلقائي داخل المحرر (سكريبت تم تطويره)**: https://greasyfork.org/zh-CN/scripts/529816-image-uploader-to-markdown-to-cloudflare-imgbed （_المؤلف: Linux.do: [calg_c](https://linux.do/u/calg_c/summary)_）
## 2. المستودع
- **إرسال الملفات إلى TG BOT لتحميلها على السحابة**：[uki0xc/img-up-bot: استخدام روبوت Telegram لربط السحابة بالتحميل](https://github.com/uki0xc/img-up-bot?tab=readme-ov-file) （_المؤلف：[uki0xc](https://github.com/uki0xc)_)
</details>
<details>
<summary>عنوان التجربة والمقالات والفيديوهات عالية الجودة (إذا كان لديك مشاكل في الإعداد أو الاستخدام، يمكنك الذهاب إلى هناك للتعلم أولاً~)</summary>
**عنوان التجربة**：[CloudFlare ImgBed](https://cfbed.1314883.xyz/)
> رمز الوصول: cfbed
**فيديو التجربة**：[CloudFlare免费图床，轻松守护你的每一份精彩！_哔哩哔哩_bilibili](https://www.bilibili.com/video/BV1y3WGe4EGh/?vd_source=da5ecbe595e41089cd1bed95932b8bfd)
**فيديوهات تعليمية ذات صلة**：
- [利用Cloudflare R2 +Pages搭建在线图床系统，不限空间，不被墙，超级简单，完全免费 (youtube.com)](https://www.youtube.com/watch?v=T8VayuUMOzM)
**مقالات عالية الجودة ذات صلة (شكرًا لكل من دعم المشروع بجهودهم)**：
- [CloudFlare-ImgBed项目 – yunsen2025的小窝](https://www.yunsen2025.top/category/cloudflare-imgbed/)
- [完全免费，图文教程手把手教你使用cloudflare搭建一个无限空间的私人图床 支持身份认证与成人元素鉴定！ - yunsen2025的小窝](https://www.yunsen2025.top/blog-cfpages-syq-imgbed)
- [为CloudFlare-ImgBed图床配置国内CDN并分线路解析，以最低成本享受极致速度！ – yunsen2025的小窝](https://www.yunsen2025.top/cloudflare-imgbed-fen-xian-pei-zhi-guo-nei-cdn/)
- [利用cloudflare pages搭建telegram频道图床 (lepidus.me)](https://blogstr.lepidus.me/post/1725801323700/)
- [搭建基于CloudFlare和Telegram的免费图床教程 - 刘学馆 | Blog (sexy0769.com)](https://blog.sexy0769.com/skill/735.html)
- [CloudFlare+Github，打造属于自己的免费图床 - 大头钉的小小blog (luckyting.top)](https://luckyting.top/index.php/archives/20/)
</details>
## 最近更新
إضافة ميزات:
- تحسين صور الأخطاء
- صفحة التحميل تدعم معاينة ملفات بصيغة ico وغيرها من الصيغ
<details>
<summary>سجل التحديثات</summary>
## 2025.6.13
إضافة ميزات:
- تحسين صور الأخطاء
- صفحة التحميل تدعم معاينة ملفات بصيغة ico وغيرها من الصيغ
## 2025.6.12
إضافة ميزات:
- دعم واجهة `upload` للوصول عبر النطاقات المختلفة
إصلاح الأخطاء:
- إصلاح مشكلة تكامل البيانات التي تعود من واجهة `list`
## 2025.5.23
إضافة ميزات:
- إضافة وظيفة الإعلانات
إصلاح الأخطاء:
- إصلاح مشكلة طول اسم الصورة في الخلفية التي تغطي الصورة
- تحسين عرض بعض الصفحات
- إصلاح مشكلة عدم إمكانية الوصول إلى صورة Docker
## 2025.5.11
إضافة ميزات:
- دعم النشر عبر Docker على الخادم
## 2025.3.14
إضافة ميزات:
- دعم إدارة المستخدمين لعرض موقع IP المحدد
## 2025.3.8
إضافة ميزات:
- دعم واجهة الصور العشوائية لقراءة حسب الدليل، ودعم التحكم في الأذونات حسب الدليل
إصلاح الأخطاء:
- إصلاح مشكلة التخزين المؤقت لواجهة الصور العشوائية
## 2025.3.7
إضافة ميزات:
- **وظيفة الدليل متاحة الآن**، تدعم حاليًا:
- التحميل إلى دليل محدد
- حذف الدليل بالكامل
- نقل موقع الملف (لا تدعم قنوات Telegraph والإصدارات القديمة)
- قراءة الملفات حسب الدليل
- دعم واجهة الصور العشوائية لقراءة حسب الدليل
إصلاح الأخطاء:
- إصلاح العديد من الأخطاء التي تؤثر على التجربة
## 2025.3.1
إضافة ميزات:
- دعم لصق عدة روابط في وقت واحد للتحميل
- دعم تخزين وإدارة الروابط الخارجية
إصلاح الأخطاء:
- إصلاح مشكلة نسخ روابط S3 في واجهة الإدارة
- إصلاح مشكلة عدم فعالية إعدادات بعض الصفحات في واجهة الإدارة
- إصلاح مشكلة عدم حفظ إعدادات القناة في بعض الحالات
## 2025.2.6
**الإصدار v2.0 يظهر بشكل جديد**، يقدم العديد من الميزات الجديدة والتحسينات، ليمنحك تجربة مستخدم جديدة:
💪**أقوى**:
- الاتصال بقنوات S3 API، دعم خدمات التخزين الكائني من مزودي الخدمة مثل Cloudflare R2 و Backblaze B2 و Qiniu Cloud و Youpai Cloud
- دعم تعيين قنوات متعددة من Telegram و S3، دعم توازن الحمل عبر قنوات متعددة
- دعم تسمية الملفات عند التحميل باستخدام طريقة الروابط القصيرة
✈️**أكثر كفاءة**:
- تم نقل جميع عناصر الإعداد إلى واجهة إعدادات النظام في واجهة الإدارة، لا حاجة لإعدادات معقدة عبر متغيرات البيئة، الإعدادات سارية المفعول فورًا
- تم تنفيذ قراءة الصفحات مثل معرض الإدارة وإدارة المستخدمين بشكل صفحي، مما يعزز سرعة العرض الأمامية، ويحسن تجربة الاستخدام
- دعم تعطيل وتفعيل القنوات، إدارة القنوات بسهولة
- إضافة نوافذ منبثقة للإعدادات المتعددة، لا حاجة للبحث في الوثائق، الإعدادات أكثر موثوقية
✨**أكثر دقة**:
- دعم الوضع الداكن عالميًا، يتبدل تلقائيًا حسب تفضيلات المستخدم والوقت، مما يبرز إحساسًا عالي الجودة
- إعادة صياغة تفاصيل عدة صفحات مثل صفحة تسجيل الدخول، صفحة المعرض، صفحة إدارة المستخدمين، مما يجعل العمليات أكثر وضوحًا
- شريط علامات جديد في صفحة التحميل، سهل الاستخدام ومرن
- تجديد الشعار، تم تصميمه يدويًا، قدراتي محدودة، لا تهاجموني (
- دعم إخفاء تذييل الصفحة حسب التخصيص، مما يساعد مرضى الوسواس القهري
## 2024.12.27
إضافة ميزات:
- دعم تخصيص بادئة الروابط الافتراضية العالمية عبر متغيرات البيئة (انظر 3.1.3.6 واجهة التكوين المخصصة)
- دعم تخصيص بادئة الروابط في واجهة الإدارة
- تحسين عرض بعض الصفحات في واجهة الإدارة
- دعم واجهة `/upload` لإرجاع الروابط الكاملة (تعيين معلمة `returnFormat` عند الطلب، انظر وثائق API)
إصلاح الأخطاء:
- تحسين عرض صفحة التحميل
## 2024.12.20
إضافة ميزات:
- دعم حظر IP التحميل في واجهة الإدارة (Dashboard->إدارة المستخدمين->السماح بالتحميل)
- دعم العمليات الجماعية في واجهة الإدارة وفقًا لترتيب اختيار المستخدم ([#issue124](https://github.com/MarSeventh/CloudFlare-ImgBed/issues/124))
- تحسين واجهة `random`، تقليل عدد عمليات KV، إضافة معلمة `content`، دعم إرجاع نوع الملف المحدد
- الاتصال بواجهة CloudFlare Cache API، تحسين سرعة الوصول إلى واجهات القائمة
- تعديل وقت التخزين المؤقت للصور التي يتم إرجاعها من CDN من سنة واحدة إلى 7 أيام، لمنع مشكلة الوصول إلى الصور لفترة طويلة في حالة عدم نجاح عملية التخزين المؤقت
## 2024.12.14
إضافة ميزات:
- إضافة وظيفة القائمة السوداء والبيضاء في واجهة الإدارة
## 2024.12.13
إضافة ميزات:
- تحسين استراتيجيات التخزين المؤقت لحالات العودة مثل blockimg و whitelistmode و 404، لتقليل طلبات العودة قدر الإمكان (راجع الوثائق `3.1.3.9 تحسين عمليات الحذف والحظر في واجهة الإدارة` للإعداد)
## 2024.12.12
إضافة ميزات:
- دعم التبديل التلقائي إلى قنوات أخرى عند فشل التحميل
- تحسين نمط عرض حالات العودة مثل 404 و blockimg و whitelistmode
## 2024.12.11
إضافة ميزات:
- عند إجراء عمليات الحذف أو إضافة إلى القائمة البيضاء أو السوداء، يتم مسح ذاكرة التخزين المؤقت لـ CF CDN تلقائيًا، لتجنب التأخير في السريان (راجع الوثائق `3.1.3.9 تحسين عمليات الحذف والحظر في واجهة الإدارة` للإعداد)
## 2024.12.10
إضافة ميزات:
- إضافة سجل حجم الملف في تفاصيل الملف
## 2024.12.09
إضافة ميزات:
- فتح المزيد من تنسيقات الملفات
إصلاح الأخطاء:
- إضافة رأس `access-control-allow-origin: *` للسماح بالوصول عبر النطاقات
## 2024.12.04
إضافة ميزات:
- دعم أساليب التسمية المخصصة (اسم الأصلي فقط أو بادئة عشوائية فقط أو بادئة عشوائية_اسم الأصلي الافتراضية)
- تسجيل بيانات الروبوت والقناة عند تحميل الملفات عبر قناة Telegram، لتسهيل النقل والنسخ الاحتياطي
- دعم تخصيص بادئة الروابط
إصلاح الأخطاء:
- حذف حاوية R2 في واجهة الإدارة عند الحذف، يتم حذف الدلو المتزامن
## 2024.11.05
إضافة ميزات:
- إضافة دعم لحاوية R2
## 2024.10.20
إضافة ميزات:
- إضافة وظيفة بوابة مخصصة في تذييل الصفحة
## 2024.09.28
إضافة ميزات:
- إعادة تصميم نمط شريط الأدوات في أسفل يمين صفحة التحميل، دعم ضغط مخصص في صفحة التحميل (قبل التحميل + في جانب التخزين)
- إضافة خيار لحذف الصور التي تم تحميلها بنجاح فقط، وإعادة محاولة تحميل الصور التي فشلت
## 2024.09.27
إضافة ميزات:
- عند النقر على الرابط في صفحة التحميل، يتم نسخه تلقائيًا إلى الحافظة
- تذكر إعدادات التحميل (طريقة التحميل، تنسيق الرابط، إلخ)
إصلاح الأخطاء:
- إذا لم يتم تعيين كلمة مرور، فلا حاجة للانتقال إلى صفحة تسجيل الدخول
## 2024.09.26
إضافة ميزات:
- تحسين طريقة تسمية الملفات عند التحميل عبر اللصق
## 2024.09.12
إضافة ميزات:
- إضافة دعم لتخصيص شفافية الخلفية
## 2024.09.11
إضافة ميزات:
- دعم تخصيص وقت تبديل الخلفية
## 2024.08.26
إضافة ميزات:
- دعم ضغط الصور التي تزيد عن 5 ميغابايت قبل التحميل
- دعم تخصيص اسم السحابة والشعار
- دعم تخصيص عنوان الموقع والرمز
## 2024.08.23
إضافة ميزات:
- دعم تحميل الروابط عبر اللصق
## 2024.08.21
إضافة ميزات:
- تحسين عرض الروابط متعددة التنسيقات، وزيادة دعم روابط UBB
- تحسين منطق تسجيل الدخول، وزيادة واجهة التحقق من رمز المصادقة في الخلفية
## 2024.07.25
إضافة ميزات:
- إضافة واجهة الصور العشوائية
إصلاح الأخطاء:
- إصلاح مشكلة عدم عرض التحميل عبر API في الخلفية
## 2024.07.22
إضافة ميزات:
- إضافة وظيفة تحميل الصور عبر اللصق
##

347
README.French.md
View File

@@ -1,347 +0,0 @@
<div align="center">
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed"><img width="80%" alt="logo" src="static/readme/banner.png"/></a>
<p><em>🗂️Solution d'hébergement de fichiers open source, basé sur Cloudflare Pages, prenant en charge Telegram Bot, Cloudflare R2, S3 et d'autres canaux de stockage</em></p>
<p>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/README.md">简体中文</a>|<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/README_en.md">English</a>
</p>
<div>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/MarSeventh/CloudFlare-ImgBed" alt="License" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/releases">
<img src="https://img.shields.io/github/release/MarSeventh/CloudFlare-ImgBed" alt="latest version" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/releases">
<img src="https://img.shields.io/github/downloads/MarSeventh/CloudFlare-ImgBed/total?color=%239F7AEA&logo=github" alt="Downloads" />
</a>
<a href="https://hub.docker.com/r/marseventh/cloudflare-imgbed">
<img src="https://img.shields.io/docker/pulls/marseventh/cloudflare-imgbed?style=flat-square" alt="Docker Pulls" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/issues">
<img src="https://img.shields.io/github/issues/MarSeventh/CloudFlare-ImgBed" alt="Issues" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/stargazers">
<img src="https://img.shields.io/github/stars/MarSeventh/CloudFlare-ImgBed" alt="Stars" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/network/members">
<img src="https://img.shields.io/github/forks/MarSeventh/CloudFlare-ImgBed" alt="Forks" />
</a>
</div>
</div>
---
> [!IMPORTANT]
>
> **Veuillez consulter l'annonce pour les notes de mise à niveau de la version v2.0 !**
<details>
<summary>Annonce</summary>
## Épinglé
1. Si vous rencontrez des problèmes lors du déploiement, veuillez d'abord consulter attentivement la documentation, les questions fréquentes et les problèmes existants.
2. **Dépôt frontal** : [MarSeventh/Sanyue-ImgHub](https://github.com/MarSeventh/Sanyue-ImgHub)
3. **Remarque** : Ce dépôt est une version remaniée du projet [Telegraph-Image](https://github.com/cf-pages/Telegraph-Image). Si vous trouvez ce projet utile, veuillez également soutenir le projet original.
## 2025.2.6 Notes de mise à niveau de la version V2.0
> La version bêta v2.0 a été publiée, avec de nombreux changements et optimisations par rapport à la version v1.0, mais la version bêta peut présenter une instabilité potentielle. Si vous recherchez la stabilité, vous pouvez choisir de retarder la mise à jour.
>
> En raison de **changements dans les commandes de construction**, cette mise à jour nécessite que vous **effectuiez manuellement** les opérations suivantes :
>
> - Synchronisez le dépôt fork vers la dernière version (si la synchronisation automatique a déjà eu lieu, vous pouvez ignorer cette étape)
>
> - Allez sur la page de gestion des pages, accédez à `Paramètres` -> `Construction`, éditez `Configuration de construction`, et dans `Commande de construction`, entrez `npm install`
>
> ![image-20250212190315179](static/readme/202502121903327.png)
>
> - Tous les paramètres de la nouvelle version ont été **migrés vers l'interface de gestion -> Paramètres système**, en principe, il n'est plus nécessaire de les configurer via des variables d'environnement. Les paramètres effectués via l'interface de paramètres système **écraseront** les paramètres des variables d'environnement. Cependant, pour garantir que les **images des canaux Telegram** soient compatibles avec l'ancienne version, **si vous avez précédemment configuré des variables d'environnement liées aux canaux Telegram, veuillez les conserver !**
>
> - Une fois que vous avez vérifié que les paramètres ci-dessus sont corrects, allez sur la page de gestion des pages, accédez à `Déploiement`, et effectuez une `réessai` de la dernière tentative de déploiement qui a échoué.
## Notification concernant le passage au canal Telegram
> En raison de l'abus du service d'hébergement d'images Telegraph, le canal de téléchargement de ce projet a été changé en canal Telegram. Veuillez **mettre à jour vers la dernière version (voir la dernière section du chapitre 3.1 pour les méthodes de mise à jour)**, et configurer **`TG_BOT_TOKEN` et `TG_CHAT_ID`** selon les exigences de déploiement dans la documentation, sinon la fonction de téléchargement ne fonctionnera pas correctement.
>
> De plus, actuellement, **la base de données KV est obligatoire**. Si elle n'a pas été configurée auparavant, veuillez suivre les instructions de la documentation pour la configurer.
>
> En cas de problème, veuillez d'abord consulter la section Q&A des questions fréquentes au chapitre 5.
</details>
<details>
<summary>Construction de l'écosystème</summary>
## 1. Plugins
- **Téléchargement automatique dans l'éditeur (script Tampermonkey)** : https://greasyfork.org/zh-CN/scripts/529816-image-uploader-to-markdown-to-cloudflare-imgbed （_Auteur : Linux.do : [calg_c](https://linux.do/u/calg_c/summary)_）
## 2. Dépôts
- **Envoyer des fichiers au canal TG pour l'hébergement d'images** : [uki0xc/img-up-bot : Utiliser le robot Telegram pour télécharger des images](https://github.com/uki0xc/img-up-bot?tab=readme-ov-file) （_Auteur : [uki0xc](https://github.com/uki0xc)_)
</details>
<details>
<summary>Adresse d'expérience et articles de qualité, vidéos (si vous avez des problèmes de configuration ou d'utilisation, vous pouvez d'abord aller apprendre là-bas~)</summary>
**Adresse d'expérience** : [CloudFlare ImgBed](https://cfbed.1314883.xyz/)
> Code d'accès : cfbed
**Vidéo d'expérience** : [CloudFlare gratuit hébergement d'images, protégez facilement chaque moment !_哔哩哔哩_bilibili](https://www.bilibili.com/video/BV1y3WGe4EGh/?vd_source=da5ecbe595e41089cd1bed95932b8bfd)
**Vidéos de tutoriels connexes** :
- [Construire un système d'hébergement d'images en ligne avec Cloudflare R2 + Pages, sans limite d'espace, non bloqué, super simple, entièrement gratuit (youtube.com)](https://www.youtube.com/watch?v=T8VayuUMOzM)
**Articles de qualité connexes (merci à chaque personne qui soutient avec enthousiasme) :**
- [Projet CloudFlare-ImgBed – le petit coin de yunsen2025](https://www.yunsen2025.top/category/cloudflare-imgbed/)
- [Entièrement gratuit, tutoriel étape par étape pour utiliser Cloudflare pour construire un hébergement d'images privé avec espace illimité, prenant en charge l'authentification et la vérification des éléments pour adultes ! - le petit coin de yunsen2025](https://www.yunsen2025.top/blog-cfpages-syq-imgbed)
- [Configurer le CDN national pour CloudFlare-ImgBed et l'analyse par ligne, pour profiter de la vitesse ultime à moindre coût ! – le petit coin de yunsen2025](https://www.yunsen2025.top/cloudflare-imgbed-fen-xian-pei-zhi-guo-nei-cdn/)
- [Construire un hébergement d'images basé sur CloudFlare et Telegram (lepidus.me)](https://blogstr.lepidus.me/post/1725801323700/)
- [Tutoriel sur la construction d'un hébergement d'images gratuit basé sur CloudFlare et Telegram - Liu Xueguan | Blog (sexy0769.com)](https://blog.sexy0769.com/skill/735.html)
- [CloudFlare + Github, créez votre propre hébergement d'images gratuit - le petit blog de Dàtóudīng (luckyting.top)](https://luckyting.top/index.php/archives/20/)
</details>
## Dernières mises à jour
Ajouter des fonctionnalités :
- Embellir les images d'erreur
- La page de téléchargement prend en charge l'aperçu des fichiers de format ico et plus encore
<details>
<summary>Journal des mises à jour</summary>
## 2025.6.13
Ajouter des fonctionnalités :
- Embellir les images d'erreur
- La page de téléchargement prend en charge l'aperçu des fichiers de format ico et plus encore
## 2025.6.12
Ajouter des fonctionnalités :
- L'interface `upload` prend en charge l'accès et l'appel inter-domaines
Corriger des bugs :
- Correction du problème d'intégrité des données retournées par l'interface `list`
## 2025.5.23
Ajouter des fonctionnalités :
- Ajout de la fonction d'annonce
Corriger des bugs :
- Correction du problème où les noms d'images dans le backend étaient trop longs et masquaient les images
- Optimisation de l'affichage de certaines pages
- Correction du problème d'accès aux liens externes https dans l'image Docker
## 2025.5.11
Ajouter des fonctionnalités :
- Prise en charge du déploiement sur le serveur via Docker
## 2025.3.14
Ajouter des fonctionnalités :
- La gestion des utilisateurs téléchargés prend en charge l'affichage de l'emplacement IP spécifique
## 2025.3.8
Ajouter des fonctionnalités :
- L'API d'images aléatoires prend en charge la lecture par répertoire, prend en charge le contrôle d'accès par répertoire
Corriger des bugs :
- Correction du problème de cache de l'API d'images aléatoires
## 2025.3.7
Ajouter des fonctionnalités :
- **La fonction de répertoire est en ligne**. Actuellement, elle prend en charge :
- Téléchargement dans un répertoire spécifié
- Suppression de tout le répertoire
- Déplacement de fichiers (Telegraph et l'ancien canal Telegram ne prennent pas en charge le déplacement)
- Lecture de fichiers par répertoire
- L'API d'images aléatoires prend en charge la lecture par répertoire
Corriger des bugs :
- Correction de plusieurs bugs affectant l'expérience
## 2025.3.1
Ajouter des fonctionnalités :
- Prise en charge du collage de plusieurs liens pour un téléchargement simultané
- Prise en charge du stockage et de la gestion des liens externes
Corriger des bugs :
- Correction des problèmes liés à la copie de liens S3 dans le backend
- Correction des problèmes où certains paramètres de page dans le backend ne prenaient pas effet
- Correction des problèmes où certains paramètres de canal ne pouvaient pas être enregistrés dans certaines situations
## 2025.2.6
**La version v2.0 fait son apparition**, apportant de nombreuses nouvelles fonctionnalités et optimisations, vous offrant une expérience utilisateur renouvelée :
💪**Plus puissant** :
- Intégration de l'API S3, prenant en charge les services de stockage d'objets de plusieurs fournisseurs tels que Cloudflare R2, Backblaze B2, Qiniu Cloud, Youpai Cloud, etc.
- Prise en charge de la configuration de plusieurs canaux Telegram et S3, prenant en charge l'équilibrage de charge multi-canaux
- Prise en charge de la méthode de nommage de fichiers courts pour les fichiers téléchargés
✈️**Plus efficace** :
- Tous les paramètres ont été migrés vers l'interface de paramètres système du backend, sans besoin de configuration fastidieuse des variables d'environnement, les paramètres prennent effet immédiatement
- Les pages de gestion telles que la galerie et la gestion des utilisateurs réalisent une lecture paginée, améliorant la vitesse de rendu frontend et optimisant l'expérience utilisateur
- Prise en charge de la désactivation et de l'activation des canaux, la gestion des canaux est sous contrôle
- Plusieurs paramètres ajoutent des fenêtres contextuelles d'alerte, pas besoin de fouiller dans la documentation, les paramètres sont plus fiables
✨**Plus raffiné** :
- Prise en charge globale du mode sombre, basculant automatiquement selon les préférences de l'utilisateur et l'heure, mettant en avant un sentiment de sophistication
- La page de connexion, la page de la galerie, la page de gestion des utilisateurs et d'autres pages ont été retravaillées pour des détails plus intuitifs
- Nouvelle barre d'onglets sur la page de téléchargement, facile à utiliser
- Logo renouvelé, fait à la main, capacités limitées, pas de critiques (
- Prise en charge de la personnalisation de la page de pied de page, les personnes perfectionnistes sont sauvées
## 2024.12.27
Ajouter des fonctionnalités :
- Prise en charge de la personnalisation du préfixe de lien par défaut global via des variables d'environnement (voir 3.1.3.6 interface de configuration personnalisée)
- Prise en charge de la personnalisation du préfixe de lien dans le backend
- Optimisation de l'affichage de certaines pages dans le backend
- L'API `/upload` prend en charge le retour de liens complets (définir le paramètre `returnFormat` lors de la demande, voir la documentation API)
Corriger des bugs :
- Optimisation de l'affichage de la page de téléchargement
## 2024.12.20
Ajouter des fonctionnalités :
- Prise en charge de la mise en liste noire des IP de téléchargement dans le backend (Dashboard -> Gestion des utilisateurs -> Autoriser le téléchargement)
- Prise en charge des opérations en masse dans le backend selon l'ordre choisi par l'utilisateur ([#issue124](https://github.com/MarSeventh/CloudFlare-ImgBed/issues/124))
- Optimisation de l'interface `random`, réduction du nombre d'opérations KV, ajout du paramètre `content`, prise en charge du retour de fichiers de type spécifié
- Intégration de l'API CloudFlare Cache, amélioration de la vitesse d'accès aux interfaces liées à la liste
- Le temps de cache CDN pour les images retournées est ajusté de 1 an à 7 jours, afin d'éviter que les images ne soient accessibles pendant une longue période en cas d'échec de la suppression du cache
## 2024.12.14
Ajouter des fonctionnalités :
- Ajout de la fonction de liste noire et de liste blanche en masse dans le backend
## 2024.12.13
Ajouter des fonctionnalités :
- Optimisation de la stratégie de cache pour les états de retour tels que blockimg, whitelistmode, 404, afin de réduire au maximum les demandes de retour (voir la documentation `3.1.3.9 optimisation des opérations de suppression, de mise en liste noire, etc. dans le backend`)
## 2024.12.12
Ajouter des fonctionnalités :
- Le backend prend en charge le changement automatique vers d'autres canaux en cas d'échec de téléchargement
- Optimisation de l'affichage des états de retour 404, blockimg, whitelistmode, etc.
## 2024.12.11
Ajouter des fonctionnalités :
- Lors de la suppression, de l'ajout à la liste blanche, de l'ajout à la liste noire, etc., suppression automatique du cache CDN CF pour éviter les délais d'effet (voir la documentation `3.1.3.9 optimisation des opérations de suppression, de mise en liste noire, etc. dans le backend`)
## 2024.12.10
Ajouter des fonctionnalités :
- Ajout d'un enregistrement de la taille des fichiers dans les détails des fichiers
## 2024.12.09
Ajouter des fonctionnalités :
- Ouverture de plus de formats de fichiers
Corriger des bugs :
- Ajout d'un en-tête `access-control-allow-origin: *` pour permettre les requêtes inter-domaines dans les en-têtes de réponse des fichiers
## 2024.12.04
Ajouter des fonctionnalités :
- Prise en charge de la méthode de nommage personnalisée (soit nom d'origine, soit préfixe aléatoire, soit préfixe aléatoire\_nom d'origine par défaut)
- Enregistrement des données du robot et du canal lors du téléchargement de fichiers dans le canal Telegram, facilitant la migration et la sauvegarde
- Prise en charge de la personnalisation du préfixe de lien
Corriger des bugs :
- Suppression synchronisée du compartiment lors de la suppression du canal R2 dans le backend
## 2024.11.05
Ajouter des fonctionnalités :
- Ajout de la prise en charge des compartiments R2
## 2024.10.20
Ajouter des fonctionnalités :
- Ajout de la fonction de portail personnalisé dans le pied de page
## 2024.09.28
Ajouter des fonctionnalités :
- Reconstruction du style de la barre d'outils en bas à droite de la page de téléchargement, prise en charge de la compression personnalisée de la page de téléchargement (avant le téléchargement + côté stockage)
- Ajout de la possibilité de supprimer uniquement les images téléchargées avec succès et de réessayer les images échouées
## 2024.09.27
Ajouter des fonctionnalités :
- Lors du clic sur un lien sur la page de téléchargement, il est automatiquement copié dans le presse-papiers
- Mémorisation des paramètres de téléchargement (méthode de téléchargement, format de lien, etc.)
Corriger des bugs :
- Si aucun mot de passe n'est défini, il n'est pas nécessaire de rediriger vers la page de connexion
## 2024.09

450
README.zh-CN.md
View File

@@ -1,450 +0,0 @@
<div align="center">
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed"><img width="80%" alt="logo" src="static/readme/banner.png"/></a>
<p><em>🗂️开源文件托管解决方案，基于 Cloudflare Pages，支持 Telegram Bot 、 Cloudflare R2 ，S3 等多种存储渠道</em></p>
<p>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/README.md">简体中文</a>|<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/README_en.md">English</a>
</p>
<div>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/MarSeventh/CloudFlare-ImgBed" alt="License" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/releases">
<img src="https://img.shields.io/github/release/MarSeventh/CloudFlare-ImgBed" alt="latest version" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/releases">
<img src="https://img.shields.io/github/downloads/MarSeventh/CloudFlare-ImgBed/total?color=%239F7AEA&logo=github" alt="Downloads" />
</a>
<a href="https://hub.docker.com/r/marseventh/cloudflare-imgbed">
<img src="https://img.shields.io/docker/pulls/marseventh/cloudflare-imgbed?style=flat-square" alt="Docker Pulls" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/issues">
<img src="https://img.shields.io/github/issues/MarSeventh/CloudFlare-ImgBed" alt="Issues" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/stargazers">
<img src="https://img.shields.io/github/stars/MarSeventh/CloudFlare-ImgBed" alt="Stars" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/network/members">
<img src="https://img.shields.io/github/forks/MarSeventh/CloudFlare-ImgBed" alt="Forks" />
</a>
</div>
</div>
---
> [!IMPORTANT]
>
> **v2.0 版本升级注意事项请查看公告！**
<details>
<summary>公告</summary>
## 置顶
1. 部署使用出现问题，请先仔细查阅文档、常见问题解答以及已有issues。
2. **前端仓库**：[MarSeventh/Sanyue-ImgHub](https://github.com/MarSeventh/Sanyue-ImgHub)
3. **注意**：本仓库为[Telegraph-Image](https://github.com/cf-pages/Telegraph-Image)项目的重制版，如果你觉得本项目不错，在支持本项目的同时，也请支持原项目。
## 2025.2.6 V2.0 版本升级注意事项
> v2.0 beta 版已发布，相较于 v1.0 版本进行了大量改动和优化，但 beta 版本可能存在潜在不稳定性，若您追求稳定，可选择暂缓更新。
>
> 由于**构建命令发生了变化**，此次更新需要您**手动进行**，请按照以下步骤进行操作：
>
> - 同步fork的仓库至最新版（若已自动同步可忽略）
>
> - 前往 pages 管理页面，进入`设置`->`构建`，编辑`构建配置`，在`构建命令`处填写`npm install`
>
> ![image-20250212190315179](static/readme/202502121903327.png)
>
> - 新版本所有设置项已**迁移至 管理端->系统设置 界面**，原则上无需再通过环境变量的方式进行设置，通过系统设置界面进行的设置将**覆盖掉**环境变量中的设置，但为了保证 **Telegram渠道的图片** 能够与旧版本相兼容，**若您之前设置了 Telegram 渠道相关的环境变量，请将其保留！**
>
> - 确保上述设置完成无误后，前往 pages 管理页面，进入`部署`，对最后一次不成功的部署进行`重试操作`
## 关于切换到 Telegram 渠道的通知
> 由于telegraph图床被滥用，该项目上传渠道已切换至Telegram Channel，请**更新至最新版（更新方式见第3.1章最后一节）**，按照文档中的部署要求**设置`TG_BOT_TOKEN`和`TG_CHAT_ID`**，否则将无法正常使用上传功能。
>
> 此外，目前**KV数据库为必须配置**，如果以前未配置请按照文档说明配置。
>
> 出现问题，请先查看第5节常见问题Q&A部分。
</details>
<details>
<summary>生态建设</summary>
## 1. 插件
- **编辑器内自动上传（油猴脚本）**：https://greasyfork.org/zh-CN/scripts/529816-image-uploader-to-markdown-to-cloudflare-imgbed （_作者：Linux.do: [calg_c](https://linux.do/u/calg_c/summary)_）
## 2.仓库
- **向TG BOT发送文件上传图床**：[uki0xc/img-up-bot: 使用telegram机器人链接图床进行上传](https://github.com/uki0xc/img-up-bot?tab=readme-ov-file) （_作者：[uki0xc](https://github.com/uki0xc)_)
</details>
<details>
<summary>体验地址及优质博文、视频（搭建或使用有问题可以先去里面学习哦~）</summary>
**体验地址**：[CloudFlare ImgBed](https://cfbed.1314883.xyz/)
> 访问码：cfbed
**体验视频**：[CloudFlare免费图床，轻松守护你的每一份精彩！_哔哩哔哩_bilibili](https://www.bilibili.com/video/BV1y3WGe4EGh/?vd_source=da5ecbe595e41089cd1bed95932b8bfd)
**相关教程视频**：
- [利用Cloudflare R2 +Pages搭建在线图床系统，不限空间，不被墙，超级简单，完全免费 (youtube.com)](https://www.youtube.com/watch?v=T8VayuUMOzM)
**相关优质博文（感谢每一位鼎力支持的热心大佬）：**
- [CloudFlare-ImgBed项目 – yunsen2025的小窝](https://www.yunsen2025.top/category/cloudflare-imgbed/)
- [完全免费，图文教程手把手教你使用cloudflare搭建一个无限空间的私人图床 支持身份认证与成人元素鉴定！ - yunsen2025的小窝](https://www.yunsen2025.top/blog-cfpages-syq-imgbed)
- [为CloudFlare-ImgBed图床配置国内CDN并分线路解析，以最低成本享受极致速度！ – yunsen2025的小窝](https://www.yunsen2025.top/cloudflare-imgbed-fen-xian-pei-zhi-guo-nei-cdn/)
- [利用cloudflare pages搭建telegram频道图床 (lepidus.me)](https://blogstr.lepidus.me/post/1725801323700/)
- [搭建基于CloudFlare和Telegram的免费图床教程 - 刘学馆 | Blog (sexy0769.com)](https://blog.sexy0769.com/skill/735.html)
- [CloudFlare+Github，打造属于自己的免费图床 - 大头钉的小小blog (luckyting.top)](https://luckyting.top/index.php/archives/20/)
</details>
## 最近更新
Add Features:
- 美化报错图片
- 上传页面支持预览ico等更多格式文件
<details>
<summary>更新日志</summary>
## 2025.6.13
Add Features:
- 美化报错图片
- 上传页面支持预览ico等更多格式文件
## 2025.6.12
Add Features:
- `upload`接口支持跨域访问和调用
Fix Bugs:
- 修复`list`接口返回数据完整性的问题
## 2025.5.23
Add Features:
- 增加公告功能
Fix Bugs:
- 修复后台图片名过长遮盖图片的问题
- 优化部分页面显示效果
- 修复 Docker 镜像无法访问 https 外链的问题
## 2025.5.11
Add Features:
- 支持通过Docker在服务器上部署
## 2025.3.14
Add Features:
- 上传用户管理支持显示IP具体位置
## 2025.3.8
Add Features:
- 随机图API支持按目录读取，支持按目录进行权限控制
Fix Bugs:
- 修复随机图API的缓存问题
## 2025.3.7
Add Features:
- **目录功能上线啦**，当前支持：
- 上传到指定目录
- 整目录删除
- 文件位置移动（ Telegraph 和旧版 Telegram 渠道不支持移动）
- 按目录读取文件
- 随机图API支持按目录读取
Fix Bugs:
- 修复多项影响体验的bug
## 2025.3.1
Add Features:
- 支持粘贴多个链接同时上传
- 支持存储和管理外链
Fix Bugs:
- 修复管理端复制 S3 链接的有关问题
- 修复管理端部分页面设置不生效的问题
- 修复渠道设置某些情况下不能保存的问题
## 2025.2.6
**v2.0版本焕新登场**，带来多项新功能和优化，给您焕然一新的用户体验：
💪**更强大**：
- 接入 S3 API 渠道，支持 Cloudflare R2 , Backblaze B2 ，七牛云，又拍云等多个服务商的对象存储服务
- 支持设置多个 Telegram 和 S3 渠道，支持多渠道负载均衡
- 上传文件支持短链接命名方式
✈️**更高效**：
- 全部设置项迁移到管理端系统设置界面，无需进行环境变量的繁琐配置，立即设置立即生效
- 管理端 Gallery 和 用户管理 等页面实现分页读取，提升前端渲染速度，优化使用体验
- 支持禁用、启用渠道，渠道管理自在掌握
- 多个设置项加入提示弹窗，不用到处翻阅文档，设置更踏实
✨**更精致**：
- 全局支持深色模式，根据用户喜好和时间自动切换，凸显满满高级感
- 登陆页面、图库页面、用户管理页面等多个页面细节重新打磨，操作更直观
- 上传页全新 Tab 栏，一拉一合，灵动又便捷
- Logo 焕新，纯手工打造，能力有限，不喜勿喷（
- 支持自定义隐藏页脚，强迫症患者有救啦
## 2024.12.27
Add Features:
- 支持通过环境变量自定义全局默认链接前缀（见3.1.3.6自定义配置接口）
- 管理端支持自定义链接前缀
- 管理端部分页面展示效果优化
- `/upload`API支持返回完整链接（请求时设置`returnFormat`参数，详见API文档）
Fix Bugs:
- 优化上传页面显示效果
## 2024.12.20
Add Features:
- 管理端支持拉黑上传IP（Dashboard->用户管理->允许上传）
- 管理端批量操作支持按照用户选择的顺序进行（[#issue124](https://github.com/MarSeventh/CloudFlare-ImgBed/issues/124)）
- `random`接口优化，减少KV操作次数，增加`content`参数，支持返回指定类型的文件
- 接入CloudFlare Cache API，提升 list 相关接口访问速度
- 正常读取返回图片的CDN缓存时间从1年调整为7天，防止缓存清除不成功的情况下图片长时间内仍可以访问的问题
## 2024.12.14
Add Features:
- 管理端增加批量黑名单、白名单功能
## 2024.12.13
Add Features:
- 优化blockimg、whitelistmode、404等返回状态的缓存策略，尽可能减少回源请求(参考文档`3.1.3.9管理端删除、拉黑等操作优化`进行设置)
## 2024.12.12
Add Features:
- 后端支持上传失败自动切换其他渠道重试
- 优化404、blockimg、whitelistmode等返回状态的显示样式
## 2024.12.11
Add Features:
- 进行删除、加入白名单、加入黑名单等操作时，自动清除CF CDN缓存，避免延迟生效(参考文档`3.1.3.9管理端删除、拉黑等操作优化`进行设置)
## 2024.12.10
Add Features:
- 文件详情增加文件大小记录
## 2024.12.09
Add Features:
- 开放更多文件格式
Fix Bugs:
- 读取文件响应头增加允许跨域头`access-control-allow-origin: *`
## 2024.12.04
Add Features:
- 支持自定义命名方式（仅原名 or 仅随机前缀 or 默认的随机前缀_原名）
- Telegram Channel渠道上传文件记录机器人和频道数据，便于迁移和备份
- 支持自定义链接前缀
Fix Bugs:
- R2渠道在管理端删除时，存储桶同步删除
## 2024.11.05
Add Features:
- 增加对R2 bucket的支持
## 2024.10.20
Add Features:
- 页脚增加自定义传送门功能
## 2024.09.28
Add Features:
- 上传页面右下角工具栏样式重构，支持上传页自定义压缩（上传前+存储端）
- 增加仅删除上传成功图片、上传失败图片重试
## 2024.09.27
Add Features:
- 上传页面点击链接时，自动复制到剪切板
- 上传设置记忆（上传方式、链接格式等）
Fix Bugs:
- 若未设置密码，无需跳转登录页
## 2024.09.26
Add Features:
- 优化粘贴上传时的文件命名方法
## 2024.09.12
Add Features:
- 增加背景透明度支持自定义
## 2024.09.11
Add Features:
- 支持背景切换时间自定义
## 2024.08.26
Add Features:
- 支持大于5MB的图片上传前自动压缩
- 图床名称和Logo支持自定义
- 网站标题和Icon支持自定义
## 2024.08.23
Add Features:
- 支持URL粘贴上传
## 2024.08.21
Add Features:
- 完善多格式链接展示形式，增加UBB格式链接支持
- 完善登录逻辑，后端增加认证码校验接口
## 2024.07.25
Add Features:
- 增加随机图API
Fix Bugs:
- 修复API上传无法直接展示在后台的问题
## 2024.07.22
Add Features:
- 增加粘贴图片上传功能
## 2024.07.21
Add Features:
- 增加Markdown、HTML等格式链接复制功能
- 上传页面增加管理端入口
</details>
# 1.Introduction
免费文件托管解决方案，具有**上传**、**管理**、**读取**、**删除**等全链路功能，覆盖文件全生命周期，支持**鉴权**、**目录**、**图片审查**、**随机图**等各项特性。
![CloudFlare](static/readme/海报.png)
# 2.Features
<details>
<summary>项目特性</summary>
- **开源**
- 前端开源（可自行修改、打包使用）
- **炫酷的动效（**
- 流畅丝滑的过渡动画~
- 上传文件实现呼吸灯效果
- 灵动的操作体验
- **人性化上传**
- **覆盖大多数文件格式**：支持绝大多数常见**图片、视频、动图**等，同时也支持其他大多数格式的文件
- **支持多种存储渠道**：支持 **Telegram Bot**, **Cloudflare R2**, **S3** 等多种存储渠道一键切换
> Telegram Bot渠道：上传文件大小限制为20MB，提供客户端和服务端压缩功能
>
> Cloudflare R2渠道：上传大小不限，但超过免费额度会扣费，详见[Pricing | Cloudflare R2 docs](https://developers.cloudflare.com/r2/pricing/)
>
> ![](static/readme/202411052346701.png)
- **上传方式多样**：支持多种上传方式（**拖拽点击、粘贴**）（Web/API)
> 1. 粘贴上传支持**文件**和**URL**
> 2. 支持批量上传（不限同时选择文件数量，但为了保证稳定性，同时处于上传状态的文件最多为10个）
> 3. 上传显示实时上传进度
> 4. Web和API端上传图片，均可直接展示在管理页面中
> 5. 过大图片在前端进行压缩，提升上传稳定性和加载性能;支持自定义压缩质量，自定义

413
README.zh-TW.md
View File

@@ -1,413 +0,0 @@
<div align="center">
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed"><img width="80%" alt="logo" src="static/readme/banner.png"/></a>
<p><em>🗂️開源文件托管解決方案，基於 Cloudflare Pages，支持 Telegram Bot 、 Cloudflare R2 ，S3 等多種存儲渠道</em></p>
<p>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/README.md">簡體中文</a>|<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/README_en.md">English</a>
</p>
<div>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/MarSeventh/CloudFlare-ImgBed" alt="License" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/releases">
<img src="https://img.shields.io/github/release/MarSeventh/CloudFlare-ImgBed" alt="latest version" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/releases">
<img src="https://img.shields.io/github/downloads/MarSeventh/CloudFlare-ImgBed/total?color=%239F7AEA&logo=github" alt="Downloads" />
</a>
<a href="https://hub.docker.com/r/marseventh/cloudflare-imgbed">
<img src="https://img.shields.io/docker/pulls/marseventh/cloudflare-imgbed?style=flat-square" alt="Docker Pulls" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/issues">
<img src="https://img.shields.io/github/issues/MarSeventh/CloudFlare-ImgBed" alt="Issues" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/stargazers">
<img src="https://img.shields.io/github/stars/MarSeventh/CloudFlare-ImgBed" alt="Stars" />
</a>
<a href="https://github.com/MarSeventh/CloudFlare-ImgBed/network/members">
<img src="https://img.shields.io/github/forks/MarSeventh/CloudFlare-ImgBed" alt="Forks" />
</a>
</div>
</div>
---
> [!IMPORTANT]
>
> **v2.0 版本升級注意事項請查看公告！**
<details>
<summary>公告</summary>
## 置頂
1. 部署使用出現問題，請先仔細查閱文檔、常見問題解答以及已有issues。
2. **前端倉庫**：[MarSeventh/Sanyue-ImgHub](https://github.com/MarSeventh/Sanyue-ImgHub)
3. **注意**：本倉庫為[Telegraph-Image](https://github.com/cf-pages/Telegraph-Image)項目的重製版，如果你覺得本項目不錯，在支持本項目的同時，也請支持原項目。
## 2025.2.6 V2.0 版本升級注意事項
> v2.0 beta 版已發布，相較於 v1.0 版本進行了大量改動和優化，但 beta 版本可能存在潛在不穩定性，若您追求穩定，可選擇暫緩更新。
>
> 由於**構建命令發生了變化**，此次更新需要您**手動進行**，請按照以下步驟進行操作：
>
> - 同步fork的倉庫至最新版（若已自動同步可忽略）
>
> - 前往 pages 管理頁面，進入`設置`->`構建`，編輯`構建配置`，在`構建命令`處填寫`npm install`
>
> ![image-20250212190315179](static/readme/202502121903327.png)
>
> - 新版本所有設置項已**遷移至 管理端->系統設置 界面**，原則上無需再通過環境變量的方式進行設置，通過系統設置界面進行的設置將**覆蓋掉**環境變量中的設置，但為了保證 **Telegram渠道的圖片** 能夠與舊版本相兼容，**若您之前設置了 Telegram 渠道相關的環境變量，請將其保留！**
>
> - 確保上述設置完成無誤後，前往 pages 管理頁面，進入`部署`，對最後一次不成功的部署進行`重試操作`
## 關於切換到 Telegram 渠道的通知
> 由於telegraph圖床被濫用，該項目上傳渠道已切換至Telegram Channel，請**更新至最新版（更新方式見第3.1章最後一節）**，按照文檔中的部署要求**設置`TG_BOT_TOKEN`和`TG_CHAT_ID`**，否則將無法正常使用上傳功能。
>
> 此外，目前**KV數據庫為必須配置**，如果以前未配置請按照文檔說明配置。
>
> 出現問題，請先查看第5節常見問題Q&A部分。
</details>
<details>
<summary>生態建設</summary>
## 1. 插件
- **編輯器內自動上傳（油猴腳本）**：https://greasyfork.org/zh-CN/scripts/529816-image-uploader-to-markdown-to-cloudflare-imgbed （_作者：Linux.do: [calg_c](https://linux.do/u/calg_c/summary)_）
## 2.倉庫
- **向TG BOT發送文件上傳圖床**：[uki0xc/img-up-bot: 使用telegram機器人鏈接圖床進行上傳](https://github.com/uki0xc/img-up-bot?tab=readme-ov-file) （_作者：[uki0xc](https://github.com/uki0xc)_)
</details>
<details>
<summary>體驗地址及優質博文、視頻（搭建或使用有問題可以先去裡面學習哦~）</summary>
**體驗地址**：[CloudFlare ImgBed](https://cfbed.1314883.xyz/)
> 訪問碼：cfbed
**體驗視頻**：[CloudFlare免費圖床，輕鬆守護你的每一份精彩！_哔哩哔哩_bilibili](https://www.bilibili.com/video/BV1y3WGe4EGh/?vd_source=da5ecbe595e41089cd1bed95932b8bfd)
**相關教程視頻**：
- [利用Cloudflare R2 +Pages搭建在線圖床系統，不限空間，不被牆，超級簡單，完全免費 (youtube.com)](https://www.youtube.com/watch?v=T8VayuUMOzM)
**相關優質博文（感謝每一位鼎力支持的熱心大佬）：**
- [CloudFlare-ImgBed項目 – yunsen2025的小窩](https://www.yunsen2025.top/category/cloudflare-imgbed/)
- [完全免費，圖文教程手把手教你使用cloudflare搭建一個無限空間的私人圖床 支持身份認證與成人元素鑑定！ - yunsen2025的小窩](https://www.yunsen2025.top/blog-cfpages-syq-imgbed)
- [為CloudFlare-ImgBed圖床配置國內CDN並分線路解析，以最低成本享受極致速度！ – yunsen2025的小窩](https://www.yunsen2025.top/cloudflare-imgbed-fen-xian-pei-zhi-guo-nei-cdn/)
- [利用cloudflare pages搭建telegram頻道圖床 (lepidus.me)](https://blogstr.lepidus.me/post/1725801323700/)
- [搭建基於CloudFlare和Telegram的免費圖床教程 - 劉學館 | Blog (sexy0769.com)](https://blog.sexy0769.com/skill/735.html)
- [CloudFlare+Github，打造屬於自己的免費圖床 - 大頭釘的小小blog (luckyting.top)](https://luckyting.top/index.php/archives/20/)
</details>
## 最近更新
Add Features:
- 美化報錯圖片
- 上傳頁面支持預覽ico等更多格式文件
<details>
<summary>更新日誌</summary>
## 2025.6.13
Add Features:
- 美化報錯圖片
- 上傳頁面支持預覽ico等更多格式文件
## 2025.6.12
Add Features:
- `upload`接口支持跨域訪問和調用
Fix Bugs:
- 修復`list`接口返回數據完整性的问题
## 2025.5.23
Add Features:
- 增加公告功能
Fix Bugs:
- 修復後台圖片名過長遮蓋圖片的問題
- 優化部分頁面顯示效果
- 修復 Docker 鏡像無法訪問 https 外鏈的問題
## 2025.5.11
Add Features:
- 支持通過Docker在服務器上部署
## 2025.3.14
Add Features:
- 上傳用戶管理支持顯示IP具體位置
## 2025.3.8
Add Features:
- 隨機圖API支持按目錄讀取，支持按目錄進行權限控制
Fix Bugs:
- 修復隨機圖API的緩存問題
## 2025.3.7
Add Features:
- **目錄功能上線啦**，當前支持：
- 上傳到指定目錄
- 整目錄刪除
- 文件位置移動（ Telegraph 和舊版 Telegram 渠道不支持移動）
- 按目錄讀取文件
- 隨機圖API支持按目錄讀取
Fix Bugs:
- 修復多項影響體驗的bug
## 2025.3.1
Add Features:
- 支持粘貼多個鏈接同時上傳
- 支持存儲和管理外鏈
Fix Bugs:
- 修復管理端複製 S3 鏈接的有關問題
- 修復管理端部分頁面設置不生效的問題
- 修復渠道設置某些情況下不能保存的問題
## 2025.2.6
**v2.0版本煥新登場**，帶來多項新功能和優化，給您煥然一新的用戶體驗：
💪**更強大**：
- 接入 S3 API 渠道，支持 Cloudflare R2 , Backblaze B2 ，七牛雲，又拍雲等多個服務商的對象存儲服務
- 支持設置多個 Telegram 和 S3 渠道，支持多渠道負載均衡
- 上傳文件支持短鏈接命名方式
✈️**更高效**：
- 全部設置項遷移到管理端系統設置界面，無需進行環境變量的繁瑣配置，立即設置立即生效
- 管理端 Gallery 和 用戶管理 等頁面實現分頁讀取，提升前端渲染速度，優化使用體驗
- 支持禁用、啟用渠道，渠道管理自在掌握
- 多個設置項加入提示彈窗，不用到處翻閱文檔，設置更踏實
✨**更精緻**：
- 全局支持深色模式，根據用戶喜好和時間自動切換，凸顯滿滿高級感
- 登錄頁面、圖庫頁面、用戶管理頁面等多個頁面細節重新打磨，操作更直觀
- 上傳頁全新 Tab 欄，一拉一合，靈動又便捷
- Logo 煥新，純手工打造，能力有限，不喜勿噴（
- 支持自定義隱藏頁腳，強迫症患者有救啦
## 2024.12.27
Add Features:
- 支持通過環境變量自定義全局默認鏈接前綴（見3.1.3.6自定義配置接口）
- 管理端支持自定義鏈接前綴
- 管理端部分頁面展示效果優化
- `/upload`API支持返回完整鏈接（請求時設置`returnFormat`參數，詳見API文檔）
Fix Bugs:
- 優化上傳頁面顯示效果
## 2024.12.20
Add Features:
- 管理端支持拉黑上傳IP（Dashboard->用戶管理->允許上傳）
- 管理端批量操作支持按照用戶選擇的順序進行（[#issue124](https://github.com/MarSeventh/CloudFlare-ImgBed/issues/124)）
- `random`接口優化，減少KV操作次數，增加`content`參數，支持返回指定類型的文件
- 接入CloudFlare Cache API，提升 list 相關接口訪問速度
- 正常讀取返回圖片的CDN緩存時間從1年調整為7天，防止緩存清除不成功的情況下圖片長時間內仍可以訪問的問題
## 2024.12.14
Add Features:
- 管理端增加批量黑名單、白名單功能
## 2024.12.13
Add Features:
- 優化blockimg、whitelistmode、404等返回狀態的緩存策略，儘可能減少回源請求(參考文檔`3.1.3.9管理端刪除、拉黑等操作優化`進行設置)
## 2024.12.12
Add Features:
- 後端支持上傳失敗自動切換其他渠道重試
- 優化404、blockimg、whitelistmode等返回狀態的顯示樣式
## 2024.12.11
Add Features:
- 進行刪除、加入白名單、加入黑名單等操作時，自動清除CF CDN緩存，避免延遲生效(參考文檔`3.1.3.9管理端刪除、拉黑等操作優化`進行設置)
## 2024.12.10
Add Features:
- 文件詳情增加文件大小記錄
## 2024.12.09
Add Features:
- 開放更多文件格式
Fix Bugs:
- 讀取文件響應頭增加允許跨域頭`access-control-allow-origin: *`
## 2024.12.04
Add Features:
- 支持自定義命名方式（僅原名 or 僅隨機前綴 or 默認的隨機前綴_原名）
- Telegram Channel渠道上傳文件記錄機器人和頻道數據，便於遷移和備份
- 支持自定義鏈接前綴
Fix Bugs:
- R2渠道在管理端刪除時，存儲桶同步刪除
## 2024.11.05
Add Features:
- 增加對R2 bucket的支持
## 2024.10.20
Add Features:
- 頁腳增加自定義傳送門功能
## 2024.09.28
Add Features:
- 上傳頁面右下角工具欄樣式重構，支持上傳頁自定義壓縮（上傳前+存儲端）
- 增加僅刪除上傳成功圖片、上傳失敗圖片重試
## 2024.09.27
Add Features:
- 上傳頁面點擊鏈接時，自動複製到剪切板
- 上傳設置記憶（上傳方式、鏈接格式等）
Fix Bugs:
- 若未設置密碼，無需跳轉登錄頁
## 2024.09.26
Add Features:
- 優化粘貼上傳時的文件命名方法
## 2024.09.12
Add Features:
- 增加背景透明度支持自定義
## 2024.09.11
Add Features:
- 支持背景切換時間自定義
## 2024.08.26
Add Features:
- 支持大於5MB的圖片上傳前自動壓縮
- 圖床名稱和Logo支持自定義
- 網站標題和Icon支持自定義
## 2024.08.23
Add Features:
- 支持URL粘貼上傳
## 2024.08.21
Add Features:
- 完善多格式鏈接展示形式，增加UBB格式鏈接支持
- 完善登錄邏輯，後端增加認證碼校驗接口
## 2024.07.25
Add Features:
- 增加隨機圖API
Fix Bugs:
- 修復API上傳無法直接展示在後台的問題
## 2024.07.22
Add Features:
- 增加粘貼圖片上傳功能
## 2024.07.21
Add Features:
- 增加Markdown、HTML等格式鏈接複製功能
- 上傳頁面增加管理端入口
</details>
# 1.Introduction
免費文件托管解決方案，具有**上傳**、**管理**、**讀取**、**刪除**等