一个功能完整的闲鱼自动回复和管理系统,支持多用户、多账号管理,具备智能回复、自动发货、自动确认发货、商品管理等企业级功能。本教程将利用威联通NAD的docker进行部署,步骤简单。

一、创建应用程序。

services:
  xianyu-auto-reply:
    image: registry.cn-shanghai.aliyuncs.com/zhinian-software/xianyu-auto-reply:1.0.1
    container_name: xianyu-auto-reply
    privileged: true
    ports:
      - 8080:8080
    volumes:
      - /vol1/1000/docker/xianyu-auto-reply:/app/data
    restart: always

二、进入闲鱼自动发货后台。

Web管理界面:http://localhost:8080
默认管理员账号:
用户名:admin
密码:admin123

三、配置相关参数。

四、系统介绍。

✨ 核心特性

 

🔐 多用户系统

 

  • 用户注册登录 – 支持邮箱验证码注册,图形验证码保护
  • 数据完全隔离 – 每个用户的数据独立存储,互不干扰
  • 权限管理 – 严格的用户权限控制和JWT认证
  • 安全保护 – 防暴力破解、会话管理、安全日志

📱 多账号管理

 

  • 无限账号支持 – 每个用户可管理多个闲鱼账号
  • 独立运行 – 每个账号独立监控,互不影响
  • 实时状态 – 账号连接状态实时监控
  • 批量操作 – 支持批量启动、停止账号任务

🤖 智能回复系统

 

  • 关键词匹配 – 支持精确关键词匹配回复
  • 指定商品回复 – 支持为特定商品设置专门的回复内容,优先级最高
  • 商品专用关键词 – 支持为特定商品设置专用关键词回复
  • 通用关键词 – 支持全局通用关键词,适用于所有商品
  • 批量导入导出 – 支持Excel格式的关键词批量导入导出
  • AI智能回复 – 集成OpenAI API,支持上下文理解
  • 变量替换 – 回复内容支持动态变量(用户名、商品信息、商品ID等)
  • 优先级策略 – 指定商品回复 > 商品专用关键词 > 通用关键词 > 默认回复 > AI回复

🚚 自动发货功能

 

  • 智能匹配 – 基于商品信息自动匹配发货规则
  • 多规格支持 – 支持同一商品的不同规格自动匹配对应卡券
  • 精确匹配+兜底机制 – 优先精确匹配规格,失败时自动降级到普通卡券
  • 延时发货 – 支持设置发货延时时间(0-3600秒)
  • 多种触发 – 支持付款消息、小刀消息等多种触发条件
  • 防重复发货 – 智能防重复机制,避免重复发货
  • 多种发货方式 – 支持固定文字、批量数据、API调用、图片发货等方式
  • 图片发货 – 支持上传图片并自动发送给买家,图片自动上传到CDN
  • 自动确认发货 – 检测到付款后自动调用闲鱼API确认发货,支持锁机制防并发
  • 防重复确认 – 智能防重复确认机制,避免重复API调用
  • 订单详情缓存 – 订单详情获取支持数据库缓存,大幅提升性能
  • 发货统计 – 完整的发货记录和统计功能

🛍️ 商品管理

 

  • 自动收集 – 消息触发时自动收集商品信息
  • API获取 – 通过闲鱼API获取完整商品详情
  • 多规格支持 – 支持多规格商品的规格信息管理
  • 批量管理 – 支持批量查看、编辑、切换多规格状态
  • 智能去重 – 自动去重,避免重复存储

🔍 商品搜索功能

 

  • 真实数据获取 – 基于Playwright技术获取真实闲鱼商品数据
  • 智能排序 – 按”人想要”数量自动倒序排列
  • 多页搜索 – 支持一次性获取多页商品数据
  • 前端分页 – 灵活的前端分页显示
  • 商品详情 – 支持查看完整商品详情信息

📊 系统监控

 

  • 实时日志 – 完整的操作日志记录和查看
  • 性能监控 – 系统资源使用情况监控
  • 健康检查 – 服务状态健康检查

