StreamCap Docker部署指南：无需Python环境的快速启动方案

【免费下载链接】StreamCap Multi-Platform Live Stream Automatic Recording Tool | 多平台直播流自动录制客户端 · 基于FFmpeg · 支持监控/定时/转码 项目地址: https://gitcode.com/gh_mirrors/st/StreamCap

StreamCap 是一款强大的多平台直播流自动录制客户端，基于FFmpeg构建，支持监控、定时录制和视频转码功能。本指南将展示如何通过Docker快速部署StreamCap，无需复杂的Python环境配置，让你轻松开始直播录制之旅。

📋 准备工作：Docker环境搭建

在开始部署前，请确保你的系统已安装Docker和Docker Compose。如果尚未安装，可以通过以下命令快速安装：

# Ubuntu/Debian系统
sudo apt-get update && sudo apt-get install docker.io docker-compose -y

# 启动Docker服务
sudo systemctl start docker && sudo systemctl enable docker

🔄 一键部署流程

1. 获取项目代码

首先克隆StreamCap仓库到本地：

git clone https://gitcode.com/gh_mirrors/st/StreamCap
cd StreamCap

2. 配置环境变量

复制环境变量示例文件并根据需要修改：

cp .env.example .env
# 使用文本编辑器修改配置（可选）
nano .env

主要配置项说明：

• PORT: Web界面端口（默认6006）
• VIDEO_API_PORT: 视频API端口（默认6007）
• TZ: 时区设置（默认Asia/Shanghai）
• CUSTOM_VIDEO_ROOT_DIR: 视频存储路径（默认使用容器内路径）

3. 启动服务

使用Docker Compose一键启动所有服务：

docker-compose up -d

启动成功后，访问 http://localhost:6006 即可打开StreamCap的Web界面。

🖥️ 界面预览与基本操作

StreamCap提供直观的用户界面，让你轻松管理直播录制任务。以下是主要功能界面：

StreamCap录制列表界面，显示当前监控和录制中的直播流

在主界面中，你可以：

• 点击"+"按钮添加新的直播监控任务
• 通过搜索框快速查找特定直播
• 查看每个直播的录制状态和时长
• 使用操作按钮管理录制任务（暂停、删除、查看详情等）

StreamCap支持多语言界面，图为英文界面展示

⚙️ 高级配置选项

数据持久化设置

Docker Compose默认配置了以下数据卷，确保数据持久化：

volumes:
  - ./logs:/app/logs        # 应用日志
  - ./config:/app/config    # 配置文件
  - ./downloads:/app/downloads  # 录制的视频文件

这些目录会映射到宿主机的当前目录下，确保重启容器后数据不会丢失。

端口映射调整

如果默认端口被占用，可以修改 docker-compose.yml 文件中的端口映射：

ports:
  - "自定义端口:6006"  # Web界面端口
  - "自定义API端口:6007"  # 视频API端口

修改后需重启服务使配置生效：

docker-compose down && docker-compose up -d

🐳 容器管理常用命令

查看服务状态

docker-compose ps

查看应用日志

docker-compose logs -f streamcap

停止服务

docker-compose down

更新应用

# 拉取最新镜像
docker-compose pull
# 重启服务
docker-compose up -d

❓ 常见问题解决

服务无法访问

如果访问 http://localhost:6006 无响应，请检查：

1. 容器是否正常运行：docker-compose ps
2. 端口是否被占用：netstat -tulpn | grep 6006
3. 防火墙设置是否允许端口访问

视频文件存储位置

录制的视频文件默认保存在宿主机的 ./downloads 目录下，你可以通过修改 .env 文件中的 CUSTOM_VIDEO_ROOT_DIR 配置自定义存储路径。

时区设置问题

如果录制时间与实际时间不符，请检查 .env 文件中的 TZ 配置是否正确，例如：

TZ=Asia/Shanghai  # 中国时区
TZ=America/New_York  # 美国纽约时区

通过以上步骤，你已经成功部署了StreamCap直播录制工具。现在可以开始添加你喜爱的直播源，享受自动录制的便利了！如有其他问题，可以查看项目中的 README.md 或提交issue获取帮助。

【免费下载链接】StreamCap Multi-Platform Live Stream Automatic Recording Tool | 多平台直播流自动录制客户端 · 基于FFmpeg · 支持监控/定时/转码 项目地址: https://gitcode.com/gh_mirrors/st/StreamCap