OwnCast 开源项目详解：自托管视频直播流平台部署教程与 Twitch 替代方案实战指南

┌─────────────────────────────────────────────────────┐
│                    OwnCast 服务器                     │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  │
│  │ RTMP 接收   │  │ HLS 分发    │  │ WebSocket   │  │
│  │ 模块        │  │ 模块        │  │ 聊天模块    │  │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘  │
│         │                │                │         │
│  ┌──────┴────────────────┴────────────────┴──────┐  │
│  │              Go 核心引擎 / 数据存储              │  │
│  │  (SQLite / 配置文件 / 视频文件系统)              │  │
│  └─────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────┘

# 1. 创建数据目录并进入
mkdir -p /opt/owncast/data
cd /opt/owncast

# 2. 启动 OwnCast 容器（Docker 命令方式）
docker run -d \
  --name owncast \
  -p 8080:8080 \
  -p 1935:1935 \
  -v $(pwd)/data:/app/data \
  owncast/owncast:latest

# 查看容器运行状态
docker ps
# 查看运行日志
docker logs -f owncast

version: "3"
services:
  owncast:
    image: owncast/owncast:latest
    container_name: owncast
    restart: unless-stopped
    ports:
      - "8080:8080"    # Web 界面和 HLS 流端口
      - "1935:1935"    # RTMP 推流端口
    volumes:
      - ./data:/app/data
    environment:
      - TZ=Asia/Shanghai

# 使用 docker-compose 启动
docker-compose up -d
# 停止服务
docker-compose down
# 查看日志
docker-compose logs -f

server {
    listen 80;
    server_name live.yourdomain.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name live.yourdomain.com;

    # SSL 证书配置（使用 Let's Encrypt 或购买的证书）
    ssl_certificate /etc/nginx/ssl/live.pem;
    ssl_certificate_key /etc/nginx/ssl/live.key;

    # 前端页面和 API 反向代理
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        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;

        # 超时设置，适合长连接和视频流
        proxy_connect_timeout 60s;
        proxy_send_timeout 300s;
        proxy_read_timeout 300s;
    }

    # HLS 视频流缓存优化
    location /hls/ {
        proxy_pass http://127.0.0.1:8080/hls/;
        proxy_set_header Host $host;

        # HLS 切片文件缓存设置
        expires 10s;
        add_header Cache-Control "public, no-cache";
    }
}

# 1. 安装 Go 语言环境（1.20 或更高版本）
wget https://go.dev/dl/go1.22.0.linux-amd64.tar.gz
tar -C /usr/local -xzf go1.22.0.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

# 2. 安装 FFmpeg 开发依赖
apt-get update && apt-get install -y ffmpeg

# 3. 克隆 OwnCast 源码
git clone https://github.com/owncast/owncast.git
cd owncast

# 4. 编译后端
go build -o owncast main.go

# 5. 运行
./owncast
# 指定端口运行
./owncast -port 8080 -rtmpport 1935

# 1. 进入前端目录
cd owncast/webroot

# 2. 安装依赖
npm install

# 3. 开发模式运行（热重载）
npm run dev

# 4. 生产构建
npm run build

# 5. 构建后的文件位于 webroot/dist/，OwnCast 启动时自动加载

# 服务器基本配置
server:
  httpPortNumber: 8080
  rtmpPortNumber: 1935
  webServerIP: "0.0.0.0"
  streamKey: "在这里修改您的推流密钥"

# 直播流质量配置
videoSettings:
  qualityVariants:
    - name: "High"
      videoBitrate: 3500
      scaledHeight: 1080
      cpuUsageLevel: 2
      framerate: 30
    - name: "Medium"
      videoBitrate: 1800
      scaledHeight: 720
      cpuUsageLevel: 2
      framerate: 30
    - name: "Low"
      videoBitrate: 800
      scaledHeight: 480
      cpuUsageLevel: 2
      framerate: 30