📁 数据管理

 

  • Excel导入导出 – 支持关键词数据的Excel格式导入导出
  • 模板生成 – 自动生成包含示例数据的导入模板
  • 批量操作 – 支持批量添加、更新关键词数据
  • 数据验证 – 导入时自动验证数据格式和重复性
  • 多规格卡券管理 – 支持创建和管理多规格卡券
  • 发货规则管理 – 支持多规格发货规则的创建和管理
  • 数据备份 – 自动数据备份和恢复
  • 一键部署 – 提供预构建Docker镜像,无需编译即可快速部署

📁 项目结构

 

点击展开查看详细项目结构

🚀 快速开始

 

⚡ 最快部署方式(推荐):使用预构建镜像,无需下载源码,一条命令即可启动!

方式一:Docker 一键部署(最简单)

 

# 1. 创建数据目录
mkdir -p xianyu-auto-reply

# 2. 一键启动容器
docker run -d \
  -p 8080:8080 \
  -v $PWD/xianyu-auto-reply/:/app/data/ \
  --name xianyu-auto-reply \
  registry.cn-shanghai.aliyuncs.com/zhinian-software/xianyu-auto-reply:1.0

# 3. 访问系统
# http://localhost:8080

Windows用户

# 创建数据目录
mkdir xianyu-auto-reply

# 启动容器
docker run -d -p 8080:8080 -v %cd%/xianyu-auto-reply/:/app/data/ --name xianyu-auto-reply registry.cn-shanghai.aliyuncs.com/zhinian-software/xianyu-auto-reply:1.0

方式二:从源码构建部署

 

# 1. 克隆项目
git clone https://github.com/zhinianboke/xianyu-auto-reply.git
cd xianyu-auto-reply

# 2. 设置脚本执行权限(Linux/macOS)
chmod +x docker-deploy.sh

# 3. 一键部署(自动构建镜像)
./docker-deploy.sh

# 4. 访问系统
# http://localhost:8080

Windows用户

# 使用Windows批处理脚本(推荐)
docker-deploy.bat

# 或者使用Git Bash/WSL
bash docker-deploy.sh

# 或者直接使用Docker Compose
docker-compose up -d --build

方式三:本地开发部署

 

# 1. 克隆项目
git clone https://github.com/zhinianboke/xianyu-auto-reply.git
cd xianyu-auto-reply

# 2. 创建虚拟环境(推荐)
python -m venv venv
source venv/bin/activate  # Linux/macOS
# 或 venv\Scripts\activate  # Windows

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

# 4. 安装Playwright浏览器
playwright install chromium
playwright install-deps chromium  # Linux需要

# 5. 启动系统
python Start.py

# 6. 访问系统
# http://localhost:8080

📋 环境要求

 

  • Python: 3.11+
  • Node.js: 16+ (用于JavaScript执行)
  • 系统: Windows/Linux/macOS
  • 内存: 建议2GB+
  • 存储: 建议10GB+
  • Docker: 20.10+ (Docker部署)
  • Docker Compose: 2.0+ (Docker部署)

🌐 访问系统

 

部署完成后,您可以通过以下方式访问系统:

⚠️ 安全提示:首次登录后请立即修改默认密码!

📋 系统使用

 

1. 用户注册

 

  • 访问 http://localhost:8080/register.html
  • 填写用户信息,完成邮箱验证
  • 输入图形验证码完成注册

2. 添加闲鱼账号

 

  • 登录系统后进入主界面
  • 点击”添加新账号”
  • 输入账号ID和完整的Cookie值
  • 系统自动启动账号监控任务

3. 配置自动回复

 

  • 关键词回复:设置关键词和对应回复内容
  • AI回复:配置OpenAI API密钥启用智能回复
  • 默认回复:设置未匹配时的默认回复

4. 设置自动发货

 

  • 添加发货规则,设置商品关键词和发货内容
  • 支持文本内容和卡密文件两种发货方式
  • 系统检测到付款消息时自动确认发货并自动发货

5. 使用商品搜索功能

 

  • 访问商品搜索页面(需要登录)
  • 输入搜索关键词和查询页数
  • 系统自动获取真实闲鱼商品数据
  • 商品按”人想要”数量自动排序
  • 支持查看商品详情和跳转到闲鱼页面

