闲鱼超级管家 详细部署教程

闲鱼超级管家 是一个开源免费的闲鱼自动化运营管理平台，支持智能自动回复、多规格自动发货、多账号管理、AI智能议价等核心功能。它基于 xianyu-auto-reply 二次开发，并采用了全新的现代化UI界面。

下面为你提供两种最主流的部署方式，建议根据你的技术水平和设备情况选择。

方案一：Docker 部署（强烈推荐 ✅）

这是最简单、最稳定的方式，尤其适合NAS（如飞牛、群晖）、软路由、低配VPS等设备。此方式使用官方预构建镜像，无需在本机编译代码，能避免因内存不足导致部署失败。

1. 一条命令直接启动（最快）

有 Docker 就能跑，不需要克隆仓库。在终端中执行以下命令（记得修改密码）：

1
2
3
4
5
6
7
8
9
docker run -d --name xianyu-butler \
  -p 8080:8080 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/logs:/app/logs \
  -v $(pwd)/backups:/app/backups \
  -e ADMIN_USERNAME=admin \
  -e ADMIN_PASSWORD=改成你自己的强密码 \
  --restart unless-stopped \
  ghcr.io/23star/xianyu-super-butler:latest

Windows PowerShell 用户：把 $(pwd) 换成 ${PWD}，把行尾的 \ 换成反引号 ```。

执行后，浏览器打开 http://你的服务器IP:8080 即可访问。数据会持久化在当前目录的 data、logs、backups 文件夹中，升级容器时数据不会丢失。

2. 使用 Docker Compose（推荐长期使用）

这种方式配置更清晰，便于后续维护。

1
2
3
4
5
6
# 克隆项目
git clone https://github.com/23Star/xianyu-super-butler.git
cd xianyu-super-butler

# 启动服务（使用预构建镜像，不本地编译）
docker compose -f docker-compose.nas.yml up -d

该配置不依赖 .env 文件，管理员账号密码直接在 docker-compose.nas.yml 文件里修改 CHANGE_ME 处。

方案二：源码运行（开发调试用）

如果你需要修改代码或进行二次开发，可以选择此方式。环境要求：Python 3.11+、Node.js 20+、npm。

1. 克隆项目并安装后端依赖

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
git clone https://github.com/23Star/xianyu-super-butler.git
cd xianyu-super-butler

# 创建Python虚拟环境（推荐）
python -m venv .venv
# 激活虚拟环境（Windows）
.\.venv\Scripts\Activate.ps1
# 激活虚拟环境（macOS/Linux）
# source .venv/bin/activate

# 安装Python依赖
pip install -r requirements.txt

# 安装Playwright浏览器（用于自动化操作）
playwright install chromium

2. 构建前端

1
2
3
4
cd frontend
npm ci   # 推荐使用ci，能严格按照package-lock.json安装
npm run build
cd ..

3. 启动服务

1
python Start.py

启动成功后，在浏览器访问 http://localhost:8080。

默认管理员账号密码：admin / admin123（首次登录后请务必立即修改！ ）

⚙️ 首次使用配置流程

部署成功后，按以下步骤让系统开始工作：

  1. 登录后台：用默认账号登录，并立即在“设置”中修改密码。
  2. 添加闲鱼账号：在“账号”页面，通过扫码登录或账号密码添加你需要管理的闲鱼号。等待状态变为“在线”和“监听中”。
  3. 同步商品：在“商品”页面，选择账号并点击“同步商品”，将闲鱼上的商品数据导入系统。
  4. 配置卡密/发货内容：在“卡密”页面创建卡券分组，并导入库存。如果卖的是虚拟商品，这是自动发货的基础。
  5. 设置自动回复与发货规则：
    • 在“自动回复”或“人工智能回复”中，配置关键词回复、AI议价策略和默认话术。
    • 在“自动发货”中，为指定商品绑定卡券，或设置全局发货规则。
  6. 验证效果：到“订单”和“消息管理”页面，核对系统是否正常处理了消息和订单。可以通过“通知与日志”排查异常。

⚠️ 重要提示与免责声明

  • 风险提示：本项目仅供学习研究使用。通过自动化手段操作闲鱼账号存在被平台风控、限制功能甚至封号的风险，使用者需自行承担一切后果。
  • 滑块验证：系统内置了滑块求解功能，实测有一定成功率，但受平台风控策略影响，不保证100%成功。如果自动失败，可在账号页转人工验证。
  • 系统资源：如果使用源码部署，首次构建会下载Chromium和大量依赖，请确保网络通畅并有足够内存（建议2GB以上）。对于低配设备，务必使用Docker预构建镜像方式。

🆕 更新方式

  • Docker部署：拉取新镜像并重建容器即可。

    1
    2
    # 使用 Compose
    docker compose -f docker-compose.nas.yml pull && docker compose -f docker-compose.nas.yml up -d

  • 源码部署：git pull 拉取最新代码后，重新构建前端并重启服务。

如果在部署中遇到问题，可以先查看项目目录下的 docs/deployment.md 文档，或通过GitHub Issues反馈。