Консольний клієнт для Linux

Консольний клієнт Яндекс.Диска для Linux дозволяє вам керувати файлами на Диску без використання віконного інтерфейсу або програм, що підтримують протокол WebDAV.

Переваги консольного клієнта порівняно з WebDAV-підключенням:

  • низькі вимоги до ресурсів системи;
  • вища швидкість читання і запису файлів;
  • вища швидкість синхронізації з сервером Диска;
  • відсутність необхідності постійного підключення для роботи з файлами.

Консольний клієнт може бути встановлений на таких операційних системах:

  • Ubuntu Linux 8.04 і вище;
  • Debian 5 і вище;
  • Fedora 9 і вище;
  • Red Hat Enterprise Linux 6 і вище;
  • CentOS 6 і вище.
  1. Встановлення клієнта
  2. Майстер початкового налаштування
  3. Робота з клієнтом
  4. Питання та відповіді
  5. GUI для консольного клієнта Linux

Встановлення клієнта

Щоб встановити клієнт автоматично, скористайтеся командою швидкого встановлення пакета.

Приклад швидкого встановлення пакета .deb
echo "deb http://repo.yandex.ru/yandex-disk/deb/ stable main" | sudo tee -a /etc/apt/sources.list.d/yandex.list > /dev/null && wget http://repo.yandex.ru/yandex-disk/YANDEX-DISK-KEY.GPG -O- | sudo apt-key add - && sudo apt-get update && sudo apt-get install -y yandex-disk

Щоб встановити клієнт вручну, завантажте потрібну версію пакета за відповідним посиланням нижче.

Формат пакета 32-bit 64-bit
.deb (Ubuntu, Debian) yandex-disk_latest_i386 yandex-disk_latest_amd64
.rpm (Fedora, Red Hat Enterprise Linux, CentOS) yandex-disk-latest.i386 yandex-disk-latest.x86_64
Увага: Завантажуючи програму, ви погоджуєтеся з умовами Ліцензійної угоди.
Приклад встановлення за допомогою менеджера пакетів dpkg
# dpkg -i yandex-disk_0.1.0.103_i386.deb
Примітка: Репозиторій автоматично встановлюється за адресою /etc/apt/sources.list.d/yandex.list
Приклад встановлення за допомогою менеджера пакетів rpm
# rpm -ivh yandex-disk-0.1.0.103-1.fedora.i386.rpm
Примітка: Репозиторій автоматично встановлюється за адресою /etc/yum.repos.d/yandex.repo

Ви також можете додати репозиторій з пакетом yandex-disk у список доступних репозиторіїв менеджера пакетів і встановити пакет за допомогою утиліти apt-get або yum.

Встановлення за допомогою apt-get
Увага: Збережіть копію файлу /etc/apt/sources.list.d/yandex.list перед внесенням у нього змін.
# echo "deb http://repo.yandex.ru/yandex-disk/deb/ stable main" >> /etc/apt/sources.list.d/yandex.list
# apt-get update
# apt-get install yandex-disk
Встановлення за допомогою yum
# nano /etc/yum.repos.d/yandex.repo
# rpm --import http://repo.yandex.ru/yandex-disk/YANDEX-DISK-KEY.GPG
# yum install yandex-disk

Вміст файлу yandex.repo:

[yandex]
name=Yandex
failovermethod=priority
baseurl=http://repo.yandex.ru/yandex-disk/rpm/stable/$basearch/
enabled=1
metadata_expire=1d
gpgcheck=1
gpgkey=http://repo.yandex.ru/yandex-disk/YANDEX-DISK-KEY.GPG

Для перевірки цифрового підпису пакета може знадобитися імпортувати в систему відкритий GPG-ключ.

Імпорт GPG-ключа для пакета .deb
wget -O YANDEX-DISK-KEY.GPG http://repo.yandex.ru/yandex-disk/YANDEX-DISK-KEY.GPG
sudo apt-key add YANDEX-DISK-KEY.GPG
Імпорт GPG-ключа для пакета .rpm
sudo rpm --import http://repo.yandex.ru/yandex-disk/YANDEX-DISK-KEY.GPG

Майстер початкового налаштування

Ви можете виконати початкове налаштування клієнта за допомогою команди setup.

$ yandex-disk setup
  1. Введіть назву каталогу для зберігання локальної копії Диска. Якщо ви залишите назву пустою, у домашньому каталозі буде створено папку Yandex.Disk.
  2. Зазначте, чи використовувати проксі-сервер (y/n).
  3. Зазначте, чи запускати клієнт під час старту системи (y/n).
  4. Введіть ім'я користувача на Яндексі.
  5. Введіть пароль на Яндексі.
    Увага: Якщо ви використовуєте двофакторну аутентифікацію, для авторизації у програмі "Яндекс.Диск" потрібен одноразовий пароль, згенерований програмою "Яндекс.Ключ".

Після того, як майстер завершить роботу, у каталозі ~/.config/yandex-disk буде створено файл конфігурації config.cfg.

Робота з клієнтом

  1. Команди
  2. Додаткові параметри [OPTION]
  3. Приклади використання команд
  4. Приклад файлу config.cfg

Команди

