Консольний клієнт для 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-disk.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-disk.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-disk.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.

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

Команди

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

  • 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 Дозволяє отримати швидкий доступ до сервісу Яндекс.Диск: скопіювати публічне посилання на файл або папку в буфер обміну, зберегти файл у вашу папку Яндекс.Диска.

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

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