Cherry私有视频库管理系统|Docker快速部署|NAS内网穿透远程访问影视库
作者
小编
发布时间

Cherry私有视频库管理系统,基于TypeScript和Svelte开发的现代化视频管理解决方案。支持用户认证、视频上传、媒体库管理,采用前后端分离架构,Docker容器化部署,开箱即用。打造个人影视收藏库或家庭媒体中心的完美选择。
Cherry - 私有视频库管理系统
项目介绍
Cherry 是一款功能强大的私有视频库管理系统,采用现代化技术栈构建,基于 TypeScript 和 Svelte 开发。它为用户提供了一个完整的视频内容管理解决方案,支持用户认证、视频上传、媒体库管理等核心功能。无论你是想要建立个人影视收藏库,还是为家庭成员打造共享媒体中心,Cherry 都能完美胜任。
项目采用现代化的前后端分离架构,支持 Docker 容器化部署,让你可以轻松在任何地方搭建属于自己的视频管理平台。内置数据库支持,开箱即用,无需复杂配置。
项目地址:点我跳转
部署安装
如果你想在外网也能访问这个项目,建议配置内网穿透服务。推荐使用 帕斯内网穿透,先注册账号备用。具体的操作流程可以 点我查看 内网穿透全平台快速上手指南。
使用 Docker 快速部署
打开你的 NAS 设备或其他支持 Docker 的系统,进入本地镜像管理界面。
点击 添加镜像 - 从 URL 添加,输入以下镜像地址:
1ghcr.io/haishanh/cherry:latest
等待镜像下载完成后,点击启动按钮启动容器。
端口映射设置
在容器配置界面,找到端口映射设置。Cherry 默认运行在容器内的 8000 端口,你可以将其映射到宿主机的任意端口(如 8000、3000 等)。如果遇到端口占用的情况,只需修改宿主机端口号即可,容器内部端口保持 8000 不变。
存储配置
Cherry 需要一个持久化存储目录来保存数据库和配置文件。建议在 NAS 上创建一个文件夹(例如 `/mnt/cherry-data`),然后将其映射到容器内的 `/data` 目录。这样即使容器重启,你的所有数据都会被完整保留。
环境变量配置
Cherry 支持以下环境变量配置:
必须设置:
PUID:运行用户的 UID(默认值:1001)
PGID:运行用户的 GID(默认值:1001)
PORT:应用运行端口(默认值:5173)
可选设置:
BODY_SIZE_LIMIT:请求体大小限制,用于上传文件(默认值:52428800,约 50MB)
NODE_ENV:运行环境(默认值:production)
其他配置保持默认即可,无需额外修改。点击启动完成部署。
访问应用
容器启动成功后,在浏览器中访问 `http://你的NAS地址:8000` 即可打开 Cherry 应用。首次访问时,你可能需要创建管理员账户来初始化系统。
本篇教程到此结束,祝你使用愉快!
相关教程

Piwigo是功能强大的开源照片库管理系统,支持批量上传、相册组织、标签管理、用户权限控制等丰富功能。完全开源免费,可自行部署在服务器上,享受完全的数据控制权。适合摄影爱好者、组织和个人使用。

DouyinLiveRecorder是功能强大的多平台直播录制工具,支持抖音、TikTok、快手、B站、虎牙等50+平台自动录制。独有循环值守功能,主播上线即自动录制,让你轻松备份喜爱主播精彩内容。支持Docker一键部署到NAS,配置简单,永久自动化运行。

SPlayer是功能丰富的现代化音乐播放器,采用Vue3+TypeScript+Electron打造,支持网页端和客户端双端部署。集成网易云音乐API,支持账号登录、歌曲下载、云盘管理、本地音乐库、逐字歌词、MV播放等丰富功能。界面简洁优雅,支持Light/Dark/Auto多种主题模式,提供一站式音乐播放体验。

Call-Me是基于WebRTC的浏览器视频通话应用,支持一对一高清实时通话。无需复杂配置,用户名登录即可快速发起视频通话。提供摄像头切换、实时文字聊天、屏幕共享等功能,支持Docker一键部署,完整REST API便于集成。