嗨,大家好呀,这里是 「青柠炸机店」!
今天给大家带来的是一款超有意思的私有相册工具——Foldergram,一个把你本地文件夹直接变成 Instagram 风格照片墙的开源神器,Docker 一键部署,轻量好看还免费!
📸 文件夹秒变Instagram,0成本私有照片墙
前言:我为什么要折腾这个?
先上最终效果——一个长得跟 Instagram 几乎一模一样的私有照片/视频相册,首页 Feed 流、探索页、点赞收藏、Reels 短视频……该有的全有。关键是?完全免费,数据全在你自己的硬盘上!

说实话,私有相册这个赛道我也折腾过不少方案了。像收费的 MT Photos,功能确实全面,体验也不错;开源热门的 Immich 我也部署过,功能强大是真的强大,但配置也是真麻烦,吃的资源也不少;还有一个比较有特点的 Chronoframe,地球仪和相片的详细信息,做的很好。这几款都各有各的好,各有各的特色。不过我最近又发现了一个画风完全不同的选手——Foldergram,主打一个极致轻量 + Ins 风高颜值,玩法和上面几款完全不一样,忍不住来给大家安利一波!
它最让我心动的地方在于——文件夹就是相册。你不需要手动上传、创建影集、打标签分类,只要把照片往文件夹里一扔,Foldergram 自动帮你索引生成缩略图,直接以 Ins 风格展示。懒人福音!
💡 本文约 2500 字,建议先收藏再看(反正你们收藏了也不看 😂),家里有 NAS 或者小主机的兄弟直接上车!
🔥 Foldergram 到底有多能打?
在动手之前先给大家简单列一下这玩意儿的核心能力,免得你们觉得我在吹:
- ✅ Instagram 同款 UI:Feed 首页、探索页、个人主页风格的文件夹展示,连 Reels(短视频)Tab 都安排上了
- ✅ 三种浏览模式:Recent(最新)、Rediscover(重温老照片)、Random(随机发现),每天打开都有惊喜
- ✅ Moments / Highlights:类似 Ins 的故事功能,自动根据照片的拍摄时间生成
- ✅ 收藏 & 点赞:支持多用户共享收藏,公开模式下浏览器本地收藏
- ✅ 角色权限控制:Admin / Viewer / Public 三级权限,分享给朋友看也不怕被误删
- ✅ PWA 支持:加到手机桌面直接当 App 用,体验拉满
- ✅ 轻量无依赖:SQLite 存储元数据,不需要额外装数据库,一个 Docker 容器搞定
- ❌ 没有云同步、评论、消息功能:纯粹的本地相册,专注于”看”这一件事(我反而觉得这是优点,Less is More)
支持的格式也很全面:图片 .jpg/.png/.webp/.gif,视频 .mp4/.mov/.mkv/.webm 统统支持。GIF 动图在浏览时还能保持动画效果,细节拉满。

🛠 手把手部署实战:核心干货
部署 Foldergram 比想象中简单得多——Docker 一把梭,前后不到 5 分钟,以 绿联 DXP4800 Plus 为例。
Step 1: 创建项目
进入 NAS 首页,找到Docker,点击 项目 - 创建 按钮

Step 2: 复制 Docker Compose 文件
不用自己从零开始写,官方已经把 Compose 文件准备好了,直接薅过来:在这个地址复制 Compose 🖐🏻,将复制好的 Compose 放入 配置框中即可。

