mirror of
https://github.com/MarSeventh/CloudFlare-ImgBed.git
synced 2026-01-31 09:03:19 +08:00
更新readme
This commit is contained in:
MarSeventh
63
README-EN.md
63
README-EN.md
@@ -1,63 +0,0 @@
|
||||
# Telegraph-Image
|
||||
|
||||
Free Image Hosting solution, Flickr/imgur alternative. Using Cloudflare Pages and Telegraph.
|
||||
|
||||
English|[中文](readme-zh.md)
|
||||
|
||||
## Deployment
|
||||
|
||||
### Preparation
|
||||
|
||||
The only thing you need to prepare in advance is a Cloudflare account
|
||||
|
||||
### Step by Step Instruction
|
||||
|
||||
3 simple steps to deploy this project and have your own image hosting
|
||||
|
||||
1.Fork this repository (Note: In order to make this work. You have to using Git or Wrangler CLI to deploy this project. [Document](https://developers.cloudflare.com/pages/functions/get-started/#deploy-your-function))
|
||||
|
||||
2.Open the Cloudflare Dashboard, enter the Pages management page, choose to create a project, then choose `Connecting to the Git Provider`
|
||||
|
||||
|
||||
|
||||
3. Follow the prompts on the page to enter the project name, select the git repository you need to connect to, then click `Deploy`
|
||||
|
||||
## Features
|
||||
|
||||
1. Unlimited number of images stored, you can upload an unlimited number of images
|
||||
|
||||
2. No need to buy a server, hosted on Cloudflare's network, when the use does not exceed Cloudflare's free quota, completely free
|
||||
|
||||
3. No need to buy a domain name, you can use the free second-level domain name `*.pages.dev` provided by Cloudflare Pages, and also support binding custom domain names
|
||||
|
||||
4. Support image review API, can be opened as needed, after opening undesirable images will be automatically blocked, no longer loaded
|
||||
|
||||
### Add custom domains
|
||||
|
||||
Inside the custom domain of pages, bind the domain name that exists in your Cloudflare account, the domain name hosted in cloudflare, will automatically modify the dns record
|
||||
|
||||
|
||||
### Setup image review API
|
||||
|
||||
1. Please go to https://moderatecontent.com/ to register and get a free API key for reviewing image content
|
||||
|
||||
2. Open the settings of Cloudflare Pages, click `Settings`, `Environment Variables`, `Add Environment Variables` in turn
|
||||
|
||||
3. Add a `variable` name as `ModerateContentApiKey`, `value` as the `API key` you just got in the first step, click `Save` to
|
||||
|
||||
Note: Since the changes will take effect on the next deployment, you may need to go to the `Deploy` page and redeploy the project
|
||||
|
||||
When image review is enabled, the first time image load will be slow because it takes time to review, but the subsequent image load will not be affected due to the existence of cache
|
||||
|
||||
|
||||
### Limitations
|
||||
|
||||
1. Since the image files are actually stored in Telegraph, Telegraph limits the size of uploaded images to a maximum of 5MB
|
||||
|
||||
2. Due to the use of Cloudflare's network, the loading speed of images may not be guaranteed in some areas.
|
||||
|
||||
3. The free version of Cloudflare Function is limited to 100,000 requests per day (i.e. the total number of uploads or loads of images cannot exceed 100,000), if this is exceeded, you may need to choose to purchase the paid package of Cloudflare Function.
|
||||
|
||||
### Thanks
|
||||
|
||||
Ideas and code provided by Hostloc @feixiang and @乌拉擦
|
||||
180
README.md
180
README.md
@@ -1,182 +1,8 @@
|
||||
# Telegraph-Image
|
||||
|
||||
免费图片托管解决方案，Flickr/imgur 替代品。使用 Cloudflare Pages 和 Telegraph。
|
||||
**注意**：本仓库为[Telegraph-Image](https://github.com/cf-pages/Telegraph-Image)项目的前端重制版，如果你觉得本项目不错，在支持本项目的同时，也请支持原项目。
|
||||
|
||||
[English](README-EN.md)|中文
|
||||
## 部署流程
|
||||
|
||||
## 如何部署
|
||||
部署方式和环境变量和原仓库保持一致。
|
||||
|
||||
### 提前准备
|
||||
|
||||
你唯一需要提前准备的就是一个 Cloudflare 账户 （如果需要在自己的服务器上部署，不依赖 Cloudflare，可参考[#46](https://github.com/cf-pages/Telegraph-Image/issues/46) ）
|
||||
|
||||
### 手把手教程
|
||||
|
||||
简单 3 步，即可部署本项目，拥有自己的图床
|
||||
|
||||
1.Fork 本仓库 (注意：必须使用 Git 或者 Wrangler 命令行工具部署后才能正常使用，[文档](https://developers.cloudflare.com/pages/functions/get-started/#deploy-your-function))
|
||||
|
||||
2.打开 Cloudflare Dashboard，进入 Pages 管理页面，选择创建项目，选择`连接到 Git 提供程序`
|
||||
|
||||
|
||||
|
||||
3. 按照页面提示输入项目名称，选择需要连接的 git 仓库，点击`部署站点`即可完成部署
|
||||
|
||||
## 特性
|
||||
|
||||
1.无限图片储存数量，你可以上传不限数量的图片
|
||||
|
||||
2.无需购买服务器，托管于 Cloudflare 的网络上，当使用量不超过 Cloudflare 的免费额度时，完全免费
|
||||
|
||||
3.无需购买域名，可以使用 Cloudflare Pages 提供的`*.pages.dev`的免费二级域名，同时也支持绑定自定义域名
|
||||
|
||||
4.支持图片审查 API，可根据需要开启，开启后不良图片将自动屏蔽，不再加载
|
||||
|
||||
5.支持后台图片管理，可以对上传的图片进行在线预览，添加白名单，黑名单等操作
|
||||
|
||||
### 绑定自定义域名
|
||||
|
||||
在 pages 的自定义域里面，绑定 cloudflare 中存在的域名，在 cloudflare 托管的域名，自动会修改 dns 记录
|
||||
|
||||
|
||||
### 开启图片审查
|
||||
|
||||
1.请前往https://moderatecontent.com/ 注册并获得一个免费的用于审查图像内容的 API key
|
||||
|
||||
2.打开 Cloudflare Pages 的管理页面，依次点击`设置`，`环境变量`，`添加环境变量`
|
||||
|
||||
3.添加一个`变量名称`为`ModerateContentApiKey`，`值`为你刚刚第一步获得的`API key`，点击`保存`即可
|
||||
|
||||
注意：由于所做的更改将在下次部署时生效，你或许还需要进入`部署`页面，重新部署一下该本项目
|
||||
|
||||
开启图片审查后，因为审查需要时间，首次的图片加载将会变得缓慢，之后的图片加载由于存在缓存，并不会受到影响
|
||||
|
||||
|
||||
### 限制
|
||||
|
||||
1.由于图片文件实际存储于 Telegraph，Telegraph 限制上传的图片大小最大为 5MB
|
||||
|
||||
2.由于使用 Cloudflare 的网络，图片的加载速度在某些地区可能得不到保证
|
||||
|
||||
3.Cloudflare Function 免费版每日限制 100,000 个请求（即上传或是加载图片的总次数不能超过 100,000 次）如超过可能需要选择购买 Cloudflare Function 的付费套餐，如开启图片管理功能还会存在 KV 操作数量的限制，如超过需购买付费套餐
|
||||
|
||||
### 感谢
|
||||
|
||||
Hostloc @feixiang 和@乌拉擦 提供的思路和代码
|
||||
|
||||
## 更新日志
|
||||
2024 年 7 月 6 日--后台管理页面更新
|
||||
|
||||
- 支持两个新的管理页面视图（网格视图和瀑布流）
|
||||
|
||||
1、网格视图，感谢@DJChanahCJD 提交的代码
|
||||
支持批量删除/复制链接
|
||||
支持按时间倒序排序
|
||||
支持分页功能
|
||||
|
||||
2、瀑布流视图，感谢@panther125 提交的代码
|
||||
|
||||
|
||||
- 添加自动更新支持
|
||||
|
||||
现在fork的项目能够自动和上游仓库同步最新的更改，自动实装最新的项目功能，感谢 @bian2022
|
||||
|
||||
打开自动更新步骤：
|
||||
当你 fork 项目之后，由于 Github 的限制，需要手动去你 fork 后的项目的 Actions 页面启用 Workflows，并启用 Upstream Sync Action，启用之后即可开启每小时定时自动更新：
|
||||
|
||||
|
||||
`如果你遇到了 Upstream Sync 执行错误，请手动 Sync Fork 一次！`
|
||||
|
||||
手动更新代码
|
||||
|
||||
如果你想让手动立即更新，可以查看 [Github 的文档](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork) 了解如何让 fork 的项目与上游代码同步。
|
||||
|
||||
你可以 star/watch 本项目或者 follow 作者来及时获得新功能更新通知。
|
||||
- 添加远端遥测
|
||||
|
||||
可通过添加`disable_telemetry`环境变量退出遥测
|
||||
|
||||
2023 年 1 月 18 日--图片管理功能更新
|
||||
|
||||
1、支持图片管理功能，默认是关闭的，如需开启请部署完成后前往后台依次点击`设置`->`函数`->`KV 命名空间绑定`->`编辑绑定`->`变量名称`填写：`img_url` `KV 命名空间` 选择你提前创建好的 KV 储存空间，开启后访问 http(s)://你的域名/admin 即可打开后台管理页面
|
||||
| 变量名称 | KV 命名空间 |
|
||||
| ----------- | ----------- |
|
||||
| img_url | 选择提前创建好的 KV 储存空间 |
|
||||
|
||||
|
||||
|
||||
|
||||
2、后台管理页面新增登录验证功能，默认也是关闭的，如需开启请部署完成后前往后台依次点击`设置`->`环境变量`->`为生产环境定义变量`->`编辑变量` 添加如下表格所示的变量即可开启登录验证
|
||||
| 变量名称 | 值 |
|
||||
| ----------- | ----------- |
|
||||
|BASIC_USER = | <后台管理页面登录用户名称>|
|
||||
|BASIC_PASS = | <后台管理页面登录用户密码>|
|
||||
|
||||
|
||||
|
||||
当然你也可以不设置这两个值，这样访问后台管理页面时将无需验证，直接跳过登录步骤，这一设计使得你可以结合 Cloudflare Access 进行使用，实现支持邮件验证码登录，Microsoft 账户登录，Github 账户登录等功能，能够与你域名上原有的登录方式所集成，无需再次记忆多一组后台的账号密码，添加 Cloudflare Access 的方式请参考官方文档，注意需要保护路径包括/admin 以及 /api/manage/\*
|
||||
|
||||
3、新增图片总数量统计
|
||||
当开启图片管理功能后，可在后台顶部查看记录中的图片数量
|
||||
|
||||
|
||||
|
||||
4、新增图片文件名搜索
|
||||
当开启图片管理功能后，可在后台搜索框使用图片文件名称，快速搜索定位需要管理的图片
|
||||
|
||||
|
||||
|
||||
5、新增图片状态显示
|
||||
当开启图片管理功能后，可在后台查看图片当前的状态{ "ListType": "None", "TimeStamp": 1673984678274 }
|
||||
ListType 代表图片当前是否在黑白名单当中，None 则表示既不在黑名单中也不在白名单中，White 表示在在白名单中，Block 表示在黑名单中，TimeStamp 为图片首次加载的时间戳，如开启的图片审查 API，则这里还会显示图片审查的结果用 Label 标识
|
||||
|
||||
|
||||
|
||||
6、新增黑名单功能
|
||||
当开启图片管理功能后，可在后台手动为图片加入黑名单，加入黑名单的图片将无法正常加载
|
||||
|
||||
|
||||
|
||||
7、新增白名单功能
|
||||
当开启图片管理功能后，可在后台手动为图片加入白名单，加入白名单的图片无论如何都会正常加载，可绕过图片审查 API 的结果
|
||||
|
||||
|
||||
|
||||
8、新增记录删除功能
|
||||
当开启图片管理功能后，可在后台手动删除图片记录，即不再后台显示该图片，除非有人再次上传并加载该图片，注意由于图片储存在 telegraph 的服务器上，我们无法删除上传的原始图片，只能通过上述第 6 点的黑名单功能屏蔽图片的加载
|
||||
|
||||
9、新增程序运行模式：白名单模式
|
||||
当开启图片管理功能后，除了默认模式外，这次更新还新增了一项新的运行模式，在该模式下，只有被添加进白名单的图片才会被加载，上传的图片需要审核通过后才能展示，最大程度的防止不良图片的加载，如需开启请设置环境变量：WhiteList_Mode=="true"
|
||||
|
||||
10、新增后台图片预览功能
|
||||
当开启图片管理功能后，可在后台预览通过你的域名加载过的图片，点击图片可以进行放大，缩小，旋转等操作
|
||||
|
||||
|
||||
|
||||
## 已经部署了的，如何更新？
|
||||
|
||||
其实更新非常简单，只需要参照上面的更新内容，先进入到 Cloudflare Pages 后台，把需要使用的环境变量提前设置好并绑定上 KV 命名空间，然后去到 Github 你之前 fork 过的仓库依次选择`Sync fork`->`Update branch`即可，稍等一会，Cloudflare Pages 那边检测到你的仓库更新了之后就会自动部署最新的代码了
|
||||
|
||||
## 一些限制：
|
||||
|
||||
Cloudflare KV 每天只有 1000 次的免费写入额度，每有一张新的图片加载都会占用该写入额度，如果超过该额度，图片管理后台将无法记录新加载的图片
|
||||
|
||||
每天最多 100,000 次免费读取操作，图片每加载一次都会占用该额度（在没有缓存的情况下，如果你的域名在 Cloudflare 开启了缓存，当缓存未命中时才会占用该额度），超过黑白名单等功能可能会失效
|
||||
|
||||
每天最多 1,000 次免费删除操作，每有一条图片记录都会占用该额度，超过将无法删除图片记录
|
||||
|
||||
每天最多 1,000 次免费列出操作，每打开或刷新一次后台/admin 都会占用该额度，超过将进行后台图片管理
|
||||
|
||||
绝大多数情况下，该免费额度都基本够用，并且可以稍微超出一点，不是已超出就立马停用，且每项额度单独计算，某项操作超出免费额度后只会停用该项操作，不影响其他的功能，即即便我的免费写入额度用完了，我的读写功能不受影响，图片能够正常加载，只是不能在图片管理后台看到新的图片了。
|
||||
|
||||
如果你的免费额度不够用，可以自行向 Cloudflare 购买 Cloudflare Workers 的付费版本，每月$5 起步，按量收费，没有上述额度限制
|
||||
|
||||
另外针对环境变量所做的更改将在下次部署时生效，如更改了`环境变量`，针对某项功能进行了开启或关闭，请记得重新部署。
|
||||
|
||||
|
||||
|
||||
### Sponsorship
|
||||
|
||||
This project is tested with BrowserStack.
|
||||
|
||||
This project is support by [Cloudflare](https://www.cloudflare.com/).
|
||||
|
||||
Reference in New Issue
Block a user