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 cần thiết để tránh trình duyệt Chromium bị crash khi khởi động:
    • Cách 1 (Khuyên dùng - Cài đặt tự động cho mọi Linux):
        curl -fsSL https://traffic4seo.com/install-deps | sudo bash

      (Script tự động nhận diện Ubuntu 20/22/24, Debian 11/12, CentOS, RHEL, Rocky, AlmaLinux và cài đặt đúng các gói tương ứng).

    • Cách 2 (Cài đặt thủ công):
      • Ubuntu (20.04/22.04/24.04) / Debian (11/12):
          sudo apt-get update && sudo apt-get install -y unzip libnss3 libnspr4 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libx11-6 libxcb1 libxext6 fonts-liberation $(apt-cache show libasound2t64 >/dev/null 2>&1 && echo "libasound2t64 libcups2t64 libatk1.0-0t64 libatk-bridge2.0-0t64 libatspi2.0-0t64" || echo "libasound2 libcups2 libatk1.0-0 libatk-bridge2.0-0")
      • CentOS / RHEL / Rocky / AlmaLinux:
          sudo dnf install -y unzip nss nspr atk at-spi2-atk cups-libs libdrm libxkbcommon libXcomposite libXdamage libXfixes libXrandr mesa-libgbm alsa-lib pango cairo libX11-xcb libxcb libxshmfence liberation-fonts

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ũ)
--name -n Hostname Đặt tên tùy chỉnh cho phiên làm việc (mặc định là tên máy chủ / hostname)
--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ũ)
--memory 80 Ngưỡng % RAM tối đa cho phép hệ thống sử dụng (từ 1-99)
--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 tên máy tùy chỉnh VPS-US-01, 10 tab và sử dụng Proxy SOCKS5 qua Proxy Connection URI:

t4s-cli --name="VPS-US-01" --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"

Kết nối qua Proxy và Cơ chế tự động thử lại (Retry / Mã thoát 43)

Khi hệ thống sử dụng Proxy, các thao tác kết nối API đầu vào (Xác thực Token, Khởi tạo và Kích hoạt Instance) có thể bị nghẽn mạng chập chờn. CLI sẽ tự động thử lại (retry) sau mỗi 5 giây, tối đa 3 lần.

Nếu sau 3 lần thử lại vẫn thất bại do lỗi mạng/proxy:

  • CLI sẽ dừng lại và thoát với mã thoát 43.
  • Mã thoát 43 thông báo cho trình quản lý tiến trình (wrapper, PM2, systemd script, v.v.) tự động khởi động lại (restart) CLI để tiếp tục lặp lại quy trình kết nối.