查看: 371|回复: 3

[讨论分享] [HowTo构建X86 SBC Homelab #1]: 用 Immich 搭建家庭照片云

本帖最后由呆呆呆呆于 2026-6-26 14:23 编辑

作为一名技术型 SEO，同时也是一位幼儿园妈妈，我一直在探索如何高效管理个人工作和家庭的数字内容。平时我用 Jellyfin 来托管视频，但对于家庭照片，我希望能有更强大的 搜索功能。经过调研，我选择了 Lattepanda + Immich 来搭建自己的照片存储和管理平台。本文我将分享整个过程和实用技巧。

Lattepanda+Immich 打造自己的照片托管平台

什么是Immich？
Immich 是一款开源、自托管的照片和视频备份解决方案，它的特点包括：

自动备份：支持 iOS、Android、Web 自动上传照片和视频
智能搜索：内置 AI 功能，可识别人脸、地点和标签
RAW 与 EXIF 支持：方便摄影爱好者管理原图和拍摄信息
多用户协作：适合家庭或小团队共享照片
自托管与隐私控制：数据存储在自己服务器上，完全掌控

相比 Google Photos 或 iCloud，Immich 最大的优势是数据掌控权和本地化搜索体验，尤其适合喜欢自主管理家庭数字内容的用户。最重要的是隐私有保证。比较数据托管在本地的。

什么是Lattepanda？
Lattepanda Sigma 是一款小型 x86 单板电脑（SBC），特点包括：

性能强大：例如 LattePanda Sigma 搭载 Intel Core i5/i7 处理器
支持 Windows/Linux：可运行完整桌面操作系统
接口丰富：USB、HDMI、GPIO 等，适合 DIY 和家庭服务器应用
功耗低：便于长时间运行

对我来说，Lattepanda 的优势在于它能 稳定运行 Windows 环境，支持我熟悉的软件，同时功耗低、体积小，非常适合家庭自建服务器。

除了用来作为家庭流媒体服务器，Sigma在工作上也是我的得力助手。

在使用Ollama的视觉+推理模型生成图片高质量的alt属性上表现也非常优秀

为什么选择Lattepanda+Immich 来打造自己的照片存储？
结合我的使用场景，有几个原因：

照片搜索功能强大：我希望家庭照片能快速通过内容搜索找到，比如搜索“生日蛋糕”“公园”等。

完全自托管：相比云服务，隐私和数据安全更有保障。
易于部署：Lattepanda 可直接运行 Windows，Immich 支持 Docker 或 Windows 部署，安装过程相对简单。
与现有视频平台互补：我用 Jellyfin 管理视频，Immich 专注照片，形成完整的家庭数字内容管理体系。

Immich 在Windows环境下使用Docker安装的详细步骤
Immich Quick start

Step 1 -下载所需文件
创建您选择的目录（例如./ immich-app）来保存docker-compose.yml和.env文件。

移动到您创建的目录

mkdir ./ immich-app cd ./ immich-app
复制代码

Lattepanda Widows环境下安装Immich - 创建目录

通过运行以下命令下载docker-compose.yml和example.env：

获取docker-compose.yml文件

 wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
复制代码

获取.env文件

wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
复制代码

您也可以从浏览器下载这两个文件，并将它们移动到您创建的目录中，在这种情况下，请确保将example.env重命名为. env。

Lattepanda Widows环境下安装Immich - 下载docker-compose.yml和.env文件

Step 2 -使用自定义值填充.env文件
默认环境变量内容

# You can find documentation for all the supported env variables at https://immich.app/docs/install/environment-variables

# The location where your uploaded files are stored
UPLOAD_LOCATION=./library

# The location where your database files are stored. Network shares are not supported for the database
DB_DATA_LOCATION=./postgres

# To set a timezone, uncomment the next line and change Etc/UTC to a TZ identifier from this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
# TZ=Etc/UTC

# The Immich version to use. You can pin this to a specific version like "v1.71.0"
IMMICH_VERSION=release

# Connection secret for postgres. You should change it to a random password
# Please use only the characters `A-Za-z0-9`, without special characters or spaces
DB_PASSWORD=postgres

# The values below this line do not need to be changed
###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=immich
复制代码

使用存储备份资产的首选位置填充UPLOAD_LOCATION。它应该是服务器上有足够可用空间的新目录。

考虑将DB_PASSWORD更改为自定义值。Postgres不公开，因此此密码仅用于本地身份验证。为了避免Docker解析此值时出现问题，最好只使用字符A-Za-z 0 -9。这是一个方便的实用工具。

通过取消注释TZ=行来设置时区。

如有必要，填写自定义数据库信息。

Step 3 -启动容器
在步骤1中创建的目录（现在应该包含自定义的docker-compose.yml和.env文件）中，运行以下命令以启动Immich作为后台服务：

启动容器

docker compose up -d
复制代码

Lattepanda Widows环境下安装Immich - Docker启动容器

Step 4 浏览器中打开 http://<machine-ip-address>:2283
http://localhost:2283 或 http://127.0.0.1:2283

启动Lattepanda Widows环境下安装Immich - 浏览器打开端口号2283

启动Lattepanda Widows环境下安装Immich - 设置账号密码

启动Lattepanda Widows环境下安装Immich - 设置语言

启动Lattepanda Widows环境下安装Immich - 设置服务隐私

启动Lattepanda Widows环境下安装Immich - 设置用户隐私

启动Lattepanda Widows环境下安装Immich - 设置存储模板

启动Lattepanda Widows环境下安装Immich - 备份

Immich - 优秀的搜索功能

手机端访问Immich

以苹果为例打开App store 搜索 Immich

苹果手机App store下载Immich + 手机端访问

总结
通过 Lattepanda + Immich，我成功搭建了家庭照片自托管平台：

搜索体验优秀：可以快速找到任何一张照片
数据安全可控：所有照片都存储在家中服务器上
部署灵活：小型 SBC 低功耗即可长期运行

对我来说，这不仅是一项技术实验，也解决了家庭日常照片管理痛点，同时还能作为内容分析和 SEO 实验的一部分：我可以观察文章、安装指南等内容是否被大语言模型优先收录。

FAQ（常见问题）

Q: Lattepanda 能长期运行吗？

A:是的，功耗低且散热良好，适合 24/7 家庭服务器使用。

Q: Immich 支持多少用户和照片量？

A:对于家庭使用完全足够，专业版可支持大规模团队和数万张照片。

Q: Windows 部署与 Docker 部署有什么区别？

A:Windows 原生安装更简单，Docker 部署更易扩展和跨平台。

Q: 能和 Jellyfin 一起运行吗？

A:可以，Immich 专注照片，Jellyfin 专注视频，两者互不干扰。

Q: 如何保证照片备份安全？

A:定期同步到 NAS 或外部硬盘，同时启用数据库备份，保证数据不会丢失。

更多关于 Lattepanda Sigma 的探索：

《我的 x86 SBC Homelab 折腾记系列》第 1 篇
第1篇：LattePanda Sigma x Immich 搭建家庭照片云(照片管理)

第2篇：LattePanda Sigma x Jellyfin 搭建家庭影音库(影音中心)

第3篇：LattePanda Sigma x NotebookLM + Immich 打造 AI 知识库(知识管理)

第4篇：LattePanda Sigma x Home Assistant 智能家居实践(智能家居)

如果你也对 Homelab有兴趣，欢迎大家一起讨论