Immich 是一个开源的、自托管的照片和视频管理解决方案，它让你能够完全掌控自己的媒体库。如果你厌倦了依赖第三方云服务来备份和整理照片，或者担心隐私和数据主权问题，那么 Immich 值得你重点关注。它提供了类似 Google Photos 的体验，但所有数据都存储在你自己的服务器上。这个项目最核心的特点是支持自动备份、智能搜索、人脸识别和强大的组织能力。你可以通过手机 App 自动上传照片和视频，然后在 Web 界面上按时间线、地点、人物或对象来浏览和搜索。Immich 还内置了机器学习功能，能够自动识别照片中的内容，比如"海滩""生日蛋糕"或特定人物，让你快速找到想要的回忆。硬件门槛方面，Immich 可以部署在从树莓派到专业服务器的各种设备上。如果只是个人或家庭使用，一台有 4GB 以上内存的 Linux 服务器就足够。对于更大的媒体库或更多用户，建议 8GB 以上内存和更强大的 CPU。显存不是必须的，但如果有 GPU 可以加速机器学习任务。本文将带你完成 Immich 的完整部署流程，包括 Docker 环境准备、服务启动、手机 App 配置、功能测试和常见问题排查。无论你是想搭建个人照片库还是为家庭提供共享相册服务，都能找到实用的操作指南。1. 核心能力速览能力项说明项目类型自托管照片视频管理平台开源协议MIT License主要功能自动备份、智能搜索、人脸识别、相册管理推荐硬件4GB+ 内存，支持 Docker 的环境GPU 要求可选，用于加速机器学习任务支持平台Web、Android、iOS启动方式Docker Compose 一键部署API 支持完整的 REST API批量任务支持批量上传、处理和导出适合场景个人媒体库、家庭共享相册、团队素材管理2. 适用场景与使用边界Immich 最适合需要完全控制自己照片数据的用户。如果你有以下需求，可以考虑部署：隐私保护：不希望照片存储在第三方云服务商那里数据主权：想要完全掌控数据的存储位置和访问权限无限存储：摆脱云服务商的存储空间限制，按需扩展硬盘容量智能搜索：需要按人物、地点、对象等条件快速搜索照片多设备同步：在手机、平板、电脑间同步照片库但是，Immich 不适合以下场景：即开即用的轻量需求：需要自己维护服务器和网络环境完全不懂技术的用户：部署需要基本的 Linux 和 Docker 知识超大规模企业级应用：虽然支持集群部署，但需要额外配置重要提醒：使用人脸识别功能时，务必确保你有权处理相关照片，尊重他人隐私。部署在公网访问时，要配置好安全措施，避免数据泄露。3. 环境准备与前置条件在开始部署前，需要确保你的环境满足以下要求：操作系统要求Linux（推荐 Ubuntu 20.04+、CentOS 7+）macOS（用于开发和测试）Windows（通过 WSL2 运行）系统资源内存：至少 4GB，推荐 8GB+存储：根据照片库大小准备，建议预留 2 倍预期容量CPU：双核以上，机器学习任务需要更强计算能力软件依赖Docker Engine 20.10+Docker Compose 2.0+如果使用 GPU：NVIDIA Container Toolkit网络要求服务器需要能访问 Docker Hub 下载镜像如果要从外网访问，需要公网 IP 和域名手机 App 需要能连接到服务器地址端口占用默认使用 2283 端口（API）和 2284 端口（Web）确保这些端口未被占用或可以修改检查 Docker 是否已安装：docker --version docker-compose --version如果未安装，需要先安装 Docker 环境。以下以 Ubuntu 为例：# 更新包管理器 sudo apt update # 安装 Docker 依赖 sudo apt install apt-transport-https ca-certificates curl software-properties-common # 添加 Docker 官方 GPG 密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - # 添加 Docker 仓库 sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" # 安装 Docker sudo apt update sudo apt install docker-ce # 启动 Docker 服务 sudo systemctl start docker sudo syste