crypt010/vitransfer

ViTransfer

面向电影制作人的专业视频审核与审批平台

ViTransfer是一款自托管Web应用，专为视频专业人士设计，用于与客户共享作品、收集反馈和管理审批工作流。采用现代技术构建，便于自托管部署。

注：使用Claude AI编写，旨在实现安全性和最佳实践。

![]([]

⚠️ 开发状态： ViTransfer目前处于积极开发阶段（v0.1.0）。虽然已完全可用且在生产环境中使用，但我们正在努力实现稳定的v1.0版本。功能和API可能会有变化。欢迎贡献和反馈！

💖 支持开发： 如果您觉得ViTransfer有用，考虑在***上支持我们，以帮助资助持续开发！

✨ 特性

核心功能

• 📹 视频上传与处理 - 自动转码为多种分辨率（720p/1080p）
• 💧 水印功能 - 可自定义预览视频水印
• 💬 时间戳评论 - 收集带有精确视频时间戳的反馈
• ✅ 审批工作流 - 带修订跟踪的客户审批系统
• 🔒 密码保护 - 使用客户密码保护项目
• 📧 电子邮件通知 - 新视频和回复的自动通知
• 🎨 深色模式 - 美观的深色/浅色主题支持
• 📱 完全响应式 - 在所有设备上完美运行

管理功能

• 👥 多用户支持 - 创建多个管理员账户
• 📊 分析仪表板 - 跟踪页面访问、下载和参与度
• 🔐 安全日志 - 监控访问尝试和可疑活动
• 🎯 版本管理 - 隐藏/显示特定视频版本
• 🔄 修订跟踪 - 限制和跟踪项目修订
• ⚙️ 灵活设置 - 每个项目和全局配置选项

技术功能

• 🐳 Docker优先 - 使用Docker Compose轻松部署
• 🚀 高性能 - 基于Next.js 16和React 19构建
• 📦 Redis队列 - 使用BullMQ进行后台视频处理
• 🎬 FFmpeg处理 - 行业标准视频转码
• 🗄️ PostgreSQL数据库 - 使用Prisma 6的可靠数据存储
• 🔐 JWT认证 - 安全会话管理
• 🌐 TUS协议 - 大文件的可恢复上传

---

📸 截图

登录页面

管理员仪表板

项目创建

项目设置

客户共享页面

---

🚀 快速开始

前提条件

• 已安装Docker和Docker Compose
• 至少4GB RAM
• 20GB+可用磁盘空间（视频存储需要更多）

安装方法1：Docker Hub（推荐 - 3分钟）

拉取预构建镜像并立即运行：

1. 下载配置文件

bash
# 创建目录
mkdir vitransfer && cd vitransfer

# 下载docker-compose.yml和.env.example
curl -O https://raw.githubusercontent.com/MansiVisuals/ViTransfer/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/MansiVisuals/ViTransfer/main/.env.example

2. 创建并配置环境文件

bash
# 复制并编辑文件
cp .env.example .env
nano .env

生成5个唯一的安全值：

bash
# 生成以下5个值（每个必须不同）：
openssl rand -hex 32      # 1. 用于POSTGRES_PASSWORD
openssl rand -hex 32      # 2. 用于REDIS_PASSWORD
openssl rand -base64 32   # 3. 用于ENCRYPTION_KEY
openssl rand -base64 64   # 4. 用于JWT_SECRET
openssl rand -base64 64   # 5. 用于JWT_REFRESH_SECRET

替换.env中的每个占位符：

• POSTGRES_PASSWORD=<<REPLACE_WITH_openssl_rand_hex_32>>
• REDIS_PASSWORD=<<REPLACE_WITH_openssl_rand_hex_32>>
• ENCRYPTION_KEY=<<REPLACE_WITH_openssl_rand_base64_32>>
• JWT_SECRET=<<REPLACE_WITH_openssl_rand_base64_64>>
• JWT_REFRESH_SECRET=<<REPLACE_WITH_openssl_rand_base64_64>>

默认管理员凭据（生产环境中请更改）：

• ADMIN_EMAIL=admin@example.com
• ADMIN_PASSWORD=Admin1234

3. 启动应用程序

bash
docker-compose up -d

4. 访问ViTransfer

• 打开http://localhost:4321（或您配置的端口）
• 使用管理员凭据登录
• 在管理员设置中完成设置

完成！🎉

---

安装方法2：从源代码构建（高级）

适用于希望从源代码构建的开发人员或贡献者：

1. 克隆仓库

bash
git clone https://github.com/MansiVisuals/ViTransfer.git
cd ViTransfer

2. 按照方法1中的步骤2-4操作

3. 构建并启动

bash
docker-compose up -d --build

源代码将在本地构建为Docker镜像，而不是从Docker Hub拉取。

---

🌐 平台支持

ViTransfer使用标准Docker Compose，应在大多数平台上运行。

计划的平台指南：

• Unraid（Docker Compose管理器）
• TrueNAS SCALE
• Synology NAS

欢迎社区贡献！ 如果您已在特定平台上成功部署，考虑贡献安装指南。

---

🔧 配置

环境变量

SMTP配置（可选）

在管理员面板中配置电子邮件通知：

• 设置 > 电子邮件配置
• 添加SMTP服务器详细信息
• 保存前测试连接
• 支持Gmail、Outlook、自定义SMTP服务器

反向代理设置

已使用Cloudflare Tunnels测试。

---

📖 使用指南

创建您的第一个项目

1. 登录管理员面板
2. 创建项目，包含：
   • 项目标题和描述
   • 客户姓名和电子邮件
   • 密码保护（推荐）
3. 上传视频到项目
4. 共享链接给您的客户
5. 收集反馈通过时间戳评论
6. 批准客户接受最终版本时

客户工作流

1. 收到电影制作人的共享链接
2. 输入密码（如果受保护）
3. 观看视频并留下带时间戳的反馈
4. 满意时提交批准
5. 下载已批准的视频（如果启用）

管理员提示

• 使用自定义URL获取易记的共享链接
• 为复杂项目启用修订跟踪
• 全局或按项目配置水印
• 监控分析以查看客户参与度
• 使用安全日志跟踪访问尝试

---

🔒 安全特性

• 🔐 密码保护项目 - 可选客户密码
• 🔑 JWT认证 - 安全管理员会话
• 🛡️ 速率限制 - 防止暴力***
• 📝 安全日志 - 跟踪所有访问尝试
• 🚫 盗链保护 - 防止未授权嵌入
• 🔒 加密密码 - 静态数据AES-256加密
• 🌐 HTTPS支持 - SSL/TLS安全连接
• ⏱️ 会话监控 - 15分钟不活动超时并发出警告

安全通知

ViTransfer使用Alpine Linux和FFmpeg，漏洞扫描器可能会显示CVE。这些是间接依赖项，风险极小。详见SECURITY.md获取详细CVE分析和风险评估。所有软件包均保持最新可用版本。

---

🛠️ 维护

备份

需要备份的重要数据：

bash
# Docker卷
docker-compose down
tar -czf vitransfer-backup.tar.gz \
  /var/lib/docker/volumes/vitransfer_postgres-data \
  /var/lib/docker/volumes/vitransfer_uploads

# 如果使用绑定挂载，则使用主机路径

更新

bash
# 从Docker Hub拉取最新镜像
docker-compose pull

# 或拉取特定版本
docker pull crypt010/vitransfer:0.1.0

# 使用新镜像重启
docker-compose up -d

# 数据库迁移会自动运行

日志

bash
# 查看应用程序日志
docker-compose logs app

# 查看工作器日志
docker-compose logs worker

# 实时跟踪日志
docker-compose logs -f

数据库管理

bash
# 访问PostgreSQL
docker exec -it vitransfer-postgres psql -U vitransfer -d vitransfer

# 备份数据库
docker exec vitransfer-postgres pg_dump -U vitransfer vitransfer > backup.sql

# 恢复数据库
docker exec -i vitransfer-postgres psql -U vitransfer vitransfer < backup.sql

---

🐛 故障排除

容器无法启动

bash
# 检查日志
docker-compose logs app

# 验证环境变量
docker-compose config

# 重启所有服务
docker-compose restart

视频未处理

bash
# 检查工作器日志
docker-compose logs worker

# 验证FFmpeg是否安装
docker exec vitransfer-worker ffmpeg -version

# 检查磁盘空间
df -h

无法登录

• 验证.env中的ADMIN_EMAIL和ADMIN_PASSWORD
• 检查数据库连接：docker-compose logs postgres
• 必要时在数据库中重置密码

上传失败

• 检查反向代理中的client_max_body_size
• 验证可用磁盘空间
• 检查卷上的上传权限

---

🤝 贡献

我们欢迎贡献！ViTransfer正在积极开发中，我们需要帮助以达到v1.0版本。

如何贡献

1. ** Fork仓库** - https://github.com/MansiVisuals/ViTransfer
2. 创建功能分支 - git checkout -b feature/amazing-feature
3. 进行更改 - 遵循现有代码风格
4. 彻底测试 - 确保一切正常工作
5. 提交拉取请求 - 我们将尽快审核

需要帮助的领域

• 🐛 错误修复 - 报告或修复问题
• 📖 文档 - 改进指南和示例
• 🌍 翻译 - 帮助ViTransfer支持多语言
• ✨ 功能 - 提出并实现新功能
• 🧪 测试 - 帮助在不同平台上测试

详见CONTRIBUTING.md获取详细指南。

---

📄 许可证

本项目采用GNU Affero通用公共许可证第3版（AGPL-3.0许可证） 授权。

这意味着：

• ✅ 您可以免费使用ViTransfer
• ✅ 您可以修改源代码
• ✅ 您可以分发修改版本
• ⚠️ 任何衍生作品必须以AGPL-3.0许可证开源
• ⚠️ 您必须包含原始许可证和版权声明

详见LICENSE文件获取完整条款。

为什么选择AGPL-3.0许可证？ 我们相信让所有创作者都能使用视频工具，同时防止商业剥削。如果您使用或修改ViTransfer，您的版本必须保持免费和开源。

---

💬 支持

• 🐛 问题： https://github.com/MansiVisuals/ViTransfer/issues
• 📖 文档： 本README和内联代码注释
• 💬 讨论： https://github.com/MansiVisuals/ViTransfer/discussions
• 🐳 Docker Hub： https://hub.docker.com/r/crypt010/vitransfer

---

💖 支持开发

如果ViTransfer对您的工作有帮助，考虑支持其开发：

您的支持有助于资助：

• 🚀 新功能和改进
• 🐛 错误修复和维护
• 📖 更好的文档
• 🎯 更快地开发v1.0版本

---

🙏 致谢

基于以下技术构建：

• Next.js - React框架
• Prisma - 数据库ORM
• BullMQ - 任务队列
• FFmpeg - 视频处理
• PostgreSQL - 数据库
• Redis - 队列和缓存
• Tailwind CSS - 样式

---

用❤️为电影制作人和视频专业人士打造===SHORT_DESC=== ViTransfer是一款现代化自托管视频反馈与共享平台，专为视频专业人士设计，用于与客户共享作品、收集时间戳反馈及管理审批工作流。

===FULL_DESC===# ViTransfer

专业视频审核与审批平台，面向电影制作人

ViTransfer是一款自托管Web应用，专为视频专业人士设计，用于与客户共享工作成果、收集反馈和管理审批工作流。采用现代技术构建，便于自托管部署。

*注：使用Claude AI编写，旨在实现安全性和最佳