如何用Distant操作Docker容器文件读写、命令执行与隧道一站搞定【免费下载链接】distant (Alpha stage software) Library and tooling that supports remote filesystem and process operations. 项目地址: https://gitcode.com/gh_mirrors/di/distantDistant 是一款基于 Rust 的开源远程文件系统与进程操作工具库。借助内置的 Docker 插件Distant 可以直接连接并操作 Docker 容器容器内文件读写、命令执行、端口隧道一站搞定——无需登录容器内部也无需在容器里安装任何守护进程。下面从原理到实战带你 5 分钟上手 Distant 操作 Docker 容器。为什么 Distant 能直接管理 Docker 容器Distant 采用「一个协议、多种后端」的设计。Docker 能力由独立的插件模块 distant-docker 提供它注册了docker插件名并处理docker://协议的目的地地址核心实现在 DockerPlugin。它的工作原理非常轻量直连 Docker 守护进程通过 bollard 客户端连接docker.sock自动探测DOCKER_HOST与 Docker Desktop 套接字不往容器里塞任何东西文件读写走 tar 归档 API读文件、写文件直接调用容器的归档接口见 api.rs 中的 tar 读文件调用比cat/echo更稳定高效命令执行走容器 exec进程、目录操作、搜索都通过 Docker exec 完成内存内传输管理器进程内直接挂起一个内存服务端不占用容器端口 因此只要你的机器能访问 Docker 守护进程就能操作任意已运行的 Unix 容器Linux/macOS/Windows 宿主均可容器须为 Unix 系统。快速上手3 步完成准备第 1 步安装 DistantDocker 功能默认开启见 Cargo.toml 的 default features# Unix curl -L https://sh.distant.dev | sh # 或从源码构建 git clone https://gitcode.com/gh_mirrors/di/distant cargo build --release第 2 步确认 Docker 守护进程正在运行docker ps第 3 步连接你的第一个容器# 连接一个正在运行的容器 distant connect docker://my-container成功连接后后续命令默认作用于该连接无需反复指定容器。场景一连接已有容器或一键拉起新容器Distant 对 Docker 有两种操作模式模式命令行为连接distant connect docker://my-container附加到已运行的容器名称或 ID 均可拉起distant launch docker://ubuntu:22.04本地没有该镜像会自动拉取创建sleep infinity常驻容器并连入拉起模式下有个贴心的细节容器默认开启auto_remove当你断开连接后Distant 会自动停止并删除这个临时容器清理逻辑见 lib.rs不会留下垃圾容器。常用连接选项通过选项可以精细控制 Docker 连接行为解析逻辑见 plugin.rs选项说明docker_host指定远程 Docker 守护进程地址如unix:///var/run/docker.sock不填则自动探测user指定 exec 命令运行的用户覆盖容器默认值working_dir默认工作目录相对路径都基于它解析shell覆盖自动探测的 shell场景二容器文件读写fs 命令连接后容器文件系统就像本地目录一样操作。文件读写底层走 Docker 的tar 归档 API写入失败时还有 exec 兜底可靠性不错# 读取容器内文件 distant fs read /etc/os-release # 写入文件 / 复制文件 / 建目录 distant fs write /tmp/hello.txt distant fs copy /src /dst distant fs make_dir /tmp/newdir -a # 查看元数据、检查存在性 distant fs metadata /var distant fs exists /app/config.yml # 重命名、删除、修改权限 distant fs rename /tmp/a /tmp/b distant fs remove /tmp/a distant fs set_permissions /tmp/hello.txt 644 # 容器内文件搜索自动探测 rg / grep / find distant fs search *.rs /app 搜索是「尽力而为」的Distant 连接时会自动探测容器里有哪些搜索工具探测逻辑在 api.rs没有rg就降级用grep或find。场景三命令执行与交互式 shell通过容器 exec 在容器里跑命令就像 SSH 一样自然# 执行一次性命令 distant spawn -- ls -la /var/log # 打开交互式 shellPTY支持终端 resize distant shell # 杀掉之前 spawn 的进程 distant kill 进程IDDistant 对每个进程做了完整跟踪stdin 写入、stdout/stderr 流式回传、PTY 尺寸调整、优雅终止都有对应通道实现见 process.rs。跑top、vim这类交互程序也没有问题。场景四端口隧道直接访问容器里的服务容器里起了 MySQL、Redis 或调试端口但没做端口映射用 Distant 的正向隧道打通# 本地 3307 - 容器内 127.0.0.1:3306 distant tunnel open 3307:127.0.0.1:3306之后本地程序连接127.0.0.1:3307流量就会被转发进容器。⚠️ 两个限制需要知道说明见 PROTOCOL.md正向隧道需要容器内装有socat 或 ncnetcat之一Distant 会自动探测并选择反向隧道不受支持——Docker exec 只有单一 stdin/stdout 通道无法复用多个入站连接功能支持一览来自官方协议文档docs/PROTOCOL.md的支持矩阵功能Distant Docker 后端文件读写✅ 支持目录操作增删改查✅ 支持路径操作exists/metadata 等✅ 支持文件搜索✅ 尽力而为取决于容器内工具进程创建 / kill✅ 支持含 PTY正向隧道✅ 尽力而为需 socat/nc反向隧道❌ 不支持文件监听watch❌ 容器内无可靠文件系统事件机制系统信息✅ 支持常见问题 FAQQ1提示Container xxx is not runningDistant 连接前会校验容器状态容器没启动时直接报ConnectionRefused见 lib.rs。先docker start xxx再连接或直接用distant launch从镜像拉起。Q2搜索时报「No search tools available」容器里没有rg/grep/find任一工具。换一个带标准 POSIX 工具的镜像如ubuntu即可。Q3隧道打不通检查容器里是否装了socat或ncdistant connect时 Distant 会探测并在版本能力里如实声明。Q4Windows 容器支持吗目前仅支持 Unix 容器。宿主机的 Docker Desktop含 Windows/macOS没问题。核心代码导航想深入 Distant 的 Docker 实现可以从这些入口读起Docker 插件入口docker://协议解析distant-docker/src/plugin.rs连接与拉起容器distant-docker/src/lib.rsDocker API 实现tar 文件 I/O execdistant-docker/src/api.rs容器进程管理PTY/killdistant-docker/src/process.rs协议与后端能力矩阵docs/PROTOCOL.md插件规范如何自写插件docs/PLUGINS.md总结Distant 把「操作 Docker 容器」这件事压缩成了三类直觉命令connect/launch管连接fs管文件spawn/shell/tunnel管进程与网络。不用进容器、不用装代理、不用配端口映射——一条docker://地址搞定全部。如果你经常在容器里折腾文件、调试服务值得装一个试试 【免费下载链接】distant (Alpha stage software) Library and tooling that supports remote filesystem and process operations. 项目地址: https://gitcode.com/gh_mirrors/di/distant创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考