shaneisrael/fireshare

自托管视频分享Docker镜像

镜像概述

本Docker镜像提供了一个轻量级、易部署的自托管视频分享解决方案，旨在帮助用户快速搭建个人或小型团队的视频分享平台。通过容器化设计，简化了传统视频分享系统的部署流程，用户无需深入掌握服务器配置即可实现视频的上传、存储、管理和分享功能，数据存储在本地环境，保障隐私与数据控制权。

核心功能和特性

• 快速部署：基于Docker容器化部署，通过简单命令或配置文件即可启动服务，无需复杂环境依赖
• Web界面管理：提供直观的Web管理界面，支持视频上传、预览、删除及分享链接生成
• 本地数据存储：视频文件存储在用户本地磁盘，避免第三方平台的数据隐私风险
• 轻量级架构：优化资源占用，可在低配置服务器、NAS设备或个人电脑上稳定运行
• 多格式兼容：支持常见视频格式（MP4、AVI、MKV、WebM等）的上传与播放
• 分享权限控制：支持生成公开分享链接或密码保护链接，灵活控制视频访问范围

使用场景和适用范围

• 个人视频分享：搭建个人视频博客、作品集展示平台，分享创作内容
• 小型团队协作：团队内部共享培训视频、会议记录、项目演示等工作资料
• 家庭媒体库：构建家庭内部视频库，集中管理和分享家庭影像资料
• 教育场景应用：培训机构、学校内部共享教学视频资源，支持学生自主学习
• 兴趣社区：小众兴趣群体内部共享主题相关视频内容，如摄影、手工、技术教程等

使用方法

Docker Run 快速启动

通过以下命令快速部署容器（替换[镜像名称]为实际镜像名称，如未指定需联系镜像提供方获取）：

bash
docker run -d \
  --name video-sharing \
  -p 8080:80 \
  -v /path/to/local/data:/app/data \
  -e ADMIN_USER=admin \
  -e ADMIN_PASSWORD=your_secure_password \
  [镜像名称]

参数说明：

• -p 8080:80：将容器内80端口映射到主机8080端口（可根据需求修改主机端口）
• -v /path/to/local/data:/app/data：挂载本地目录（需替换为实际路径）到容器内数据目录，实现视频文件持久化存储
• -e ADMIN_USER：设置管理员登录用户名（默认值：admin）
• -e ADMIN_PASSWORD：设置管理员登录密码（建议使用强密码，必填项）

Docker Compose 配置

创建docker-compose.yml文件，通过配置文件管理服务（推荐生产环境使用）：

yaml
version: '3.8'

services:
  video-sharing:
    image: [镜像名称]
    container_name: video-sharing
    restart: unless-stopped
    ports:
      - "8080:80"  # 主机端口:容器端口，可修改主机端口避免冲突
    volumes:
      - ./video-data:/app/data  # 本地视频存储目录（相对/绝对路径均可）
      - ./config:/app/config    # 配置文件持久化（可选，保存系统设置）
    environment:
      - ADMIN_USER=admin        # 管理员用户名
      - ADMIN_PASSWORD=P@ssw0rd # 管理员密码（请替换为安全密码）
      - TZ=Asia/Shanghai        # 时区设置（可选，默认UTC）
      - MAX_UPLOAD_SIZE=500     # 最大单视频上传大小（MB，可选，默认500）

启动服务：

bash
docker-compose up -d

环境变量说明

数据持久化

为避免容器重启或删除导致视频数据丢失，必须通过-v参数挂载本地目录到容器内数据目录（默认/app/data）。建议使用独立的本地目录（如/opt/video-sharing/data）作为挂载点，并确保该目录有足够的磁盘空间存储视频文件。

访问与使用

1. 服务启动后，通过浏览器访问 http://<主机IP>:<映射端口>（如http://localhost:8080）
2. 使用配置的管理员用户名（ADMIN_USER）和密码（ADMIN_PASSWORD）登录系统
3. 通过Web界面上传视频文件，系统自动处理并生成分享链接
4. 通过"分享"功能生成链接，根据需求选择公开分享或密码保护

常见问题

如何更新镜像？

1. 停止并删除当前容器（数据卷挂载确保数据不丢失）：

   bash
   docker stop video-sharing && docker rm video-sharing
   

2. 拉取最新镜像：

   bash
   docker pull [镜像名称]
   

3. 使用原启动命令或Docker Compose配置重新启动容器

视频无法播放怎么办？

• 确认视频格式是否为支持的类型（优先推荐MP4格式以获得最佳兼容性）
• 检查视频文件大小是否超过MAX_UPLOAD_SIZE限制
• 尝试刷新页面或清除浏览器缓存后重新访问

如何修改默认端口？

通过-p参数修改主机端口映射（如-p 9000:80将主机9000端口映射到容器80端口），或修改PORT环境变量自定义容器内端口（需同步调整端口映射参数）。