withoutbg/app

🎨 withoutbg/app - AI驱动的背景移除工具

即时移除图片背景 - 一款自托管Web应用，由withoutBG Focus v1.0.0开源模型提供支持，可选Pro API访问以获取顶级质量的处理结果。

---

🚀 快速开始

30秒内启动并运行：

bash
docker 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配置

yaml
version: '3.8'
services:
  withoutbg:
    image: withoutbg/app:latest
    ports:
      - "80:80"
    restart: unless-stopped

使用withoutBG Pro API（可选）

需要更高质量？只需在Web界面中输入API密钥！

1. 从withoutbg.com获取API密钥
2. 打开http://localhost访问Web界面
3. 在设置中输入API密钥
4. 根据需要切换本地Focus模型和Pro API

---

🌐 访问应用

启动容器后，打开浏览器：

→ http://localhost

即可看到直观的拖放界面，您可以：

• 📤 上传图片（拖放或点击浏览）
• 🎨 使用Focus模型处理图片
• 🔄 通过交互式滑块比较处理前后效果
• 💾 立即下载处理后的图片

---

💡 Web界面使用方法

1. 启动容器（见快速开始部分）
2. 在浏览器中打开http://localhost
3. 拖放图片或点击浏览上传
4. 等待几秒处理（约2-5秒）
5. 使用滑块比较处理前后效果
6. 下载透明背景的图片

可选：使用Pro API获取最佳质量

如需更好效果，可轻松切换至Pro API：

1. 从withoutbg.com获取API密钥
2. 在Web界面设置中输入密钥
3. 根据需要切换模型：
   • 本地Focus模型（免费、快速、优质）
   • Pro API（最佳质量，需API密钥）

---

📊 版本标签

示例：

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

---

🤝 贡献指南

这是一个开源项目！欢迎贡献：

• 🐛 报告漏洞：https://github.com/withoutbg/withoutbg/issues
• 💡 建议功能：https://github.com/withoutbg/withoutbg/discussions
• 🔧 提交PR：https://github.com/withoutbg/withoutbg/blob/main/CONTRIBUTING.md

代码仓库：https://github.com/withoutbg/withoutbg

---

📜 许可协议

Apache License 2.0 - 详见https://github.com/withoutbg/withoutbg/blob/main/LICENSE

第三方组件

• Depth Anything V2：Apache 2.0许可（仅vits模型）
• ISNet：Apache 2.0许可

完整第三方许可信息见https://github.com/withoutbg/withoutbg/blob/main/THIRD_PARTY_LICENSES.md

---

🌟 在GitHub上为我们点赞！

如果觉得有用，请为仓库点赞：
https://github.com/withoutbg/withoutbg

---

📚 其他资源

• 完整文档 - 详细的设置和部署指南
• Focus模型效果 - 查看内置模型的输出示例
• Pro API效果 - 查看顶级质量输出
• 模型对比 - Focus与Pro对比
• https://github.com/withoutbg/withoutbg - 源代码和问题跟踪
• https://github.com/withoutbg/withoutbg/blob/main/CHANGELOG.md - 版本历史
• Python SDK - 编程方式使用

---

💬 支持与社区

• GitHub Issues：https://github.com/withoutbg/withoutbg/issues
• GitHub Discussions：https://github.com/withoutbg/withoutbg/discussions
• 官网：withoutbg.com

---

由withoutbg团队精心打造 ❤️

专业级背景移除，无需订阅。 🚀