⚠️ 高能预警:如果你网络环境不太行,
wgetGitHub 的文件可能会超时。这种情况下直接浏览器打开上面的链接,手动复制内容到本地的docker-compose.yml文件里就行。
Step 3: 准备你的照片
Foldergram 的规则很简单:一个文件夹 = 一个相册。在 data/gallery/ 下面创建子文件夹,往里面扔照片就完事儿:
mkdir -p data/gallery/旅行照片mkdir -p data/gallery/美食记录mkdir -p data/gallery/猫片合集然后把你的照片和视频文件复制到对应的文件夹里。
💡 这里的坑我帮大家踩过了:直接放在
data/gallery/根目录下的文件会被忽略!必须放到子文件夹里才能被索引到。我一开始把所有照片直接倒进了 gallery 根目录,然后打开网页一脸懵——“我的照片呢??“,排查了半天才发现这个规则(心态崩了 😂)。
Step 4: 最终效果
打开浏览器访问 http://你的内网IP:4141 就能看到效果了!
⚠️ 注意端口:Foldergram 默认端口是 4141,不是常见的 3000 或 8080。如果 4141 被占用了,修改
docker-compose.yml里端口映射的左边数字就行,比如改成8888:4141。
Step 5: 进阶配置(可选)
官方的 Compose 文件默认配置了两个关键参数:
environment: - IMAGE_DETAIL_SOURCE=preview # 查看大图时使用生成的预览图 - DERIVATIVE_MODE=eager # 扫描时立即生成缩略图简单解释一下这两个参数:
IMAGE_DETAIL_SOURCE:设成preview打开大图时加载预先生成的预览图(加载快但有压缩),设成original则直接展示原图(更清晰但加载慢)DERIVATIVE_MODE:eager模式会在扫描照片时一口气全部生成缩略图和预览图(首次扫描稍慢,之后浏览飞快);lazy模式是用到哪个生成哪个(首次扫描快,但第一次打开每张图会卡一下)
💡 我的建议:照片不多(几千张以内)就用默认的
eager模式,一劳永逸。如果你是那种硬盘里存了十几万张照片的摄影大佬,可以考虑改成lazy,不然首次扫描可能要等很久。
⚡️ 访问控制:分享给朋友也不怕
Foldergram 内置了一套简洁的权限系统,在 Web 界面的 Settings 里就能配置(不需要改配置文件):
- Admin 模式:完全权限,可以扫描、删除、重建索引,管理一切
- Viewer 模式:只能浏览和点赞,不能搞破坏,适合分享给家人朋友
- Public 模式:任何人打开链接就能看,适合做公开展示
三个模式可以灵活切换。比如你平时自己用 Admin 模式管理,给女朋友/老婆开个 Viewer 密码让她在自己手机上回忆旅行照片,或者设置成 Public 模式做个在线作品集展示给客户——这波操作属实优雅。
💣 体验与避坑(灵魂所在)
真实好评 ✅
最让我上瘾的是 Rediscover(重温) 模式,它会随机翻出你很久以前的照片。有天晚上我本来只是想测试功能,结果不知不觉刷了一个小时自己的旧照片…… 这功能简直是电子茶叶蛋,一颗接一颗停不下来。
翻车现场 ❌
当然也不是一帆风顺,分享两个差点让我砸键盘的瞬间:
-
嵌套文件夹的”惊喜”:我习惯把照片按
年份/月份/事件这样多层嵌套整理。结果在 Foldergram 里显示出来全是打散的——因为它的逻辑是每个直接包含图片的文件夹都是独立相册,嵌套文件夹不会合并到父文件夹!比如2025/03/樱花季/会变成一个单独的相册,而不是归到2025下面。理解了这个规则之后其实还好,但一开始确实有点懵。 -
视频处理依赖 FFmpeg:Docker 镜像里已经自带了
ffmpeg,所以 Docker 部署的兄弟不用担心。但如果你像我一样手贱想从源码跑(才怪,我试了三次才放弃回到 Docker),那你得自己装ffmpeg和ffprobe,不然视频缩略图死活生成不出来。老老实实用 Docker 吧,别折腾了。
客观聊聊不足 🤔
任何工具都不可能十全十美,说完优点也得客观聊聊 Foldergram 目前的短板:
- 没有自动同步机制:Foldergram 只负责”展示”,不管”同步”。你需要自己把照片搬到
gallery目录下,它不会自动从手机同步照片过来。不过配合 Syncthing 之类的同步工具,这个问题倒也不难解决。 - 不支持人脸识别 / 智能分类:它的核心哲学是”文件夹即相册”,分类完全靠你自己的目录结构。想要 AI 自动按人物、地点、场景分类的兄弟,这个不适合你。
- 单机部署,无多用户体系:虽然有 Admin/Viewer/Public 权限区分,但不是那种每个人有独立相册、独立账号的多租户架构。它更适合个人或家庭使用。
- 项目还比较年轻:GitHub 上目前版本迭代到 v7,社区规模还不大,遇到问题可能需要自己翻 Issue 或看源码。好在技术栈(Node.js + Vue 3 + SQLite)都是主流的,有动手能力的兄弟不怕。
- 暂时只有英文,还在页面中的功能比较少,简单的翻译一下就好了。
📝 总结:值不值得折腾?
适合谁折腾?
- 有 NAS 或小主机,想要一个高颜值私有相册的值友
- 照片按文件夹整理,不想折腾复杂的导入/同步流程的懒人玩家
- 想给家人朋友分享照片,但又不愿意用网盘或者公有云的隐私党
- 摄影爱好者想搞个在线作品集但懒得建站的兄弟
不适合谁?
- 需要手机自动同步、人脸识别、智能分类等进阶功能的重度用户
- 照片量超过几十万张还没做好目录分类的重度囤积症患者
- 需要多人独立账号、评论互动等社交属性的团队场景
每款相册软件都有自己的定位和特色,Foldergram 的独特之处在于把”文件夹变成 Instagram”这个思路做到了极致。它不追求大而全,而是专注在轻量 + 高颜值本地浏览这个细分方向上——零配置、零学习成本、零额外依赖,Docker 一键启动就能获得一个让人眼前一亮的私有相册。如果你和我一样,照片本来就是按文件夹整理的,想要一个好看又省心的浏览工具,那 Foldergram 绝对值得一试。省下的折腾时间拿去拍更多好照片,它不香吗?🧋
这期的分享就到这里!大家平时都是怎么管理自己的照片的?有什么私藏的好方案?欢迎评论区激情对线 👇!
项目地址:https://github.com/foldergram/foldergram 项目Demo:https://foldergram.intentdeep.com
因你更精彩
打赏将用于网站日常运营
