Foldergram

在云端存储日益昂贵且隐私顾虑丛生的今天，如何优雅地管理本地海量的照片和视频？Foldergram 提供了一个极具创意的解决方案：它是一个自托管的 Web 应用程序，能将你本地的文件夹直接转换为一个拥有 Instagram 风格界面的个人媒体画廊。

无需上传、无需同步、无需复杂的数据库配置，Foldergram 让你完全掌控数据，同时享受现代化的浏览体验。

核心理念：本地即云端，文件夹即应用

Foldergram 的设计哲学极其纯粹：直接映射文件系统。

• 应用文件夹（App Folders）：在配置的 GALLERY_ROOT 目录下，任何包含受支持媒体文件的非隐藏文件夹，都会自动成为一个独立的“应用文件夹”，对应 Instagram 中的个人主页或专辑。
• 帖子（Posts）：文件夹内的每个图像或视频文件，即为一个“帖子”。
• 隔离性：嵌套的子文件夹不会合并到父文件夹中，保持独立的索引结构；根目录下的散乱文件则被忽略，确保画廊的整洁。

这种设计意味着，你只需像往常一样在资源管理器中整理照片，Foldergram 就会自动同步呈现，无需额外的上传步骤。

功能亮点：熟悉的 Instagram 体验

Foldergram 复刻了 Instagram 的核心交互逻辑，让本地浏览变得生动有趣：

1. 沉浸式信息流

• 主页动态：支持“最新”、“重温”和“随机”三种模式，打破传统文件管理器的枯燥列表。
• Reels 视频流：专门的 /reels 路由提供纯视频队列，支持推荐、最新或随机播放，完美适配短视频浏览习惯。
• 精选与瞬间：顶部栏根据拍摄日期智能显示“精选”内容或“精彩瞬间”。

2. 高效的媒体管理

• 媒体库浏览：支持搜索、排序和删除操作，方便快速查找特定内容。
• 点赞与收藏：
  • 登录用户：点赞数据存储在 SQLite 数据库中，跨会话持久化。
  • 公共模式：使用浏览器本地存储（Local Storage）保存临时收藏，保护隐私的同时提供个性化体验。
• 原始文件控制：在详情页和故事模式中，提供原始媒体下载按钮，或直接打开本地文件，确保无损访问。

3. 性能优化

• 智能缩略图生成：支持即时生成或延迟生成（Lazy Generation）衍生文件（缩略图、预览），首次浏览极速加载，后续访问流畅无阻。
• SQLite 索引：运行时读取 SQLite 数据库和生成的资产，而非每次请求都扫描实时文件系统，大幅提升响应速度。
• 稳定资产存储：衍生文件存储在稳定的资产键分片下，不镜像源文件夹结构，升级迁移更平滑。

技术架构与隐私保护

Foldergram 是一款真正的**本地优先（Local-First）**应用：

• 无云依赖：没有多用户账户系统、没有云端同步、没有评论、消息或远程 API。所有数据均留在你的设备上。
• 轻量级后端：使用 SQLite 存储元数据，结构简单高效。
• PWA 支持：提供 Web 应用清单和 Service Worker，可安装为桌面或移动应用，离线也可访问已缓存内容。
• 角色权限：支持管理员、查看者和公共浏览三种模式，灵活控制访问权限。

支持格式

• 图像：.jpg, .jpeg, .png, .webp, .gif
• 视频：.mp4, .mov, .m4v, .webm, .mkv
  • 注：视频处理依赖 ffmpeg 和 ffprobe。Docker 镜像已预装，源码安装需自行配置。

快速开始：Docker 一键部署

推荐使用 Docker 进行部署，简单几步即可拥有自己的私有 Instagram：

# 1. 创建项目目录
mkdir foldergram
cd foldergram

# 2. 下载 Docker Compose 配置文件
wget -O docker-compose.yml https://raw.githubusercontent.com/foldergram/foldergram/main/docker-compose.yml

# 3. 创建画廊文件夹并放入测试媒体
mkdir -p data/gallery/example-album
# 将你的照片/视频放入 data/gallery/example-album

# 4. 启动服务
docker compose up -d

# 5. 访问 http://localhost:4141

对于开发者，也支持从源码运行（基于 pnpm）：

git clone https://github.com/foldergram/foldergram.git
cd foldergram
cp .env.example .env
pnpm install
pnpm dev # 开发模式
# 或 pnpm build && pnpm start # 生产模式

对于摄影师、家庭用户或任何希望摆脱云端束缚的人来说，Foldergram 提供了一个美观、高效且私密的数字记忆空间。只需一个 Docker 命令，你就能重新夺回照片的所有权，并以最熟悉的方式欣赏它们。