
Immich部署教程3步跑通自托管照片库免费用上智能搜索与人脸识别【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immichImmich 是一款开源免费的自托管照片与视频管理系统用 Docker 就能在自己的服务器或 NAS 上搭起私有照片库内置基于 CLIP 模型的内容搜索、人脸识别、共享相册等能力数据完全留在本地。这篇文章按先说清它解决什么问题、再一步步搭起来、最后聊日常使用和进阶玩法的顺序来写跟着做即可。 照片还困在云服务和手机相册里先聊聊常见的三个不爽云相册收费且不可控。照片存在别人的服务器上超出免费额度就要付费账号停服、隐私争议时你几乎没有谈判余地。换手机等于搬家工程。备份、导回、去重一轮下来折腾好几天老照片的 EXIF 和文件夹结构还经常乱掉。找照片靠翻。几万张照片堆在一起想找去年在海边拍的那张只能按年份一页页划。这些问题的共同根源是照片的存储权、检索权都不在自己手里。 Immich 的思路整套能力搬回你自己的机器Immich 的定位是把照片备份 智能管理整条链路搬到你自己的硬件上手机 App 负责自动备份上传服务端负责存储、转码、索引机器学习容器负责搜索和人脸聚类。对你来说它同时是网盘、相册应用和搜索引擎而且不花订阅费。官方对硬件的要求写在 docs/docs/install/requirements.md 里简单记这几条项目最低推荐内存6GB8GBCPU2 核4 核系统Linux 64 位任意支持 Docker 的发行版磁盘本地 SSD 给数据库预留相册体积的 1.2~1.3 倍缩略图转码如果你的机器只有 4GB 内存也可以关掉机器学习功能先跑起来后面再升级。⚙️ 第 1 步克隆仓库并准备配置先把仓库克隆到目标机器上git clone https://gitcode.com/GitHub_Trending/im/immich安装部署的细节可以参考 docs/docs/install/docker-compose.mdx。核心就是两样东西一份.env文件和一个docker-compose.yml。.env里最关键的几项是UPLOAD_LOCATION照片原图落盘的目录建议直接指到大容量磁盘数据库位置Postgres 数据放本地 SSD 最稳别挂网络共享端口服务默认对外监听 2283 端口compose 文件里定义了四个容器immich-server主服务、immich-machine-learningAI 推理、redis队列和databasePostgres完整结构可以打开 docker/docker-compose.yml 对照查看。 第 2 步启动并注册第一个管理员在 compose 文件所在目录执行启动命令后浏览器访问http://服务器IP:2283就能打开网页端按提示注册第一个账号这个账号自动成为管理员。然后是手机这边下载 Immich App仓库里 mobile/ 目录就是 App 源码登录时填你刚才的服务器地址。App 首次连接成功后在设置里打开备份开关选上打开 App 时自动备份之后每次解锁看照片新拍的就会在后台悄悄传上去。重复文件会自动跳过不会二次占空间。 日常使用说人话的搜索认人的相册这部分是 Immich 最值钱的地方。内容级搜索。机器学习容器会给每张照片生成 CLIP 向量索引于是你能直接用自然语言搜海滩日落生日蛋糕命中的是画面内容而不是文件名。除了文字描述高级筛选还能叠加地点、时间段、相机型号、收藏与否等条件。搜索相关文档见 docs/docs/features/searching.md后台可以按需切换更大或多语言的模型。人脸识别。系统会自动检测照片里的脸并把同一个人聚类成一个人物条目你给它命名比如爸爸以后按人找照片就是一秒钟的事。顺手一提的其他能力图片内文字 OCR 搜索、反向地理编码把 GPS 坐标变成城市名、标签与文件夹视图都在手机和网页端可用功能清单可以参考 docs/docs/features/ 下的各篇文档。 把照片交给家人共享相册与伙伴共享给父母、伴侣开账号后Immich 支持两种协作方式共享相册把某个活动旅行、宝宝周岁建成长期或指定时间窗的共享相册对方能看能参与上传。伙伴共享Partner Sharing两人的媒体库互相可见像一对夫妻档账号适合小家庭共用一套设备。设置入口在网页端个人设置里权限可以精确到只读还是可上传文档在 docs/docs/features/partner-sharing.md。 长期运行监控、备份与 GPU 加速跑一段时间后建议养成两个习惯看任务面板。网页端管理 任务状态页面能看到智能搜索、人脸检测等后台任务的处理进度积压多时先查这里详见 docs/docs/administration/jobs-workers.md。看服务器统计。存储空间、资产数量一目了然方便规划扩容。关于备份本身Immich 是你的存储终点所以它自己的数据要遵循 3-2-1 原则——原图目录定期增量备份到另一块盘或异地数据库定期pg_dump方法见 docs/docs/administration/backup-and-restore.md。有 GPU 的加个硬件加速。换一张镜像标签再补几行 compose 配置就能让 AI 推理跑在显卡上索引几万张照片的时间明显缩短转码也可以交给 NVENC/QuickSync。配套文件都在仓库里docker/hwaccel.ml.yml 和 docker/hwaccel.transcoding.yml教程在 docs/docs/features/ml-hardware-acceleration.md。 小结把照片的主权拿回来到这里你已经有了一套完全自己掌控的照片系统备份自动跑、搜索用自然语言、人脸按人归类、家人随时可共享还能用 GPU 把处理速度拉满。整个部署过程没有付费环节后期成本只有电费和磁盘。下一步建议从最小的事做起今晚就把手机备份开关打开让第一万张照片先回家再慢慢把老手机、相机卡里的存货导入进来。【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考