chocobozzz/peertube

PeerTube 镜像文档

镜像概述和主要用途

PeerTube 是一个免费、去中心化且联邦式的视频平台，旨在作为 ***、Dailymotion、Vimeo 等中心化视频平台的替代方案。它基于联邦式架构，允许多个小型视频托管节点组成网络，用户可在其中关注创作者、上传视频，实现无供应商锁定的视频分享体验。该平台由社区所有，无广告干扰，适合个人创作者、社区组织及希望避免数据和注意力被中心化平台垄断的用户。

核心功能和特性

视频流媒体与直播

• 支持视频上传与流式播放，兼容多种设备
• 内置直播功能，支持临时直播活动及永久直播流
• 视频可添加描述、标签，实现跨实例发现

联邦式与去中心化架构

• 基于 ActivityPub 协议，与联邦宇宙（Fediverse）互通（如 ***、Pleroma 等）
• 无需在视频所在实例注册账号，即可通过联邦网络关注创作者
• 实例间可互相缓存视频，分担流量负载，提升小实例的内容分发能力

用户与管理员友好体验

• 可定制界面（如颜色主题），支持第三方客户端
• 无用户体验暗模式，不收集用户数据，无算法推荐干扰
• 创作者可添加支持按钮，链接至***账户等外部资源

社区驱动与开放源码

• 开源协议（GNU Affero General Public License v3.0），社区可贡献代码、翻译及文档
• 支持 RSS 订阅，兼容联邦宇宙内其他平台的内容交互

使用场景和适用范围

适用用户与组织

• 个人创作者：需要去中心化平台托管视频，避免广告分成和内容审核限制
• 社区组织：构建专属视频社区，分享内部内容或公开宣传
• 教育机构：托管教学视频，实现安全、可控的内容分发
• 去中心化技术爱好者：参与联邦式网络建设，支持开放互联网生态

典型应用场景

• 替代 *** 等平台，搭建个人或小型社区视频站点
• 组织线上直播活动（如会议、讲座），无需依赖中心化直播服务
• 构建跨机构的视频资源共享网络，实现资源互助与流量分担

详细使用方法和配置说明

前提条件

• 服务器推荐配置：2 CPU 核心、4GB RAM、至少20GB存储空间（根据视频存储需求调整）
• 已安装 Docker 和 Docker Compose
• 域名及 SSL 证书（推荐使用 Let's Encrypt）

Docker 部署示例

1. 使用 docker run 快速启动（测试环境）

bash
# 拉取官方镜像（具体标签参考 https://hub.docker.com/r/chocobozzz/peertube）
docker pull chocobozzz/peertube:latest

# 启动容器（测试用，生产环境需配置数据库、存储卷等）
docker run -d \
  --name peertube \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/peertube/data:/data \
  -e PEERTUBE_WEBSERVER_HOSTNAME=your-domain.com \
  -e PEERTUBE_DATABASE_USERNAME=peertube \
  -e PEERTUBE_DATABASE_PASSWORD=your-db-password \
  chocobozzz/peertube:latest

2. 生产环境 docker-compose 配置

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  peertube:
    image: chocobozzz/peertube:latest
    container_name: peertube
    restart: always
    ports:
      - "80:80"
      - "443:443"
      - "1935:1935" # RTMP 直播端口
    volumes:
      - ./data:/data
      - ./config:/config
      - ./certbot/conf:/etc/letsencrypt
      - ./certbot/www:/var/www/certbot
    environment:
      - PEERTUBE_WEBSERVER_HOSTNAME=your-domain.com
      - PEERTUBE_WEBSERVER_HTTPS=true
      - PEERTUBE_DATABASE_HOST=postgres
      - PEERTUBE_DATABASE_USERNAME=peertube
      - PEERTUBE_DATABASE_PASSWORD=secure-db-password
      - PEERTUBE_DATABASE_NAME=peertube
      - PEERTUBE_ADMIN_EMAIL=admin@your-domain.com
      - PEERTUBE_SMTP_HOST=smtp.your-email-provider.com
      - PEERTUBE_SMTP_PORT=587
      - PEERTUBE_SMTP_USERNAME=your-email@example.com
      - PEERTUBE_SMTP_PASSWORD=your-email-password
      - PEERTUBE_SMTP_FROM=noreply@your-domain.com
    depends_on:
      - postgres
      - redis

  postgres:
    image: postgres:14-alpine
    container_name: peertube-postgres
    restart: always
    volumes:
      - ./postgres:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=peertube
      - POSTGRES_PASSWORD=secure-db-password
      - POSTGRES_DB=peertube

  redis:
    image: redis:alpine
    container_name: peertube-redis
    restart: always
    volumes:
      - ./redis:/data

启动服务：

bash
docker-compose up -d

核心配置参数说明

数据持久化

需挂载以下目录以确保数据持久化：

• /data：存储视频文件、缩略图等用户数据
• /config：配置文件（如 production.yaml）
• 数据库和 Redis 数据卷（如示例中 postgres 和 redis 服务的挂载目录）

文档和资源

• 官方网站：joinpeertube.org
• GitHub 仓库：https://github.com/Chocobozzz/PeerTube
• Docker 部署文档：https://github.com/Chocobozzz/PeerTube/blob/develop/support/doc/docker.md
• 管理员文档：创建自己的实例
• API 文档：REST API 参考