smdk000/qq-farm-bot-ui

QQ 农场智能助手 - 多账号挂机 + Web 面板

🔴 **醒目提醒：现在扫码登录失效，等其他大佬修复，本仓库暂停更新功能，仅修复bug了。**基于 Node.js 的 QQ 农场自动化工具，支持多账号管理、Web 控制面板、实时日志与数据分析。

!https://img.shields.io/badge/%E7%89%88%E6%9C%AC-v4.5.61-blue !https://img.shields.io/badge/Node.js-20+-green !https://img.shields.io/badge/MySQL-8.0-orange !https://img.shields.io/badge/Redis-6.0-red !https://img.shields.io/badge/License-ISC-yellow

---

技术栈

后端技术

核心框架

• 运行时: Node.js 20+ (推荐 Node.js 22+)
• Web 框架: Express 4.21.0
• 实时通信: Socket.io 4.8.3
• HTTP 客户端: Axios 1.16.0

数据库与存储

• 主数据库: MySQL 8.0 (mysql2 3.18.2)
• 缓存: Redis (ioredis 5.10.0)
• 兼容依赖: better-sqlite3 12.6.2（仅保留历史兼容代码，不再作为部署或账号持久化方案）
• 协议缓冲: Protobuf.js 8.0.0 (腾讯 QQ 农场私有协议)

日志与通知

• 日志框架: Winston 3.18.3
• 推送服务: pushoo 0.1.11 (支持 Bark、Webhook 等)

打包与部署

• 打包工具: pkg 5.8.1 (跨平台二进制打包)
• 支持平台: Windows x64, Linux x64, macOS x64/arm64

https://nodejs.org/ https://expressjs.com/ []([***] https://www.mysql.com/ https://redis.io/

前端技术

核心框架

• 框架: Vue 3.5.28 (Composition API)
• 构建工具: Vite 7.3.1
• 语言: TypeScript 5.9.3
• 状态管理: Pinia 3.0.4
• 路由: Vue Router 5.0.3
• HTTP 客户端: Axios 1.13.5
• WebSocket: Socket.io-client 4.8.3
• 工具库: @vueuse/core 14.2.1

UI 与样式

• 原子化 CSS: UnoCSS 66.5.12
• 图标:
  • @iconify-json/carbon 1.2.18
  • @iconify-json/fa-solid 1.2.2
  • @iconify-json/svg-spinners 1.2.4
• 重置样式: @unocss/reset 66.5.12

开发与质量

• 类型检查: vue-tsc 3.2.5
• 代码规范:
  • ESLint 9.39.1
  • @antfu/eslint-config 7.4.3
  • eslint-plugin-format 1.4.0
• 可视化分析: rollup-plugin-visualizer 7.0.0
• 压缩插件: vite-plugin-compression 0.5.1

https://vuejs.org/ https://vitejs.dev/ https://www.typescriptlang.org/ https://pinia.vuejs.org/ []([***]

部署与 DevOps

容器化

• Docker: Docker Compose v2+
• 多平台构建: Docker Buildx (linux/amd64, linux/arm64)
• 镜像仓库:
  • Docker Hub: smdk000/qq-farm-bot-ui
  • GitHub Container Registry: ghcr.io/smdk000/qq-farm-ui-pro-max

包管理

• 包管理器: pnpm 10.30.2
• 工作空间: pnpm workspace

CI/CD

• GitHub Actions: 自动构建、测试、发布
• 自动发布: GitHub Releases 自动上传二进制文件
• 镜像同步: 自动推送到 Docker Hub 和 GHCR

https://www.docker.com/ https://pnpm.io/ https://github.com/features/actions

---

功能特性

多账号与模式管理

• 账号新增、编辑、删除、启动、停止
• 提供三种核心运作模式：
  • 主号模式：享有最高优先度和全部操作权限
  • 小号模式：对高危操作免疫，执行自动的秒级防风控收获延迟（可自主调参）
  • 风险规避模式：切断高危互动并基于历史封禁日志生成一键防御黑名单罩
