mizorewww/gdirect

效率与系统工具

在终端里浏览、传输和挂载 Google Drive,并把 Drive 流量发往本地扫描出的 Google IP。

533
28
Rust
GPL-2.0
今天创建

如果你习惯在终端里处理文件,并且经常遇到大文件传输断线或线路不稳,这个项目值得试。gdirect 把 Google Drive 的浏览、下载、上传和挂载做成命令行工具,核心动作是先在本地扫描可用的 Google IP,而不是完全走系统默认路由。

解决什么问题

典型流程是:在 Drive 里找到一个大文件,开始下载,网络一抖就得重来或手动续传;平时列目录、下文件还要在浏览器和脚本之间倒腾。gdirect 把中间这一步换掉:运行 browse 进入终端文件浏览器,按 d 把文件加入下载队列,传输走它扫描并保留 24 小时的 Google IP。下载结束后会按 Drive 的 MD5 校验,已完成的文件也会通过校验和被识别出来。

有什么不同

它的机制是先扫描能连通的 Google IP,然后让 Drive API、下载和上传直接走这个 IP;登录和刷新 token 仍走系统网络。实际好处是下载可以多连接(最多 16 路),中断后重跑同一条命令就能从部分文件继续,不用自己拼接续传参数。mount 走的是另一条路:通过 rclone 挂载,同样走系统网络。代价是网络配置需要你长期维护:使用 TUN 模式的代理或 VPN 时,要把扫描出的 IP 设为直连并关闭 fake-ip,否则扫描不到结果。README 也说明改 TLS SNI 并不会跳过证书检查,所以这些 SNI 选项不是绕过网络策略的通用手段。

谁值得试

适合:想在终端里操作 Google Drive、需要可续传的多连接大文件下载,或者需要挂载 Drive,并且愿意调整代理规则的开发者或重度用户。不适合:希望一条命令完成登录、不想自己创建 Google Cloud OAuth 客户端的人;gdirect 明确不提供共享客户端。也不适合不愿花约 10 分钟做一次性 Google 配置,或者环境里装不上挂载依赖的人。如果你只需要在桌面文件管理器里用 Drive,这套终端和挂载流程反而会多出步骤。

使用条件与边界

平台覆盖比较具体:预编译包支持 macOS 15+(Apple Silicon 和 Intel)、glibc 2.35+ 的 Linux x86_64,以及 Windows x86_64;Alpine/musl、旧版 glibc 和 Linux ARM64 需要从源码构建,要求 Rust 1.91+、C++ 编译器、OpenSSL 3 等构建工具。登录和刷新 token 必须通过系统网络访问 Google,所以 Google 被封锁时这一步仍然需要代理或 VPN。挂载额外需要 rclone 1.75.2+,Linux 还要 FUSE3;Windows 需要 WinFsp,可能弹出管理员授权。它不是装完就一劳永逸:要维护扫描 IP 的代理规则,注意文档提到的登录 7 天过期,还要留意挂载的上传缓存——它尽量控制在 5 GiB 以下,但打开或未发送的文件可能让缓存超出。README 说卸载会保留未上传文件、下次挂载再传,但挂载和核心传输仍是两套需要分别照看的东西。

HotRepo 点评

HotRepo 目前只有一条记录:2026-10-25 在新项目榜(不是总榜或日榜)排第 14,共 367 个 star,这不是日增数据。只有一天观测、项目年龄 0 天,无法据此判断热度能否持续。上手前,建议对照 Google OAuth 配置指南 和 故障排查说明,重点确认你的代理方式和平台是否匹配,摩擦通常出在这里。

本文由 AI 根据项目 README 生成,更新于 2026年10月25日,以项目官方文档为准。