项目简介

Immich 是一款开源的自托管照片和视频管理平台，支持本地化部署，提供类似 Google Photos 的智能分类、人脸识别、地图定位等功能。用户可以轻松地在私有服务器上构建属于自己的多媒体中心，实现数据隐私保护与高效管理。

Immich 使用现代 Web 技术栈开发，前端采用 Angular 框架，后端使用 NestJS（基于 Node.js），并结合 PostgreSQL 数据库和 Redis 缓存系统。其核心功能包括：

GitHub 地址：https://github.com/immich-app/immich（当前 Star 数：12.6k+）

Ciuic 服务器配置选型

推荐部署平台为 Ciuic云服务器，其提供高性能且价格合理的云主机服务，适合中小型项目的部署需求。

对于 Immich 来说，推荐至少选择 标准型 S2 以确保数据库、缓存及后台任务稳定运行，尤其在开启人脸识别等资源密集型功能时。

通用部署流程

1. 运行环境准备

Immich 依赖以下组件：

建议使用 Docker 容器方式部署，简化依赖管理。

2. 服务器配置

登录 Ciuic 控制台，创建 Ubuntu 22.04 LTS 实例，并开放如下端口：

3. 安装依赖

更新系统包并安装 Docker 及相关工具：

sudo apt update && sudo apt upgrade -ysudo apt install docker.io docker-compose curl git -y

克隆官方仓库并进入目录：

git clone https://github.com/immich-app/immich.gitcd immich

4. 启动服务

编辑 .env 文件配置数据库、存储路径等参数后执行：

docker-compose up -d

等待镜像拉取并启动所有服务，可通过以下命令查看日志：

docker-compose logs -f

Nginx 完整配置

安装 Nginx 并进行反向代理配置：

sudo apt install nginx -y

创建站点配置文件 /etc/nginx/sites-available/immich，内容如下：

server {    listen 80;    server_name your.domain.com;    client_max_body_size 100M;    location / {        proxy_pass http://localhost:5150;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;        proxy_set_header X-Forwarded-Proto $scheme;    }    location /api {        proxy_pass http://localhost:5151;        proxy_http_version 1.1;        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection 'upgrade';        proxy_cache_bypass $http_upgrade;    }}

启用站点并重启 Nginx：

sudo ln -s /etc/nginx/sites-available/immich /etc/nginx/sites-enabled/sudo nginx -t && sudo systemctl restart nginx

如需 HTTPS，可使用 Let's Encrypt 免费证书：

sudo apt install certbot python3-certbot-nginx -ysudo certbot --nginx -d your.domain.com

通过以上步骤，你已完成 Immich 的完整部署与优化配置。现在可以通过域名访问你的私有相册系统，享受安全、高效的多媒体管理体验。