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

作者QQ：1503938233--付费版请咨询

• 基于 Node.js 的 QQ 农场自动化工具，支持多账号管理、Web 控制面板、实时日志与数据分析。
• 更新优化日志详见update.log 感谢支持，喜欢的点一个star⭐吧！
• 默认账号密码都是admin，端口3007，请部署登录后尽快修改密码！
• 重构版V2.5.4完整更新日志详见：更新日志

外面基于我的重构版很多，在GitHub上搜qq-farm即可，有很多实力强的作者也一直在跟进开源，不用看我的古老开源版了，去GitHub上寻觅其他大佬的开源版拉下来部署吧。

技术栈

后端

前端

部署

环境要求

• 源码运行：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）

建议使用宝塔最为便捷，在网站其他项目选项中按照如图所示去部署即可

启动后访问面板：

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

Docker 部署（拉取不了镜像直接下载压缩包解压即可）

# 拉取仓库
git clone https://github.com/XyhTender/qq-farm-automation-bot.git

# 进入目录
cd /qq-farm-automation-bot-main

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

# 查看日志
docker compose logs -f

# 停止并移除容器
docker compose down

# 浏览器访问http://你的IP:3007

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

构建

pnpm install
pnpm package:release

产物输出在 dist/ 目录：

• 产物在Releases中也可以下载，无需自己构建

运行

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

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

程序会在可执行文件同级目录自动创建 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

免责声明

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