gdirect README

README проекта с github.com/mizorewww/gdirect. Одним файлом markdown: README.md.

gdirect

Release CI License

中文 · Changelog

Browse, download, upload and mount your Google Drive from networks where Google is blocked, without a proxy for the transfers themselves. gdirect finds Google front-end IPs that your network can still reach and sends Drive traffic straight to them, with multi-connection, resumable downloads.

The gdirect desktop client listing a Drive folder, with one file downloading and others queued

Download for Windows

Download for macOS (Apple silicon)

Download for macOS (Intel)

Download for Linux

Quick start

1. Install (macOS 15+, Linux x86_64 with glibc 2.35+, Windows x86_64)

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/mizorewww/gdirect/main/scripts/install.sh | bash
# or Homebrew (Homebrew 7 asks you to trust a tap before installing from it)
brew tap mizorewww/gdirect https://github.com/mizorewww/gdirect && brew trust mizorewww/gdirect
brew install mizorewww/gdirect/gdirect
# or Arch Linux (AUR)
paru -S gdirect-bin # or yay -S gdirect-bin (use gdirect-git to build from VCS)
# Windows PowerShell
& ([scriptblock]::Create((Invoke-RestMethod 'https://raw.githubusercontent.com/mizorewww/gdirect/main/scripts/install.ps1')))

Add --with-mount (PowerShell: -WithMount) to also install what mount needs. Archives for every platform are on the releases page.

2. Create your Google client — once, about 10 minutes: follow the Google setup guide to download a Desktop app OAuth client JSON.

3. Sign in — a browser opens; signing in needs normal access to Google, so keep a proxy on for this step if Google is blocked:

gdirect login --client-secret ~/Downloads/client_secret.json
# or, without the file: gdirect login --client-id ID   (asks for the secret)

4. Use it

gdirect                          # browse your Drive; press ? for keys, d to download, u to upload
gdirect download FILE_ID_OR_URL  # saves to ./downloads
gdirect upload ./photos -r       # upload a folder; run again to resume
gdirect mount                    # Drive at ~/GoogleDrive

The first transfer scans for reachable Google IPs, which can take about a minute.

[!IMPORTANT] Using a TUN-mode proxy or VPN (sing-box, Clash TUN…)? Nothing to set up: gdirect binds its Google connections to your network adapter, so the tunnel never carries them; sign-in still uses the proxy. Turn this off with gdirect scan --bypass-tun off or in the desktop client's Settings › Network. See Network and proxies.

Desktop app (preview)

The same engine in a Material 3 window: browse and manage files, drag files in to upload, watch the transfer queue, scan and pin endpoints, and switch accounts. It shares the command line's sign-in and settings, follows your system's language (English or Chinese), and adapts to narrow windows.

Transfers Routes Settings
Transfer queue with finished downloads Routes page with latencies Appearance settings

Download it with the buttons at the top, or from the releases page:

To build it yourself, see Building from source.

Documentation

License

GPL-2.0-or-later

gdirect (mizorewww/gdirect)

Ищем в базе…

Что это такое?gdirect — это инструмент командной строки на Rust, который позволяет просматривать, скачивать, загружать и монтировать ваш Google Диск прямо из терминала. Трафик к Диску идёт через проверенные IP-адреса Google, благодаря чему передача быстрая, с несколькими соединениями и возможностью продолжения после обрыва.
Это приложение с графическим интерфейсом или инструмент для терминала?Это CLI-инструмент для терминала с интерактивным текстовым интерфейсом в стиле файлового менеджера для просмотра и передачи файлов Диска; отдельного графического приложения не предусмотрено.
Как установить и начать работу?Установите готовый бинарный файл через установщик curl (macOS/Linux) или PowerShell (Windows) либо через Homebrew, затем выполните одноразовую настройку Google Cloud, чтобы создать собственный OAuth-клиент, и запустите gdirect login.
Нужны ли мне собственные учётные данные Google API?Да. gdirect не содержит общего клиента Google, поэтому перед входом нужно создать собственный OAuth-клиент в проекте Google Cloud (примерно 10 минут).
Смогу ли я получить доступ к Диску, если сам Google заблокирован?Через проверенные доступные IP-адреса Google проходит только трафик Drive API (просмотр, скачивание, загрузка). Вход в аккаунт и обновление токенов идут через обычную сеть, поэтому если Google заблокирован у вас, для одного только входа всё равно понадобятся прокси или VPN.
Для каких платформ есть готовые сборки?Готовые бинарные файлы есть для macOS 15+ (Apple Silicon или Intel), Linux x86_64 с glibc 2.35+ и Windows x86_64. Для Alpine/musl, более старых версий glibc и Linux ARM64 нужна сборка из исходников.
Где хранятся мои учётные данные и настройки?Учётные данные, проверенные IP-адреса и настройки находятся в одном приватном локальном файле SQLite (например, ~/.local/share/gdirect/state.sqlite3 в Linux) и никуда больше не отправляются.
Как gdirect находит рабочий маршрут к Google Диску?Он перебирает кандидатные IP-адреса Google, доступные из вашей сети, проверяет каждый с настоящим TLS SNI, а затем с подменённой идентичностью (g.cn в качестве имени TLS, настоящий хост в заголовке Host), и кэширует самый быстрый рабочий IP-адрес на 24 часа.
Как работает монтирование Google Диска как файловой системы?Монтирование использует rclone вместе со встроенным NFS-клиентом на macOS или FUSE3 на Linux (WinFsp в Windows). Запись сначала идёт в локальный кэш, а загрузка на диск выполняется в фоновом режиме.
Можно ли использовать gdirect в скриптах без интерактивного входа?Да. Переменная окружения GDIRECT_ACCESS_TOKEN может передать токен доступа вместо входа для большинства команд, however монтированию всё равно требуется gdirect login.
Как программа убеждается, что она действительно общается с Google?Сертификаты проверяются по собственным корневым сертификатам Google GTS, встроенным в бинарный файл, а не по системному набору сертификатов CA. Поэтому скомпрометированный сторонний центр сертификации не сможет выдать себя за Google перед gdirect.
Какие есть похожие проекты?MasterHttpRelayVPN-RUST, gping, zlib, aria2, mhr-cfw, sing-box, v2ray, shadowsocks-c
Автор
mizorewww
Размер
7.6 MB
Звёзды
824
Возраст
24 д
Коммиты · 90 дней