在日常工作里,抠图几乎是绕不开的刚需:电商主图要白底、运营做海报要透明背景、做证件照要换底色……但很多人长期依赖第三方在线抠图平台,常见痛点也很真实:次数限制、速度慢、画质不稳定、隐私担忧,更别说有的平台说不准哪天就不可用了。
所以这篇文章就带你搭一套真正“自己说了算”的解决方案:withoutbg 私有抠图站。
部署到服务器后,你就拥有一个网页工具:上传图片 → 自动去背景 → 下载透明 PNG,不需要 PS,不需要求人,不用再担心图片被上传到陌生平台(本地模式下)。官方也明确强调:本地处理时图片不会离开你的机器/服务器。
1. 项目介绍
withoutbg 是一个开源的图片去背景工具包,支持两种模式:
- 本地模型处理(免费、离线、隐私友好)
- 可选 Pro API(更强质量,适合更高要求或高并发场景)
我们今天部署的是它的 Docker Web 应用版:开箱即用的网页 UI,适合给团队、社群或自己长期使用。仓库也给了 Docker Web 的快速启动命令。
1.1 项目特点
🧠 本地 AI 去背景(隐私更安心)
本地模式下,处理发生在你的服务器上,图片默认不会外发(除非你切换到 Pro API)。
🖱️ 拖拽上传的 Web 界面
打开浏览器就能用,拖进去就开始处理,体验非常“工具化”。
⚡ 部署简单,30 秒起站
官方 Quick Start 就是一条 docker run,非常适合新手。
🧩 双引擎可切换:本地 Focus 模型 / Pro API
网页里可输入 API Key 并切换处理方式:想要完全离线就用本地,想要更强效果就切 Pro。
🧾 格式与限制清晰
支持 JPEG/PNG/WebP,单张默认最大 10MB(可配置)。
1.2 项目展示




2.相关地址
gitHub开源项目:https://github.com/withoutbg/withoutbg?tab=readme-ov-file
3.搭建环境
- 服务器:这里为了方便搭建项目使用的是莱卡云的境外香港云服务器。(国内用户连接建议使用国内的服务器(需备案域名或者IP+端口)延迟会更低)
- 莱卡云服务器促销活动性价比会更高。查看官网购买链接:https://www.lcayun.com
- 资源配置:2核2G 30G硬盘
由于国内服务器访问海外源较慢,这边为了方便演示直接使用海外服务器搭建。 - 服务器系统:Debian-13
- 【必需】安装Docker:安装好 Docker、Docker-compose
- 【非必需】域名一枚,可用于解析到服务器上使用域名访问

4.搭建视频
哔哩哔哩:https://www.bilibili.com/video/BV1iUrdBpE6q/
5.搭建方式
5.1 安装docker和docker-compose
安装教程:服务器上安装docker和docker-compose教程
5.2 创建docker文件
#在opt目录下创建withoutbg文件夹
mkdir -p /opt/withoutbg
#打开withoutbg文件
cd /opt/withoutbg
5.3 创建Docker Compose 配置
#编辑docker-compose.yml
vim docker-compose.yml
填入以下的配置文件
根据自己实际情况来设置
services:
app:
image: withoutbg/app:latest # 使用 withoutbg 官方镜像(latest=最新版本)
container_name: withoutbg # 容器名称,方便 docker ps / logs 直接定位
ports:
- "11280:80" # 端口映射:宿主机 11280 -> 容器 80(Web 访问用)
restart: unless-stopped # 重启策略:除非手动停止,否则异常退出会自动重启
environment:
- TZ=Asia/Shanghai # 设置容器时区(避免日志时间不对)
healthcheck: # 健康检查:用于判断容器内服务是否正常
# 执行命令:请求健康接口 /api/health
# 成功:返回内容里包含 ok(忽略大小写)则健康
# 失败:返回码非 0,Docker 标记为 unhealthy
test: ["CMD-SHELL", "wget -qO- http://127.0.0.1/api/health | grep -qi ok || exit 1"]
interval: 30s # 每 30 秒检查一次
timeout: 5s # 单次检查最多等待 5 秒
retries: 3 # 连续失败 3 次后标记为 unhealthy
logging: # 日志设置:限制日志大小,防止长期运行占满磁盘
driver: "json-file" # 默认日志驱动(Docker 默认就是 json-file)
options:
max-size: "20m" # 单个日志文件最大 20MB
max-file: "3" # 最多保留 3 个日志文件(滚动轮转)
5.4 运行withoutbg的docker镜像
我们先启动docker
# 启动docker
docker compose up -d
# 重启docker
docker compose stop
docker compose start
# 升级docker
docker compose down
docker compose pull
docker compose up -d

5.5 访问自己搭建的withoutbg
浏览器访问
http://你的服务器IP:11280

有需求的可以通过API来处理
6.日常维护与升级
🔄 更新 withoutbg
cd /opt/withoutbg
docker compose pull
docker compose up -d
7.结语
withoutbg 私有抠图站就已经搭建完成了。以后不管是做电商主图、海报素材、证件照换底色,还是日常剪辑配图需要透明背景,都可以直接打开你自己的地址一键处理:稳定、可控、不受平台次数限制,也不用再把图片交给第三方网站“碰运气”。
后续你可以根据实际使用场景继续优化:比如用 Nginx 反代上域名和 HTTPS、加访问密码/限流防刷、定期更新镜像并备份配置。总之,自建之后抠图这件事就从“临时求助”变成了“随时可用”的基础能力——从此告别“求别人抠图”,你自己就是工具平台。







