Add complete French (fr) and Chinese (zh) translations for all documentation: - Root files: README, CHANGELOG, SECURITY, BETA-RELEASE - docs/: All 16 core documentation files - DOCS/: All 19 deep-dive documents including embedded/ and archive/ - package/secubox/: All 123+ package READMEs - Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/ Total: 346 translation files created Each file includes language switcher links for easy navigation between English, French, and Chinese versions. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
135 lines
3.3 KiB
Markdown
135 lines
3.3 KiB
Markdown
# SecuBox PeerTube
|
||
|
||
> **Languages:** [English](README.md) | [Francais](README.fr.md) | 中文
|
||
|
||
在 LXC Debian 容器中运行的联邦视频流媒体平台。
|
||
|
||
## 功能特性
|
||
|
||
- **PeerTube 实例**:支持 ActivityPub 联邦的自托管视频平台
|
||
- **视频导入**:通过 yt-dlp 从 YouTube、Vimeo 和 1000 多个网站导入视频
|
||
- **多轨字幕**:自动下载和同步多种语言的字幕
|
||
- **视频分析**:转录提取和 Claude AI 分析(peertube-analyse)
|
||
- **直播流媒体**:RTMP 输入和 HLS 输出
|
||
|
||
## 组件
|
||
|
||
| 组件 | 描述 |
|
||
|------|------|
|
||
| `peertubectl` | 容器管理的主控制脚本 |
|
||
| `peertube-import` | 带字幕同步的视频导入 |
|
||
| `peertube-analyse` | 转录提取和 AI 分析 |
|
||
|
||
## 视频导入
|
||
|
||
从外部平台导入视频,自动同步字幕。
|
||
|
||
### CLI 使用方法
|
||
|
||
```bash
|
||
# 基本导入
|
||
peertube-import https://youtube.com/watch?v=xxx
|
||
|
||
# 导入多种字幕语言
|
||
peertube-import --lang fr,en,de,es https://youtube.com/watch?v=xxx
|
||
|
||
# 导入为未列出的视频
|
||
peertube-import --privacy 2 https://youtube.com/watch?v=xxx
|
||
|
||
# 导入到指定频道
|
||
peertube-import --channel 2 https://vimeo.com/xxx
|
||
```
|
||
|
||
### 选项
|
||
|
||
| 选项 | 描述 | 默认值 |
|
||
|------|------|--------|
|
||
| `--lang <codes>` | 字幕语言(逗号分隔) | `fr,en` |
|
||
| `--channel <id>` | PeerTube 频道 ID | `1` |
|
||
| `--privacy <level>` | 1=公开,2=未列出,3=私密 | `1` |
|
||
| `--output <dir>` | 下载临时目录 | `/tmp/peertube-import` |
|
||
| `--peertube <url>` | PeerTube 实例 URL | 从 UCI 配置读取 |
|
||
|
||
### 门户集成
|
||
|
||
通过 SecuBox 门户 -> 智能与分析 -> 视频导入 访问
|
||
|
||
门户提供:
|
||
- 视频源 URL 输入框
|
||
- 语言选择复选框
|
||
- 隐私级别选择器
|
||
- 实时进度跟踪
|
||
- 导入视频的直接链接
|
||
|
||
### CGI 端点
|
||
|
||
```bash
|
||
# 启动导入任务
|
||
curl -X POST http://192.168.255.1/cgi-bin/peertube-import \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"url":"https://youtube.com/watch?v=xxx","languages":"fr,en"}'
|
||
|
||
# 响应:{"success": true, "job_id": "import_xxx"}
|
||
|
||
# 检查状态
|
||
curl "http://192.168.255.1/cgi-bin/peertube-import-status?job_id=import_xxx"
|
||
|
||
# 响应(进行中):
|
||
# {"status": "downloading", "progress": 45, "job_id": "import_xxx"}
|
||
|
||
# 响应(已完成):
|
||
# {"success": true, "video_url": "https://tube.example.com/w/uuid"}
|
||
```
|
||
|
||
## 配置
|
||
|
||
UCI 配置文件:`/etc/config/peertube`
|
||
|
||
```
|
||
config peertube 'main'
|
||
option enabled '1'
|
||
option data_path '/srv/peertube'
|
||
|
||
config peertube 'server'
|
||
option hostname 'tube.example.com'
|
||
option port '9001'
|
||
option https '1'
|
||
|
||
config peertube 'admin'
|
||
option username 'root'
|
||
option password 'changeme'
|
||
|
||
config peertube 'transcoding'
|
||
option enabled '1'
|
||
option threads '2'
|
||
list resolutions '480p'
|
||
list resolutions '720p'
|
||
```
|
||
|
||
## 依赖
|
||
|
||
- `lxc`, `lxc-common` - 容器运行时
|
||
- `wget-ssl` - HTTPS 下载
|
||
- `tar`, `jsonfilter` - 归档和 JSON 处理
|
||
- `yt-dlp` - 视频下载(pip install)
|
||
- `node` - yt-dlp 的 JavaScript 运行时(opkg install)
|
||
|
||
## 支持的导入源
|
||
|
||
yt-dlp 支持 1000 多个网站,包括:
|
||
- YouTube、YouTube Music
|
||
- Vimeo
|
||
- Dailymotion
|
||
- Twitch(VODs)
|
||
- Twitter/X
|
||
- TikTok
|
||
- 以及更多...
|
||
|
||
详见:https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md
|
||
|
||
## 版本
|
||
|
||
- 包版本:1.2.0
|
||
- yt-dlp:2026.2.4(推荐)
|
||
- Node.js:20.20.0(用于 YouTube JS 运行时)
|