Ydisks闲鱼助手12步清单：从零配置到自动发货跑通

Ydisks闲鱼助手是一款自托管的闲鱼多账号管理、消息回复与自动发货系统，基于 Go 与 React 构建，把账号在线、即时聊天、订单、卡密库存、自动化规则和 AI 回复整合进同一个 Web 控制台。如果你卖虚拟商品（兑换码、资料、云盘资源），跟着下面这份12 步清单，从部署到自动发货全流程跑通，全程不需要写代码。

开始前：环境要求一览

⚠️ 温馨提示：本项目为非官方社区工具，请确保使用方式符合平台规则与账号授权范围；账号登录期间不要频繁重启程序，以免触发风控。

第 1 步：选择部署方式并获取项目代码

个人试用建议直接用 Docker Compose，一条命令带起全部依赖。在服务器上克隆仓库：

git clone https://gitcode.com/gh_mirrors/yd/Ydisks-Xianyu-Helper.git cd Ydisks-Xianyu-Helper cp .env.example .env

Docker Compose 文件见 compose.yml，支持 Linux x86_64、ARM64 和 Apple Silicon。

第 2 步：配置 .env 五个核心参数

编辑.env，至少设置以下五项（完整变量表见 部署与数据库 Wiki）：

POSTGRES_DB=xianyu POSTGRES_USER=xianyu POSTGRES_PASSWORD=换成强密码 DATABASE_URL=postgres://xianyu:URL编码后的密码@postgres:5432/xianyu?sslmode=disable XIANYU_DATA_KEY=用 openssl rand -base64 48 生成 XIANYU_ADMIN_PASSWORD=你的管理员密码

💡关键点：XIANYU_DATA_KEY用于加密 Cookie、密码和 API Key 等敏感数据，生成一次后终身不换，请和数据库一起离线备份——换密钥会导致旧数据无法解密。

第 3 步：启动服务并初始化管理员

docker compose up -d docker compose ps curl -fsS http://127.0.0.1:59188/health

浏览器打开http://服务器地址:59188，用admin和刚才设置的密码登录。设置了XIANYU_ADMIN_PASSWORD时，Compose 会在首次启动自动创建管理员；其他方式启动时，页面会直接显示初始化表单，填写两次不少于 8 位的密码即可。

🔒 公网部署务必在防火墙或反向代理层限制 59188 端口的访问范围。

账号接入：从扫码到库存商品

第 4 步：扫码添加闲鱼账号并确认在线

进入账号管理，点击"扫码添加新账号"，用闲鱼 App 扫码，遇到人脸验证只在官方流程中完成。登录成功后给账号填写备注方便区分，确认账号处于"在线 + 启用"状态。

操作细节见 账号管理使用手册。账号状态、在线状态和登录审计都由后台自动维护。

第 5 步：在卡密库存建立可交付内容

进入卡密库存→ "添加新卡密"，选择交付类型：

保存时记下卡密组 ID，下一步建自动化规则要用。批量卡密可用"批量导入"追加库存，注意不要把同一批卡密重复导入。手册见 卡密库存使用文档。

第 6 步：同步已有商品或发布新商品

账号在线后，在商品管理中同步店铺内已有商品；新商品可以直接在页面发布，支持列表式铺货和 CSV/XLSX/TSV 批量上传。商品同步完成后，自动化规则才能通过"商品/规格"精确匹配订单。详见 商品管理手册 与 批量铺货文档。

第 7 步：（可选）建立多条顺序发货模板

如果交付内容较多（例如先发链接、再发使用说明、最后发售后卡），在发货模板里建立多条顺序消息，支持订单号、买家、卡密等变量，后续在"付款发货"或"评价赠品"规则中直接绑定即可。手册见 发货模板文档。

自动化配置：让系统替你发货

第 8 步：验证在线聊天与消息收发

进入在线聊天，确认账号会话列表和历史消息正常同步，给测试账号发一条文本或图片，确认收发链路通畅。买家普通消息的回复优先级是：关键词回复 → AI 回复 → 默认回复，都可在"自动化规则"页配置。

第 9 步：创建"付款后自动发货"规则

这是跑通自动发货的核心一步：

1. 进入自动化规则→ 交易自动化 → 选择"付款后自动发货"，点击新增；
2. 选择账号和商品（有规格时按规格分别配置）；
3. 添加"发送卡密"动作，选择第 5 步建立的卡密组、每件发送数量；
4. 保存并确认规则处于启用状态。

四个交易触发器（拍下未付款自动改价、付款后自动发货、评价后送赠品、超时求评价）的完整配置方法见 自动化发货与回复手册。

第 10 步：绑定通知渠道并发送测试通知

在通知设置创建渠道（支持 Bark、钉钉、飞书、企业微信、Telegram、邮件、自定义 Webhook），先在账号管理的"编辑账号 → 通知渠道绑定"中勾选渠道，再在渠道事件中勾选"付款发货"等类别。只建渠道不绑账号是收不到通知的。渠道配置见 通知与运维文档。

第 11 步：（可选）启用 AI 回复

在系统与AI中配置 OpenAI 兼容的模型地址和 Key，页面内置端到端连接测试；然后回到账号管理，单独为账号开启 AI 并设置砍价边界。AI 目前专注砍价场景，未启用时自动回落到默认回复。详见 系统设置手册。

验收上线：最后一步别跳过

第 12 步：小额测试订单全链路验证

上线前做一次完整的"演习"：

1. 用测试商品 + 测试卡密 + 小额订单走一遍拍下 → 付款流程；
2. 确认卡密内容已发送到买家会话，卡密库存扣减正确；
3. 若开启了"自动确认发货"，再确认平台订单状态变为已发货（该开关只负责标记订单，是否发出卡密仍取决于规则与库存）；
4. 检查通知渠道是否收到发货结果通知。

全部通过后，再开放正式商品。之后如遇到异常，在"自动化规则"的异常区先查订单、库存和聊天记录，不确定是否已发货时不要直接重试，避免重复发卡；人工补发走订单管理的手动发货能力。

写在最后

12 步走完后，你的闲鱼店铺就拥有了：多账号统一管理、付款自动发卡、订单自动改价、关键词/AI 智能回复和全渠道异常通知。更多页面级操作手册都放在仓库的 中文 Wiki 首页 中，按"部署 → 账号 → 库存 → 商品 → 自动化"的顺序阅读即可。

有使用问题或想交流玩法，可以扫码加入社区群组：