PeerTube视频存储路径自定义配置指南

背景介绍

PeerTube作为一款去中心化视频平台，允许管理员自定义视频文件的存储路径。很多管理员出于磁盘空间管理或性能优化的考虑，会将视频文件存储到非默认位置。本文详细介绍如何正确配置PeerTube的视频存储路径，特别是当使用自定义路径时需要注意的Nginx相关设置。

存储路径配置

PeerTube的配置文件(通常位于config/production.yaml)中提供了丰富的存储路径配置选项。管理员可以自定义以下关键路径：

• web_videos: 存放转码后的视频文件
• streaming_playlists: 流媒体播放列表
• original_video_files: 原始视频文件
• redundancy: 冗余存储文件
• torrents: 种子文件

当这些路径被修改为非默认值时，必须相应调整Nginx配置以确保视频文件可被正常访问。

Nginx配置要点

PeerTube默认的Nginx配置假设视频文件存储在特定位置。当使用自定义路径时，需要特别注意以下配置块：

location /static/webseed/ {
    alias /var/www/peertube/storage/web-videos/;
}

这个配置块需要根据实际情况进行以下两种调整之一：

1. 完全移除：如果使用完全自定义的路径结构
2. 修改alias指令：指向新的视频存储路径
3. 添加root指令：替代alias来指定基础路径

最佳实践建议

1. 权限设置：确保Nginx工作进程(通常是www-data用户)对自定义路径有读取权限
2. 符号链接：对于简单迁移，可以考虑使用符号链接而非直接修改配置
3. 测试验证：修改后务必测试视频播放功能
4. 路径一致性：保持配置文件中的路径与实际文件系统路径完全一致
5. SELinux/AppArmor：如果系统启用了安全模块，记得更新相关策略

故障排查

如果配置后视频无法播放，可以检查：

1. Nginx错误日志中的权限问题
2. 文件路径是否正确映射
3. 配置文件修改后是否重启了Nginx服务
4. 存储目录及其内容的所有权和权限设置

通过正确配置这些参数，管理员可以灵活地将PeerTube视频文件存储在任意位置，同时确保平台的正常运作。