# 社交与主播信息
instanceDetails:
  name: "我的直播间"
  title: "欢迎来到我的直播间"
  summary: "这是一个使用 OwnCast 搭建的自托管直播平台"
  url: "https://live.yourdomain.com"
  tags:
    - "Technology"
    - "Gaming"

# 数据库与存储
database:
  filepath: "data/owncast.db"

docker restart owncast

# 获取直播状态（无需认证）
curl http://localhost:8080/api/status

# 示例返回：
# {
#   "online": true,
#   "viewerCount": 42,
#   "title": "今天聊聊开源技术",
#   "streamTitle": "Open Source Tech Talk"
# }

# 获取配置信息
curl http://localhost:8080/api/config

# 获取最近 50 条聊天消息
curl http://localhost:8080/api/chat

# 发送系统消息（需要管理员 Access Token）
curl -X POST http://localhost:8080/api/integrations/chat/system \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"body": "欢迎来到直播间！请遵守社区规范。"}'

# 配置 Webhook（使用管理员 Token）
curl -X POST http://localhost:8080/api/webhooks \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-webhook-server.com/owncast-events",
    "events": ["STREAM_STARTED", "STREAM_STOPPED", "CHAT", "FOLLOWER"]
  }'

# 支持的事件类型：
# - STREAM_STARTED：直播开始
# - STREAM_STOPPED：直播结束  
# - CHAT：新聊天消息
# - FOLLOWER：新关注者
# - VIEWER_COUNT_UPDATED：观众数更新

{
  "type": "STREAM_STARTED",
  "eventData": {
    "title": "开源项目分享",
    "streamUrl": "https://live.yourdomain.com",
    "timestamp": 1718880000
  }
}

# webhook_listener.py
from flask import Flask, request
import requests

app = Flask(__name__)

@app.route('/owncast-events', methods=['POST'])
def handle_event():
    event = request.json

    if event['type'] == 'STREAM_STARTED':
        title = event['eventData']['title']
        url = event['eventData']['streamUrl']

        # 调用 Twitter API 发推文（需配置开发者账号）
        # 此处省略具体 Twitter API 调用代码
        print(f"🔴 直播开始：{title} - {url}")

    return 'OK', 200

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

const express = require('express');
const { Client, GatewayIntentBits } = require('discord.js');

const app = express();
app.use(express.json());

const discordClient = new Client({
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages]
});

discordClient.login('YOUR_DISCORD_BOT_TOKEN');

app.post('/owncast-events', (req, res) => {
  const event = req.body;

  if (event.type === 'CHAT') {
    const channel = discordClient.channels.cache.get('DISCORD_CHANNEL_ID');
    if (channel) {
      channel.send(`[${event.eventData.user}]: ${event.eventData.body}`);
    }
  }

  res.sendStatus(200);
});

app.listen(5000, () => console.log('Webhook 监听中...'));

# /etc/sysctl.conf 添加以下配置
# 增大文件描述符限制
fs.file-max = 65535

# TCP 连接参数优化
net.ipv4.tcp_max_syn_backlog = 65536
net.core.somaxconn = 65535
net.core.rmem_max = 16777216
net.core.wmem_max = 16777216
net.ipv4.tcp_rmem = 4096 87380 16777216
net.ipv4.tcp_wmem = 4096 65536 16777216

# 应用配置
sysctl -p

# /etc/security/limits.conf 添加
* soft nofile 65535
* hard nofile 65535

