gabekangas/owncast

Owncast Docker镜像文档

概述

Owncast是一个自托管的直播视频流与聊天服务器，旨在让用户完全掌控自己的内容分发。它提供开箱即用的功能，无需复杂配置即可搭建个人直播平台，支持主流直播软件，并提供灵活的视频存储选项，帮助用户避免将数据和隐私交给大型科技公司。

核心功能与特性

• 独立自托管：无需依赖第三方平台，完全掌控数据和内容
• 内置Web界面：包含视频播放和实时聊天功能，界面可通过HTML、CSS和JavaScript自定义
• RTMP协议支持：兼容所有主流直播软件（OBS、Streamlabs、Restream等）
• 灵活存储选项：支持本地存储（适合小流量场景）和S3兼容存储（分担带宽压力）
• 简单配置：提供丰富的自定义选项，包括Web UI外观、视频参数等

使用场景

• 个人直播创作者希望摆脱第三方平台限制
• 小型社区或组织需要私有的直播和互动空间
• 对数据隐私有高要求，不愿将用户数据交给大型科技公司的场景
• 教育机构、企业内部培训等需要可控直播环境的场景

快速开始

使用Docker运行

基本部署

bash
docker run -d \
  --name owncast \
  -p 8080:8080 \  # Web界面和视频服务端口
  -p 1935:1935 \  # RTMP推流端口
  -v ./owncast-data:/app/data \  # 持久化存储配置和视频数据
  owncast/owncast

Docker Compose配置

yaml
version: '3'
services:
  owncast:
    image: owncast/owncast
    container_name: owncast
    ports:
      - "8080:8080"   # Web访问端口
      - "1935:1935"   # RTMP推流端口
    volumes:
      - ./owncast-data:/app/data  # 数据持久化
    restart: unless-stopped       # 自动重启

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

配置说明

Owncast提供多种配置选项，可通过修改配置文件或Web界面进行调整：

主要配置项

• 服务器设置：修改服务器名称、描述、logo等基本信息
• 视频参数：调整分辨率、比特率、帧率等视频编码设置
• Web界面自定义：编辑HTML、CSS和JavaScript文件修改界面外观
• 聊天功能：配置聊天规则、用户权限、过滤设置等
• 存储配置：切换本地存储或S3兼容存储模式

详细配置指南请参考官方配置文档。

直播软件兼容性

Owncast兼容所有支持RTMP协议的直播软件，包括：

• OBS Studio（推荐）
• Streamlabs
• Restream
• XSplit
• 手机直播APP（如Streamlabs Mobile）

配置方法：在直播软件中设置RTMP服务器地址为 rtmp://你的服务器IP:1935/live，流密钥默认为 abc123（可在Owncast设置中修改）。

视频存储选项

本地存储

默认存储方式，视频文件保存在服务器本地并直接提供访问。适合：

• 观众规模小（几十人以内）
• 服务器具备足够带宽和存储空间
• 网络连接稳定且带宽充足

S3兼容存储

将视频文件存储在S3兼容对象存储服务，减轻本地服务器带宽压力。支持：

• AWS S3
• MinIO
• DigitalOcean Spaces
• 其他S3兼容存储服务

配置方法请参考官方S3配置文档。

从源码构建

如需自定义或开发，可从源码构建Docker镜像：

bash
# 克隆仓库
git clone https://github.com/owncast/owncast
cd owncast

# 构建Docker镜像
docker build -t owncast-custom .

# 运行自定义镜像
docker run -d -p 8080:8080 -p 1935:1935 owncast-custom

许可协议

本项目采用MIT许可协议，详情见https://github.com/owncast/owncast/blob/develop/LICENSE%E3%80%82

联系方式

• 项目聊天：加入Rocket.Chat
• 开发者：Gabe Kangas (@***)
• 项目地址：https://github.com/owncast/owncast
• 官方文档：[***]