• 扫码登录（支持 QQ 与 微信）与手动输入 Code
• 账号被踢下线自动删除
• 账号连续离线超时自动删除
• 账号离线推送通知（支持 Bark、自定义 Webhook 等）

自动化能力

• 农场管理：收获、种植、浇水、除草、除虫、铲除、土地升级
• 仓库管理：收获后自动出售果实
• 好友互动：自动偷菜 / 帮忙 / 捣乱
• 任务系统：自动检查并领取任务奖励
• 智能防护：
  • 好友黑名单：跳过指定好友
  • 静默时段：指定时间段内不执行好友操作
  • 60 秒防偷抢收保护
  • 两季作物智能识别

Web 面板

• 概览 / 农场 / 背包 / 好友 / 分析 / 账号 / 设置 / 帮助中心页面
• 实时日志，支持按账号、模块、事件、级别、关键词、时间范围筛选
• 深色 / 浅色主题切换
• 响应式设计，支持移动端访问

!Dashboard

分析页

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

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

!分析页面

帮助中心

• 新手入门指南
• 详细设置说明
• 高级功能教程
• 故障排查指南
• 配置模板推荐

!帮助中心

---

环境要求

源码运行

• Node.js: 20+ (推荐 Node.js 22+)
• 包管理器: pnpm 10+ (推荐通过 corepack enable 启用)
• 可选数据库:
  • MySQL 8.0+ (生产环境推荐)
  • Redis 6.0+ (缓存加速，可选)

二进制发布版

• 无需安装 Node.js
• 直接从 GitHub Releases 下载对应平台的可执行文件

Docker 部署

• Docker: Docker Engine 20+
• Docker Compose: v2+
• 支持架构:
  • linux/amd64 (Intel/AMD 服务器)
  • linux/arm64 (树莓派/鲲鹏/飞腾/Apple Silicon)

---

快速启动

🚀 一键启动（推荐）

Linux/macOS:

bash
./docker/start.sh

ARM Mac 本地开发（一键编译 + 启动）：

bash
./dev.sh

脚本会自动关闭占用端口、编译前端、启动后端，适合改代码和测试。

Windows:

cmd
docker\\start.bat

手动启动

Windows

powershell
# 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_PASSWORD="你的强密码"
pnpm dev:core

Linux（Ubuntu/Debian）

bash
# 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 部署完整指南（整合版）

部署文档入口：

• 海外 / 官方源服务器：deploy/README.md
• 国内网络服务器：deploy/README.cn.md

发布前文档/公告自检（推荐）：

bash
pnpm check:announcements
pnpm check:doc-links

check:announcements 用于校验 Update.log / CHANGELOG 的标题、bullet 与文件完整性；check:doc-links 用于校验 README、部署文档与关键说明文件中的本地链接、图片引用和 NUL 字节问题。

🚀 场景 1：全新服务器完整部署

标准部署栈固定为 4 个服务：主程序 + MySQL + Redis + ipad860。后续版本主要更新主程序；MySQL、Redis、ipad860 默认复用已部署版本。 如果你的服务器在中国大陆网络环境，优先查看 deploy/README.cn.md。

自 v4.5.20 起，部署目录固定带上两类修复脚本，并统一附带安装/更新/核验辅助脚本：

• repair-mysql.sh：修复旧 MySQL 结构、补齐缺失表/列并回填历史数据
• repair-deploy.sh：修复旧部署目录缺脚本、缺 docker-compose.yml、缺 init-db、缺 /opt/qq-farm-current（以及历史 /opt/qq-farm-bot-current）链接的问题

一键脚本

为降低 GitHub Raw 边缘节点偶发卡住的概率，推荐直接使用下面这条带 HTTP/1.1 + retry + timeout 的稳态命令：

