Immich-Go 项目常见问题解决方案

Immich-Go 项目常见问题解决方案

immich-go An alternative to the immich-CLI command that doesn't depend on nodejs installation. It tries its best for importing google photos takeout archives. 项目地址: https://gitcode.com/gh_mirrors/im/immich-go

1. 项目基础介绍和主要编程语言

项目名称: Immich-Go
项目简介: Immich-Go 是一个开源工具，旨在简化将大量照片上传到自托管的 Immich 服务器的过程。它特别擅长处理从 Google Photos 下载的 Google Takeout 档案，同时保留如 GPS 位置、拍摄日期和相册信息等重要元数据。此外，Immich-Go 还支持从计算机文件夹、文件夹树和 ZIP 档案中直接上传照片。
主要编程语言: Go (Golang)

2. 新手在使用 Immich-Go 项目时需要特别注意的3个问题及详细解决步骤

问题1: 安装过程中遇到 NodeJS 依赖问题
解决步骤:

1. 确认系统环境: 确保你的系统中没有安装 NodeJS，因为 Immich-Go 不需要 NodeJS 依赖。
2. 下载安装包: 从项目的 GitHub 页面下载最新的二进制文件或源代码。
3. 解压并安装: 如果是二进制文件，直接解压并运行；如果是源代码，使用 Go 语言的 go build 命令进行编译。
4. 验证安装: 运行 immich-go --version 命令，确认安装成功。

问题2: 上传 Google Photos Takeout 档案时出现文件格式不兼容
解决步骤:

1. 检查文件格式: 确保 Google Photos Takeout 档案是以 ZIP 格式下载的。
2. 解压档案: 如果档案是 .tgz 格式，需要先解压成一个文件夹。
3. 指定文件路径: 使用 immich-go import 命令时，指定文件路径为 /path/to/your/files/takeout-*zip。
4. 导入选项: 使用 -google-photos 选项来确保正确处理 Google Photos 的元数据。

问题3: 上传过程中出现中断，如何恢复上传
解决步骤:

1. 检查中断原因: 首先检查网络连接或系统资源是否充足。
2. 重新启动上传: 使用相同的命令重新启动上传过程，Immich-Go 会自动跳过已上传的文件。
3. 监控进度: 使用 -verbose 选项来监控上传进度，确保所有文件都被正确处理。
4. 备份数据: 在重新上传之前，建议备份未上传完成的文件，以防数据丢失。

通过以上步骤，新手用户可以更好地理解和使用 Immich-Go 项目，避免常见问题的困扰。

immich-go An alternative to the immich-CLI command that doesn't depend on nodejs installation. It tries its best for importing google photos takeout archives. 项目地址: https://gitcode.com/gh_mirrors/im/immich-go