🧰 gofile-tool

Tải / upload Gofile.io ở tốc độ tối đa — tự động vượt chặn IP của datacenter/VPS.

Gofile hay drop kết nối TLS với IP máy ảo (báo error-rateLimit, treo TLS handshake). gofile-tool tự xử lý: thử đường thẳng → nếu bị chặn thì tự bật Tor, xoay IP, tạo tài khoản guest và ký đúng header X-Website-Token mà Gofile đòi. Dữ liệu lớn vẫn tải/upload thẳng qua store*.gofile.io / upload.gofile.io nên tốc độ nguyên bản.

pip install gofile-tool
gofile-tool download Uc4c9oyJ -o ./tai-ve

⚡ Cài đặt

pip install gofile-tool          # hoặc: pipx install gofile-tool

# chỉ cần khi IP của bạn bị Gofile chặn (tool tự bật Tor):
sudo apt install -y tor          # Debian/Ubuntu
brew install tor                 # macOS

Yêu cầu: Python ≥ 3.8.

🚀 Lệnh

gofile-tool info     <CODE>                  # xem metadata file/folder
gofile-tool download <CODE> -o ./tai-ve      # tải file hoặc cả folder
gofile-tool upload   ./file.zip              # up + tự set public + in link
gofile-tool public   <CODE>                  # mở public cho nội dung đã có
gofile-tool delete   <FILE_ID> --token <TK>  # xoá file
gofile-tool stop-tor                         # tắt Tor

Ví dụ JSON (gofile-tool upload ./file.zip --json):

{
 "ok": true, "name": "file.zip", "size": 577188003, "md5": "912175…",
 "code": "UGqKJoFZ", "page": "https://gofile.io/d/nAF2ydFc",
 "file_id": "783e9f12-…", "speed_MBps": 83.0,
 "public": true, "link": "https://gofile.io/d/UGqKJoFZ",
 "_token": "Q23LICkojSBdNVgRjhbx7z72ZqVBldGw"
}

🤖 Dành cho AI agent

Không cần agent thông minh — chỉ cần bảo nó chạy:

pip install gofile-tool
gofile-tool download <CODE> -o <DIR> --json     # hoặc: gofile-tool upload <FILE> --json

Mọi lệnh đều có --json; output gồm link, md5, size, ok, _token. Tool tự lo: tài khoản, chữ ký, đổi IP, resume, kiểm tra MD5.

🔍 Nguyên lý (3 mánh)

1. Ký đúng chữ ký web. Gofile đòi X-Website-Token = sha256(UA :: ngôn ngữ :: accountToken :: floor(epoch/14400) :: secret). secret nằm trong /js/wt.obf.js và bị xoay định kỳ → tool tự tải, tự bóc (và đối chiếu chéo bằng node nếu có), cache 6 giờ.
2. Đổi IP bằng Tor khi bị chặn. Tự cài/khởi động Tor (SOCKS5 9050, control 9051), gặp error-rateLimit thì gửi SIGNAL NEWNYM đổi exit node, thử lại tối đa 6 lần.
3. Tách đường điều khiển / đường dữ liệu. Chỉ vài KB metadata đi qua Tor/chậm; còn dữ liệu lớn đi thẳng store* / upload → tốc độ tối đa (đo thực tế: tải 36 MB/s, upload 83 MB/s).

Không vượt quyền truy cập: tool chỉ gửi đúng header mà trình duyệt vẫn gửi; file private thì vẫn không mở được.

🩺 Sự cố thường gặp

⚠️ Giới hạn

• Mặc định dùng tài khoản guest (tự tạo). Muốn giữ file lâu: truyền --token <token của bạn> hoặc set GOFILE_TOKEN.
• Gofile miễn phí dọn file sau ~10 ngày không có lượt tải.
• Cần tor (hoặc proxy riêng) chỉ khi IP của bạn bị chặn; IP nhà thường không cần.

Giấy phép

MIT