🏗️ 系统架构

 

┌─────────────────────────────────────┐
│           Web界面 (FastAPI)         │
│         用户管理 + 功能界面          │
└─────────────┬───────────────────────┘
              │
┌─────────────▼───────────────────────┐
│        CookieManager               │
│         多账号任务管理              │
└─────────────┬───────────────────────┘
              │
┌─────────────▼───────────────────────┐
│      XianyuLive (多实例)           │
│     WebSocket连接 + 消息处理        │
└─────────────┬───────────────────────┘
              │
┌─────────────▼───────────────────────┐
│        SQLite数据库                │
│   用户数据 + 商品信息 + 配置数据     │
└─────────────────────────────────────┘

✨ 核心功能特性

 

🚀 自动回复系统

 

  • 智能关键词匹配 – 支持精确匹配和模糊匹配,灵活配置回复规则
  • AI智能回复 – 集成多种AI模型(通义千问、GPT等),智能理解用户意图
  • 多账号管理 – 支持同时管理多个闲鱼账号,独立配置和运行
  • 实时消息处理 – WebSocket长连接,毫秒级响应用户消息
  • 自定义回复模板 – 支持占位符和动态内容,个性化回复体验

🛒 自动发货系统

 

  • 智能订单识别 – 自动识别虚拟商品订单,精准匹配发货规则
  • 多重安全验证 – 超级加密保护,防止误操作和数据泄露
  • 批量处理能力 – 支持批量确认发货,提高处理效率
  • 异常处理机制 – 完善的错误处理和重试机制,确保发货成功
  • 多渠道通知 – 支持QQ、钉钉、邮件等多种发货通知方式

👥 多用户系统

 

  • 用户注册登录 – 支持邮箱验证和图形验证码,安全可靠
  • 权限管理 – 管理员和普通用户权限分离,精细化权限控制
  • 数据隔离 – 每个用户的数据完全隔离,保护隐私安全
  • 会话管理 – JWT Token认证,支持自动续期和安全登出

📊 数据管理

 

  • 商品信息管理 – 自动获取和同步商品信息,实时更新状态
  • 订单数据统计 – 详细的订单数据分析和可视化图表
  • 关键词管理 – 灵活的关键词配置,支持正则表达式
  • 数据导入导出 – 支持Excel格式的批量数据操作
  • 自动备份 – 定期自动备份重要数据,防止数据丢失

🔍 商品搜索

 

  • 真实数据获取 – 基于Playwright技术,无头模式获取真实闲鱼商品数据
  • 多页搜索 – 支持分页搜索和批量获取,无限制数据采集
  • 智能排序 – 按”人想要”数量自动倒序排列,优先显示热门商品
  • 数据可视化 – 美观的商品展示界面,支持排序和筛选
  • 前端分页 – 灵活的前端分页显示,提升用户体验
  • 账号状态验证 – 自动检查cookies启用状态,确保搜索功能正常

📱 通知系统

 

  • 多渠道支持 – QQ、钉钉、邮件、微信、Telegram等6种通知方式
  • 智能配置 – 可视化配置界面,支持复杂参数和加密设置
  • 实时推送 – 重要事件实时通知,及时了解系统状态
  • 通知模板 – 自定义通知内容和格式,个性化消息推送

🔐 安全特性

 

  • Cookie安全管理 – 加密存储用户凭证,定期自动刷新
  • Token自动刷新 – 智能检测和刷新过期Token,保持连接稳定
  • 操作日志 – 详细记录所有操作日志,支持审计和追踪
  • 异常监控 – 实时监控系统异常和错误,主动预警

🎨 用户界面

 

  • 现代化设计 – 基于Bootstrap 5的响应式界面,美观易用
  • 多主题支持 – 支持明暗主题切换,个性化界面体验
  • 移动端适配 – 完美适配手机和平板设备,随时随地管理
  • 实时更新 – 界面数据实时更新,无需手动刷新

📁 核心文件功能说明

 

