GitHub - GuDong2003/xianyu-auto-reply-fix: 闲鱼智能客服系统
基于 FastAPI + SQLite + Playwright 的闲鱼管理系统，支持多用户、多账号管理、AI 自动回复、自动发货确认、多渠道消息通知与 Web 管理后台，可通过 Docker 一键部署。
社区作者 · zZz
它解决什么问题
本项目是一个基于 FastAPI + SQLite + Playwright 的闲鱼管理系统，提供多用户注册登录、邮箱验证、图形验证码、权限控制与用户数据隔离；支持每个用户管理多个闲鱼账号并进行独立启停、状态查看和 Cookie 维护。核心能力包括关键词回复、默认回复、指定商品回复、图片关键词和 AI 自动回复，以及文本、批量数据、API、图片等自动发货方式。同时还提供商品信息自动收集、订单管理、通知渠道、消息通知、在线客服、实时日志、健康检查、安全统计和日志轮转等功能。
AI 回复采用统一的 model_name / api_key / base_url / api_type 配置模式，支持 OpenAI-compatible、OpenAI Responses、DashScope、Gemini、Anthropic、Azure OpenAI 等接口，也可通过自定义 base_url 接入第三方 OpenAI-compatible 服务。项目采用 AGPL-3.0 许可证，仅供学习研究使用。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
Docker Compose（推荐）：步骤 1 · 克隆仓库：
git clone https://github.com/GuDong2003/xianyu-auto-reply-fix.git步骤 2 · 进入目录：
cd xianyu-auto-reply-fix- 在仓库根目录创建 .env，至少覆盖 ADMIN_PASSWORD（替换为强密码）和 JWT_SECRET_KEY（替换为长随机字符串）。docker-compose.yml 中的默认管理员密码和 JWT 密钥仅用于本地体验，正式或联网部署前必须覆盖。
步骤 4 · 启动服务：
docker compose up -d- 仅在修改 Dockerfile 或依赖文件、需要本地重新构建镜像时，使用 docker compose up -d --build。
- 访问地址：Web 管理界面 http://localhost:9000；API 文档 http://localhost:9000/docs；健康检查 http://localhost:9000/health。
首次初始化的默认管理员账号为 admin / admin123，该默认值仅用于本地初始化，请在首次登录后立即修改。默认持久化目录为 data/、logs/ 和 backups/，升级或重建容器前请先备份。
本地运行：
步骤 1
git clone https://github.com/GuDong2003/xianyu-auto-reply-fix.git步骤 2
cd xianyu-auto-reply-fix步骤 3
python -m venv venv- source venv/bin/activate（Windows 使用 venv\Scripts\activate）
步骤 5
pip install --upgrade pip步骤 6
pip install -r requirements.txt- playwright install chromium
步骤 8
python Start.py- 默认访问 http://localhost:8090
安全注意事项：
- 不要将 VNC（5900）和 noVNC（6080）直接暴露到公网，远程访问应配合防火墙、访问控制和可信网络。
- 对外提供 Web 管理界面时，请使用 HTTPS 反向代理，并限制管理端访问来源。
- data/、logs/、backups/ 和 global_config.yml 可能包含运行数据或敏感配置，不要提交到 Git，也不要随 Issue/PR 上传。
- Cookie、Token、账号密码和数据库凭据均属于敏感信息，公开日志和截图前请先脱敏。
常见问题：
端口被占用：
Docker Compose 修改 docker-compose.yml / docker-compose-cn.yml 的端口映射；本地运行可修改 API_PORT 或 global_config.yml。
- Playwright 浏览器缺失：执行 source venv/bin/activate && playwright install chromium。
Docker 容器启动失败：执行 docker compose logs -f、docker compose down、docker compose build --no-cache、docker compose up -d。