bash
bash <(curl --http1.1 --retry 4 --retry-delay 1 --retry-all-errors --connect-timeout 10 --max-time 90 -fsSL https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/install-or-update.sh) --action install

脚本会自动完成这些事情：

• （可用时）执行公告预检：check-announcements.js（缺少 Node 或脚本时自动跳过，不阻断部署）
• 检查并安装 Docker / Docker Compose
• 检查端口占用并提示修改 WEB_PORT，非交互模式下会自动顺延到下一个可用端口
• 在 /opt/YYYY_MM_DD/qq-farm 创建部署目录，并自动维护 /opt/qq-farm-current 当前版本链接
• 下载 docker-compose.yml、.env.example、初始化 SQL、部署说明、一键部署/更新/修复/核验脚本
• 启动 qq-farm-bot、mysql、redis、ipad860
• 等待容器健康检查通过
• 主程序镜像按 APP_IMAGE -> Docker Hub -> GHCR -> 本地缓存 -> 源码构建 顺序回退
• 支持 --image-archive /path/to/qq-farm-bot-images-<arch>.tar.gz 或 .env 里的 IMAGE_ARCHIVE=/path/to/...
• 启动前会检查主程序镜像架构是否和宿主机一致，避免把 arm64 镜像误装到 amd64 服务器
• 启动完成后自动执行一次 repair-mysql.sh

常用无交互写法：

bash
WEB_PORT=3080 ADMIN_PASSWORD='你的强密码' NON_INTERACTIVE=1 \
bash <(curl --http1.1 --retry 4 --retry-delay 1 --retry-all-errors --connect-timeout 10 --max-time 90 -fsSL https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/install-or-update.sh) --action install

弱网或离线首装示例：

bash
IMAGE_ARCHIVE=/root/qq-farm-bot-images-amd64.tar.gz \
bash <(curl --http1.1 --retry 4 --retry-delay 1 --retry-all-errors --connect-timeout 10 --max-time 90 -fsSL https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/install-or-update.sh) --action install

如需固定镜像版本或覆盖仓库，可在 .env 中设置：

bash
APP_IMAGE=smdk000/qq-farm-bot-ui:4.5.61
MYSQL_IMAGE=mysql:8.0
REDIS_IMAGE=redis:7-alpine
IPAD860_IMAGE=smdk000/ipad860:latest

最短 Docker Compose 部署

bash
mkdir -p /opt/qq-farm && cd /opt/qq-farm
curl -fsSLO https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/deploy/docker-compose.yml
curl -fsSLo .env https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/deploy/.env.example
mkdir -p init-db && curl -fsSLo init-db/01-init.sql https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/deploy/init-db/01-init.sql
docker compose up -d

手动分步骤部署

bash
mkdir -p /opt/$(date +%Y_%m_%d)/qq-farm
cd /opt/$(date +%Y_%m_%d)/qq-farm

curl -fsSLO https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/deploy/docker-compose.yml
curl -fsSLo .env.example https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/deploy/.env.example
curl -fsSLo init-db/01-init.sql --create-dirs https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/deploy/init-db/01-init.sql
curl -fsSLo install-or-update.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/install-or-update.sh
curl -fsSLo update-app.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/update-app.sh
curl -fsSLo update-agent.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/update-agent.sh
curl -fsSLo install-update-agent-service.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/install-update-agent-service.sh
curl -fsSLo manual-config-wizard.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/manual-config-wizard.sh
curl -fsSLo repair-mysql.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/repair-mysql.sh
curl -fsSLo repair-deploy.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/repair-deploy.sh
curl -fsSLo stack-layout.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/stack-layout.sh
curl -fsSLo verify-stack.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/verify-stack.sh
curl -fsSLo fresh-install.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/fresh-install.sh
curl -fsSLo quick-deploy.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/quick-deploy.sh
chmod +x install-or-update.sh update-app.sh update-agent.sh install-update-agent-service.sh manual-config-wizard.sh repair-mysql.sh repair-deploy.sh stack-layout.sh verify-stack.sh fresh-install.sh quick-deploy.sh

