Christ9038/Ydisks-Xianyu-Helper

项目介绍

Ydisks Xianyu Helper 是面向闲鱼卖家的自托管管理系统，把账号运行状态、即时消息、订单、商品、卡券库存、自动化规则、AI 回复和异常通知收进同一个 Web 控制台。适合个人或小团队管理多个闲鱼账号，或需要自动交付兑换码、链接、图片等虚拟商品的场景。

Go 客户端负责闲鱼侧的协议工作，包括扫码登录、Cookie 续期、MTOP 请求和 WebSocket 消息通路；大部分业务逻辑在服务端执行，需要浏览器环境的功能（如浏览器指纹、滑块 token）交给 Chromium 处理。数据库可选 SQLite、MySQL 或 PostgreSQL，敏感字段使用 AES-256-GCM 加密 (2)。

快速开始

推荐用 Docker Compose 部署，支持 Linux x86_64、Linux ARM64 和 Apple Silicon，需要 Docker Engine 或 Docker Desktop 以及 Compose v2 (31)。

git clone https://github.com/Christ9038/Ydisks-Xianyu-Helper.git
cd Ydisks-Xianyu-Helper
cp .env.example .env

在 .env 中至少填写 POSTGRES_DB、POSTGRES_USER、POSTGRES_PASSWORD、DATABASE_URL、XIANYU_DATA_KEY 和 XIANYU_ADMIN_PASSWORD，示例值应替换为自行生成的内容。然后启动服务：

docker compose up -d

浏览器打开 http://localhost:59188，用配置的管理员密码登录 (36)。Compose 使用持久化的 PostgreSQL、应用数据和浏览器数据卷，升级前应备份数据库和 .env。

登录后在账号管理中扫描二维码，按官方流程完成人脸或安全验证，等待账号上线，再同步商品和订单，在卡券库存中创建发货内容，并在自动化中关联商品、卡券和触发条件 (44)。

如果从源码运行，需要 Go 1.26.4 或兼容版本、Node.js 24 与 npm，以及 Chromium 系统依赖 (38)：

npm --prefix frontend ci
npm --prefix frontend run build
go run ./cmd/server -db data/xianyu_data.db -addr 127.0.0.1:59188

空数据库首次访问会显示管理员初始化表单；无头环境可用 -init-admin 和 -admin-password 初始化 (59)。

配置与运维

数据库连接优先级为 DATABASE_URL > -db-url > -db (46)。两个关键配置是 XIANYU_DATA_KEY 和 XIANYU_ADMIN_PASSWORD：前者必须固定保存并备份，丢失后受保护的凭据无法解密；后者用于管理员初始化。Playwright 和 Chromium 路径会自动发现，也可显式指定外部运行时或跳过浏览器下载 (2)。

/health 端点返回状态、数据库、版本、提交和构建时间，适合升级后检查 (51)。生产环境建议把镜像固定到 release 或 SHA 标签而不是 latest，并通过反向代理或负载均衡加 HTTPS，同时给应用加上 -secure 参数 (53)。

使用约束

• 项目没有闲鱼或阿里的官方授权，属于非官方社区工具 (2)，只能在遵守适用法律、平台规则和自己账号授权范围的前提下使用。
• Go 客户端目前只支持扫码登录；不要分享 Cookie、密码、二维码或验证链接 (44)。
• 账号登录状态下频繁重启会触发风控，因为每次重启都会请求登录凭据 (2)。
• 用 -no-browser 跳过浏览器会失去浏览器指纹和滑块 token 相关功能 (43)。
• 账号状态、自动化、回复规则、AI 设置和管理员凭据都存在数据库中；向外部 AI、SMTP、Webhook 或远程验证服务发送数据前，需要先确认这些服务的可信度和数据流向。
• 采用 Apache-2.0 许可证，分发原始或衍生作品时需保留 NOTICE 和许可声明，并标注修改过的文件 (15)。

HotRepo 点评

该项目在 2026 年 11 月 3 日的 GitHub 全部语言日榜上记录到第 16 名，当天在 Go 语言榜中显示 2,196 Star、612 Fork、单日新增 16 Star。这只是单次快照，可以说明当天关注度集中，但不足以判断趋势。对自托管卖家工具而言，比较值得注意的工程点是按账号隔离的运行时、发货动作的幂等检查点，以及明确的凭据加密和日志脱敏说明——这些对多账号运营的实际价值高于功能数量本身。