immich-cli是Immich开源媒体管理方案的命令行工具,主要用于通过终端与Immich服务器交互,完成媒体文件的管理和操作。作为Immich生态的一部分,它和Web界面、移动应用形成互补,尤其适合需要高效处理或自动化管理媒体库的场景。
从功能上看,immich-cli支持多种核心操作:比如批量上传本地照片和视频到Immich服务器,可指定目标相册或添加标签;从服务器下载媒体文件到本地备份,支持按时间、相册或标签筛选;管理相册,包括创建新相册、删除旧相册,或修改现有相册的名称和描述;同步本地文件夹与服务器,自动检测新增或删除的文件并保持两边一致;还能配置服务器连接参数,像地址、端口、API密钥等,一次设置后后续操作无需重复输入验证信息。
实际使用中,它的优势很明显。比如用户有几百GB本地照片需要上传到Immich服务器,手动点击上传效率低,用immich-cli一条命令就能批量处理;服务器管理员可以写个简单脚本,配合系统定时任务(如cron),让工具定期同步新文件,省去手动操作;开发者测试Immich功能时,也能用它快速模拟上传、下载等用户行为,验证接口稳定性。
另外,作为命令行工具,它资源占用低,能在没有图形界面的服务器或终端环境流畅运行。加上Immich本身是开源项目,immich-cli也在持续更新,功能会跟着主项目扩展,比如后续可能增加标签批量管理、视频转码参数设置等功能。对熟悉终端操作的用户或需要自动化管理媒体库的场景来说,immich-cli算是个实用工具,让Immich的使用更灵活高效。
请登录使用轩辕镜像享受快速拉取体验,支持国内加速,速度提升50倍
docker pull ghcr.io/immich-app/immich-cli:latest来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429