Для роботи з клієнтом використовуються такі команди:

  • token — отримати ключ авторизації (OAuth-токен) для вашого логіна на Яндексі (USERNAME). Під час введення команди ви можете зазначити ваш пароль на Яндексі (PASSWORD) і задати ім'я файлу для зберігання токена і шлях до нього (FILE). Якщо додаткові параметри не буде зазначено, для зберігання токена буде створено файл passwd у каталозі ~/.config/yandex-disk.
    $ yandex-disk token [-p, --password=PASSWORD] [OPTION] USERNAME [FILE]
  • start — запустити демон і синхронізувати всі папки, крім зазначених у списку винятків exclude-dirs.
    $ yandex-disk start [OPTION]
  • status — відобразити статус роботи демона (стан синхронізації, помилки синхронізації, список синхронізованих файлів, загальний і вільний простір на Диску).
    $ yandex-disk status [OPTION]
  • stop — зупинити роботу демона.
    $ yandex-disk stop [OPTION]
  • sync — синхронізувати всі папки, крім зазначених у списку винятків exclude-dirs.
    $ yandex-disk sync [OPTION]
  • publish — отримати публічне посилання на зазначений файл або папку (FILE).
    $ yandex-disk publish [OPTION] FILE
  • unpublish — скасувати публікацію для зазначеного файлу або папки (FILE).
    $ yandex-disk unpublish FILE

Додаткові параметри [OPTION]

--config=FILE, -c FILE

Зазначити файл конфігурації. За замовчуванням використовується файл config.cfg у каталозі ~/.config/yandex-disk.

--dir=DIR, -d DIR

Зазначити каталог для зберігання локальної копії Диска. Якщо його назву не було задано під час виконання початкового налаштування, за замовчуванням використовуватиметься каталог ~/Yandex.Disk.

--auth=FILE, -a FILE

Зазначити файл із даними авторизації. За замовчуванням використовується файл passwd, який створюється за допомогою команди token або майстра початкового налаштування і зберігається в каталозі ~/.config/yandex-disk.

--exclude-dirs=DIR1,DIR2,...

Не синхронізувати зазначені каталоги. Щоб налаштування діяло завжди, каталоги потрібно додати в список винятківexclude-dirs у файлі config.cfg. Щоб налаштування діяло коректно, назви директорій, що виключаються, треба перераховувати через кому, без пропусків.

--read-only

Заборонити змінювати файли на сервері Диска і виконати синхронізацію тільки в локальній копії. При виникненні конфліктів синхронізації локальні файли буде перейменовано. Якщо додатково зазначено параметр --overwrite, локальні файли буде перезаписано.

--overwrite

Під час синхронізації із сервером дозволити перезаписувати зміни, зроблені в локальній копії Диска. Використовується разом із параметром --read-only.

--no-daemon, -D

Запустити демон без повернення керування в консоль. Щоб повернути керування, демон потрібно зупинити, запустивши в іншій консолі команду yandex-disk stop або закривши поточну консоль.

--help, -h

Вивести довідку.

--proxy=PARAM

Налаштувати проксі-сервер. Допустимі параметри:

  • auto — використовувати системні налаштування проксі-сервера (використовується за замовчуванням);
  • no — не використовувати проксі-сервер;
  • protocol,address,port,login,password — налаштувати вручну.

Приклади використання команд

$ yandex-disk start -c ~/ydconfig/newconfig.cfg # запустити демон і синхронізацію із зазначеним файлом конфігурації
$ yandex-disk start --exclude-dirs=Foto # не синхронізувати папку Foto
$ yandex-disk sync --read-only # синхронізувати папки в режимі read-only
$ yandex-disk publish Foto # отримати публічне посилання на папку Foto

Приклад файлу config.cfg

# Шлях до файлу з даними авторизації
auth="/home/user/ydconfig/my_passwd"

# Каталог для зберігання локальної копії Диска.
dir="/home/user/myDisk"

# Не синхронізувати зазначені каталоги.
#exclude-dirs="exclude/dir1,exclude/dir2,path/to/another/exclude/dir"

# Зазначити проксі-сервер. Приклади:
#proxy=https,127.0.0.1,80
#proxy=https,127.0.0.1,80,login,password
#proxy=https,127.0.0.1,443
#proxy=socks4,my.proxy.local,1080,login,password
#proxy=socks5,my.another.proxy.local,1081
#proxy=auto
#proxy=no

Питання та відповіді

Які можливості Диска доступні в консольному клієнті?

Під час роботи з консольним клієнтом вам доступні всі основні можливості Диска: синхронізація і публікація файлів та папок, вибіркова синхронізація папок.

Чи працює в консольному клієнті вибіркова синхронізація папок?

Так. Ви можете заборонити синхронізацію окремих папок, зазначивши їх під час введення команди (параметр --exclude-dirs=DIR1,DIR2,...) або додавши у список винятків exclude-dirs у файлі config.cfg.

Чи можна використати консольний клієнт для реплікації даних?

Так. Реплікація даних може бути реалізована за допомогою параметра --read-only.

GUI для консольного клієнта Linux

Ви можете працювати з консольним клієнтом за допомогою GUI від сторонніх розробників.

Назва Опис
YD-tools Утиліта підтримує майже всі основні функції консольного клієнта, крім вибіркової синхронізації. Додає у контекстне меню пункти, що відповідають за публікацію.
Ya-gui Утиліта дозволяє запустити демон у звичайному або розширеному режимі (з додатковими опціями). Додає в контекстне меню пункт, який відповідає за публікацію. У запущеному стані дозволяє відкрити або закрити доступ до файлів, зупинити демон, а також відображає інформацію про поточний статус демона.
Yandex.Disk ServiceMenu Дозволяє отримати швидкий доступ до сервісу Яндекс.Диск: скопіювати публічне посилання на файл або папку у буфер обміну, зберегти файл у вашу папку Яндекс.Диска.
Віджет Magic Folder Дозволяє отримати посилання на публікацію.

Якщо ви знаєте про інші GUI для консольного клієнта та їх немає на цій сторінці, будь ласка, повідомте нам про це.

Також ви можете працювати з Диском через WebDAV.