# 按需修改端口、管理员密码、第三方扫码配置
cp .env.example .env
vi .env

bash install-or-update.sh --action install --non-interactive

🔄 场景 2：服务器已部署过，只更新主程序

该模式只更新 qq-farm-bot 容器，不会重启或替换 MySQL / Redis / ipad860，也不会清理数据卷。

一键更新脚本

bash
/opt/qq-farm-current/install-or-update.sh --action update --preserve-current

手动分步骤更新

bash
cd /opt/qq-farm-current
bash install-or-update.sh --action update --preserve-current

# 如需只更新主程序
bash update-app.sh

# 如需切到指定版本
bash update-app.sh --image smdk000/qq-farm-bot-ui:4.5.61

# 弱网 / 离线环境：先 docker load，再用离线镜像包更新
bash update-app.sh --image-archive /root/qq-farm-bot-images-amd64.tar.gz

# 只想单独修复旧 MySQL 结构
bash repair-mysql.sh --backup

补充说明：

• deploy/init-db/01-init.sql 只会在 MySQL 空数据卷首次启动时执行。
• repair-mysql.sh 会对旧数据库执行幂等修复，补齐缺失表/列、回填 cards.days / used_at / expires_at，可重复执行。
• update-app.sh 会在更新前尝试执行公告预检（检测到脚本与 Node 时执行）。
• update-app.sh 会先执行 repair-mysql.sh，再更新主程序镜像。
• update-app.sh 会同步部署目录里的 docker-compose.yml、.env.example、README 和修复脚本。
• install-or-update.sh --action update --preserve-current 会在更新前先备份当前部署目录。
• update-app.sh 会重新维护 /opt/qq-farm-current 链接，避免旧服 current 链接丢失。
• update-app.sh 同样会按 APP_IMAGE -> Docker Hub -> GHCR -> 本地缓存 -> 源码构建 回退，并在启动前做主程序镜像架构预检。

🩹 场景 3：旧服务器先修部署包，再升级

适用于这些情况：

• 部署目录里没有 repair-mysql.sh / update-app.sh
• docker-compose.yml、init-db/01-init.sql、.env.example 已经很旧
• /opt/qq-farm-current 丢失或指向错误目录

bash
cd /opt/qq-farm-current 2>/dev/null || cd /opt/qq-farm-bot-current 2>/dev/null || cd /opt
curl -fsSLo repair-deploy.sh https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/repair-deploy.sh
chmod +x repair-deploy.sh
./repair-deploy.sh --backup
./install-or-update.sh --action update --preserve-current --non-interactive

📊 验证部署成功

bash
# 检查 4 个容器状态
docker compose ps

# 查看主程序日志
docker compose logs -f qq-farm-bot

# 测试接口
curl http://localhost:3080/api/ping

Release 离线包

从本版本开始，Release 与本地导出都会同时产出：

• qq-farm-bot-images-amd64.tar.gz
• qq-farm-bot-images-arm64.tar.gz
• qq-farm-bot-v4.5.61-offline-amd64.tar.gz
• qq-farm-bot-v4.5.61-offline-arm64.tar.gz

其中 arm64 离线包里的 ipad860 仍是 linux/amd64，目标宿主机需支持 QEMU。

访问地址：http://服务器IP:3080

• 默认用户名：admin
• 默认密码：见部署目录 .env 中的 ADMIN_PASSWORD

---

🏗️ Docker 多平台构建

构建并推送到 Docker Hub 和 GitHub

0. 代码更新后直接发镜像

推荐直接使用项目内置脚本，它会先跑公告/文档/关键回归检查，再优先复用当前 Docker 登录态并调用多架构构建脚本：

bash
docker login
bash scripts/deploy/auto-update-docker.sh --version v4.5.61

