ar1995/qq-farm-bot-ui repository overview

⁠此镜像为开源项目构建，属于“游戏外挂”，使用本镜像造成的损失自行承担！

qq-farm-bot-ui 是一个为经典 QQ 农场机器人设计的基于 Node.js 的自动化项目，提供 Web 控制面板，支持多账号挂机、自动农场/好友/任务流程等功能。

原项目地址: https://github.com/Penty-d/qq-farm-bot-ui⁠

---

⁠使用方法 (Using Docker)

你可以通过 Docker CLI 或 Docker Compose 来部署 qq-farm-bot-ui。

⁠方法一：使用 Docker Compose

1. 创建项目目录:

   mkdir qq-farm-ui && cd qq-farm-ui
   

   Copy

2. 创建 docker-compose.yml 文件: 在项目目录中创建一个名为 docker-compose.yml 的文件，并将以下内容粘贴进去：

   services:
     qq-farm-bot-ui:
       image: ar1995/qq-farm-bot-ui
       container_name: qq-farm-bot-ui
       restart: unless-stopped
       ports:
         - "3000:3000" # 将宿主机的 3000 端口映射到容器的 3000 端口
       environment:
         - ADMIN_PASSWORD=admin # 设置管理员密码，强烈建议修改为强密码
         - TZ=Asia/Shanghai     # 设置时区为中国上海
       volumes:
         - ./data:/app/core/data     # 挂载本地 data 目录到容器内，用于持久化配置和账号数据
   

   Copy

3. 修改配置 (可选但推荐):

   • 管理员密码: 将 ADMIN_PASSWORD=admin 中的 admin 修改为你自己的强密码。
   • 时区: TZ=Asia/Shanghai 已设为中国上海时区，可根据需要修改。

4. 启动服务: 在 docker-compose.yml 文件所在目录下执行以下命令：

   docker compose up -d
   

   Copy

5. 访问面板: 服务启动后，打开浏览器访问 http://<你的服务器IP>:3000。首次访问可能需要稍等片刻让应用完成初始化。使用你在 ADMIN_PASSWORD 环境变量中设置的密码登录。

---

⁠方法二：使用 Docker CLI

1. 拉取镜像:

   docker pull ar1995/qq-farm-bot-ui
   

   Copy

2. 运行容器:

   # 替换 <your-password> 为你想要设置的管理员密码
   docker run -d \
     --name qq-farm-bot-ui \
     --restart unless-stopped \
     -p 3000:3000 \
     -e ADMIN_PASSWORD=<your-password> \
     -e TZ=Asia/Shanghai \
     -v $(pwd)/data:/app/core/data \
     ar1995/qq-farm-bot-ui
   

   Copy
   • $(pwd)/data 会将当前命令执行目录下的 data 文件夹挂载到容器内的 /app/core/data。你也可以指定绝对路径，如 /home/user/qq_farm_data:/app/core/data。

3. 访问面板: 同 Docker Compose 方法的第 5 步。

---

⁠数据持久化

• 无论使用哪种方法，-v 或 volumes 都将容器内的 /app/core/data 目录挂载到了宿主机的一个目录（示例中为 ./data）。
• 该目录会存储 qq-farm-bot-ui 的配置文件 (store.json) 和账号数据 (accounts.json)。
• 重要: 请妥善备份该目录下的文件，以防数据丢失。

---

⁠安全提示

• 修改默认密码: 请务必修改 ADMIN_PASSWORD 的默认值 admin。
• 防火墙: 确保服务器防火墙允许配置的端口（默认 3000）进行访问。
• 网络: 考虑到安全，可以将端口绑定到 127.0.0.1，并通过反向代理（如 Nginx）暴露 HTTPS。

---