fancybits/chrome-capture-for-channels

Chrome标签页音视频捕获Docker镜像

镜像概述

该Docker镜像基于Headless Chrome技术构建，提供从Chrome浏览器标签页捕获视频和音频流的能力。通过容器化封装，无需本地安装Chrome及依赖，即可便捷实现网页内容的音视频录制，支持自定义参数配置，可无缝集成到自动化工作流中。

核心功能与特性

• 音视频同步捕获：同时录制Chrome标签页中的视频画面与音频流，确保音画同步
• Headless模式运行：基于无界面Chrome（Headless Chrome），无需图形化环境，降低系统资源占用
• 灵活参数配置：支持自定义视频分辨率、帧率、录制时长、输出路径等核心参数
• 目标精准定位：通过URL直接指定需捕获的标签页内容，支持动态网页和单页应用
• 轻量级部署：优化镜像体积，最小化依赖，支持快速启动和资源高效利用

使用场景与适用范围

典型使用场景

• 网页动态内容录制（如交互演示、动画效果、数据可视化）
• 在线会议/直播内容存档（如远程会议、网络研讨会录制）
• 教育课程捕获（如在线课程、培训视频、教学直播）
• 自动化测试辅助（记录UI操作流程、错误复现过程）
• 内容创作素材采集（如社交媒体内容、网页游戏画面）

适用人群

• 开发者（集成到CI/CD流程、自动化脚本）
• 内容创作者（快速获取网页端素材）
• 教育工作者（录制在线教学内容）
• QA测试人员（记录测试过程与界面表现）
• IT运维人员（监控网页状态与内容变化）

使用方法与配置说明

环境变量配置

Docker Run 命令示例

1. 基本录制（默认参数）

bash
docker run -d \
  -e CHROME_URL="https://example.com/live" \
  -v $(pwd)/output:/output \
  --name chrome-capture \
  [镜像名称]

说明：默认录制5分钟，输出1920x1080视频至宿主机当前目录的output/capture.mp4

2. 自定义参数录制

bash
docker run -d \
  -e CHROME_URL="https://meeting.example.com/room123" \
  -e VIDEO_RESOLUTION="1280x720" \
  -e VIDEO_FPS="24" \
  -e DURATION="1800" \
  -e OUTPUT_PATH="/output/meeting_202405.mp4" \
  -v $(pwd)/meeting-recordings:/output \
  --name meeting-recorder \
  [镜像名称]

说明：录制30分钟（1800秒）720p/24fps视频，输出至宿主机meeting-recordings/meeting_202405.mp4

Docker Compose 配置示例

yaml
version: '3.8'
services:
  chrome-capture:
    image: [镜像名称]
    container_name: lecture-recorder
    environment:
      - CHROME_URL=https://course.example.com/lecture-01
      - VIDEO_RESOLUTION=1920x1080
      - VIDEO_FPS=30
      - DURATION=3600
      - AUDIO_BITRATE=192k
      - CAPTURE_AUDIO=true
      - OUTPUT_PATH=/output/lecture-01.mp4
    volumes:
      - ./lecture-records:/output
    restart: "no"  # 单次任务，完成后自动退出
    network_mode: "bridge"

注意事项

• 网络访问：容器需具备访问目标URL的网络权限，如需代理可通过HTTP_PROXY/HTTPS_PROXY环境变量配置
• 认证页面处理：对需登录的页面，可通过CHROME_COOKIES环境变量传入认证Cookie（格式：key1=value1;key2=value2）
• 资源配置：高分辨率（如2560x1440）或长时间录制建议分配2核CPU及2GB以上内存，避免卡顿或崩溃
• 输出权限：挂载宿主机目录时，确保容器用户对输出目录有写权限（可通过-u $(id -u):$(id -g)参数映射本地用户ID）
• 网页加载等待：对于动态加载内容，可通过PAGE_LOAD_DELAY环境变量设置页面加载等待时间（单位：秒，默认5秒）