# Nginx 配置 - 将 HLS 目录通过 CDN 回源
location /hls/ {
    proxy_pass http://127.0.0.1:8080/hls/;
    proxy_set_header Host $host;

    # 设置长缓存，大幅降低源站压力
    expires 30s;
    add_header Cache-Control "public, max-age=30";

    # 允许 CORS
    add_header Access-Control-Allow-Origin "*";
}

                        ┌─────────────┐
                        │   CDN 层     │
                        │ (Cloudflare) │
                        └──────┬──────┘
                               │ HTTPS
                        ┌──────▼──────┐
                        │  负载均衡器  │
                        │  (Nginx)    │
                        └──┬───────┬──┘
                           │       │
                    ┌──────▼─┐  ┌▼──────┐
                    │ OwnCast │  │OwnCast│
                    │ 节点 1  │  │ 节点2 │
                    └────┬───┘  └───┬───┘
                         │ RTMP推流  │
                         └─────┬─────┘
                               │
                        ┌──────▼──────┐
                        │  共享存储     │
                        │ (NFS/对象存储)│
                        └─────────────┘

# 1. 检查 OwnCast 容器是否运行
docker ps | grep owncast

# 2. 查看 OwnCast 日志中的错误信息
docker logs owncast --tail 100

# 3. 检查端口是否开放（1935 是 RTMP 端口）
netstat -tlnp | grep -E '1935|8080'

# 4. 防火墙检查（UFW 示例）
ufw status
# 开放端口
ufw allow 1935/tcp
ufw allow 8080/tcp

# 5. 云服务商安全组检查（阿里云/腾讯云/AWS 需在控制台配置）
# 确保 1935 和 8080 端口已放行入站规则

# 1. 检查服务器 CPU/内存/带宽使用率
top          # CPU 和内存
htop         # 交互式进程查看
iftop        # 实时带宽监控（需安装）
nload        # 网卡流量监控

# 2. 检查磁盘 IO（HLS 切片频繁写入）
iostat -x 1 5

# 3. 优化建议
# - 主播降低推流码率（如从 4000 Kbps 降到 2500 Kbps）
# - 减少画质档位（从 3 档减到 2 档降低 CPU 消耗）
# - 升级服务器配置（CPU 核心数、上行带宽）
# - 配置 CDN 加速视频分发

# 4. 检查 FFmpeg 进程是否正常
ps aux | grep ffmpeg

# 1. 浏览器控制台检查 WebSocket 连接错误（F12）
# 常见错误：
# - Mixed Content: HTTPS 页面连接 WS 协议 → 需改为 WSS
# - Connection refused: 防火墙或 Nginx 配置问题

# 2. Nginx 反向代理需确保正确配置 Upgrade 头
# location / {
#     proxy_set_header Upgrade $http_upgrade;
#     proxy_set_header Connection "upgrade";
# }

# 3. 检查 OwnCast 日志中的 WebSocket 错误
docker logs owncast | grep -i websocket

# 1. 定期备份数据目录（重要！）
tar -czf owncast-backup-$(date +%Y%m%d).tar.gz /opt/owncast/data

# 2. 自动备份脚本（放到 /etc/cron.daily/）
#!/bin/bash
BACKUP_DIR="/var/backups/owncast"
DATA_DIR="/opt/owncast/data"
mkdir -p $BACKUP_DIR
tar -czf $BACKUP_DIR/owncast-$(date +%Y%m%d).tar.gz $DATA_DIR
# 删除 7 天前的备份
find $BACKUP_DIR -name "*.tar.gz" -mtime +7 -delete

# 3. SQLite 数据库修复
sqlite3 /opt/owncast/data/owncast.db ".backup backup.db"
# 恢复数据（必要时）
sqlite3 /opt/owncast/data/owncast.db ".restore backup.db"

┌──────────────┐    直播流内容     ┌────────────────┐
│   OwnCast    │ ───────────────→ │   观众浏览器     │
│  (实时直播)   │                  └────────────────┘
└──────┬───────┘
       │ 录制的视频文件
       ▼
┌──────────────┐                 ┌────────────────┐
│    Immich    │ ──────────────→ │  个人相册/App   │
│  (照片视频管理)│                 └────────────────┘
└──────────────┘

┌──────────────┐                 ┌────────────────┐
│  Nextcloud   │ ──────────────→ │  团队协作/云盘  │
│  (文件存储共享)│                 └────────────────┘
└──────────────┘