从零构建Immich私有云相册：Docker部署+内网穿透全攻略

最新推荐文章于 2026-05-04 10:00:00 发布

原创

最新推荐文章于 2026-05-04 10:00:00 发布 · 547 阅读

1. Immich私有云相册简介

你有没有遇到过手机存储空间不足的烦恼？或者担心把照片上传到公有云服务会泄露隐私？Immich就是为解决这些问题而生的开源私有云相册解决方案。它就像是你自己搭建的Google Photos，但所有数据都完全掌握在自己手中。

我第一次接触Immich是在2022年，当时正在寻找一个能替代Google Photos的方案。经过对比多个开源项目后，Immich的界面美观度和功能完整性让我眼前一亮。它不仅能自动备份手机照片，还支持人脸识别、地图视图、相册共享等高级功能，而且全部通过Docker容器化部署，安装过程异常简单。

Immich特别适合以下几类用户：

摄影爱好者：支持RAW格式照片存储和浏览
家庭用户：多人共享相册，记录孩子成长点滴
隐私敏感者：数据完全私有，不用担心第三方窥探
技术爱好者：喜欢折腾自建服务的极客

相比Nextcloud等综合型网盘，Immich专注于照片管理这个垂直领域，因此在用户体验上更加精致。我实测过在树莓派4B上部署Immich，管理2万多张照片依然流畅运行，这对于个人和家庭使用完全足够。

2. 环境准备与Docker安装

2.1 硬件需求

Immich对硬件要求相当友好，以下是我的推荐配置：

最低配置：双核CPU/2GB内存/50GB存储（适合千张照片量级）
推荐配置：四核CPU/4GB内存/200GB+存储（适合家庭使用）
高性能配置：八核CPU/8GB内存/SSD存储（适合专业摄影）

我曾在三种设备上成功部署过Immich：

闲置的笔记本电脑（i5-8250U/8GB/256GB SSD）
树莓派4B（4GB内存版）
阿里云轻量应用服务器（2核4G/80GB）

2.2 操作系统选择

Immich支持主流Linux发行版，我个人推荐：

新手首选：Ubuntu Server 22.04 LTS
轻量选择：Debian 11
NAS用户：群晖DSM、QTS等（需支持Docker）

2.3 Docker安装指南

在Ubuntu上安装Docker只需三步：

# 1. 卸载旧版本（如有）
sudo apt-get remove docker docker-engine docker.io containerd runc

# 2. 设置仓库并安装
sudo apt-get update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 3. 安装Docker引擎
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

验证安装是否成功：

sudo docker run hello-world

如果看到"Hello from Docker!"的提示信息，说明安装正确。建议将当前用户加入docker组，避免每次都要sudo：

sudo usermod -aG docker $USER
newgrp docker  # 立即生效

3. Immich本地部署实战

3.1 一键部署Immich

官方提供了极简的安装脚本，这是我用过最省心的部署方式：

curl -o- https://raw.githubusercontent.com/immich-app/immich/main/install.sh | bash

这个脚本会自动完成以下工作：

创建immich-app目录
下载最新的docker-compose.yml和.env配置文件
启动所有必需容器（共7个服务）

第一次启动可能需要5-10分钟，具体取决于网络速度。完成后访问http://localhost:2283就能看到登录界面。

3.2 手动配置详解

如果你想更精细控制配置，可以手动调整：

首先下载配置文件：

mkdir -p ~/immich && cd ~/immich
wget https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget https://github.com/immich-app/immich/releases/latest/download/example.env -O .env

修改.env文件关键参数：

# 照片存储路径（建议改为大容量分区）
UPLOAD_LOCATION=/mnt/data/immich/library

# 时区设置（国内用户建议修改）
TZ=Asia/Shanghai

# 数据库密码（务必修改！）
DB_PASSWORD=your_strong_password

启动服务：

docker compose up -d

3.3 常见问题排查

我在部署过程中遇到过几个典型问题：

问题1：端口冲突错误提示：Bind for 0.0.0.0:2283 failed: port is already allocated 解决方案：修改docker-compose.yml中的端口映射，比如改为2284:2283

问题2：权限不足错误提示：Permiss

标签

#Immich #私有云 #Docker部署 #内网穿透

最低0.47元/天解锁文章