🚀 核心启动模块

 

  • Start.py – 项目启动入口,初始化CookieManager和FastAPI服务,从数据库加载账号任务并启动后台API服务,支持环境变量配置
  • XianyuAutoAsync.py – 闲鱼WebSocket连接核心,处理消息收发、自动回复、指定商品回复、自动发货、商品信息收集、AI回复
  • reply_server.py – FastAPI Web服务器,提供完整的管理界面和RESTful API接口,支持多用户系统、JWT认证、权限管理
  • cookie_manager.py – 多账号Cookie管理器,负责账号任务的启动、停止、状态管理和线程安全操作,支持数据库持久化

🗄️ 数据和配置管理

 

  • db_manager.py – SQLite数据库管理器,支持多用户数据隔离、自动迁移、版本管理、完整的CRUD操作、邮箱验证、系统设置
  • config.py – 全局配置文件管理器,加载YAML配置和环境变量,提供配置项访问接口,支持动态配置更新
  • global_config.yml – 全局配置文件,包含WebSocket、API、自动回复、AI、通知等所有系统配置项

🤖 智能功能模块

 

  • ai_reply_engine.py – AI智能回复引擎,支持OpenAI、通义千问等多种AI模型,意图识别、上下文管理、个性化回复
  • secure_confirm_ultra.py – 自动确认发货模块,采用多层加密保护,调用闲鱼API确认发货状态,支持锁机制防并发
  • secure_freeshipping_ultra.py – 自动免拼发货模块,支持批量处理、异常恢复、智能匹配、规格识别
  • file_log_collector.py – 实时日志收集器,提供Web界面日志查看、搜索、过滤、下载和管理功能

🛠️ 工具模块 (utils/)

 

  • xianyu_utils.py – 闲鱼API核心工具,包含加密算法、签名生成、数据解析、Cookie处理、请求封装
  • message_utils.py – 消息处理工具,格式化消息内容、变量替换、内容过滤、模板渲染、表情处理
  • ws_utils.py – WebSocket客户端封装,处理连接管理、心跳检测、重连机制、消息队列、异常恢复
  • qr_login.py – 二维码登录功能,生成登录二维码、状态检测、Cookie获取、验证、自动刷新
  • item_search.py – 商品搜索功能,基于Playwright获取真实闲鱼商品数据,支持分页、过滤、排序
  • order_detail_fetcher.py – 订单详情获取工具,解析订单信息、买家信息、SKU详情,支持缓存优化、锁机制
  • image_utils.py – 图片处理工具,支持压缩、格式转换、尺寸调整、水印添加、质量优化
  • image_uploader.py – 图片上传工具,支持多种CDN服务商、自动压缩、格式优化、批量上传

🌐 前端界面 (static/)

 

  • index.html – 主管理界面,包含账号管理、关键词管理、系统监控、实时状态显示
  • login.html – 用户登录页面,支持图形验证码、记住登录状态、多重安全验证
  • register.html – 用户注册页面,支持邮箱验证码、实时验证、密码强度检测
  • user_management.html – 用户管理页面,管理员专用,用户增删改查、权限管理
  • data_management.html – 数据管理页面,支持Excel导入导出、数据备份、批量操作
  • log_management.html – 日志管理页面,实时日志查看、日志搜索过滤、日志下载
  • item_search.html – 商品搜索页面,获取真实闲鱼商品数据,支持多条件搜索
  • js/app.js – 主要JavaScript逻辑,处理前端交互、API调用、实时更新
  • css/ – 模块化样式文件,包含布局、组件、主题等分类样式,响应式设计
  • xianyu_js_version_2.js – 闲鱼JavaScript工具库,加密解密、数据处理、API封装
  • lib/ – 前端依赖库,包含Bootstrap、jQuery、Chart.js等第三方库

