一键部署 Immich

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

前置准备

1
一台 Linux 服务器
服务器最低配置:4GB 内存 + 50GB 硬盘,推荐阿里云/腾讯云轻量应用服务器(月费约 ¥50-100)
2
有 SSH 登录权限
Windows 用户推荐用 Xshell 或 PuTTY,Mac 用户用自带终端输入 ssh root@你的服务器IP

🚀 一键部署命令

复制下面这条命令,粘贴到你的服务器终端里,然后按回车

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

脚本会自动完成:检测系统 → 安装 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停止服务