Tài liệu aktar CLI

aktar upload

Tải lên một hoặc nhiều tệp và in ra mỗi tệp một liên kết, theo đúng thứ tự, ngay khi từng tệp xong.

Cách dùng

$ aktar upload <file>... [options]

Tùy chọn

Cần biết

• Mọi tệp đều được kiểm tra trước khi tải lên bất cứ thứ gì: nếu một tệp không tồn tại, không tệp nào được tải lên và aktar thoát với mã 2.
• Nếu một lượt tải lên thất bại, các tệp khác vẫn được tải lên. Mỗi lỗi được báo trên stderr, và mã thoát là 1.
• Không có --folder, mẫu đường dẫn của đích sẽ đặt tên tệp, giống như khi thả tệp lên thanh menu. Có --folder, tệp giữ nguyên tên bên trong thư mục đó.
• --name chỉ dùng với một tệp mỗi lần. Dấu gạch chéo bị xóa, và phần mở rộng của tệp được thêm vào nếu tên không có: --name cover tải IMG_4021.jpg lên thành cover.jpg. Với --folder, đó là tên bên trong thư mục.
• --expires nhận 1, 7, 14 hoặc 30 (ngày), hoặc 0 để giữ tệp. Không có tùy chọn này, tệp được giữ lại, dù Xóa sau trong Aktar được đặt thế nào. Đích cần có quy tắc tự động xóa của Aktar, và không thể kết hợp với --folder.
• --qr không thể kết hợp với --json, và --png chỉ dùng được với aktar qr.
• Trong terminal, tiến trình hiển thị trên stderr khi tệp đang tải lên. Tệp được truyền dạng luồng đến Aktar, nên dung lượng không quan trọng, và không có giới hạn thời gian.

Ví dụ

$ aktar upload screenshot.png
https://files.example.com/2026/10/7f3c2a91.png

