Immich-go工具使用指南：解决API认证401错误问题

概述

Immich-go是一个用于与Immich照片管理服务交互的命令行工具。在使用过程中，用户可能会遇到401未授权错误，这通常是由于API密钥配置不当导致的。本文将详细介绍如何正确获取和使用Immich API密钥，以及解决认证问题的完整流程。

常见问题分析

当使用immich-go工具时，如果收到401未授权错误，最常见的原因是使用了错误的API密钥类型。许多用户会误以为可以使用Portainer或其他管理工具的API密钥，但实际上需要的是Immich服务本身生成的专用API密钥。

正确获取API密钥的步骤

1. 登录Immich Web界面：首先需要访问Immich的Web管理界面
2. 进入设置页面：在界面中找到设置或用户配置区域
3. 生成API密钥：在相关设置选项中，可以创建新的API密钥
4. 复制并保存密钥：生成的密钥需要妥善保管，因为它将作为命令行工具的认证凭证

命令行工具的正确使用方式

获得正确的API密钥后，使用immich-go工具时应注意以下几点：

• 确保服务器地址正确无误
• 使用-key参数指定从Immich获取的API密钥
• 对于自签名证书的情况，可以使用-skip-verify-ssl参数
• 上传操作前可使用-dry-run参数进行测试运行

最佳实践建议

1. 密钥管理：API密钥应视为敏感信息，避免在公共场合展示
2. 测试运行：首次使用时建议先进行dry-run测试
3. 错误排查：如果仍遇到401错误，检查服务器日志获取更详细的错误信息
4. 版本兼容性：确保immich-go工具版本与Immich服务版本兼容

通过遵循以上指南，用户应该能够顺利解决401认证错误问题，并成功使用immich-go工具进行照片管理操作。