Flyimg
开源、自托管的图片实时优化服务，支持 Docker 一键部署，自动转换为 AVIF、WebP 等现代格式。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自己搭一个 Cloudinary，图片处理又快又省心。
核心功能
- 支持 AVIF、WebP、JPEG XL 等现代图片格式，体积更小画质更好
- 基于 Docker 一键部署，无需复杂配置
- 实时抓取、调整、裁剪、压缩、缓存，请求自动加速
- 完全自托管，数据隐私安全，无 API 调用限制
- 支持自定义参数，灵活控制图片质量、尺寸、格式
避坑指南
- •首次使用需运行 `composer install` 安装依赖（如果手动构建镜像）；默认监听 8080 端口，注意防火墙；图片缓存存储在容器内，重启容器会丢失，建议挂载持久化卷。
适用场景
- 网站图片加速优化，让页面加载更快
- 电商产品图批量统一尺寸及压缩
- 博客/CDN图片实时适配不同终端
- 自建图片处理服务替代 SaaS 降低费用
详细介绍
Flyimg 是一个基于 Docker 的图片实时优化服务，让你可以自建类似 Cloudinary 的图片处理平台。它从任意 URL 抓取图片，然后实时调整大小、裁剪、压缩，并缓存输出为 AVIF、WebP 等现代格式。只需一个 Docker 容器即可部署完整的图片处理流水线。它还支持 JPEG XL 格式（通过 ImageMagick）。完全自托管，数据隐私可控，无 API 调用限制，适合追求高性能和自主可控的开发者。
常见问题与排障 (1)
故障排除如何修复 Flyimg 主页上缺失 butterfly-3000.jpg 导致的 404 错误？
首页演示图片是热链接自 https://mudawn.com/assets/butterfly-3000.jpg 的,该外部资源曾一度返回 HTTP/2 404。Flyimg 维护者恢复了原图片,同时还更新了官方演示,改用托管在 flyimg.io 域名下的图片。对于自托管的 Flyimg 实例,请使用 curl -I https://mudawn.com/assets/butterfly-3000.jpg 验证该 URL;如果仍然失败,请将模板/配置中的演示图片引用替换为托管在您自己域名上的图片或最新的 Flyimg 演示资源,然后重新部署/重启应用。使用以下命令查找该引用:grep -R "butterfly-3000.jpg" .。此问题影响 Flyimg 1.4.13、1.7.5 以及其他使用旧外部示例 URL 的版本。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
确保已安装 Docker，运行 `docker pull flyimg/flyimg`
启动容器：`docker run -itd -p 8080:80 flyimg/flyimg`
浏览器访问 http://localhost:8080 验证服务正常
- 确保已安装 Docker，运行 `docker pull flyimg/flyimg`
- 启动容器：`docker run -itd -p 8080:80 flyimg/flyimg`
- 浏览器访问 http://localhost:8080 验证服务正常
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止容器：`docker stop flyimg`，删除容器：`docker rm flyimg`，删除镜像：`docker rmi flyimg/flyimg`
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