withoutbg/app Docker 镜像 - 轩辕镜像
withoutbg/appwithoutbg/app是一款AI驱动的自托管背景移除Web应用，集成withoutBG Focus v1.0.0开源模型，支持本地处理或Pro API访问，提供专业级图片去背景功能，保护数据隐私，部署简单。
0 次下载
🎨 withoutbg/app - AI驱动的背景移除工具
![Docker Pulls]([] ![Docker Image Size]([] ![License]([***]
即时移除图片背景 - 一款自托管Web应用，由withoutBG Focus v1.0.0开源模型提供支持，可选Pro API访问以获取顶级质量的处理结果。
🚀 快速开始
30秒内启动并运行：
bashdocker run -p 80:80 withoutbg/app:latest
然后在浏览器中打开**http://localhost**。就是这么简单！🎉
✨ 为什么选择withoutbg？
- 🏠 自托管 - 完全控制您的数据和处理过程
- 🚀 生产就绪 - 基于React 18、FastAPI和Vite构建
- 🎯 双处理选项 - 本地Focus模型或withoutBG Pro API
- 🖼️ 高质量 - Focus v1.0.0带来专业级效果
- 💻 现代UI - 美观、响应式界面，支持拖放操作
- 🔒 隐私优先 - 本地处理确保图片保留在您的服务器上
- 📦 轻松部署 - 单条Docker命令即可启动
- 🆓 开源 - Apache 2.0许可，透明且可扩展
🎯 适用场景
- 📸 摄影师 - 处理人像，精细保留发丝细节
- 🛒 电商卖家 - 批量处理清晰的产品图片
- 🎨 设计师 - 工作流中快速移除背景
- 👥 营销团队 - 为活动制作专业图片
- 🏢 ** agencies** - 为客户工作提供自托管解决方案
- 💼 小型企业 - 无需订阅费用，在自有硬件上运行
🎬 镜像内容
此Docker镜像包含：
- 前端：React 18 + Vite + TailwindCSS
- 后端：FastAPI（Python 3.12）与ONNX Runtime
- AI模型：withoutBG Focus v1.0.0（预加载，约320MB）
- ISNet分割模型（177 MB）
- Depth Anything V2 vits（99 MB）
- Focus Matting模型（27 MB）
- Focus Refiner模型（15 MB）
- 服务器：Uvicorn，同时提供API和静态文件服务
- 所有依赖：无需额外配置
🖼️ 模型质量与效果
withoutBG Focus（内置 - 本地处理）
Focus v1.0.0模型提供专业级效果：
- ✅ 出色边缘细节 - 清晰、干净的边缘处理
- ✅ 优质发丝/毛发处理 - 自然保留精细细节
- ✅ 良好通用性 - 适用于多种图片类型
- ✅ 深度感知处理 - 智能主体检测
查看Focus模型效果示例 →
withoutBG Pro API（可选 - 最佳质量）
如需顶级质量，可使用withoutBG Pro API：
- 🏆 顶级质量 - 优于Focus模型的效果
- ⚡ 更快处理 - 优化的云基础设施
- 🔧 低资源占用 - 处理在云端进行
- 📈 可扩展性 - 处理高容量工作负载
查看Pro API效果示例 →
对比Focus与Pro →
📖 使用示例
基础使用
bash# 默认端口80运行 docker run -p 80:80 withoutbg/app:latest # 自定义端口运行 docker run -p 8080:80 withoutbg/app:latest # 后台运行 docker run -d -p 80:80 --name withoutbg withoutbg/app:latest
生产环境部署
bash# 带重启策略 docker run -d \ --name withoutbg \ --restart unless-stopped \ -p 80:80 \ withoutbg/app:latest
Docker Compose配置
yamlversion: '3.8' services: withoutbg: image: withoutbg/app:latest ports: - "80:80" restart: unless-stopped
使用withoutBG Pro API（可选）
需要更高质量？只需在Web界面中输入API密钥！
- 从withoutbg.com获取API密钥
- 打开http://localhost访问Web界面
- 在设置中输入API密钥
- 根据需要切换本地Focus模型和Pro API
🌐 访问应用
启动容器后，打开浏览器：
即可看到直观的拖放界面，您可以：
- 📤 上传图片（拖放或点击浏览）
- 🎨 使用Focus模型处理图片
- 🔄 通过交互式滑块比较处理前后效果
- 💾 立即下载处理后的图片
💡 Web界面使用方法
- 启动容器（见快速开始部分）
- 在浏览器中打开http://localhost
- 拖放图片或点击浏览上传
- 等待几秒处理（约2-5秒）
- 使用滑块比较处理前后效果
- 下载透明背景的图片
可选：使用Pro API获取最佳质量
如需更好效果，可轻松切换至Pro API：
- 从withoutbg.com获取API密钥
- 在Web界面设置中输入密钥
- 根据需要切换模型：
- 本地Focus模型（免费、快速、优质）
- Pro API（最佳质量，需API密钥）
📊 版本标签
| 标签 | 描述 | 适用场景 |
|---|---|---|
latest | 最新稳定版 | 生产环境部署 |
1.x.x | 特定版本 | 固定到精确版本 |
1.x | 次要版本系列 | 自动获取补丁更新 |
1 | 主要版本系列 | 获取所有v1.x更新 |
示例：
bash# 获取最新版 docker pull withoutbg/app:latest # 固定到特定版本 docker pull withoutbg/app:1.0.0 # 获取1.0的补丁更新 docker pull withoutbg/app:1.0
🔧 配置与环境
默认设置
- 端口：80（容器内部端口）
- 模型：withoutBG Focus v1.0.0（预加载）
- 支持格式：PNG、JPEG、WebP
- 最大上传大小：10MB（可配置）
自定义端口映射
bash# 在不同端口运行（如8080） docker run -d \ -p 8080:80 \ withoutbg/app:latest # 然后通过http://localhost:8080访问
📈 性能表现
本地处理（Focus模型）
- 首次运行：约5-10秒/张（模型初始化）
- 后续运行：约2-5秒/张（CPU）
- 内存占用：约2GB RAM
- 磁盘空间：约320MB（模型预加载于镜像中）
- 成本：永久免费
Pro API处理（可选）
- 处理时间：约1-3秒/张
- 内存占用：极低（处理在云端进行）
- 成本：按使用付费
- 质量：顶级效果
🔒 隐私与安全
- 本地优先：使用Focus模型时，所有处理在服务器本地进行
- 无外部调用：图片不会离开服务器（除非使用Pro API）
- 开源透明：代码可自行审计
- Apache 2.0许可：商业友好许可
🆘 故障排除
容器无法启动？
bash# 查看日志 docker logs withoutbg # 检查端口80是否可用 docker ps lsof -i :80 # macOS/Linux
内存不足？
bash# 增加Docker内存限制 # Docker Desktop → 设置 → 资源 → 内存 # 推荐：4GB以上以确保流畅运行
端口已被占用？
bash# 使用其他端口 docker run -p 8080:80 withoutbg/app:latest # 然后通过http://localhost:8080访问
API返回错误？
bash# 检查API健康状态 curl http://localhost/api/health # 查看详细日志 docker logs -f withoutbg
🤝 贡献指南
这是一个开源项目！欢迎贡献：
- 🐛 报告漏洞：GitHub Issues
- 💡 建议功能：GitHub Discussions
- 🔧 提交PR：贡献指南
代码仓库：github.com/withoutbg/withoutbg
📜 许可协议
Apache License 2.0 - 详见LICENSE
第三方组件
- Depth Anything V2：Apache 2.0许可（仅vits模型）
- ISNet：Apache 2.0许可
完整第三方许可信息见THIRD_PARTY_LICENSES.md
🌟 在GitHub上为我们点赞！
如果觉得有用，请为仓库点赞：
github.com/withoutbg/withoutbg
📚 其他资源
- 完整文档 - 详细的设置和部署指南
- Focus模型效果 - 查看内置模型的输出示例
- Pro API效果 - 查看顶级质量输出
- 模型对比 - Focus与Pro对比
- GitHub仓库 - 源代码和问题跟踪
- 更新日志 - 版本历史
- Python SDK - 编程方式使用
💬 支持与社区
- GitHub Issues：报告漏洞
- GitHub Discussions：提问交流
- 官网：withoutbg.com
由withoutbg团队精心打造 ❤️
专业级背景移除，无需订阅。 🚀
istio/app
仅用于Istio测试的Docker镜像
11M+ pulls
上次更新：未知
docker/app
使Docker Compose应用可重用，并可在Docker Hub上共享的实验性工具
41.9K pulls
上次更新：未知
xampp/app
xampp/app 是集成 Apache、MySQL、PHP 和 Perl 的 Docker 镜像，用于快速搭建跨平台 Web 开发环境，简化本地开发和测试环境的部署流程。
22100K+ pulls
上次更新：未知
kcnjbsf/app
暂无描述
100K+ pulls
上次更新：未知
webdb/app
WebDB是一款开源高效的数据库IDE，集成数据查看器、智能查询编辑器、版本历史回溯、ERD可视化等工具，支持自动发现数据库和NoSQL结构推断，适用于数据库开发与管理，提升操作效率。
3100K+ pulls
上次更新：未知
rvennam/app
暂无描述
100K+ pulls
上次更新：未知
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录仓库拉取
通过 Docker 登录认证访问私有仓库
Linux
在 Linux 系统配置镜像服务
Windows/Mac
在 Docker Desktop 配置镜像
Docker Compose
Docker Compose 项目配置
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
MacOS OrbStack
MacOS OrbStack 容器配置
宝塔面板
在宝塔面板一键配置镜像
群晖
Synology 群晖 NAS 配置
飞牛
飞牛 fnOS 系统配置镜像
极空间
极空间 NAS 系统配置服务
爱快路由
爱快 iKuai 路由系统配置
绿联
绿联 NAS 系统配置镜像
威联通
QNAP 威联通 NAS 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
专属域名拉取
无需登录使用专属域名
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
轩辕镜像免费版与专业版有什么区别？
免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。
轩辕镜像支持哪些镜像仓库？
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。
流量耗尽错误提示
当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
410 错误问题
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
manifest unknown 错误
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
镜像拉取成功后，如何去掉轩辕镜像域名前缀？
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"
咨询镜像拉取问题请 提交工单，官方技术交流群：1072982923
轩辕镜像面向开发者与科研用户，提供开源镜像的搜索和访问支持。所有镜像均来源于原始仓库，本站不存储、不修改、不传播任何镜像内容。