一键部署 Immich

搭建属于你自己的「谷歌相册」,照片和视频都存在你自己家里,不上传到任何云服务,还有 AI 帮你自动识别人脸和分类

前置准备

1
一台 Linux 服务器
服务器最低配置:4GB 内存 + 50GB 硬盘,推荐阿里云/腾讯云轻量应用服务器(月费约 ¥80-150)
2
安装部署 Agent
在服务器终端执行一行命令即可安装:
curl -fsSL https://awesome-toolkit.pages.dev/agent/install-agent.sh | bash

一键部署到你的服务器

在网页上填写服务器 IP 和 Agent Token,自动完成:检测系统 → 拉取镜像 → 启动服务

开始部署向导
💻 或者手动使用 Agent 命令行(高级用户)

🤖 通过 Agent 部署

先安装 Agent,然后通过它一键部署。Agent 会帮你管理所有部署的工具。

步骤 1:安装 Agent

curl -fsSL https://awesome-toolkit.pages.dev/agent/install-agent.sh | bash

步骤 2:部署工具

curl -fsSL https://awesome-toolkit.pages.dev/deploy/install.sh | bash -s -- immich

Agent 会自动完成:检测 Docker → 拉取镜像 → 启动服务,整个过程 3-5 分钟

🎯 部署完成后

🔗
访问地址
http://你的服务器IP:2283
💡
下一步

打开浏览器访问 http://你的服务器IP:2283,创建管理员账号。然后在手机上下载 Immich App(iOS/安卓),用同样的地址登录,开启自动备份即可。

💻 服务器配置要求

4GB
内存
50GB
硬盘
1
端口
3-5分钟
部署耗时

⚙️ 环境变量(可选)

部署前可以设置这些变量来自定义安装,不设置则使用默认值

DB_PASSWORD数据库密码
changeMe123!
UPLOAD_LOCATION照片存储路径
./data/photos

使用示例:

export DB_PASSWORD=mySecretPass123; curl -fsSL ... | bash -s -- immich

📋 常用管理命令

部署完成后,SSH 进入 ~/awesome-tools/immich 目录,然后运行:

docker compose ps查看运行状态
docker compose logs -f查看实时日志
docker compose restart重启服务
docker compose pull && docker compose up -d更新到最新版本
docker compose down停止服务