🐳 部署配置

 

  • Dockerfile – Docker镜像构建文件,包含Python环境、Playwright浏览器、系统依赖,支持无头模式运行
  • docker-compose.yml – Docker Compose配置,支持一键部署、环境变量配置、资源限制、健康检查
  • docker-deploy.sh – Docker部署管理脚本,提供构建、启动、监控、日志查看等功能(Linux/macOS)
  • docker-deploy.bat – Windows版本部署脚本,支持Windows环境一键部署
  • entrypoint.sh – Docker容器启动脚本,处理环境初始化和服务启动
  • nginx/nginx.conf – Nginx反向代理配置,支持负载均衡、SSL终端、WebSocket代理
  • requirements.txt – Python依赖包列表,精简版本无冗余依赖,按功能分类组织,包含详细说明
  • .gitignore – Git忽略文件配置,完整覆盖Python、Docker、前端等开发文件
  • .dockerignore – Docker构建忽略文件,优化构建上下文大小和构建速度
  • Dockerfile-cn – 国内优化版Docker镜像构建文件,使用国内镜像源加速构建
  • docker-compose-cn.yml – 国内优化版Docker Compose配置文件

🏗️ 详细技术架构

 

📊 系统架构图

 

┌─────────────────────────────────────────────────────────────────┐
│                        Web前端界面                              │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │  用户管理   │ │  账号管理   │ │  关键词管理 │ │  商品管理   │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │  日志管理   │ │  数据管理   │ │  商品搜索   │ │  系统监控   │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                     FastAPI Web服务器                          │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │  用户认证   │ │  权限管理   │ │  API接口    │ │  文件上传   │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │  邮箱验证   │ │  图形验证码 │ │  实时日志   │ │  健康检查   │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                    CookieManager 多账号管理器                   │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │  任务调度   │ │  状态监控   │ │  线程管理   │ │  异常处理   │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                XianyuLive 实例集群 (多实例并行)                  │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │  账号A实例  │ │  账号B实例  │ │  账号C实例  │ │    ...      │ │
│  │ WebSocket   │ │ WebSocket   │ │ WebSocket   │ │             │ │
│  │ 消息处理    │ │ 消息处理    │ │ 消息处理    │ │             │ │
│  │ 自动回复    │ │ 自动回复    │ │ 自动回复    │ │             │ │
│  │ 自动发货    │ │ 自动发货    │ │ 自动发货    │ │             │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                      辅助服务模块                               │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │ AI回复引擎  │ │ 图片处理    │ │ 商品搜索    │ │ 订单处理    │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │ 日志收集    │ │ 文件管理    │ │ 通知推送    │ │ 数据备份    │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                      SQLite数据库                               │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │  用户数据   │ │  账号数据   │ │  关键词数据 │ │  商品数据   │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │  发货数据   │ │  系统设置   │ │  日志数据   │ │  统计数据   │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘

🔄 数据流程图

 

用户消息 → WebSocket接收 → 消息解析 → 关键词匹配 → 回复生成 → 消息发送
    │           │            │          │          │          │
    ▼           ▼            ▼          ▼          ▼          ▼
 商品识别   连接管理      内容过滤   AI处理    模板渲染   发送确认
    │           │            │          │          │          │
    ▼           ▼            ▼          ▼          ▼          ▼
 数据存储   状态监控      安全检查   上下文    变量替换   日志记录

🔐 安全架构

 

┌─────────────────────────────────────────────────────────────────┐
│                        安全防护层                               │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │  JWT认证    │ │  权限控制   │ │  数据加密   │ │  访问控制   │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│  │  图形验证码 │ │  邮箱验证   │ │  会话管理   │ │  操作日志   │ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘

⚙️ 配置说明

 

管理员密码配置

 

重要:为了系统安全,强烈建议修改默认管理员密码!

默认密码

 

  • 用户名admin
  • 默认密码admin123
  • 初始化机制:首次创建数据库时自动创建admin用户

全局配置文件

 

global_config.yml 包含详细的系统配置,支持:

  • WebSocket连接参数
  • API接口配置
  • 自动回复设置
  • 商品管理配置
  • 日志配置等

🔧 高级功能

 

AI回复配置

 

  1. 在用户设置中配置OpenAI API密钥
  2. 选择AI模型(支持GPT-3.5、GPT-4、通义千问等)
  3. 设置回复策略和提示词
  4. 启用AI回复功能

自动发货规则

 

  1. 进入发货管理页面
  2. 添加发货规则,设置商品关键词
  3. 上传卡密文件或输入发货内容
  4. 系统自动匹配商品并发货

