## 背景

StreamCap 是一款开源的多平台直播自动录制工具，基于 FFmpeg 直接拉取直播源流并落盘，支持抖音、快手、B 站、虎牙、斗鱼、小红书以及 TikTok、Twitch、YouTube 等 40 余个平台；开播自动录制，下播继续监控，无需人工守屏。

![](https://developer.qcloudimg.com/http-save/yehe-12413718/fdbe420fa928729978e239ae537a36f5.jpg)

本文记录服务器端无人值守部署，提供 Docker 与 Python + systemd 两种方案，并覆盖安全配置、运维命令与已知问题。
* * *
## 一、项目简介

StreamCap 不做屏幕重采集（录屏），而是通过 streamget 解析直播地址，再调用 FFmpeg 拉取源流直接落盘：画质取决于源流，不占用 GPU 编码，也无需保持浏览器页面开启。


**技术栈**


| 组成           | 说明                                      |
| ------------ | --------------------------------------- |
| 桌面端 / Web UI | flet（Flutter 的 Python 封装）               |
| 流解析          | streamget，内置 40 余个平台的解析逻辑               |
| 拉流与转码        | FFmpeg；Windows 安装包自带，Linux 需自行安装        |
| Web 管理界面     | 默认 6006 端口                              |
| 录像回看服务       | FastAPI，默认 6007 端口，支持 HTTP Range，可拖动进度条 |

平台覆盖国内 30+、海外 10+，完整清单见 README。
* * *
## 二、核心功能


* **循环监控**：默认 180 秒轮询，开播自录、下播续监；

* **定时监听**：仅在指定时段检测，降低无效请求与风控概率；

* **批量管理**：多直播间同时监控，支持搜索与批量启停、删除；

* **输出格式**：视频 ts /flv/mkv /mov/mp4，纯音频 mp3 /m4a；

* **分段转码**：按时长切片，录制结束后自动转 mp4；

* **消息推送**：钉钉、微信、飞书、Bark、Telegram、邮件；

* **多端运行**：Windows /macOS 桌面端，Linux 走 Web 模式或 Docker。


![图形化界面](https://developer.qcloudimg.com/http-save/yehe-12413718/47e418206603cdedce134cb4b3db197b.jpg)


由于界面话操作上手无门槛，下面以服务端无人值守部署为例，介绍下如何快速搭建一套 24 小时监控服务。
* * *
## 三、方案一：Docker 部署（推荐）

前置条件：已安装 Docker Engine 与 Compose 插件，网络可访问目标平台。

获取代码并准备配置：


```
git clone https://github.com/ihmily/StreamCap.git
cd StreamCap
cp .env.example .env
```

编辑 `.env`：


```
PORT=6006                          # Web 管理界面端口
VIDEO_API_PORT=6007                # 录像回看 API 端口
TZ=Asia/Shanghai                   # 时区，影响定时监听
VIDEO_API_EXTERNAL_URL=http://服务器IP:6007   # 回看服务的外部访问地址
```

编辑 `docker-compose.yml`，为两个服务添加 `restart: always`，否则进程崩溃或主机重启后录制会静默中断：


```
services:
  streamcap:
    image: ihmily/streamcap
    restart: always
    # ...
  video_api:
    image: ihmily/streamcap
    restart: always
    # ...
```

同时确认 `downloads/`、`config/`、`logs/` 已映射到宿主机路径，避免容器重建后数据丢失。

启动并访问：


```
docker compose up -d
# 浏览器访问 http://服务器IP:6006
```

常用命令：


```
docker compose logs -f streamcap              # 实时日志
docker compose ps                             # 容器状态
docker compose restart streamcap              # 重启
docker compose pull && docker compose up -d   # 升级
```
* * *
## 四、方案二：Python + systemd 部署

### 4.1 安装依赖

Python 3.10+、FFmpeg、venv，Debian / Ubuntu 为例：


```
sudo apt update
sudo apt install -y python3 python3-pip python3-venv ffmpeg git
```

### 4.2 部署代码


```
git clone https://github.com/ihmily/StreamCap.git /opt/StreamCap
cd /opt/StreamCap

python3 -m venv venv
source venv/bin/activate
pip install -i https://pypi.org/simple streamget
pip install -r requirements-web.txt

cp .env.example .env
```

编辑 `.env`：`PLATFORM=web`、`HOST=0.0.0.0`（否则仅本机可访问）：


```
PLATFORM=web
HOST=0.0.0.0
PORT=6006
```

先前台验证再配置服务：


```
venv/bin/python main.py --web --host 0.0.0.0 --port 6006
```

### 4.3 配置 systemd

创建 `/etc/systemd/system/streamcap.service`：


```
[Unit]
Description=StreamCap Web Service
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/StreamCap
ExecStart=/opt/StreamCap/venv/bin/python main.py --web --host 0.0.0.0 --port 6006
Restart=always
RestartSec=5
Environment=TZ=Asia/Shanghai

[Install]
WantedBy=multi-user.target
```

在线回看还需创建 `/etc/systemd/system/streamcap-video-api.service`（Docker 方式已自动包含）：


```
[Unit]
Description=StreamCap Video Stream API
After=network.target streamcap.service

[Service]
Type=simple
WorkingDirectory=/opt/StreamCap
ExecStart=/opt/StreamCap/venv/bin/python -m app.api.video_stream_service
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
```

启用：


```
sudo systemctl daemon-reload
sudo systemctl enable --now streamcap streamcap-video-api
journalctl -u streamcap -f          # 查看日志
```
* * *
## 五、部署后配置与安全


1. **修改默认口令**：初始账号 `admin / admin`，登录后在「账号设置」修改；账号文件 `config/web_auth.json`；

2. **录制参数**：设置 → 录制设置，确认格式、清晰度、循环间隔；

3. **存储**：设置保存目录与剩余空间阈值，定期清理旧录像或扩容；

4. **消息推送（可选）**：设置 → 推送设置；

5. **公网访问**：不要直接暴露 6006 / 6007 端口，使用反向代理加 HTTPS 并限制来源 IP。

Nginx 示例：


```
server {
    listen 443 ssl;
    server_name your.domain.example;

    ssl_certificate     /etc/nginx/certs/your.domain.pem;
    ssl_certificate_key /etc/nginx/certs/your.domain.key;

    location / {
        proxy_pass http://127.0.0.1:6006;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```
* * *
## 六、网络环境


* 国内平台用境内线路；TikTok、Twitch、YouTube 等海外平台需境外机器或在设置中配置代理；

* 云服务商 IP 段易被平台风控，录制频繁失败时优先更换为家宽或 NAT 主机，而非调整程序参数。

## 七、运维速查

**目录**

| 目录           | 内容      |
| ------------ | ------- |
| `downloads/` | 录像文件    |
| `config/`    | 配置与账号信息 |
| `logs/`      | 运行日志    |

**命令对照**

| 操作 | Docker                                        | systemd                       |
| -- | --------------------------------------------- | ----------------------------- |
| 状态 | `docker compose ps`                           | `systemctl status streamcap`  |
| 日志 | `docker compose logs -f streamcap`            | `journalctl -u streamcap -f`  |
| 重启 | `docker compose restart streamcap`            | `systemctl restart streamcap` |
| 停止 | `docker compose stop`                         | `systemctl stop streamcap`    |
| 升级 | `docker compose pull && docker compose up -d` | `git pull` 后更新依赖并重启           |

迁移时备份上述三个目录即可。



## 八、常见问题


| 现象                   | 说明与建议                                                                    |
| -------------------- | ------------------------------------------------------------------------ |
| 虎牙录制中断、产生碎片文件        | 见 [Issue #421](https://github.com/ihmily/StreamCap/issues/421)，先做长时间试录   |
| 下播后仍显示「录制中」，漏录下一场    | 见 [Issue #210](https://github.com/ihmily/StreamCap/issues/210)，定期检查状态并重启 |
| 掉帧、TS 合并后音画不同步       | 见 [Issue #316](https://github.com/ihmily/StreamCap/issues/316)，录前检查文件完整性 |
| 小红书无法循环监控            | 地址为一次性，暂不支持                                                              |
| YouTube 录制失败         | 需配置有效 Cookie                                                             |
| 斗鱼 / 部分抖音 App 链接无法解析 | 需安装 Node.js                                                              |
| 任务整体失败               | 查日志 → `df -h` 查磁盘 → 确认线路 → FFmpeg 手动拉流验证                                 |

---

## 相关链接

* 项目仓库：[https://github.com/ihmily/StreamCap](https://github.com/ihmily/StreamCap)

* 最新下载：[https://github.com/ihmily/StreamCap/releases/latest](https://github.com/ihmily/StreamCap/releases/latest)

StreamCap 是一款开源的多平台直播自动录制工具，基于 FFmpeg 直接拉取直播源流并落盘，支持抖音、快手、B 站、虎牙、斗鱼、小红书以及 TikTok、Twitch、YouTube 等 40 余个平台；开播自动录制，下播继续监控，无需人工守屏。

开源直播录制工具 StreamCap 服务器部署实战：24 小时无人值守自动录制

开源多平台直播录制工具 StreamCap 的 Docker 与 Python+systemd 服务器无人值守部署方案，含安全配置、运维速查与已知问题

开发工具

架构设计

运维

StreamCap是一款支持40+平台的开源直播自动录制工具，基于FFmpeg拉取源流，覆盖抖音、B站、虎牙、TikTok等平台。支持开播自动录制、循环监控、定时监听、批量管理、分段转码及多端消息推送。本文提供Docker与Python+systemd两种服务器端无人值守部署方案，包含安全配置、运维命令及常见问题处理指南。

数据丢失

服务器

Flutter

Windows

Docker

Debian

容器

Python

Ubuntu

GitHub

MacOS

Nginx

Linux

JSON

9.9元起，最快1天搭建自有直播平台


4核4G3M云服务器 新用户低至38元/年！

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

StreamCap是一款支持40+平台的开源直播自动录制工具，基于FFmpeg拉取源流，覆盖抖音、B站、虎牙、TikTok等平台。支持开播自动录制、循环监控、定时监听、批量管理、分段转码及多端消息推送。本文提供Docker与Python+systemd两种服务器端无人值守部署方案，包含安全配置、运维命令及常见问题处理指...

开源直播录制工具 StreamCap 服务器部署实战：24 小时无人值守自动录制-腾讯云开发者社区-腾讯云

开源直播录制工具 StreamCap 服务器部署实战：24 小时无人值守自动录制

开源直播录制工具 StreamCap 服务器部署实战：24 小时无人值守自动录制

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