ne0ark/internxt-cli

Internxt-CLI Docker镜像文档

镜像概述

Internxt-CLI Docker镜像是Internxt云存储服务的官方命令行客户端容器化版本，旨在提供便捷、一致的方式通过命令行与Internxt云存储进行交互。该镜像封装了Internxt-CLI工具及其依赖环境，可在任何支持Docker的系统中运行，无需单独配置本地依赖，适用于自动化脚本、服务器环境或无图形界面场景下的云存储管理。

核心功能与特性

• 文件管理：支持文件上传、下载、删除、重命名及移动操作，兼容大文件分片传输。
• 文件夹操作：可创建、删除、列出文件夹内容，支持递归操作子目录。
• 账户认证：通过API密钥或***密码进行身份验证，支持会话持久化（通过挂载数据卷保存配置）。
• 批量处理：支持通配符匹配及批量文件/文件夹操作，提升效率。
• 跨平台一致性：基于Docker实现环境隔离，确保在Linux、macOS、Windows等系统中行为一致。
• 轻量级：镜像体积优化，基于Alpine Linux构建，减少资源占用。

使用场景

• 开发者自动化：集成到CI/CD流程中，实现构建产物自动上传至Internxt云存储。
• 服务器环境：在无图形界面的服务器中，通过命令行管理备份文件或资源文件。
• 脚本任务：编写Shell/Python等脚本，调用CLI执行定时文件同步、清理等操作。
• 多环境统一：在团队协作中，通过Docker镜像确保所有成员使用相同版本的CLI工具，避免版本差异问题。

使用方法

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 拥有Internxt账户（需提前注册并获取API密钥或登录凭证）

镜像拉取

通过Docker Hub拉取最新版本镜像：

bash
docker pull docker.xuanyuan.run/internxt/cli:latest

如需指定版本，可替换latest为具体版本号（如1.2.0），版本列表可参考https://github.com/internxt/cli%E3%80%82

基本使用流程

1. 容器运行与认证配置

首次使用需进行账户认证，支持两种方式：

方式一：通过命令行交互认证（推荐）

运行容器并进入交互式终端，执行login命令完成认证：

bash
docker run -it --rm --name internxt-cli docker.xuanyuan.run/internxt/cli:latest login

根据提示输入Internxt***和密码，或API密钥，认证信息将临时保存在容器内（退出后失效）。

方式二：通过环境变量非交互式认证

使用环境变量传递认证信息（适用于自动化场景）：

bash
docker run --rm -e INTERNXT_EMAIL="your@email.com" -e INTERNXT_PASSWORD="your-password" docker.xuanyuan.run/internxt/cli:latest whoami

注意：敏感信息建议通过Docker Secrets或外部配置文件挂载传递，避免直接暴露在命令行中。

2. 数据持久化（可选）

如需持久化认证信息及配置，可挂载本地目录至容器内CLI配置路径（通常为/root/.internxt）：

bash
docker run -it --rm -v $HOME/.internxt:/root/.internxt docker.xuanyuan.run/internxt/cli:latest

挂载后，认证状态及配置将保存在本地$HOME/.internxt目录，下次运行无需重复认证。

常用命令示例

列出远程目录内容

bash
docker run --rm -v $HOME/.internxt:/root/.internxt docker.xuanyuan.run/internxt/cli:latest ls /my-remote-folder

上传本地文件至远程目录

bash
docker run --rm -v $HOME/.internxt:/root/.internxt -v $(pwd):/data docker.xuanyuan.run/internxt/cli:latest upload /data/local-file.txt /remote-folder/

说明：通过-v $(pwd):/data挂载当前目录至容器内/data，实现本地文件访问。

下载远程文件至本地

bash
docker run --rm -v $HOME/.internxt:/root/.internxt -v $(pwd):/data docker.xuanyuan.run/internxt/cli:latest download /remote-folder/remote-file.txt /data/

创建远程文件夹

bash
docker run --rm -v $HOME/.internxt:/root/.internxt docker.xuanyuan.run/internxt/cli:latest mkdir /new-remote-folder

环境变量配置

Docker Compose示例

创建docker-compose.yml文件，简化容器管理：

yaml
version: '3'
services:
  internxt-cli:
    image: docker.xuanyuan.run/internxt/cli:latest
    volumes:
      - $HOME/.internxt:/root/.internxt  # 持久化配置
      - ./data:/data                     # 挂载本地数据目录
    environment:
      - INTERNXT_EMAIL=your@email.com
      - LOG_LEVEL=info
    # 可通过command指定默认执行命令
    # command: ls /my-remote-folder

启动服务并执行命令：

bash
docker-compose run --rm internxt-cli upload /data/local-file.txt /remote-folder/

注意事项

• 敏感操作（如删除文件）需谨慎，建议先通过ls命令确认路径。
• 大文件上传下载建议配置网络超时参数（通过--timeout选项或环境变量）。
• 镜像版本需与Internxt API兼容，推荐使用最新稳定版。
• 如需自定义配置，可通过挂载配置文件（如/root/.internxt/config.json）实现。

参考链接

• Internxt官方网站
• https://github.com/internxt/cli
• https://docs.docker.com/