使用 Immich 自托管我的照片

<p>对于我使用的每一个云服务，我都希望拥有一份本地数据副本以作备份和独立使用。不幸的是，当 Google 限制 OAuth 范围后，<code>gphotos-sync</code> 工具<a href="https://github.com/gilesknap/gphotos-sync-discussion/discussions/1">在 2025 年 3 月停止了工作</a>，因此我需要为现有的 Google Photos 设置寻找替代方案。本文将介绍我是如何设置 <a href="https://immich.app/">Immich</a>（一个可自托管的照片管理器）的。</p> <p>以下是最终结果：来自 <a href="/posts/2025-09-21-nixcon-2025-trip-report/">NixCon 2025</a> 的几张（实时）照片：</p> <a href="https://michael.stapelberg.ch/posts/2025-11-29-self-hosting-photos-with-immich/2025-11-19-immich-screenshot-featured.jpg"><img srcset="https://michael.stapelberg.ch/posts/2025-11-29-self-hosting-photos-with-immich/2025-11-19-immich-screenshot-featured_hu_6928fc2a893484f1.jpg 2x,https://michael.stapelberg.ch/posts/2025-11-29-self-hosting-photos-with-immich/2025-11-19-immich-screenshot-featured_hu_7c70567581178dd5.jpg 3x" src="https://michael.stapelberg.ch/posts/2025-11-29-self-hosting-photos-with-immich/2025-11-19-immich-screenshot-featured_hu_744c6f048556917c.jpg" alt="Immich 在网页浏览器中的截图" title="Immich 在网页浏览器中的截图" width="600" height="504" style=" border: 1px solid #000; " loading="lazy"></a> <h2 id="step-1-hardware">第一步：硬件</h2> <p>我在我的 <a href="/posts/2024-07-02-ryzen-7-mini-pc-low-power-proxmox-hypervisor/">Ryzen 7 Mini PC (ASRock DeskMini X600)</a> 上运行 Immich，这款电脑闲置功耗低于 10 W，并且拥有充足的虚拟机资源（64 GB 内存、1 TB 磁盘）。你可以在我在 2024 年 7 月发布的博文中了解更多：</p> <div class="postlink"> <div> <a href="https://michael.stapelberg.ch/posts/2024-07-02-ryzen-7-mini-pc-low-power-proxmox-hypervisor/"><h3>Ryzen 7 Mini-PC 成为高能效虚拟机主机</h3></a> </div> <div class="summary"> <a href="https://michael.stapelberg.ch/posts/2024-07-02-ryzen-7-mini-pc-low-power-proxmox-hypervisor/" style="min-width: 200px; margin-right: 1.5rem; margin-bottom: 1.5rem"><img src="https://michael.stapelberg.ch/posts/2024-07-02-ryzen-7-mini-pc-low-power-proxmox-hypervisor/240630-server-featured_hu_6c2736729d115f81.jpg" width="200" height="134"/></a> <p> <a href="https://michael.stapelberg.ch/posts/2024-07-02-ryzen-7-mini-pc-low-power-proxmox-hypervisor/"> 当我第一次看到 ASRock DeskMini X600 准系统的评测时，我立刻对用它搭建家庭实验室虚拟机主机产生了兴趣。显然，DeskMini X600 功耗不到 10W，但却支持最新一代 AMD CPU，比如 Ryzen 7 8700G！ <span class="readmore"><a href="https://michael.stapelberg.ch/posts/2024-07-02-ryzen-7-mini-pc-low-power-proxmox-hypervisor/">阅读更多 →</a></span> </a> </p> </div> </div> <p>我安装了 <a href="https://proxmox.com/en/">Proxmox</a>（一个开源虚拟化平台）来将这台迷你服务器划分为多个虚拟机，当然你也可以直接在任意服务器上安装 Immich。</p> <h2 id="step-2-install-immich">第二步：安装 Immich</h2> <p>我创建了一个虚拟机（名为“photos”），分配了 500 GB 磁盘空间、4 个 CPU 核心和 4 GB 内存。</p> <p>对于初始导入，你可以分配更多 CPU 和内存，但正常使用时这些配置已经足够。</p> <p>我按照这篇博文中的描述，<a href="/posts/2025-06-01-nixos-installation-declarative/">（声明式地）在该虚拟机上安装了 NixOS</a>：</p> <div class="postlink"> <div> <a href="https://michael.stapelberg.ch/posts/2025-06-01-nixos-installation-declarative/"><h3>我喜欢的 NixOS 安装方式（声明式）</h3></a> </div> <div class="summary"> <a href="https://michael.stapelberg.ch/posts/2025-06-01-nixos-installation-declarative/" style="min-width: 200px; margin-right: 1.5rem; margin-bottom: 1.5rem"><img src="https://michael.stapelberg.ch/posts/2025-06-01-nixos-installation-declarative/nix-snowflake-rainbow-featured_hu_2c3edabdd6900fed.png" width="200" height="200"/></a> <p> <a href="https://michael.stapelberg.ch/posts/2025-06-01-nixos-installation-declarative/"> 在我搭建某台网络存储 PC 时，我正在寻找 Flatcar Container Linux 的替代品，于是（在中断近 10 年后）再次尝试了 NixOS。安装 NixOS 有多种方式，本文将介绍我喜欢的安装方式：通过网络进行完全声明式的安装，适用于物理硬件或虚拟机。 <span class="readmore"><a href="https://michael.stapelberg.ch/posts/2025-06-01-nixos-installation-declarative/">阅读更多 →</a></span> </a> </p> </div> </div> <p>之后，我使用以下精确配置启用了 Immich：</p> <div class="highlight"><pre tabindex="0" style="background-color:#f0f0f0;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-nix" data-lang="nix"><span style="display:flex;"><span>services<span style="color:#666">.</span>immich <span style="color:#666">=</span> { </span></span><span style="display:flex;"><span> enable <span style="color:#666">=</span> <span style="color:#60add5">true</span>; </span></span><span style="display:flex;"><span>}; </span></span></code></pre></div><p>此时，Immich 仅在 <code>localhost</code> 上可用，但无法通过网络访问，因为 NixOS 默认启用了防火墙。我可以启用 <code>services.immich.openFirewall</code> 选项，但实际上我希望 Immich 仅通过我的 Tailscale VPN 可用，因此无需开放防火墙访问——相反，我使用 <code>tailscale serve</code> 将流量转发到 <code>localhost:2283</code>：</p> <pre tabindex="0"><code>photos# tailscale serve --bg http://localhost:2283 </code></pre><p>由于我已启用 <a href="https://tailscale.com/kb/1081/magicdns">Tailscale 的 MagicDNS</a> 和 <a href="https://tailscale.com/kb/1153/enabling-https">TLS 证书自动配置</a>，现在我可以在 PC、笔记本电脑或手机的浏览器中打开 <a href="https://photos.example.ts.net">https://photos.example.ts.net</a>。</p> <h2 id="step-2-initial-photos-import">第二步：初始照片导入</h2> <p>起初，我尝试使用官方 Immich CLI 导入照片：</p> <pre tabindex="0"><code>% nix run nixpkgs#immich-cli -- login https://photos.example.ts.net secret % nix run nixpkgs#immich-cli -- upload --recursive /home/michael/lib/photo/gphotos-takeout </code></pre><p>遗憾的是，上传过程并不稳定，在遇到超时后需要手动重新启动几次。后来我意识到这是因为 Immich 服务器正在运行后台任务（如缩略图创建、元数据提取或人脸检测），这些后台任务会拖慢上传速度，以至于上传可能因超时而失败。</p> <p>另一个问题是，即使上传完成，我发现 Google Takeout 的 Google Photos 存档会在原始图片文件旁边包含单独的 JSON 元数据文件：</p> <a href="https://michael.stapelberg.ch/posts/2025-11-29-self-hosting-photos-with-immich/2025-11-19-google-photos-takeout.jpg"><img srcset="https://michael.stapelberg.ch/posts/2025-11-29-self-hosting-photos-with-immich/2025-11-19-google-photos-takeout_hu_c2ca8fd1cf90122a.jpg 2x,https://michael.stapelberg.ch/posts/2025-11-29-self-hosting-photos-with-immich/2025-11-19-google-photos-takeout_hu_7169d5fe6b33d18d.jpg 3x" src="https://michael.stapelberg.ch/posts/2025-11-29-self-hosting-photos-with-immich/2025-11-19-google-photos-takeout_hu_8ac7b224e95d405d.jpg" alt="Takeout：Google Photos 格式" title="Takeout：Google Photos 格式" width="600" height="720" style=" border: 1px solid #000; " loading="lazy"></a> <p>不幸的是，<code>immich-cli</code> 并没有考虑这些文件。</p> <p>幸运的是，有一个很棒的第三方工具叫 <a