闲鱼自动发货系统源码搭建教程
发布时间：2025-12-24 分类：运营推广 浏览量：64
闲鱼自动回复和管理系统，采用现代化的技术架构，支持多用户、多账号管理，具备智能回复、自动发货、自动确认发货、商品管理等企业级功能。系统基于Python异步编程，使用FastAPI提供RESTful API，SQLite数据库存储，支持Docker一键部署。闲鱼自动发货系统代搭建￥100元/年，包服务器，单独为你建立好该系统，可以加我微信备注说明。
技术架构
核心技术栈
- 后端框架: FastAPI + Python 3.11+ 异步编程
- 数据库: SQLite 3 + 多用户数据隔离 + 自动迁移
- 前端: Bootstrap 5 + Vanilla JavaScript + 响应式设计
- 通信协议: WebSocket + RESTful API + 实时通信
- 部署方式: Docker + Docker Compose + 一键部署
- 日志系统: Loguru + 文件轮转 + 实时收集
- 安全认证: JWT + 图形验证码 + 邮箱验证 + 权限控制
系统架构特点
- 微服务设计: 模块化架构，易于维护和扩展
- 异步处理: 基于asyncio的高性能异步处理
- 多用户隔离: 完全的数据隔离和权限控制
- 容器化部署: Docker容器化，支持一键部署
- 实时监控: WebSocket实时通信和状态监控
- 自动化运维: 自动重连、异常恢复、日志轮转
✨ 核心特性
🔐 多用户系统
- 用户注册登录 - 支持邮箱验证码注册，图形验证码保护
- 数据完全隔离 - 每个用户的数据独立存储，互不干扰
- 权限管理 - 严格的用户权限控制和JWT认证
- 安全保护 - 防暴力破解、会话管理、安全日志
- 授权期限管理 - 核心滑块验证模块包含授权期限验证，确保合规使用
📱 多账号管理
- 无限账号支持 - 每个用户可管理多个闲鱼账号
- 独立运行 - 每个账号独立监控，互不影响
- 实时状态 - 账号连接状态实时监控
- 批量操作 - 支持批量启动、停止账号任务
🤖 智能回复系统
- 关键词匹配 - 支持精确关键词匹配回复
- 指定商品回复 - 支持为特定商品设置专门的回复内容，优先级最高
- 商品专用关键词 - 支持为特定商品设置专用关键词回复
- 通用关键词 - 支持全局通用关键词，适用于所有商品
- 批量导入导出 - 支持Excel格式的关键词批量导入导出
- AI智能回复 - 集成OpenAI API，支持上下文理解
- 变量替换 - 回复内容支持动态变量（用户名、商品信息、商品ID等）
- 优先级策略 - 指定商品回复 > 商品专用关键词 > 通用关键词 > 默认回复 > AI回复
🚚 自动发货功能
- 智能匹配 - 基于商品信息自动匹配发货规则
- 多规格支持 - 支持同一商品的不同规格自动匹配对应卡券
- 精确匹配+兜底机制 - 优先精确匹配规格，失败时自动降级到普通卡券
- 延时发货 - 支持设置发货延时时间（0-3600秒）
- 多种触发 - 支持付款消息、小刀消息等多种触发条件
- 防重复发货 - 智能防重复机制，避免重复发货
- 多种发货方式 - 支持固定文字、批量数据、API调用、图片发货等方式
- 图片发货 - 支持上传图片并自动发送给买家，图片自动上传到CDN
- 自动确认发货 - 检测到付款后自动调用闲鱼API确认发货，支持锁机制防并发
- 防重复确认 - 智能防重复确认机制，避免重复API调用
- 订单详情缓存 - 订单详情获取支持数据库缓存，大幅提升性能
- 发货统计 - 完整的发货记录和统计功能
🛍️ 商品管理
- 自动收集 - 消息触发时自动收集商品信息
- API获取 - 通过闲鱼API获取完整商品详情
- 多规格支持 - 支持多规格商品的规格信息管理
- 批量管理 - 支持批量查看、编辑、切换多规格状态
- 智能去重 - 自动去重，避免重复存储
🔍 商品搜索功能
- 真实数据获取 - 基于Playwright技术获取真实闲鱼商品数据
- 智能排序 - 按"人想要"数量自动倒序排列
- 多页搜索 - 支持一次性获取多页商品数据
- 前端分页 - 灵活的前端分页显示
- 商品详情 - 支持查看完整商品详情信息
📊 系统监控
- 实时日志 - 完整的操作日志记录和查看
- 性能监控 - 系统资源使用情况监控
- 健康检查 - 服务状态健康检查
📁 数据管理
- Excel导入导出 - 支持关键词数据的Excel格式导入导出
- 模板生成 - 自动生成包含示例数据的导入模板
- 批量操作 - 支持批量添加、更新关键词数据
- 数据验证 - 导入时自动验证数据格式和重复性
- 多规格卡券管理 - 支持创建和管理多规格卡券
- 发货规则管理 - 支持多规格发货规则的创建和管理
- 数据备份 - 自动数据备份和恢复
- 一键部署 - 提供预构建Docker镜像，无需编译即可快速部署
核心功能特性
🚀 自动回复系统
- 智能关键词匹配 - 支持精确匹配和模糊匹配，灵活配置回复规则
- AI智能回复 - 集成多种AI模型（通义千问、GPT等），智能理解用户意图
- 多账号管理 - 支持同时管理多个闲鱼账号，独立配置和运行
- 实时消息处理 - WebSocket长连接，毫秒级响应用户消息
- 自定义回复模板 - 支持占位符和动态内容，个性化回复体验
🛒 自动发货系统
- 智能订单识别 - 自动识别虚拟商品订单，精准匹配发货规则
- 多重安全验证 - 超级加密保护，防止误操作和数据泄露
- 批量处理能力 - 支持批量确认发货，提高处理效率
- 异常处理机制 - 完善的错误处理和重试机制，确保发货成功
- 多渠道通知 - 支持QQ、钉钉、飞书、Bark、邮件等多种发货通知方式
👥 多用户系统
- 用户注册登录 - 支持邮箱验证和图形验证码，安全可靠
- 权限管理 - 管理员和普通用户权限分离，精细化权限控制
- 数据隔离 - 每个用户的数据完全隔离，保护隐私安全
- 会话管理 - JWT Token认证，支持自动续期和安全登出
📊 数据管理
- 商品信息管理 - 自动获取和同步商品信息，实时更新状态
- 订单数据统计 - 详细的订单数据分析和可视化图表
- 关键词管理 - 灵活的关键词配置，支持正则表达式
- 数据导入导出 - 支持Excel格式的批量数据操作
- 自动备份 - 定期自动备份重要数据，防止数据丢失
🔍 商品搜索
- 真实数据获取 - 基于Playwright技术，无头模式获取真实闲鱼商品数据
- 多页搜索 - 支持分页搜索和批量获取，无限制数据采集
- 智能排序 - 按"人想要"数量自动倒序排列，优先显示热门商品
- 数据可视化 - 美观的商品展示界面，支持排序和筛选
- 前端分页 - 灵活的前端分页显示，提升用户体验
- 账号状态验证 - 自动检查cookies启用状态，确保搜索功能正常
📱 通知系统
- 多渠道支持 - QQ、钉钉、飞书、Bark、邮件、微信、Telegram等8种通知方式
- 智能配置 - 可视化配置界面，支持复杂参数和加密设置
- 实时推送 - 重要事件实时通知，及时了解系统状态
- 通知模板 - 自定义通知内容和格式，个性化消息推送
- 移动端支持 - Bark iOS推送，随时随地接收通知
🔐 安全特性
- Cookie安全管理 - 加密存储用户凭证，定期自动刷新
- Token自动刷新 - 智能检测和刷新过期Token，保持连接稳定
- 操作日志 - 详细记录所有操作日志，支持审计和追踪
- 异常监控 - 实时监控系统异常和错误，主动预警
🎨 用户界面
- 现代化设计 - 基于Bootstrap 5的响应式界面，美观易用
- 多主题支持 - 支持明暗主题切换，个性化界面体验
- 移动端适配 - 完美适配手机和平板设备，随时随地管理
- 实时更新 - 界面数据实时更新，无需手动刷新
访问系统
部署完成后，您可以通过以下方式访问系统：
- Web管理界面：http://localhost:8080
- 默认管理员账号：
- 用户名：
admin - 密码：
admin123
- 用户名：
- API文档：http://localhost:8080/docs
- 健康检查：http://localhost:8080/health
⚠️ 安全提示：首次登录后请立即修改默认密码！
📋 系统使用
1. 用户注册
- 访问
http://localhost:8080/register.html - 填写用户信息，完成邮箱验证
- 输入图形验证码完成注册
2. 添加闲鱼账号
- 登录系统后进入主界面
- 点击"添加新账号"
- 输入账号ID和完整的Cookie值
- 系统自动启动账号监控任务
3. 配置自动回复
- 关键词回复：设置关键词和对应回复内容
- AI回复：配置OpenAI API密钥启用智能回复
- 默认回复：设置未匹配时的默认回复
4. 设置自动发货
- 添加发货规则，设置商品关键词和发货内容
- 支持文本内容和卡密文件两种发货方式
- 系统检测到付款消息时自动确认发货并自动发货
5. 使用商品搜索功能
- 访问商品搜索页面（需要登录）
- 输入搜索关键词和查询页数
- 系统自动获取真实闲鱼商品数据
- 商品按"人想要"数量自动排序
- 支持查看商品详情和跳转到闲鱼页面
安装方式
https://github.com/noelzhao/xianyu-auto-reply
在宝塔面板左侧菜单栏中找到文件 -> 上传文件 -> 进行解压！
根目录运行终端 ，输入命令按回车键./docker-deploy.sh
选择国内镜像回复Y 等待安装完成，放行8080端口
📱 访问地址:
HTTP: http://localhost:8080
🔐 默认登录信息:
用户名: admin
密码: admin123
📊 管理命令:
查看状态: ./docker-deploy.sh status
查看日志: ./docker-deploy.sh logs
重启服务: ./docker-deploy.sh restart
停止服务: ./docker-deploy.sh stop
