lovefaker/qq-farm-bot-pro-max

🐳 QQ Farm Bot UI - 快速部署指南

镜像信息

bash
docker pull lovefaker/qq-farm-bot-pro-max:latest

---

🚀 快速部署

方式一：Docker Compose（推荐）

1. 创建项目目录

bash
mkdir -p /opt/qq-farm-ui && cd /opt/qq-farm-ui

2. 创建 docker-compose.yml

yaml
version: '3.8'

services:
  qq-farm-bot-ui:
    image: lovefaker/qq-farm-bot-pro-max:latest
    container_name: qq-farm-bot-ui
    restart: unless-stopped
    ports:
      - "3090:3000"
    environment:
      - ADMIN_PASSWORD=admin
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/app/data

3. 启动服务

bash
docker compose up -d

---

方式二：Docker Run

bash
docker run -d \
  --name qq-farm-bot-ui \
  -p 3090:3000 \
  -e ADMIN_PASSWORD=admin \
  -e TZ=Asia/Shanghai \
  -v $(pwd)/data:/app/data \
  --restart unless-stopped \
  lovefaker/qq-farm-bot-pro-max:latest

---

⚙️ 配置说明

端口映射

访问地址: http://localhost:3090 或 http://服务器IP:3090

环境变量

数据持久化

• 挂载路径: ./data:/app/data
• 作用: 保存应用配置、用户数据等
• 备份建议: 定期备份宿主机的 ./data 目录

---

📁 目录结构

/opt/qq-farm-ui/
├── docker-compose.yml    # Compose 配置文件
├── data/                 # 持久化数据目录
│   ├── config/           # 配置文件
│   └── database/         # 数据库文件
└── logs/                 # 日志目录（可选）

---

🔧 常用管理命令

Docker Compose

bash
# 查看运行状态
docker compose ps

# 查看实时日志
docker compose logs -f

# 停止服务
docker compose down

# 重启服务
docker compose restart

# 更新镜像并重启
docker compose pull && docker compose up -d

Docker Run

bash
# 查看容器状态
docker ps | grep qq-farm-bot-ui

# 查看实时日志
docker logs -f qq-farm-bot-ui

# 停止容器
docker stop qq-farm-bot-ui

# 启动容器
docker start qq-farm-bot-ui

# 删除容器
docker rm -f qq-farm-bot-ui

---

🛠️ 故障排查

常见问题

日志查看

bash
# 查看最近 100 行日志
docker compose logs --tail=100

# 实时查看日志
docker compose logs -f

数据备份与恢复

bash
# 备份数据目录
tar -czf qq-farm-backup-$(date +%Y%m%d).tar.gz ./data/

# 恢复数据
tar -xzf qq-farm-backup-YYYYMMDD.tar.gz

---

🔄 更新说明

Docker Compose

bash
# 拉取最新镜像
docker compose pull

# 重启服务
docker compose up -d

Docker Run

bash
# 停止并删除旧容器
docker stop qq-farm-bot-ui && docker rm qq-farm-bot-ui

# 拉取最新镜像
docker pull lovefaker/qq-farm-bot-pro-max:latest

# 使用新镜像重新运行
docker run -d \
  --name qq-farm-bot-ui \
  -p 3090:3000 \
  -e ADMIN_PASSWORD=admin \
  -e TZ=Asia/Shanghai \
  -v $(pwd)/data:/app/data \
  --restart unless-stopped \
  lovefaker/qq-farm-bot-pro-max:latest

---

⚠️ 安全建议

• 修改默认密码 — 首次登录后务必修改管理员密码
• 防火墙配置 — 仅对外开放必要端口，建议使用反向代理（如 Nginx）并配置 SSL
• 定期更新 — 关注镜像更新，及时获取安全修复
• 数据备份 — 定期备份 data 目录，建议设置自动备份脚本

---

❓ 常见问题

Q: 如何修改管理员密码？

A: 修改 docker-compose.yml 中的 ADMIN_PASSWORD 环境变量值，然后重启容器。

Q: 数据存储在哪里？

A: 数据存储在宿主机的 ./data 目录中，与容器内的 /app/data 目录同步。

Q: 如何查看应用版本？

A: 访问 Web 界面查看版本信息，或通过 docker inspect 命令查看镜像详情。

Q: 容器无法启动怎么办？

A: 查看容器日志：docker logs qq-farm-bot-ui，根据错误信息进行排查。

---

📞 技术支持

如有问题，请：

1. 查看容器日志：docker logs qq-farm-bot-ui
2. 检查配置是否正确
3. 在项目 Issues 页面反馈问题

⚠️ 注意: 本镜像仅供学习和研究使用，请遵守相关***。