🗂️开源文件托管解决方案，支持 Docker 和无服务器部署，支持 Telegram、Discord、Cloudflare R2、S3、Huggingface 等多种存储渠道，支持 WebDAV 协议和多种 RESTful API

Important

v2.0 版本升级注意事项请查看公告！

公告

置顶

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

2026.3.4 V2.6.2 重构 Docker 镜像的说明

本次版本对 Docker 镜像进行了重构，涉及基础镜像、目录结构和数据库等方面的变更，带来了并发、内存管理等方面的优化。为确保数据安全，请务必先备份数据再进行升级。

升级前：备份数据

备份数据：在管理面板下载备份文件（若原来使用本地R2存储需要全部下载重传）

备份data文件夹

升级步骤
拉取最新镜像：
docker compose pull
使用新镜像启动容器：
docker compose up -d
检查容器是否正常运行：
docker compose logs -f
确认日志中无报错信息后即可正常使用。
恢复数据：在管理面板恢复全部数据（原来的R2文件需要重传）
升级异常：回退版本

如果升级后出现异常，可通过以下步骤回退：
停止容器：
docker compose down
回退到旧版本镜像：
# amd64
docker pull marseventh/cloudflare-imgbed@sha256:896dc1b79883
# arm
docker pull marseventh/cloudflare-imgbed@sha256:b5442ccc198c
同时修改 docker-compose.yml 中的 image 字段为对应旧版本 tag，然后重新启动：
docker compose up -d
注意事项：

升级前请务必确认备份完整，必要时备份一份data文件夹

如果你使用了自定义的 docker-compose.yml 配置（如自定义端口、环境变量等），升级时请注意保留

遇到问题请先查阅文档和已有 issues，或提交新的 issue

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

v2.0 版已发布，相较于 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部分。