如果同时要推送 GHCR：

bash
export DOCKERHUB_TOKEN='你的 Docker Hub Token'
export GHCR_USERNAME='你的 GitHub 用户名'
export GHCR_TOKEN='你的 GitHub Token'
bash scripts/deploy/auto-update-docker.sh --version v4.5.61 --with-ghcr --with-release-assets

镜像推送完成后，服务器直接执行：

bash
/opt/qq-farm-current/update-app.sh --image smdk000/qq-farm-bot-ui:4.5.61

0.5 发镜像后顺手滚动两台服务器

publish-and-rollout.sh 会先调用上面的镜像发布脚本，然后通过本地 expect + ssh 按目标列表逐台执行安装或升级。密码不写进仓库，只从本地环境变量读取：

bash
export QQ_FARM_PRIMARY_PASSWORD='***'
export QQ_FARM_CLUSTER_PASSWORD='***'

bash scripts/deploy/publish-and-rollout.sh --version v4.5.61 --with-ghcr \
  --target "10.31.1.254|root|QQ_FARM_PRIMARY_PASSWORD|update|qq-farm|/opt/qq-farm-current|" \
  --target "10.31.2.242|smdk000|QQ_FARM_CLUSTER_PASSWORD|update|qq-farm-2400|/opt/qq-farm-2400-current|" \
  --target "10.31.2.242|smdk000|QQ_FARM_CLUSTER_PASSWORD|update|qq-farm-2500|/opt/qq-farm-2500-current|" \
  --target "10.31.2.242|smdk000|QQ_FARM_CLUSTER_PASSWORD|update|qq-farm-2600|/opt/qq-farm-2600-current|"

1. 环境准备

bash
# 检查 Docker 和 Buildx
docker --version
docker buildx version

# 登录 Docker Hub
docker login

# 登录 GitHub Container Registry
echo $GH_PAT | docker login ghcr.io -u smdk000 --password-stdin

2. 构建多平台镜像

使用脚本构建（推荐）:

bash
chmod +x scripts/docker/docker-build-multiarch.sh
./scripts/docker/docker-build-multiarch.sh --version 4.5.61

手动构建:

bash
# 构建并推送到 Docker Hub
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t smdk000/qq-farm-bot-ui:4.5.61 \
  -t smdk000/qq-farm-bot-ui:latest \
  -f core/Dockerfile . \
  --push

# 构建并推送到 GitHub Container Registry
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t ghcr.io/smdk000/qq-farm-ui-pro-max:4.5.61 \
  -t ghcr.io/smdk000/qq-farm-ui-pro-max:latest \
  -f core/Dockerfile . \
  --push

3. 输出 GitHub Release 同款二进制与部署包

bash
chmod +x scripts/release/build-release-assets.sh
./scripts/release/build-release-assets.sh --version v4.5.61

# 产物默认输出到 ./release-assets
ls release-assets

4. 验证构建

bash
# 查看镜像信息
docker buildx imagetools inspect smdk000/qq-farm-bot-ui:4.5.61

# Docker Hub 查看
# https://hub.docker.com/r/smdk000/qq-farm-bot-ui/tags

# GitHub Packages 查看
# https://github.com/users/smdk000/packages/container/package/qq-farm-ui-pro-max

bash
# 巡检历史 GitHub Release 对象与标准 11 件附件
pnpm check:release-assets

# 也可以只检查指定版本
node scripts/utils/check-release-assets.js v4.5.54 v4.5.61

---

🔄 版本升级

从旧版本升级

bash
# 1. 进入现有部署目录
cd /opt/YYYY_MM_DD/qq-farm-bot

# 2. 先备份当前数据（推荐）
docker compose exec qq-farm-mysql sh -lc 'mysqldump -u root -p"$MYSQL_ROOT_PASSWORD" "$MYSQL_DATABASE"' > backup-$(date +%Y%m%d).sql

# 3. 只更新主程序
./update-app.sh