商品信息管理

 

  1. 系统自动收集消息中的商品信息
  2. 通过API获取完整商品详情
  3. 支持手动编辑商品信息
  4. 为自动发货提供准确的商品数据

📊 监控和维护

 

日志管理

 

  • 实时日志:Web界面查看实时系统日志
  • 日志文件logs/ 目录下的按日期分割的日志文件
  • 日志级别:支持DEBUG、INFO、WARNING、ERROR级别

🔒 安全特性

 

  • JWT认证:安全的用户认证机制
  • 图形验证码:防止自动化攻击
  • 邮箱验证:确保用户邮箱真实性
  • 数据隔离:用户数据完全隔离
  • 会话管理:安全的会话超时机制
  • 操作日志:完整的用户操作记录
  • 代码加密:核心业务逻辑采用多层加密保护

🛡️ 技术特性

 

🏗️ 架构设计

 

  • 微服务架构:模块化设计,易于维护和扩展
  • 异步编程:基于asyncio的高性能异步处理
  • WebSocket长连接:实时消息处理,低延迟响应
  • RESTful API:标准化的API接口设计

🔧 技术栈

 

  • 后端框架:FastAPI + Uvicorn
  • 数据库:SQLite(轻量级,无需额外配置)
  • 前端技术:原生HTML/CSS/JavaScript + Bootstrap
  • WebSocket:实时双向通信
  • 容器化:Docker + Docker Compose

🚀 性能优化

 

  • 连接池管理:高效的数据库连接管理
  • 异步处理:非阻塞I/O操作
  • 内存优化:智能缓存和垃圾回收
  • 资源限制:Docker容器资源限制和监控

🔐 安全机制

 

  • 多层加密:敏感代码采用5层编码混淆
  • 变量名随机化:防止静态分析
  • 运行时解密:代码在内存中动态解密执行
  • 防重复机制:智能防重复确认和发货

🤝 贡献指南

 

欢迎为项目做出贡献!您可以通过以下方式参与:

📝 提交问题

 

  • 在 GitHub Issues 中报告Bug
  • 提出新功能建议和改进意见
  • 分享使用经验和最佳实践

🔧 代码贡献

 

  • Fork 项目到您的GitHub账号
  • 创建功能分支:git checkout -b feature/your-feature
  • 提交更改:git commit -am 'Add some feature'
  • 推送分支:git push origin feature/your-feature
  • 提交 Pull Request

❓ 常见问题

 

1. 端口被占用

 

如果8080端口被占用,可以修改 global_config.yml 文件中的 AUTO_REPLY.api.port 配置,或者在 Docker 启动时通过环境变量 WEB_PORT 指定端口。

2. 数据库连接失败

 

检查数据库文件权限,确保应用有读写权限。

3. WebSocket连接失败

 

检查防火墙设置,确保WebSocket端口可以访问。

4. Shell脚本执行错误(Linux/macOS)

 

如果遇到 bad interpreter 错误,说明脚本的行结束符格式不正确:

# 方法1:手动修复行结束符
sed -i 's/\r$//' docker-deploy.sh
chmod +x docker-deploy.sh
./docker-deploy.sh

# 方法2:直接使用bash运行
bash docker-deploy.sh

5. Docker容器启动失败

 

如果遇到 exec /app/entrypoint.sh: no such file or directory 错误:

# 确保entrypoint.sh文件存在并重新构建
docker-compose down
docker-compose build --no-cache
docker-compose up -d

6. 预构建镜像拉取失败

 

如果无法拉取预构建镜像,可以使用源码构建:

# 克隆项目并从源码构建
git clone https://github.com/zhinianboke/xianyu-auto-reply.git
cd xianyu-auto-reply
./docker-deploy.sh

7. Windows系统部署

 

Windows用户推荐使用批处理脚本:

# 使用Windows批处理脚本
docker-deploy.bat

# 或者使用PowerShell
powershell -ExecutionPolicy Bypass -File docker-deploy.bat
声明:
本站所有文章,如无特殊说明或标注,均为本站原创发布。
任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。
如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。