Aktar
RU
СкачатьСкачать

Командная строка

Загрузка из терминала с aktar

Одна команда, одна ссылка: aktar upload report.pdf отправляет файл в ваш бакет через приложение Aktar и выводит его URL, Markdown или полный JSON. Создано для скриптов, CI-задач и редакторов вроде Typora.

Через npm
npm install -g @getaktar/cli
Через Homebrew
brew install getaktar/tap/aktar-cli

Или попробуйте без установки: npx @getaktar/cli upload file.png

Читать документацию @getaktar/cli getaktar/cliv0.3.0

aktar upload в терминале выводит ссылки, изображение в Markdown и JSON

Команды

  • aktar upload <file>…

    Загружает один или несколько файлов и выводит по ссылке на каждый файл, по мере завершения.

  • --format markdown

    Выводит Markdown, HTML или ваш собственный шаблон из Aktar вместо простого URL.

  • --json

    Выводит все в формате JSON: URL, все форматы, ключ объекта, размер и время, когда файл будет удален.

  • -d --folder --expires

    Выбирает место назначения по имени, загружает в папку или поручает бакету удалить файл через 1, 7, 14 или 30 дней.

  • --clipboard

    Загружает файл или изображение из буфера обмена.

  • --name cover

    Загружает один файл под другим именем, которое используют шаблон пути места назначения и история Aktar.

  • --qr aktar qr

    Выводит под каждой ссылкой QR-код, чтобы открыть ее на телефоне. aktar qr показывает код для любой ссылки или для загрузки из истории.

  • "reused": true

    Если такой же файл уже есть в бакете, Aktar возвращает его ссылку вместо повторной загрузки, а aktar сообщает об этом в stderr.

  • aktar replace

    Записывает новый файл поверх загрузки и сохраняет ее ссылку, по ID загрузки, ссылке или ключу. Нужен Aktar для Mac 0.14.0 или для Windows 0.7.0.

  • aktar login

    Сохраняет токен из настроек Aktar, предварительно проверив, что он работает.

  • status destinations history

    Показывает подключение, ваши места назначения и историю загрузок с поиском.

Все команды, параметры и примеры в документации

Настройка за минуту

  1. В Aktar для Mac или Windows откройте Настройки > Интеграции и включите Разрешить локальные подключения.
  2. Скопируйте показанный там токен.
  3. Выполните aktar login и вставьте его. Готово: теперь aktar upload использует место назначения, выбранное в Aktar.

Изображения Typora в вашем бакете

Назначьте aktar собственным загрузчиком изображений в Typora, и каждое изображение, вставленное в документ, будет загружаться в ваш бакет, а ссылка сразу попадет в Markdown.

Настроить Typora

Создано для скриптов

Ссылки выводятся в стандартный вывод, по одной на строку, а все остальное в стандартный поток ошибок, поэтому URL=$(aktar upload build.zip) просто работает. --json дает все подробности, а код выхода сообщает, что произошло. В CI задайте AKTAR_TOKEN вместо входа.

Код выхода
0Все загружено
1Как минимум одна загрузка не удалась, остальные прошли
2Неверные аргументы или файл не найден, ничего не загружено
3Aktar недоступен или токен неверный

Ваши ключи остаются в Aktar

CLI никогда не видит учетные данные вашего хранилища. Он отправляет файлы приложению Aktar на 127.0.0.1, а оно загружает их с ключами из Связки ключей или Диспетчера учетных данных.

Локальный API Aktar выключен, пока вы его не включите, никогда не принимает подключения с других компьютеров, и каждый запрос требует вашего токена. CLI хранит токен в файле, который можете прочитать только вы.

Требования

  • Aktar для Mac 0.4.0 или новее либо Aktar для Windows, хотя бы с одним местом назначения
  • Node.js 18 или новее (Homebrew установит его за вас)
  • Повторное использование ссылок на уже загруженные файлы: Aktar для Mac 0.10.0 или Aktar для Windows 0.3.0
  • aktar replace: aktar 0.3.0 и Aktar для Mac 0.14.0 или для Windows 0.7.0
  • Открытый исходный код (MIT) на GitHub

Вопросы

Работает ли CLI без приложения Aktar?

Нет. Это пульт управления приложением: Aktar хранит ключи хранилища и выполняет загрузку, поэтому он должен быть запущен с включенным параметром «Разрешить локальные подключения». Именно поэтому CLI никогда не нужны ваши ключи доступа.

Можно ли использовать его в CI или на сервере?

Только там, где работает Aktar, так как CLI общается с ним на том же компьютере. Для агента сборки на Mac или Windows это отлично подходит, а на Linux-сервере используйте собственный CLI вашего провайдера.

Какие хранилища поддерживаются?

Все, что поддерживает Aktar: Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, MinIO и любой S3-совместимый сервис. См. руководства по настройке.

Где хранится токен?

В ~/.config/aktar/cli.json на Mac (%APPDATA%\aktar\cli.json в Windows), доступном для чтения только вашему пользователю. aktar logout удаляет его, а создание нового токена в Aktar отключает всех клиентов.