mizorewww/gdirect

选用指南

AI 根据 README 整理 · 2026/10/25 15:56:09

使用方式

通过命令行使用，支持浏览、上传、下载和挂载 Google Drive。

查看 README 依据

**First login:** download a Desktop OAuth client JSON using the [configuration guide](docs/configuration/README.md), then: ```sh gdirect login --client-secret ~/Downloads/client_secret.json gdirect browse ``` Working Google IPs are discovered automatically and stored in local SQLite. `gdirect scan` rescans; `gdirect scan --list` lists results. Downloads default to 8 connections. | Key | Browser action | | --- | --- | | `j/k`, `↑/↓` | Select | | Enter, `l/→` | Open folder | | `h/←`, Backspace | Parent folder | | `d` | Download; export Google documents as PDF |

| `+/-` | Download connections (1–16) | | `r` | Refresh | | `c` | Cancel, keeping partial data | | `q` | Quit | ```sh gdirect browse -o downloads -j 8 gdirect ls root --json gdirect download FILE_ID -o downloads/file.zip gdirect upload ./file.zip gdirect upload ./file.zip --parent FOLDER_ID --name backup.zip gdirect mount # ~/GoogleDrive; requires mount dependencies gdirect mount ~/MyDrive --read-only gdirect unmount # Windows foreground mount: Ctrl-C ```

部署要求

需要 Google 账户和浏览器进行首次授权；挂载功能需要 rclone 1.75.2+，Linux 还需 FUSE3，Windows 需 WinFsp。

查看 README 依据

# gdirect [中文](README.zh-CN.md) ## Installation **Version 0.1.1+ includes Google authentication. No gcloud CLI or separate Google SDK installation is required.** First-time users still need a Desktop OAuth client JSON: follow the [Google configuration guide](docs/configuration/README.md) after installation. | Use | Runtime dependencies | | --- | --- | | Browse, upload, download | gdirect and a Google account; a browser for initial authorization | | Mount on macOS | rclone 1.75.2+; built-in NFS, no FUSE driver | | Mount on Linux | rclone 1.75.2+, FUSE3 (`fusermount3`) |

| Mount on Windows | rclone 1.75.2+, WinFsp; foreground mode | Prebuilt binaries: macOS 15+ (Apple Silicon / Intel), Linux x86_64 with glibc 2.35+, Windows x86_64. Alpine/musl, older glibc and Linux ARM64 do not have a compatible prebuilt package. Homebrew (macOS / Linux): ```sh brew tap mizorewww/gdirect https://github.com/mizorewww/gdirect && brew install mizorewww/gdirect/gdirect rclone ``` Linux Homebrew users also need their distro's FUSE3 package for mounting. To upgrade: `brew update && brew upgrade gdirect`.

已知限制

预编译包仅支持 macOS 15+、Linux x86_64 (glibc 2.35+) 和 Windows x86_64，不支持 Alpine/musl、旧 glibc 和 Linux ARM64。

查看 README 依据

| Mount on Windows | rclone 1.75.2+, WinFsp; foreground mode | Prebuilt binaries: macOS 15+ (Apple Silicon / Intel), Linux x86_64 with glibc 2.35+, Windows x86_64. Alpine/musl, older glibc and Linux ARM64 do not have a compatible prebuilt package. Homebrew (macOS / Linux): ```sh brew tap mizorewww/gdirect https://github.com/mizorewww/gdirect && brew install mizorewww/gdirect/gdirect rclone ``` Linux Homebrew users also need their distro's FUSE3 package for mounting. To upgrade: `brew update && brew upgrade gdirect`.