Immich自托管照片管理完全指南：三步搭建你的免费照片备份平台
【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich
手机相册里照片越存越多，想找某一张却要翻很久，而商业网盘既有费用又让人不放心。Immich 是一款免费、自托管的照片管理与照片备份方案，装在自己的服务器上，数据从此只属于你。
Immich 是一个完整的自托管照片与视频管理平台，把服务端、数据库、AI 分析、网页端和移动应用整套部署在你自己的机器或 NAS 上，手机拍完的照片会自动同步进你的存储。它适合希望完全掌控数据的个人用户，也适合需要共享素材的小团队。和商业云服务的差别在于：文件、数据库、账号全部在你手里，没有订阅费，也没有第三方碰你的照片。
三个典型场景：自动备份、AI 检索、家人共享
照片自动备份的设置方法
一次旅行拍两三百张照片，"周末再整理"的想法常常落空，而手机内存有限，设备损坏就是实实在在的丢失。Immich 的移动应用把这件事简化成一次设置：登录后开启备份，它会在后台静默运行，只上传新增文件，还可以限定仅在 Wi-Fi 下传输，省下流量。文件到达服务器后会被自动处理：生成缩略图与预览图，提取拍摄时间、地理位置、相机型号等元数据，再进入 AI 分析队列。整个过程不需要你手动搬动任何一个文件。
人脸识别与多条件搜索快速找出老照片
你确定去年拍过某只猫，却想不起它在哪个相册里。Immich 的机器学习服务（machine-learning/）会对每张照片做一轮分析：人脸被自动检测并按人聚合成相册，场景、物体乃至图中的文字也会被索引，支持关键词直接搜。再叠加人物、地点、时间、标签、拍摄设备这些筛选条件，两三次点选就能缩小范围，"海边日落"这样的自然语言查询同样可以返回结果。
与家人安全共享的设置方法
想让家人看到旅行照，又不想逐张转发；同时也不想让私人动态对所有人开放。Immich 的伙伴共享是这样运作的：把对方添加为伙伴，双方账号关联后，你选择共享的照片会同时出现在双方的图库中，新增内容实时同步。对不登录系统的亲友，则可以用公开链接相册，自行决定是否允许下载并设置有效期。共享的范围由你决定，而不是由平台决定。
快速上手：用 Docker 三条命令部署
最省事的路径是 Docker。在一台装了 Docker 的 Linux 机器或 NAS 上，进入仓库的 docker/ 目录，把示例环境文件复制出来并填好，然后启动：
cp example.env .env docker compose -f docker-compose.yml up -d浏览器打开http://localhost:2283，注册第一个账号，系统即告完成。.env里你只需关心三处：UPLOAD_LOCATION指定照片的存放目录，DB_PASSWORD是数据库密码，请改成复杂值；端口映射默认 2283，按需调整。
实用建议：最低硬件配置与安全要点
- 硬件起步：2 核 CPU、4GB 内存可跑起个人规模；照片达到几十万张再考虑 4 核 8GB；视频多、经常在线转码的话，8 核 16GB 更从容。
- 存储：把照片目录放在 SSD 上，缩略图加载和备份速度会明显变快；定期备份时请同时覆盖照片目录和数据库目录，两者缺一个都恢复不全。
- 安全：建议把服务放在反向代理之后启用 HTTPS，数据库的 5432 端口不要直接暴露到公网；访问控制由账号体系负责，管理面板里还提供用户配额与存储统计，便于长期运维。
生态与资源：文档与学习入口
项目迭代很快，社区贡献者众多，是自托管领域活跃度高的一线开源项目。官方文档 docs/docs/ 覆盖安装、管理与开发全流程；接口规范在 open-api/，可基于它自行生成客户端；常见疑问可以先查 docs/docs/FAQ.mdx。界面已翻译成 89 种语言，中文用户在设置里切换即可。
Immich 解决的是两件事：照片有安全的归处，需要时能快速找到，而部署门槛低到一下午就能完成。小提醒：部署完成后，请按照 3-2-1 备份原则定期为照片目录和数据库做异地副本，这样真出问题时，一切都能找得回来。
【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
