PeerTube生产环境部署与维护完全指南

前言

PeerTube是一个基于ActivityPub协议的去中心化视频平台，采用Node.js开发。本文将详细介绍PeerTube在生产环境中的部署流程、配置优化以及后续升级维护方法，帮助系统管理员和技术人员快速搭建稳定运行的视频平台。

硬件要求

在开始部署前，请确保您的服务器满足以下基本要求：

• 不建议在低带宽连接(如家庭ADSL)上部署生产环境
• 建议使用专用服务器而非共享主机
• 根据预期用户规模选择合适的CPU和内存配置
• 准备充足的存储空间用于视频文件存储

部署流程

1. 系统依赖安装

PeerTube运行需要以下基础依赖：

• Node.js (建议使用LTS版本)
• PostgreSQL数据库(10+版本)
• Redis缓存服务
• FFmpeg视频处理工具
• Python构建工具

2. 创建专用用户

为安全考虑，应为PeerTube创建专用系统用户：

sudo useradd -m -d /var/www/peertube -s /usr/sbin/nologin -p peertube peertube

3. 数据库配置

创建PostgreSQL数据库及用户：

sudo -u postgres createuser -P peertube  # 设置数据库密码
sudo -u postgres createdb -O peertube -E UTF8 -T template0 peertube_prod

安装必要扩展：

sudo -u postgres psql -c "CREATE EXTENSION pg_trgm;" peertube_prod
sudo -u postgres psql -c "CREATE EXTENSION unaccent;" peertube_prod

4. PeerTube安装

获取最新版本并安装：

VERSION=$(获取最新版本命令)
cd /var/www/peertube
sudo -u peertube mkdir -p versions
cd versions
sudo -u peertube wget "下载链接"
sudo -u peertube unzip peertube-${VERSION}.zip

安装Node依赖：

cd /var/www/peertube/peertube-latest
sudo -H -u peertube npm run install-node-dependencies -- --production

5. 配置文件设置

PeerTube使用两层配置：

• default.yaml: 默认配置(不应修改)
• production.yaml: 生产环境配置(覆盖默认值)

必须正确配置以下关键项：

• 网站域名和HTTPS设置
• 数据库连接信息
• SMTP邮件服务配置
• 管理员邮箱
• 安全密钥(PeerTube 5.0+)

6. Nginx配置

PeerTube提供Nginx配置模板，需要：

1. 复制模板到Nginx配置目录
2. 替换域名占位符
3. 调整路径指向PeerTube安装位置
4. 配置SSL证书(推荐使用Let's Encrypt)

7. 系统优化

TCP/IP参数调优

sudo cp /var/www/peertube/peertube-latest/support/sysctl.d/30-peertube-tcp.conf /etc/sysctl.d/
sudo sysctl -p /etc/sysctl.d/30-peertube-tcp.conf

文件描述符限制

增加系统文件描述符限制以支持更多并发连接

8. 服务管理

systemd配置

sudo cp /var/www/peertube/peertube-latest/support/systemd/peertube.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now peertube

管理员设置

初始管理员账户为root，密码会生成在日志中。可通过以下命令重置：

cd /var/www/peertube/peertube-latest && \
NODE_CONFIG_DIR=/var/www/peertube/config \
NODE_ENV=production \
npm run reset-password -- -u root

升级维护

升级步骤

1. 检查更新日志中的重大变更说明
2. 备份数据库
3. 运行升级脚本：

cd /var/www/peertube/peertube-latest/scripts
sudo -H -u peertube ./upgrade.sh

配置更新

每次升级后应检查：

• 默认配置变更
• Nginx配置变更
• systemd服务文件变更

故障恢复

如升级失败，可回退到旧版本：

OLD_VERSION="v0.42.42" 
cd /var/www/peertube
sudo -u peertube unlink ./peertube-latest
sudo -u peertube ln -s "versions/peertube-$OLD_VERSION" peertube-latest
sudo -u postgres pg_restore -c -C -d peertube_prod "备份文件路径"
sudo systemctl restart peertube

最佳实践

1. 定期监控服务器资源使用情况
2. 设置自动化备份策略(数据库+存储目录)
3. 根据用户增长适时扩展服务器配置
4. 关注PeerTube社区的安全公告
5. 考虑使用CDN分发视频内容减轻服务器负载

通过以上步骤，您可以成功部署并维护一个稳定运行的PeerTube实例，为用户提供去中心化的视频分享服务。