Technical Anshu 主页 › 教程 › Immich Docker 安装
🐳 Docker 自托管照片

Immich 使用 Docker 安装 - 最快的方法

Immich 是您自己的私人 Google 照片:时间轴、相册、面部搜索和自动手机备份,在您自己家中的计算机上运行。官方的 Docker Compose 安装非常短——下载两个文件,编辑一个文件,运行一个命令。

✍️ Technical Anshu🐳 Docker / Linux Server🎧 Multi-Language Audio
Immich 使用 Docker 安装 - 最快的方法
🎧 多语言音频: 在视频播放器中,点击 [设置] (⚙️) ➔ [音频轨道] 选择您的首选语言。

📑章节

  • 为什么选择 Immich - 您自己的硬件上的私人 Google 相册替代方案
  • 开始之前需要什么 - 机器、Docker 和存储
  • 下载两个官方文件
  • 编辑 .env 文件 - UPLOAD_LOCATION 和 DB_PASSWORD
  • 用一个命令启动堆栈
  • 在端口 2283 上打开 Immich 并创建管理员帐户
  • 四个容器以及从第一天开始遵循的规则
  • 📋 概述和分步指南

    1

    首先检查您需要什么

    Immich 是一个自托管的照片和视频备份平台 - 免费且开源 - 运行它的官方方式是在支持 Docker 的 Linux 服务器、旧 PC、迷你 PC 或 NAS 上运行 Docker Compose。机器必须保持开启状态:每天晚上睡觉的笔记本电脑是一个糟糕的照片服务器。存储空间是您首先会用完的空间,因此请为完整照片库规划空间,另外为缩略图和转码视频预留大约 10-20% 的空间。

    大约 4 GB 的 RAM 是实用的底限;机器学习容器是最需要的部分,因此 6-8 GB 明显更满意。确认 Docker 和 Docker Compose 已安装并正常工作:

    终端
    docker compose version
    2

    创建文件夹并下载两个官方文件

    永远不要从博客或论坛帖子中复制随机的 docker-compose 文件 - 版本会发生变化,陌生人的文件可能会将您锁定到旧版本。官方文件始终位于项目的 GitHub 发布页面上。创建文件夹并移入其中:

    终端
    mkdir ./immich-app
    cd ./immich-app

    下载撰写文件和环境模板:

    终端
    wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
    wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
    📌 注意第二个命令中的重命名:模板名为 example.env,但 Docker 仅在文件名为 .env 时才读取它。
    3

    编辑 .env 文件 - 唯一重要的配置

    .env 文件包含一些我无法猜测的值。打开它:

    终端
    nano .env

    设置 UPLOAD_LOCATION=./library — 您的原始照片和视频所在的位置;将其指向最大、最可靠的磁盘。为数据库设置DB_DATA_LOCATION=./postgres,并将DB_PASSWORD更改为长随机密码。取消注释 TZ 并设置您的时区(例如亚洲/加尔各答),以便照片日期和预定的作业保持一致。首次安装时,请保留 IMMICH_VERSION 和标记线以下的所有内容。

    ⚠️ 保护您的库的两条规则:在 DB_PASSWORD 中仅使用字母和数字(A-Z、a-z、0-9)——特殊字符可能会破坏 Docker 对文件的解析。并将数据库保存在本地磁盘上,最好是 SSD:Immich 的文档直言不讳地说数据库不支持网络共享,并且在网络共享上运行可能会损坏它。
    4

    启动堆栈

    一个命令即可启动一切。 Docker下载容器镜像并一起启动;第一次运行需要几分钟,具体取决于您的互联网速度:

    终端
    docker compose up -d
    docker compose ps

    第二个命令检查一切是否正常 - 您应该看到服务器、机器学习、数据库和 Redis 容器正在运行。

    5

    打开 Immich 并创建管理员帐户

    在同一网络上的浏览器中打开 Immich - 它在端口 2283 上应答:

    浏览器地址栏
    http://YOUR-SERVER-IP:2283

    点击欢迎屏幕并注册。创建的第一个帐户将成为管理员 - 因此,在网络上的其他人找到该页面之前,请立即亲自执行此步骤。然后在手机上安装免费的 Immich 应用程序,使用相同的服务器地址登录,并打开自动备份。

    6

    了解四个容器和规则

    撰写文件运行一个小团队,而不是单个程序:immich-server 是大脑 - Web 界面、API、上传、相册和搜索; immich-machine-learning是眼睛——人脸检测、人脸识别、智能搜索; PostgreSQL 数据库是内存——每张照片的名称、日期、相册和脸部数据都存储在那里,而原件是文件; Redis 是服务器和后台工作者之间传递作业的信使。了解这种划分很重要:如果搜索失败,你就检查机器学习;如果搜索失败,你就检查机器学习;如果搜索失败,你就检查机器学习。如果照片从时间轴上消失但文件仍在磁盘上,则您需要检查数据库。

    ✅ 从第一天起就遵循两条规则:每次更新前阅读发行说明 - Immich 经常发布,某些版本包含需要特定升级步骤的重大更改。并在其他地方保留不可替代照片的另一个备份 - 开发人员自己建议这样做,因为您的服务器也是一台可能会发生故障的机器。

    🏷️Topic Search Variables & Keywords

    🔍 Immich 🔍 Docker Compose 🔍 Self Hosted Photos 🔍 Google Photos Alternative 🔍 Photo Backup Server 🔍 UPLOAD_LOCATION 🔍 DB_PASSWORD 🔍 Port 2283 🔍 Face Recognition 🔍 Linux Server 🔍 TechnicalAnshu
    🎙️ 完整文字记录 — 点击展开

    分步故障排除指南和解决方案 - 立即安装 IMMICH GOOGLE PHOTOS ALTERNATE。技术安叔屏幕演示......

    逐步使用 Docker Compose 安装 Immich - 下载官方文件,在 .env 文件中设置 UPLOAD_LOCATION 和 DB_PASSWORD,启动堆栈并在端口 2283 上打开您自己的私有 Google Photos 替代方案。

    (转录在源页面上结束)

    ❓ 常见问题(英文)

    本教程 100% 免费学习吗?

    是的!技术安数演示的所有指南和方法均使用免费、合法的教育资源。

    初学者可以遵循本指南吗?

    绝对是!每个步骤都在屏幕上演示并附有详细说明,以便任何人都可以轻松遵循。

    如果遇到困难我可以在哪里提问?

    直接在 YouTube 视频上发表评论,我们的社区和技术安树将为您提供帮助。

    🚀 在 YouTube 上观看完整教程

    🚀 在 YouTube 上观看完整的分步视频教程:https://www.youtube.com/watch?v=b_v7DbyFO14

    订阅技术安数以获取 IT 支持、Windows 故障排除和服务器管理。

    ▶️观看完整视频
    本教程基于Technical Anshu的Immich Docker 安装视频 • 遇到任何步骤?在视频评论中提问——你会在那里得到帮助🙏