QQ 农场多账号挂机 + Web 面板

基于 Node.js 的 QQ 农场自动化工具，支持多账号管理、Web 控制面板、实时日志与数据分析。 基于Penty-d/qq-farm-bot-ui项目二开。 现在qq扫码用不了，自行寻找方法获取code。新协议参考sulimu2/qq-farm-bot项目。目前qq端好友接口寄了，等大佬修复

技术栈

后端

前端

部署

---

功能特性

多账号管理

• 账号新增、编辑、删除、启动、停止
• 扫码登录（QQ）与手动输入 Code
• 账号被踢下线自动删除
• 账号连续离线超时自动删除
• 账号离线推送通知（支持 Bark、自定义 Webhook 等）

自动化能力

• 农场：收获、种植、浇水、除草、除虫、铲除、土地升级
• 仓库：收获后自动出售果实
• 好友：自动偷菜 / 帮忙 / 捣乱
• 任务：自动检查并领取
• 好友黑名单：跳过指定好友
• 静默时段：指定时间段内不执行好友操作

Web 面板

• 概览 / 农场 / 背包 / 好友 / 分析 / 账号 / 设置页面
• 实时日志，支持按账号、模块、事件、级别、关键词、时间范围筛选
• 深色 / 浅色主题切换

分析页

支持按以下维度排序作物：

• 经验效率 / 普通肥经验效率
• 净利润效率 / 普通肥净利润效率
• 等级要求

---

环境要求

• 源码运行：Node.js 20+，pnpm（推荐通过 corepack enable 启用）
• 二进制发布版：无需安装 Node.js

安装与启动（源码方式）

Windows

# 1. 安装 Node.js 20+（https://nodejs.org/）并启用 pnpm
node -v
corepack enable
pnpm -v

# 2. 安装依赖并构建前端
cd D:\Projects\qq-farm-bot-ui
pnpm install
pnpm build:web

# 3. 启动
pnpm dev:core

# （可选）设置其他端口后启动
$env:ADMIN_PORT="你的新端口"
pnpm dev:core

Linux（Ubuntu/Debian）

# 1. 安装 Node.js 20+
sudo apt update && sudo apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
corepack enable

# 2. 安装依赖并构建前端
cd /path/to/qq-farm-bot-ui
pnpm install
pnpm build:web

# 3. 启动
pnpm dev:core

# （可选）设置管理密码后启动
ADMIN_PASSWORD='你的强密码' pnpm dev:core

启动后访问面板：

• 本机：http://localhost:3000
• 局域网：http://<你的IP>:3000

---

Docker 部署

# 构建并后台启动
docker compose up -d --build

# 查看日志
docker compose logs -f

# 停止并移除容器
docker compose down

数据持久化

docker-compose.yml 已将数据目录挂载：

宿主机路径	容器内路径
./data	/app/core/data

账号与配置数据保存在 ./data/accounts.json 和 ./data/store.json。

设置管理密码

在 docker-compose.yml 的 environment 中配置：

environment:
  ADMIN_PASSWORD: 你的强密码

修改后执行 docker compose up -d 重启生效。

---

二进制发布版（无需 Node.js）

构建

pnpm install
pnpm package:release

产物输出在 dist/ 目录：

平台	文件名
Windows x64	qq-farm-bot-win-x64.exe
Linux x64	qq-farm-bot-linux-x64
macOS Intel	qq-farm-bot-macos-x64
macOS Apple Silicon	qq-farm-bot-macos-arm64

运行

# Windows：双击 exe 或在终端执行
.\qq-farm-bot-win-x64.exe

# Linux / macOS
chmod +x ./qq-farm-bot-linux-x64 && ./qq-farm-bot-linux-x64

程序会在可执行文件同级目录自动创建 data/ 并写入 store.json、accounts.json。

---

登录与安全

• 面板首次访问需要登录
• 默认管理账号：admin
• 默认管理密码：admin
• 建议部署后立即修改为强密码

---

项目结构

qq-farm-bot-ui/
├── core/                  # 后端（Node.js 机器人引擎）
│   ├── src/
│   │   ├── config/        # 配置管理
│   │   ├── controllers/   # HTTP API
│   │   ├── gameConfig/    # 游戏静态数据
│   │   ├── models/        # 数据模型与持久化
│   │   ├── proto/         # Protobuf 协议定义
│   │   ├── runtime/       # 运行时引擎与 Worker 管理
│   │   └── services/      # 业务逻辑（农场、好友、任务等）
│   ├── data/              # 运行时数据（accounts.json、store.json）
│   └── client.js          # 主进程入口
├── web/                   # 前端（Vue 3 + Vite）
│   ├── src/
│   │   ├── api/           # API 客户端
│   │   ├── components/    # Vue 组件
│   │   ├── stores/        # Pinia 状态管理
│   │   └── views/         # 页面视图
│   └── dist/              # 构建产物
├── pnpm-workspace.yaml
└── package.json

---

特别感谢

• 基于：Penty-d/qq-farm-bot-ui二改
• 核心功能：linguo2625469/qq-farm-bot
• 部分功能：QianChenJun/qq-farm-bot
• 扫码登录：lkeme/QRLib
• 推送通知：imaegoo/pushoo
• 新协议参考：sulimu2/qq-farm-bot

免责声明

本项目仅供学习与研究用途。使用本工具可能违反游戏服务条款，由此产生的一切后果由使用者自行承担。