WaterCrawl前端官方镜像文档

镜像概述和主要用途

WaterCrawl前端官方镜像是WaterCrawl项目的官方Web前端组件，基于现代前端技术栈（如React、Vue或Angular）构建。该镜像提供用户友好的图形界面，作为WaterCrawl爬虫系统的交互入口，用于简化爬虫任务的管理、运行状态监控及爬取数据的可视化分析。

核心功能和特性

• 任务管理：支持爬虫任务的创建、编辑、启动、暂停及删除，可配置任务参数（如爬取目标、频率、并发数等）。
• 实时监控：展示爬虫任务实时运行状态、进度百分比及关键指标（如请求成功率、数据抓取量）。
• 日志查看：提供结构化任务日志，支持关键词搜索和时间范围筛选，便于问题排查。
• 数据可视化：通过图表直观展示爬取数据统计（如每日抓取量、数据类型分布）及任务执行效率分析。
• 权限控制：支持多用户角色（管理员、操作员），基于RBAC模型管理界面操作权限。

使用场景和适用范围

• 开发环境：供开发者在本地调试爬虫任务流程，验证前端与后端API的交互。
• 生产环境：部署于服务器，为团队提供统一的爬虫任务管理平台。
• 教育/演示：作为WaterCrawl项目的可视化教学工具，展示爬虫系统的使用流程。
• 中小型数据采集团队：无需编写命令行操作，通过界面快速完成数据爬取需求。

使用方法和配置说明

环境要求

• Docker Engine 19.03+
• 后端服务：需配合WaterCrawl后端API服务（建议使用官方watercrawl/backend镜像）

快速启动（Docker Run）

docker run -d \
  --name watercrawl-frontend \
  -p 80:80 \
  -e API_URL=[***] \  # 后端API服务地址（必填）
  -e PORT=80 \                             # 前端服务端口（可选，默认80）
  watercrawl/frontend:latest

启动后访问 http://localhost 即可打开Web界面。

Docker Compose部署（推荐）

创建docker-compose.yml文件：

version: '3.8'
services:
  frontend:
    image: watercrawl/frontend:latest
    ports:
      - "80:80"
    environment:
      - API_URL=[***]  # 与后端服务容器名关联
      - LOG_LEVEL=info               # 日志级别：debug/info/warn/error（可选）
    depends_on:
      - backend

  backend:
    image: watercrawl/backend:latest  # 需确保后端服务已部署
    environment:
      - DATABASE_URL=mysql://user:pass@db:3306/watercrawl
    # 其他后端配置...

启动命令：docker-compose up -d

配置参数说明

访问与初始登录

部署成功后，通过http://<服务器IP>:<PORT>访问界面。初始管理员账号：

• 用户名：admin
• 密码：watercrawl@2024（首次登录需强制修改）

注意事项

• 生产环境建议通过反向代理（如Nginx）配置HTTPS，增强传输安全性。
• 若修改API_URL，需重启容器使配置生效。
• 前端容器本身不存储持久化数据，所有状态依赖后端API服务。