当前位置：

社区首页

电脑数码

存储设备

网络存储

文章详情

数字时代的记忆保管库：在Docker上启动你的Shoebox项目

一、Shoebox介绍

1.1 Shoebox简介

Shoebox 是一个数字记忆管理工具，灵感来源于人们过去用鞋盒保存珍贵回忆的方式，帮助用户以结构化和安全的方式组织、存储视频，避免在云平台中遗失。

1.2 主要特点

视频组织： 提供高效方式对视频进行分类与管理，便于日后查找与使用。
视频导出： 支持将原始视频导出至指定路径，方便后续编辑与备份。
记忆保存： 以时间线或主题形式结构化存储视频片段，便于回顾与创意再利用。
用户友好界面： 简洁直观的交互设计，提升用户的操作体验。
高效媒体处理： 基于 FFmpeg 实现快速且稳定的视频转码与处理功能。
现代技术栈支持： 后端采用 Rust + Axum，前端基于 React + TypeScript，支持 SQLite/PostgreSQL 数据库，并具备 Docker/Kubernetes 部署能力。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为Ubuntu 22.04.1。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎； 2.在Docker环境下部署Shoebox数字记忆保存箱。

2.3 注意事项

⚠️ 注意事项

项目仍处于活跃开发阶段：Shoebox 目前仍在积极开发中，尚未达到生产环境的稳定性与安全性要求，功能和数据模型可能会发生变更。
可能存在影响数据的风险：在使用过程中有可能出现导致媒体文件损坏或数据丢失的问题，请务必定期备份您的原始视频和关键数据。
自行承担使用风险：建议仅在测试或个人环境中部署使用，不推荐用于重要生产场景或商业用途，除非你已充分了解并接受潜在风险。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven01:~# systemctl status docker ● docker.service - Docker Application Container Engine Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled) Active: active (running) since Wed 2025-06-11 12:57:12 UTC; 1 week 0 days ago TriggeredBy: ● docker.socket Main PID: 848 (dockerd) Tasks: 83 Memory: 3.2G CPU: 29min 49.224s CGroup: /system.slice/docker.service ├─ 848 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

3.2 检查Docker版本

检查Docker版本

root@jeven01:~# docker -v Docker version 27.1.1, build 6312585

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven01:~# docker compose version Docker Compose version v2.19.1

四、拉取Shoebox镜像

拉取Shoebox镜像，原镜像为ghcr.io/slackspace-io/shoebox:sha-9f05da53931ad6fa4f5b7f1d9b447ca65dec3e8b，如果拉取缓慢或失败，可尝试拉取swr.cn-north-4.myhuaweicloud.com/jeven/shoebox:latest镜像。

root@jeven01:~# docker pull swr.cn-north-4.myhuaweicloud.com/jeven/shoebox:latest latest: Pulling from jeven/shoebox Digest: sha256:29b82b098906c818c49dc2da6005656297e4e121e25e201148eaea40164d738d Status: Image is up to date for swr.cn-north-4.myhuaweicloud.com/jeven/shoebox:latest swr.cn-north-4.myhuaweicloud.com/jeven/shoebox:latest

五、部署Shoebox容器

5.1 创建部署目录

mkdir -p /data/shoebox && cd /data/shoebox

5.2 编辑部署文件

在`部署目录下，创建docker-compose.yaml文件，如下所示：

vim docker-compose.yaml

version: '3' services: app: image: swr.cn-north-4.myhuaweicloud.com/jeven/shoebox:latest container_name: shoebox restart: always ports: - "7200:3000" volumes: # Mount media source directories (read-only) - ./videos:/mnt/videos:ro # Mount export directory (read-write) - ./exports:/app/exports # Mount data directory for persistence - ./data:/app/data # Mount thumbnails directory for persistence - ./thumbnails:/app/thumbnails environment: - SERVER_HOST=0.0.0.0 - SERVER_PORT=3000 - DATABASE_URL=sqlite:/app/data/videos.db - MEDIA_SOURCE_PATHS=/mnt/videos - THUMBNAIL_PATH=/app/thumbnails - EXPORT_BASE_PATH=/app/exports - RUST_LOG=info

🛠️ 环境变量说明

📁 目录映射建议（对应 volumes 配置）

5.3 创建Shoebox容器

执行以下命令，创建Shoebox容器。

docker compose up -d

5.4 查看Shoebox容器状态

检查Shoebox容器运行状态，确保Shoebox容器正常启动。

root@jeven01:/data/tillywork# docker compose ps NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS tillywork-db-1 postgres:16.3-bullseye "docker-entrypoint.s…" db 2 minutes ago Up 2 minutes 5432/tcp tillywork-redis-1 redis:7.2.5-alpine "docker-entrypoint.s…" redis 2 minutes ago Up 2 minutes 6379/tcp tillywork-tillywork-1 tillywork/tillywork:latest "/docker-entrypoint.…" tillywork 2 minutes ago Up 2 minutes 0.0.0.0:8110->80/tcp, :::8110->80/tcp, 0.0.0.0:3600->3000/tcp, :::3600->3000/tcp

六、访问Shoebox服务

浏览器地址： http://<个人的服务器IP>:7200，访问Shoebox的初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

七、Shoebox基本使用

7.1 上传文件

在宿主机/data/shoebox/videos挂载目录下，上传视频文件。

root@jeven01:/data/shoebox/videos# pwd /data/shoebox/videos root@jeven01:/data/shoebox/videos# ll total 3336 drwxr-xr-x 2 root root 4096 Jun 18 15:00 ./ drwxr-xr-x 6 root root 4096 Jun 18 14:52 ../ -rw-r--r-- 1 root root 3406789 Jun 18 15:00 test.mp4

7.2 扫描视频目录

点击点“Scan Directories ”扫描视频目录，如下所示：

可以看到已经扫描出视频文件，并且显示视频的缩略图。

八、总结

通过 Docker 部署 Shoebox，可以快速搭建一个高效、稳定的数字记忆管理平台，充分利用其现代化技术栈和强大功能来整理和保存珍贵视频资料。合理的环境变量配置与目录挂载策略确保了数据的持久化与安全性，同时便于后续维护和扩展。此次部署实战验证了 Shoebox 在容器化环境中的良好兼容性与实用性，为个人或团队提供了一种便捷的视频记忆存档解决方案。

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～