---

🛡️ 数据保护

数据卷挂载说明

备份策略

定期备份:

bash
# 每天凌晨 2 点备份
0 2 * * * tar -czf /backup/farm-bot-$(date +\%Y\%m\%d).tar.gz ./data

升级前备份:

bash
tar -czf farm-bot-backup-$(date +%Y%m%d).tar.gz ./data

从备份恢复:

bash
tar -xzf farm-bot-backup-20260301.tar.gz -C ./data

⚠️ 重要提醒

• ❌ 不要删除 ./data 目录，否则所有数据将丢失
• ❌ 不要手动修改 数据库文件，可能导致数据损坏
• ✅ 定期备份 数据到安全位置
• ✅ 升级前先备份

---

⚠️ 常见错误与解决方案

错误 1: 镜像拉取失败 ❌

错误信息:

Error response from daemon: pull access denied

原因:

• 使用了错误的镜像名称
• Docker Hub 账号未登录

解决方案:

bash
# ✅ 正确的镜像名称
docker pull smdk000/qq-farm-bot-ui:latest

# ❌ 错误的镜像名称
docker pull qq-farm-bot-ui:latest  # 缺少用户名

# 如果需要登录
docker login

---

错误 2: 端口被占用 ❌

错误信息:

Error starting userland proxy: listen tcp 0.0.0.0:3080: bind: address already in use

解决方案:

bash
# 检查端口占用
lsof -i :3080

# 使用不同端口
export WEB_PORT=3081
bash <(curl --http1.1 --retry 4 --retry-delay 1 --retry-all-errors --connect-timeout 10 --max-time 90 -fsSL https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/install-or-update.sh) --action install

---

错误 3: 权限错误 ❌

错误信息:

permission denied while trying to connect to the Docker daemon socket

解决方案:

bash
# 使用 sudo
sudo bash <(curl --http1.1 --retry 4 --retry-delay 1 --retry-all-errors --connect-timeout 10 --max-time 90 -fsSL https://raw.githubusercontent.com/smdk000/qq-farm-ui-pro-max/main/scripts/deploy/install-or-update.sh) --action install

# 或将用户添加到 docker 组
sudo usermod -aG docker $USER
newgrp docker

---

📊 多平台支持

• ✅ linux/amd64 - Intel/AMD x86_64 服务器
• ✅ linux/arm64 - ARM64 服务器（树莓派 4B/鲲鹏/飞腾等）

Docker 会自动选择适合您系统架构的镜像版本。

---

📝 配置说明

环境变量

端口映射

---

📚 完整文档

• GitHub 仓库: https://github.com/smdk000/qq-farm-ui-pro-max
• Docker Hub: https://hub.docker.com/r/smdk000/qq-farm-bot-ui
• GitHub Packages: https://github.com/users/smdk000/packages/container/package/qq-farm-bot-ui
• 部署指南: deploy/README.md
• 国内网络部署: deploy/README.cn.md
• 故障排查: docs/guides/TROUBLESHOOTING.md
• 配置模板: docs/guides/CONFIG_TEMPLATES.md

---

🆘 获取帮助

文档资源

• https://github.com/smdk000/qq-farm-ui-pro-max - 项目说明
• DEPLOYMENT_FIX_REPORT.md - 部署问题修复报告
• DOCKER_BUILD_COMPLETE.md - Docker 构建完成总结

技术支持

• GitHub Issues: https://github.com/smdk000/qq-farm-ui-pro-max/issues
• *******: 227916149
• Docker Hub: https://hub.docker.com/r/smdk000/qq-farm-bot-ui

---

程序截图

登录

支持多模式验证、Token安全保护、体验卡自助领取与一键全自动登录入驻。

!登录控制台1 !登录控制台2 !登录控制台3

主题

内置多种玻璃态 (Glassmorphism) 梦幻色彩主题，全面适配深浅双模与性能自适应。

![主题