$ aktar upload *.png -f markdown
![](https://files.example.com/2026/10/1b9e44d0.png)
![](https://files.example.com/2026/10/c2f71a5e.png)

$ aktar upload IMG_4021.jpg --name cover --folder blog/2026
https://files.example.com/blog/2026/cover.jpg

$ aktar upload photo.jpg
aktar: photo.jpg: already uploaded, reused the existing link
https://files.example.com/2026/09/4d2a8c61.jpg

aktar upload --clipboard

Tải lên tệp hoặc hình ảnh đang có trong bộ nhớ tạm, giống phím tắt bộ nhớ tạm của chính Aktar.

Cách dùng

$ aktar upload --clipboard [options]

Tùy chọn

Cần biết

• Truyền tệp hoặc --clipboard, không truyền cả hai.
• --name và --folder chỉ dùng với tệp. -d, -f, --expires, --qr và --json hoạt động như với tệp.
• Với --json, lệnh vẫn in ra một mảng, có một phần tử.

Ví dụ

$ aktar upload --clipboard
https://files.example.com/2026/10/9a4c03be.png

$ aktar upload --clipboard -f markdown -d Blog
![](https://blog-assets.example.com/2026/10/e5b2c8a4.png)

$ aktar upload --clipboard --expires 1
https://files.example.com/tmp/1d/2026/10/38f0d7c2.png

aktar replace

Ghi một tệp mới đè lên một tệp đã tải lên, nên khóa và liên kết của nó giữ nguyên. Ai có liên kết cũng sẽ thấy tệp mới.

Cách dùng

$ aktar replace <upload-id|link|key> <file> [options]

Tùy chọn

Cần biết

• Đối số đầu tiên là ID tải lên hoặc liên kết từ aktar history (mục lịch sử trong Aktar được cập nhật), nếu không thì là một khóa trong bucket của -d (đích đang chọn trong Aktar khi bỏ trống). Liên kết không có trong lịch sử của Aktar sẽ bị từ chối: hãy truyền khóa của nó kèm -d.
• Aktar xóa siêu dữ liệu của tệp và đổi kích thước theo cài đặt của đích, nhưng không bao giờ chuyển sang định dạng khác, nên phần mở rộng của khóa giữ nguyên. Tệp trong tmp/{N}d/ bắt đầu đếm lại N ngày.
• Khóa không bao giờ bị đánh số và không có gì khác được tải lên. --folder, --expires, --name và --clipboard không áp dụng và sẽ bị từ chối.
• Bản cũ có thể còn trong bộ nhớ đệm của CDN một lúc. Thời gian bộ nhớ đệm ngắn của đích hoặc tính năng xóa bộ nhớ đệm Cloudflare trong Aktar sẽ xử lý việc đó.
• Cần Aktar cho Mac 0.14.0 hoặc Aktar cho Windows 0.7.0 trở lên.

Ví dụ

$ aktar replace 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 report-v2.pdf
https://files.example.com/2026/09/0e7d51b3.pdf

$ aktar replace docs/guide.pdf guide.pdf -d Blog -f markdown
[guide.pdf](https://blog-assets.example.com/docs/guide.pdf)

aktar qr

Hiển thị mã QR của một liên kết hoặc văn bản bất kỳ trong terminal, để bạn mở trên điện thoại. Khi nhận ID tải lên, lệnh hiển thị liên kết của tệp đó cùng mã QR.

Cách dùng

$ aktar qr <link|text|upload-id> [--png <file>]

Tùy chọn

Cần biết

• Truyền đúng một đối số, và đặt văn bản có dấu cách trong dấu ngoặc kép.
• ID tải lên là id từ aktar history --json hoặc aktar upload --json. aktar tìm nó trong 1.000 lượt tải lên gần nhất trong lịch sử của Aktar; với văn bản thường hoặc liên kết, nó không cần Aktar.
• Mã được vẽ màu đen trên nền trắng trong terminal, bất kể giao diện của terminal. Khi đầu ra không phải terminal, hoặc khi NO_COLOR được đặt, mã được vẽ không màu.
• --png lưu mã QR thành tệp PNG thay vì in ra.

Ví dụ

$ aktar qr https://files.example.com/2026/10/demo.mp4

$ aktar qr 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 --png cover-qr.png
Saved to cover-qr.png

aktar login

Kiểm tra token với Aktar rồi lưu lại, để các lệnh khác có thể kết nối.

Cách dùng

$ aktar login [--token <token>] [--port <port>]

Tùy chọn

Cần biết

• Trong terminal, lệnh hỏi token và ẩn những gì bạn gõ. Khi đầu vào được truyền qua pipe, lệnh đọc token từ đó.
• --token bỏ qua lời nhắc, nhưng token sẽ nằm trong lịch sử shell của bạn. Truyền qua pipe hoặc dùng AKTAR_TOKEN sẽ tránh được điều đó.
• Token bị Aktar từ chối sẽ không được lưu, và mã thoát là 3.

Ví dụ

$ aktar login
Copy the token from Aktar: Settings > Integrations (turn on Allow local connections first).
Token:
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

$ pbpaste | aktar login
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

$ aktar login --token "$AKTAR_SECRET" --port 47920
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

aktar logout

Xóa token và cổng đã lưu.

Cách dùng

$ aktar logout

Tùy chọn

Không có tùy chọn.

Cần biết

• AKTAR_TOKEN, nếu được đặt, vẫn hoạt động sau aktar logout.
• Lệnh không ngắt kết nối các client khác. Để làm vậy, hãy tạo lại token trong Aktar.

Ví dụ

$ aktar logout
Logged out.

$ aktar status
aktar: Not connected to Aktar yet. Run aktar login with the token from Aktar's Settings > Integrations.

aktar status

Cho biết bạn đang kết nối với Aktar nào, trên cổng nào, đích đang chọn trong Aktar, và tệp cấu hình nằm ở đâu.

Cách dùng

$ aktar status [--json]

Tùy chọn

Cần biết

• Cách nhanh để kiểm tra kết nối trong script: lệnh thoát với mã 3 khi không liên lạc được với Aktar hoặc token sai.

Ví dụ

$ aktar status
Aktar 0.10.0 (build 28) on port 47913
Destination: Screenshots (Cloudflare R2, screenshots)
Config: /Users/you/.config/aktar/cli.json

$ aktar status --json
{
  "app": "Aktar",
  "version": "0.10.0",
  "build": "28",
  "apiVersion": 1,
  "defaultDestinationId": "5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47",
  "outputFormat": "url",
  "port": 47913
}

aktar destinations

Liệt kê các đích cùng nhà cung cấp, bucket và ID. * đánh dấu đích đang chọn trong Aktar.

Cách dùng

$ aktar destinations [--json]

Tùy chọn

Cần biết

• Dùng tên hoặc ID với -d. Tên được so khớp không phân biệt chữ hoa chữ thường; ID luôn dùng được, kể cả sau khi đổi tên.
• --json trả về id, name, provider, providerName, bucket, publicBaseURL và isDefault cho từng đích.

Ví dụ

$ aktar destinations
* Screenshots  Cloudflare R2  screenshots  5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47
  Builds  Amazon S3  acme-builds  A83F2C10-6D4B-4F7E-9C1A-2B5E8D0F3C66
  Blog  Backblaze B2  blog-assets  E2C7B9A4-1F3D-4A8E-B6C0-9D5F2A7E4B13

$ aktar destinations --json | jq -r '.[] | select(.isDefault) | .name'
Screenshots

aktar history

Liệt kê các tệp tải lên gần đây, mới nhất trước: ngày, tên tệp và liên kết. Các từ sau history dùng để tìm trong lịch sử.

Cách dùng

$ aktar history [search] [options]

Tùy chọn

Cần biết

• Lệnh liệt kê 20 tệp tải lên, trừ khi bạn truyền -n.
• --json trả về cùng các trường như aktar upload --json, gồm cả id của từng tệp để dùng với aktar qr.

Ví dụ

$ aktar history -n 3
2026-10-01  screenshot.png  https://files.example.com/2026/10/7f3c2a91.png
2026-10-01  cover.jpg  https://files.example.com/blog/2026/cover.jpg
2026-09-30  invoice-september.pdf  https://files.example.com/2026/09/0e7d51b3.pdf

$ aktar history invoice -d Screenshots
2026-09-30  invoice-september.pdf  https://files.example.com/2026/09/0e7d51b3.pdf
2026-08-29  invoice-august.pdf  https://files.example.com/2026/08/a6c94f20.pdf

$ aktar history -d Builds -n 1 --json | jq -r '.[0].url'
https://acme-builds.s3.amazonaws.com/2026/10/app-3f9c2e1.zip

Tùy chọn cho mọi lệnh