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-Go 提供了一种替代 Immich-CLI 命令的方式，不需要依赖 NodeJS 安装，使得安装和使用更加简单。

2. 项目使用的关键技术和框架

Immich-Go 项目主要使用了以下关键技术和框架：

• Go 语言：作为项目的核心编程语言，Go 提供了高效的并发处理能力和简洁的语法。
• Immich API：项目通过 Immich API 与 Immich 服务器进行通信，实现照片的上传和管理。
• 命令行工具：Immich-Go 是一个命令行工具，用户可以通过终端窗口运行该工具。
• 配置文件管理：项目支持通过配置文件管理服务器地址和 API 密钥，简化后续操作。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装和配置 Immich-Go 之前，请确保您的系统满足以下要求：

• 操作系统：支持 Linux、macOS 和 Windows 系统。
• Go 语言环境：确保您的系统上已经安装了 Go 语言环境。如果没有安装，请访问 Go 官方网站 下载并安装。
• Immich 服务器：确保您已经有一个运行中的 Immich 服务器，并且知道服务器的 URL 和 API 密钥。

详细安装步骤

步骤 1：下载项目源码

首先，从 GitHub 下载 Immich-Go 项目的源码：

git clone https://github.com/simulot/immich-go.git

步骤 2：进入项目目录

进入下载的项目目录：

cd immich-go

步骤 3：安装依赖

使用 Go 语言的包管理工具 go mod 安装项目依赖：

go mod download

步骤 4：编译项目

编译项目以生成可执行文件：

go build -o immich-go

步骤 5：配置文件设置

在项目目录中创建一个配置文件 immich-go.json，并填写以下内容：

{
  "server": "http://your-immich-server-url:2283",
  "api": "http://your-immich-api-endpoint:3301",
  "key": "your-api-key"
}

将 your-immich-server-url 替换为您的 Immich 服务器地址，your-immich-api-endpoint 替换为 API 端点地址，your-api-key 替换为您的 API 密钥。

步骤 6：运行 Immich-Go

在终端中运行 Immich-Go 工具，并指定配置文件路径：

./immich-go -use-configuration=path/to/config/file

将 path/to/config/file 替换为您的配置文件路径。

步骤 7：上传照片

使用 upload 命令上传照片：

./immich-go upload -album="Your Album Name" /path/to/your/photos

将 Your Album Name 替换为您想要创建的相册名称，/path/to/your/photos 替换为您的照片路径。

总结

通过以上步骤，您已经成功安装并配置了 Immich-Go 项目，并可以开始上传照片到您的 Immich 服务器。希望这篇指南对您有所帮助！

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