Hướng dẫn sử dụng Traffic4SEO CLI

Traffic4SEO CLI là công cụ dòng lệnh mạnh mẽ giúp bạn thực thi các workflow SEO tự động trên máy chủ hoặc máy tính cá nhân mà không cần giao diện đồ họa.

Cài đặt nhanh

Linux

curl -fsSL https://traffic4seo.com/install-cli | bash

{warning} Yêu cầu chuẩn bị trên Linux:

  1. Hệ thống của bạn cần cài đặt sẵn công cụ unzip để giải nén trình duyệt.
  2. Trên máy chủ Linux không giao diện (VPS), bạn cần cài đặt các thư viện hệ thống dưới đây để tránh trình duyệt Chromium bị crash khi khởi động:
    • Ubuntu / Debian:
        sudo apt-get update && sudo apt-get install -y unzip libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxrandr2 libgbm1 libasound2 libpango-1.0-0 libcairo2 libx11-xcb1 libxcb-dri3-0 libxshmfence1
    • CentOS / RHEL / Rocky Linux:
        sudo dnf install -y unzip nss nspr atk at-spi2-atk cups-libs libdrm libxkbcommon libXcomposite libXdamage libXrandr mesa-libgbm alsa-lib pango cairo libX11-xcb libxcb libxshmfence

Windows (PowerShell)

irm https://traffic4seo.com/install-cli.ps1 | iex

Cách sử dụng cơ bản

Sau khi cài đặt, bạn chỉ cần gõ một lệnh duy nhất để bắt đầu:

t4s-cli

1. Đăng nhập (Lần đầu sử dụng)

Nếu đây là lần đầu bạn chạy CLI, hệ thống sẽ yêu cầu bạn nhập Access Token.

  1. Truy cập trang quản trị Traffic4SEO để lấy Token.
  2. Dán Token vào terminal khi được hỏi.
  3. Hệ thống sẽ ghi nhớ đăng nhập của bạn trong 30 ngày.

2. Tự động cài đặt trình duyệt

Trong lần chạy đầu tiên, nếu hệ thống chưa có sẵn trình duyệt phù hợp, CLI sẽ hỏi: "Bạn có muốn tải bản Bundled Chromium không? (y/n)" Bạn chỉ cần chọn y để hệ thống tự động tải và cấu hình mọi thứ.

Các tham số nâng cao (Options)

CLI hỗ trợ nhiều tham số để bạn tùy chỉnh phiên làm việc:

Tham số Viết tắt Mặc định Mô tả
--token -t Cung cấp Token ngay khi chạy (sẽ ghi đè token cũ)
--tabs 30 Số lượng trình duyệt chạy song song (tối đa 30)
--headless true false để hiện cửa sổ trình duyệt (nếu máy có GUI)
--no-monitor Tắt giao diện giám sát TUI để xem log thuần túy
--proxy -p Chuỗi Proxy Connection URI (ví dụ http://user:pass@host:port) (khuyên dùng)
--proxy-host -ph Cấu hình Proxy Hostname/IP (cũ)
--proxy-port -pp Cổng kết nối Proxy (cũ)
--proxy-type -pt http Loại proxy (http, https, socks5) (cũ)
--only-warmup Chỉ khởi tạo trình duyệt và cookie rồi thoát
--force -f Ép buộc cài đặt lại trình duyệt Chromium
--restart Tự động khởi động lại CLI sau số phút chỉ định (phải là số nguyên dương)

Ví dụ cấu hình nâng cao

Chạy CLI với 10 tab và sử dụng Proxy SOCKS5 qua Proxy Connection URI:

t4s-cli --tabs=10 --proxy="socks5://user:[email protected]:1080"

Chạy ngầm trên Linux (Background)

Để duy trì CLI hoạt động khi tắt terminal (trên VPS), bạn nên sử dụng Screen:

  1. Tạo phiên mới: screen -S t4s
  2. Chạy lệnh: t4s-cli
  3. Nhấn Ctrl + A rồi D để thoát ra.
  4. Quay lại xem bất cứ lúc nào: screen -r t4s

Gỡ cài đặt

Xóa thư mục cài đặt và cấu hình:

rm -rf ~/.t4s-cli
rm -rf ~/.config/t4s-cli

Khắc phục sự cố

Lỗi kẹt lock cập nhật (Stuck Update)

Nếu bạn gặp cảnh báo sau khi khởi động CLI:

[AutoUpdater] ERROR: Update process seems to be stuck or failed!
Timeout waiting for lock directory: versions/vX.Y.Z.lock

Lỗi này xảy ra khi một tiến trình cập nhật trước đó bị dừng đột ngột (crash hoặc bị kill) trước khi kịp hoàn thành giải nén và dọn dẹp file khóa.

Cách khắc phục:

Đảm bảo không còn tiến trình t4s-cli nào khác đang chạy, sau đó xóa thư mục lock thủ công:

Linux:

rm -rf ~/.t4s-cli/versions/*.lock

Windows (PowerShell):

Remove-Item -Path "$HOME\.t4s-cli\versions\*.lock" -Recurse -Force

Windows (CMD):

rmdir /s /q "%USERPROFILE%\.t4s-cli\versions\vX.Y.Z.lock"