PyPI - gofile-tool - Versions diffs - 0.1.0__tar.gz - Mend

gofile-tool 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

gofile_tool-0.1.0/LICENSE +21 -0
gofile_tool-0.1.0/PKG-INFO +136 -0
gofile_tool-0.1.0/README.md +123 -0
gofile_tool-0.1.0/README_PYPI.md +108 -0
gofile_tool-0.1.0/pyproject.toml +45 -0
gofile_tool-0.1.0/setup.cfg +4 -0
gofile_tool-0.1.0/src/gofile_tool/__init__.py +7 -0
gofile_tool-0.1.0/src/gofile_tool/__main__.py +3 -0
gofile_tool-0.1.0/src/gofile_tool/cli.py +85 -0
gofile_tool-0.1.0/src/gofile_tool/core.py +547 -0
gofile_tool-0.1.0/src/gofile_tool.egg-info/PKG-INFO +136 -0
gofile_tool-0.1.0/src/gofile_tool.egg-info/SOURCES.txt +14 -0
gofile_tool-0.1.0/src/gofile_tool.egg-info/dependency_links.txt +1 -0
gofile_tool-0.1.0/src/gofile_tool.egg-info/entry_points.txt +3 -0
gofile_tool-0.1.0/src/gofile_tool.egg-info/requires.txt +6 -0
gofile_tool-0.1.0/src/gofile_tool.egg-info/top_level.txt +1 -0

gofile_tool-0.1.0/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 gofile-tool contributors
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gofile_tool-0.1.0/PKG-INFO ADDED Viewed

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: gofile-tool
+Version: 0.1.0
+Summary: Tải / upload Gofile.io tốc độ tối đa — tự động vượt chặn IP (Tor + chữ ký web X-Website-Token)
+Author: gofile-tool contributors
+License: MIT
+Project-URL: Homepage, https://pypi.org/project/gofile-tool/
+Project-URL: Source, https://pypi.org/project/gofile-tool/
+Keywords: gofile,downloader,uploader,tor,cli,bypass,download
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Requires-Dist: pysocks>=1.7.1
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+# 🧰 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.
+```bash
+pip install gofile-tool
+gofile-tool download Uc4c9oyJ -o ./tai-ve
+```
+---
+## ⚡ Cài đặt
+```bash
+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
+```bash
+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
+```
+| Cờ | Ý nghĩa |
+|---|---|
+| `--json` | Output JSON (cho AI agent / script). Luôn kèm `_token` để quản lý sau |
+| `-o DIR` | Thư mục lưu file tải về (mặc định `.`) |
+| `--workers N` | Số luồng khi tải folder (mặc định 4) |
+| `--token TOKEN` | Dùng tài khoản Gofile của bạn (mặc định tự tạo guest) |
+| `--proxy URL` | Dùng proxy/VPN riêng: `--proxy socks5h://127.0.0.1:1080` |
+| `--no-tor` | Không dùng Tor |
+| `--no-verify` | Bỏ qua kiểm tra MD5 |
+**Ví dụ JSON (`gofile-tool upload ./file.zip --json`):**
+```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:
+```bash
+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
+| Thông báo | Cách sửa |
+|---|---|
+| `error-notPremium` | Secret đã xoay → tool tự nạp lại; nếu kẹt: xoá `~/.cache/gofile_secret.json` |
+| `error-rateLimit` | Tool tự đổi mạch Tor; chờ vài giây |
+| `API thất bại (direct: ConnectTimeout)` | Thiếu Tor → `sudo apt install -y tor`, hoặc `--proxy socks5h://…` |
+| Folder tải chậm | Gofile chỉ cho ZIP folder ở gói Premium → tool tải từng file, đa luồng |
+| `Permission denied …/control_auth_cookie` | `sudo rm -rf ~/.cache/gofile-tor` rồi chạy lại |
+| Upload xong bị "Protected content" | Phải set public cho **cả thư mục cha** — tool đã làm sẵn |
+## ⚠️ 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

gofile_tool-0.1.0/README.md ADDED Viewed

@@ -0,0 +1,123 @@
+# 🧰 gofile_tool — toolkit Gofile.io "miễn nhiễm chặn IP"
+Một file Python duy nhất, tự lo hết: **tạo tài khoản, ký chữ ký web, đổi IP bằng Tor khi bị chặn, tải/upload tốc độ tối đa**.
+Dùng được bởi người thật lẫn **AI agent** (mọi lệnh đều có `--json`).
+---
+## ⚡ Cài đặt (1 lần)
+```bash
+pip install requests pysocks        # tool cũng tự cài nếu thiếu
+sudo apt install -y tor             # hoặc: brew install tor   (chỉ cần khi IP bị chặn)
+```
+## 🚀 Dùng ngay (copy-paste)
+```bash
+cd /home/user/gofile-toolkit
+python3 gofile_tool.py info Uc4c9oyJ                  # xem metadata file/folder
+python3 gofile_tool.py download Uc4c9oyJ -o ./tai-ve  # tải (file hoặc cả folder)
+python3 gofile_tool.py upload  file.zip               # up + tự set public + in link
+python3 gofile_tool.py public  <code|contentId>       # set public cho nội dung đã có
+python3 gofile_tool.py delete  <id1,id2> --token <tk> # xoá file
+python3 gofile_tool.py stop-tor                       # tắt Tor
+python3 gofile_tool.py info Uc4c9oyJ --json           # output JSON cho agent
+```
+Tuỳ chọn hay dùng:
+| Cờ | Ý nghĩa |
+|---|---|
+| `--json` | Output JSON (máy đọc). Luôn kèm `_token` để quản lý/xoá sau |
+| `-o DIR` | Thư mục lưu file tải về (mặc định `.`) |
+| `--workers N` | Số luồng tải khi gặp folder (mặc định 4) |
+| `--token TOKEN` | Dùng tài khoản Gofile có sẵn (để file vào tài khoản của bạn) |
+| `--no-tor` | Không dùng Tor (dùng khi IP của bạn sạch) |
+**Gợi ý:** `alias gf='python3 /home/user/gofile-toolkit/gofile_tool.py'` rồi `gf info <code>`.
+---
+## 🤖 DÀNH CHO AI AGENT — đọc 5 dòng này rồi chạy
+1. Đừng tự viết lại code gọi API Gofile. Cứ gọi tool này.
+2. Lấy metadata / tải file:
+   ```bash
+   python3 /home/user/gofile-toolkit/gofile_tool.py download <CODE> -o <THU_MUC> --json
+   ```
+3. Upload và lấy link chia sẻ:
+   ```bash
+   python3 /home/user/gofile-toolkit/gofile_tool.py upload <DUONG_DAN_FILE> --json
+   ```
+   → trong JSON có `link` (dạng `https://gofile.io/d/XXXXXXXX`), `md5`, `size`, `_token`.
+4. Nếu lệnh báo lỗi: chạy lại với `--json`, đọc trường `error`; 90% là do chưa cài `tor` (`sudo apt install -y tor`).
+5. **Không** tự brute-force / đập liên tục vào `api.gofile.io` — sẽ bị block IP cả ngày. Tool đã tự giới hạn và tự đổi mạch.
+**Output mẫu (`upload --json`):**
+```json
+{
+ "ok": true, "name": "x.7z", "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"
+}
+```
+---
+## 🔍 Vì sao cần tool này (kiến trúc Gofile)
+| Cụm máy chủ | Ví dụ | Bị chặn IP datacenter? |
+|---|---|---|
+| Web + API | `gofile.io`, `api.gofile.io` (94.139.32.3) | ☠️ Có (drop TLS sau vài chục request bot) |
+| Lưu trữ | `store1…store5.gofile.io` (45.112.123.x) | ✅ Không |
+| Upload | `upload.gofile.io` (94.139.32.15-25) | ✅ Không |
+**Ba mánh khoá mà tool cài sẵn:**
+1. **Ký đúng chữ ký web** — Gofile đòi header
+   `X-Website-Token = sha256(UserAgent :: ngôn ngữ :: accountToken :: floor(epoch/14400) :: secret)`.
+   `secret` nằm trong `/js/wt.obf.js`, **bị xoay định kỳ** → tool tự tải file JS, bóc secret, và có `node` thì đối chiếu chéo với hàm `generateWT()` gốc của Gofile. Cache 6 giờ, hết hạn tự nạp lại.
+2. **Đổi IP bằng Tor khi bị chặn** — tự cài/khởi động Tor (SOCKS5 `9050`, control `9051`), mỗi lần gặp `error-rateLimit` thì gửi `SIGNAL NEWNYM` đổi exit node rồi 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ũng được); còn **dữ liệu lớn đi thẳng** vào `store*` / `upload` → tốc độ nguyên bản (đo được: tải 36 MB/s, up 83 MB/s).
+Không vượt quyền truy cập: tool chỉ gửi đúng những header mà trình duyệt của bạn vẫn gửi; file private thì tool vẫn không mở được.
+---
+## 🧪 Đã test thật (18/09/2026)
+| Tình huống | Kết quả |
+|---|---|
+| IP máy ảo bị Gofile drop TLS | `info` qua Tor → OK (exit IP 67.215.237.232) |
+| Tải 608 MB | 16,9 s @ 36 MB/s, MD5 khớp |
+| Upload 551 MB | 7 s @ 83 MB/s |
+| Upload → set public → tài khoản **khác** tải lại | MD5 khớp (`md5_ok: true`) |
+| Resume khi đứt giữa chừng | Có (ghi `.part`, gửi `Range`) |
+| Xoá file bằng token | `status: ok` |
+---
+## 🩺 Xử lý sự cố
+| Thông báo | Nguyên nhân | Cách sửa |
+|---|---|---|
+| `error-notPremium` | Chữ ký sai / secret đã xoay | Tool tự nạp lại secret; nếu vẫn lỗi → xoá `~/.cache/gofile_secret.json` |
+| `error-rateLimit` | IP hoặc exit node bị xài chung | Tool tự `NEWNYM` đổi mạch; kiên nhẫn vài giây |
+| `API thất bại (direct: ConnectTimeout)` mà không bật được Tor | Thiếu `tor` | `sudo apt install -y tor` (hoặc `brew install tor`) |
+| Tải folder bị chậm | Folder ZIP cần Premium | Tool tải từng file (đa luồng), không cần Premium |
+| `Permission denied …/control_auth_cookie` | Tor từng chạy bằng root | Tool đã tự xử lý; nếu còn: `sudo rm -rf ~/.cache/gofile-tor` |
+| File up lên bị "Protected content" | Chưa set public cho **thư mục cha** | Tool đã set cả 2 cấp; nếu tự làm: set `public` trên `parentFolder` với `recursive: true` |
+---
+## ⚠️ Giới hạn cần biết
+- Tài khoản mặc định là **guest** (tool tự tạo). Muốn giữ file lâu: đăng nhập Gofile, lấy token rồi truyền `--token` (hoặc set `GOFILE_TOKEN`).
+- Gofile miễn phí **dọn file sau ~10 ngày không có lượt tải**.
+- Folder ZIP / bulk download là tính năng Premium — tool tải từng file thay thế.
+- Tool chỉ gửi vài chục request, không quét, không dò — đủ để không bị block oan.

gofile_tool-0.1.0/README_PYPI.md ADDED Viewed

@@ -0,0 +1,108 @@
+# 🧰 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.
+```bash
+pip install gofile-tool
+gofile-tool download Uc4c9oyJ -o ./tai-ve
+```
+---
+## ⚡ Cài đặt
+```bash
+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
+```bash
+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
+```
+| Cờ | Ý nghĩa |
+|---|---|
+| `--json` | Output JSON (cho AI agent / script). Luôn kèm `_token` để quản lý sau |
+| `-o DIR` | Thư mục lưu file tải về (mặc định `.`) |
+| `--workers N` | Số luồng khi tải folder (mặc định 4) |
+| `--token TOKEN` | Dùng tài khoản Gofile của bạn (mặc định tự tạo guest) |
+| `--proxy URL` | Dùng proxy/VPN riêng: `--proxy socks5h://127.0.0.1:1080` |
+| `--no-tor` | Không dùng Tor |
+| `--no-verify` | Bỏ qua kiểm tra MD5 |
+**Ví dụ JSON (`gofile-tool upload ./file.zip --json`):**
+```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:
+```bash
+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
+| Thông báo | Cách sửa |
+|---|---|
+| `error-notPremium` | Secret đã xoay → tool tự nạp lại; nếu kẹt: xoá `~/.cache/gofile_secret.json` |
+| `error-rateLimit` | Tool tự đổi mạch Tor; chờ vài giây |
+| `API thất bại (direct: ConnectTimeout)` | Thiếu Tor → `sudo apt install -y tor`, hoặc `--proxy socks5h://…` |
+| Folder tải chậm | Gofile chỉ cho ZIP folder ở gói Premium → tool tải từng file, đa luồng |
+| `Permission denied …/control_auth_cookie` | `sudo rm -rf ~/.cache/gofile-tor` rồi chạy lại |
+| Upload xong bị "Protected content" | Phải set public cho **cả thư mục cha** — tool đã làm sẵn |
+## ⚠️ 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

gofile_tool-0.1.0/pyproject.toml ADDED Viewed

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "gofile-tool"
+version = "0.1.0"
+description = "Tải / upload Gofile.io tốc độ tối đa — tự động vượt chặn IP (Tor + chữ ký web X-Website-Token)"
+readme = {file = "README_PYPI.md", content-type = "text/markdown"}
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [{name = "gofile-tool contributors"}]
+keywords = ["gofile", "downloader", "uploader", "tor", "cli", "bypass", "download"]
+classifiers = [
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "requests>=2.25.0",
+    "pysocks>=1.7.1",
+]
+[project.optional-dependencies]
+dev = ["build", "twine"]
+[project.scripts]
+gofile-tool = "gofile_tool.cli:main"
+gf = "gofile_tool.cli:main"
+[project.urls]
+Homepage = "https://pypi.org/project/gofile-tool/"
+Source = "https://pypi.org/project/gofile-tool/"
+[tool.setuptools.packages.find]
+where = ["src"]
+[tool.setuptools]
+include-package-data = true

gofile_tool-0.1.0/setup.cfg ADDED Viewed

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build =
+tag_date = 0

gofile_tool-0.1.0/src/gofile_tool/__init__.py ADDED Viewed

@@ -0,0 +1,7 @@
+"""gofile-tool — tải/upload Gofile.io tốc độ tối đa, tự vượt chặn IP."""
+__version__ = "0.1.0"
+from .core import Gofile, Tor
+from .cli import main
+__all__ = ["Gofile", "Tor", "main", "__version__"]

gofile_tool-0.1.0/src/gofile_tool/__main__.py ADDED Viewed

@@ -0,0 +1,3 @@
+import sys
+from .cli import main
+sys.exit(main())

gofile_tool-0.1.0/src/gofile_tool/cli.py ADDED Viewed

@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*-
+"""gofile_tool.cli — giao diện dòng lệnh: gofile-tool / gf"""
+import argparse
+import json
+import sys
+from . import __version__
+from .core import Gofile, Tor
+EPILOG = """
+vi du:
+  gofile-tool info Uc4c9oyJ
+  gofile-tool download Uc4c9oyJ -o ./tai-ve
+  gofile-tool upload  file.zip
+  gofile-tool public  <code>
+  gofile-tool delete  <file_id> --token <token>
+  gofile-tool stop-tor
+Them --json vao bat ky lenh nao de nhan output may doc duoc (cho AI agent).
+"""
+def build_parser():
+    ap = argparse.ArgumentParser(
+        prog="gofile-tool",
+        description="Tai / upload Gofile.io toc do toi da, tu dong vuot chan IP.",
+        epilog=EPILOG,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    ap.add_argument("--version", action="version", version=f"gofile-tool {__version__}")
+    ap.add_argument("cmd", nargs="?",
+                    choices=["info", "download", "upload", "public", "delete", "stop-tor"])
+    ap.add_argument("target", nargs="?", help="ma Gofile (vd: Uc4c9oyJ) hoac duong dan file")
+    ap.add_argument("-o", "--out", default=".", help="thu muc luu file tai ve (mac dinh: .)")
+    ap.add_argument("--token", default=None, help="tai khoan Gofile (mac dinh: tu tao guest)")
+    ap.add_argument("--proxy", default=None,
+                    help="proxy rieng, vd socks5h://127.0.0.1:9050 hoac http://host:port "
+                         "(mac dinh: tu bat Tor)")
+    ap.add_argument("--no-tor", action="store_true", help="khong dung Tor")
+    ap.add_argument("--workers", type=int, default=4, help="so luong tai folder (mac dinh 4)")
+    ap.add_argument("--no-verify", action="store_true", help="bo qua kiem tra MD5")
+    ap.add_argument("--json", dest="as_json", action="store_true", help="output JSON")
+    return ap
+def main(argv=None):
+    ap = build_parser()
+    a = ap.parse_args(argv)
+    if not a.cmd:
+        ap.print_help()
+        return 1
+    if a.cmd == "stop-tor":
+        Tor().stop()
+        print("da tat Tor")
+        return 0
+    g = Gofile(token=a.token, use_tor=not a.no_tor, verbose=not a.as_json, proxy=a.proxy)
+    out = {}
+    try:
+        if a.cmd == "info":
+            j = g.info(a.target)
+            out = j.get("data") if j.get("status") == "ok" else {"error": j}
+        elif a.cmd == "download":
+            out = {"files": g.download(a.target, a.out, workers=a.workers,
+                                       verify=not a.no_verify)}
+        elif a.cmd == "upload":
+            out = g.upload(a.target)
+        elif a.cmd == "public":
+            out = {"ok": g.set_public(code=a.target)}
+        elif a.cmd == "delete":
+            if not a.target:
+                ap.error("thieu id")
+            out = g.delete(*a.target.split(","))
+    except Exception as e:
+        out = {"ok": False, "error": str(e)}
+    if isinstance(out, dict):
+        out.setdefault("_token", g.token)
+    print(json.dumps(out, ensure_ascii=False, indent=1))
+    return 0 if out.get("ok", True) else 1
+if __name__ == "__main__":
+    sys.exit(main())

gofile_tool-0.1.0/src/gofile_tool/core.py ADDED Viewed

@@ -0,0 +1,547 @@
+# -*- coding: utf-8 -*-
+"""
+gofile_tool.core — lõi: Tor, chữ ký web X-Website-Token, API Gofile, tải/upload.
+Nguyên lý:
+  * Gofile tách hạ tầng: [web+api] bảo vệ gắt (hay drop TLS với IP datacenter),
+    còn [store*] lưu trữ và [upload] thì thoáng.
+  * Tool thử gọi API trực tiếp; nếu bị chặn -> tự bật Tor, xoay IP, tạo tài khoản
+    guest và ký header đúng chuẩn.
+  * Dữ liệu lớn luôn đi THẲNG tới store*/upload (không qua Tor) -> tốc độ tối đa.
+"""
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+=============================================================================
+ gofile_tool.py — Tải / upload Gofile.io, kể cả khi IP máy bị Gofile chặn.
+=============================================================================
+NGUYÊN LÝ (đọc README.md để biết chi tiết):
+  * Gofile chia hạ tầng: [web+api] bị bảo vệ gắt, [store*] lưu trữ và
+    [upload] thì thoáng hơn. IP datacenter gọi API kiểu bot sẽ bị drop TLS.
+  * Tool này: (1) thử gọi API trực tiếp; nếu bị chặn → tự bật Tor, xoay IP,
+    tạo tài khoản guest, ký header X-Website-Token đúng chuẩn của Gofile;
+    (2) lấy metadata (vài KB) qua đường nào cũng được;
+    (3) TẢI/UPLOAD DỮ LIỆU LỚN thì đi THẲNG tới store*/upload (không qua Tor)
+        → tốc độ tối đa.
+LỆNH (copy-paste được ngay):
+  python3 gofile_tool.py info Uc4c9oyJ                 # xem metadata (JSON)
+  python3 gofile_tool.py download Uc4c9oyJ -o ./tai    # tải file/folder
+  python3 gofile_tool.py upload  file.zip              # up + tự public + in link
+  python3 gofile_tool.py public  <contentId|code>      # set public
+  python3 gofile_tool.py stop-tor                      # tắt Tor
+  Thêm --json ở bất kỳ lệnh nào để nhận output máy đọc được (dành cho agent).
+YÊU CẦU: python3 + requests + pysocks  (tool tự pip cài nếu thiếu)
+         tor (chỉ cần khi IP bị chặn — tool tự apt/brew cài nếu có sudo)
+         node (tuỳ chọn, dùng để kiểm tra chéo chữ ký)
+=============================================================================
+"""
+import hashlib
+import json
+import os
+import re
+import shutil
+import socket
+import subprocess
+import sys
+import time
+from concurrent.futures import ThreadPoolExecutor
+API = "https://api.gofile.io"
+UPLOAD_URL = "https://upload.gofile.io/uploadfile"
+UA = ("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+      "(KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36")
+LANG = "en-US"
+TOR_DIR = os.path.expanduser("~/.cache/gofile-tor")
+SECRET_CACHE = os.path.expanduser("~/.cache/gofile_secret.json")
+SOCKS = "socks5h://127.0.0.1:9050"
+CTRL = ("127.0.0.1", 9051)
+# ---------------------------------------------------------------- deps ----
+def ensure_deps():
+    try:
+        import requests  # noqa
+        import socks     # noqa
+        return True
+    except Exception:
+        pass
+    print("[deps] đang cài requests + pysocks…", file=sys.stderr)
+    for cmd in ([sys.executable, "-m", "pip", "install", "-q", "--disable-pip-version-check",
+                 "requests", "pysocks"],
+                [sys.executable, "-m", "pip", "install", "-q", "--break-system-packages",
+                 "--disable-pip-version-check", "requests", "pysocks"]):
+        try:
+            if subprocess.run(cmd, capture_output=True, timeout=300).returncode == 0:
+                return True
+        except Exception:
+            continue
+    print("[deps] KHÔNG cài được requests/pysocks — hãy chạy: "
+          "pip install requests pysocks", file=sys.stderr)
+    return False
+ensure_deps()
+import requests  # noqa: E402
+try:
+    import socks  # noqa: F401
+except Exception:
+    pass
+def log(*a):
+    print(*a, file=sys.stderr, flush=True)
+# ----------------------------------------------------------------- tor ----
+class Tor:
+    """Quản lý Tor: tự cài (nếu có sudo), tự chạy, tự xoay mạch (NEWNYM)."""
+    def __init__(self):
+        self.proc = None
+        self.cookie = None
+    @staticmethod
+    def binary():
+        return shutil.which("tor")
+    def install(self):
+        if self.binary():
+            return True
+        log("[tor] chưa có tor, thử cài…")
+        for cmd in (["sudo", "-n", "apt-get", "install", "-y", "-q", "tor"],
+                    ["apt-get", "install", "-y", "-q", "tor"],
+                    ["brew", "install", "tor"]):
+            try:
+                subprocess.run(cmd, capture_output=True, timeout=900)
+                if self.binary():
+                    log("[tor] cài xong:", self.binary())
+                    return True
+            except Exception:
+                continue
+        log("[tor] không tự cài được. Cài thủ công: sudo apt install tor  |  brew install tor")
+        return False
+    def running(self):
+        try:
+            s = socket.create_connection(("127.0.0.1", 9050), timeout=3)
+            s.close()
+            return True
+        except Exception:
+            return False
+    def start(self, wait=90):
+        """Chạy tor: ưu tiên chạy ở user thường (đơn giản, không cần root);
+        nếu không được mới dùng sudo với thư mục riêng."""
+        if self.running():
+            return True
+        if not self.install():
+            return False
+        for prefix, d in (([], TOR_DIR), (["sudo", "-n"], "/tmp/gofile-tor-root")):
+            cfg_text = ("SocksPort 127.0.0.1:9050\n"
+                        "ControlPort 127.0.0.1:9051\n"
+                        "CookieAuthentication 1\n"
+                        f"DataDirectory {d}\n"
+                        f"Log notice file {d}/tor.log\n")
+            try:
+                if prefix:                       # chạy bằng root: dựng dir + file qua sudo
+                    subprocess.run(["sudo", "-n", "rm", "-rf", d], capture_output=True, timeout=60)
+                    subprocess.run(["sudo", "-n", "mkdir", "-p", d], capture_output=True, timeout=60)
+                    subprocess.run(["sudo", "-n", "chmod", "700", d], capture_output=True, timeout=60)
+                    cfg = "/tmp/gofile-torrc-root"
+                    subprocess.run(["sudo", "-n", "tee", cfg], input=cfg_text.encode(),
+                                   capture_output=True, timeout=60)
+                else:                            # chạy bình thường
+                    os.makedirs(d, exist_ok=True)
+                    cfg = os.path.join(d, "torrc")
+                    with open(cfg, "w") as fh:
+                        fh.write(cfg_text)
+                self.proc = subprocess.Popen(prefix + ["tor", "-f", cfg],
+                                             stdout=subprocess.DEVNULL,
+                                             stderr=subprocess.DEVNULL)
+                for _ in range(wait):
+                    time.sleep(1)
+                    if self.running():
+                        self.cookie = os.path.join(d, "control_auth_cookie")
+                        log(f"[tor] sẵn sàng, IP ra ngoài: {self.exit_ip()}")
+                        return True
+                try:
+                    self.proc.terminate()
+                except Exception:
+                    pass
+            except Exception as e:
+                log("[tor] lỗi khởi động:", type(e).__name__, e)
+                continue
+        log("[tor] không khởi động được Tor — kiểm tra: sudo apt install tor")
+        return False
+    @staticmethod
+    def exit_ip():
+        try:
+            return requests.get("https://api.ipify.org",
+                                proxies={"http": SOCKS, "https": SOCKS}, timeout=25).text
+        except Exception as e:
+            return f"?({type(e).__name__})"
+    def newnym(self):
+        """Đổi exit node (SIGNAL NEWNYM) qua control port + cookie auth."""
+        cookie = getattr(self, "cookie", None) or os.path.join(TOR_DIR, "control_auth_cookie")
+        try:
+            data = open(cookie, "rb").read().hex()
+        except Exception:
+            try:
+                data = subprocess.run(["sudo", "-n", "cat", cookie],
+                                      capture_output=True, timeout=30).stdout.decode().strip()
+            except Exception:
+                return False
+        try:
+            s = socket.create_connection(CTRL, timeout=10)
+            s.sendall(f"AUTHENTICATE {data}\r\n".encode())
+            time.sleep(0.3)
+            s.sendall(b"SIGNAL NEWNYM\r\n")
+            time.sleep(0.3)
+            s.close()
+            return True
+        except Exception:
+            return False
+    def stop(self):
+        try:
+            subprocess.run(["pkill", "-f", f"tor -f {TOR_DIR}"], capture_output=True, timeout=30)
+        except Exception:
+            pass
+        if self.proc:
+            try:
+                self.proc.terminate()
+            except Exception:
+                pass
+# --------------------------------------------------------------- secret ----
+def extract_secret(js_text):
+    """Bóc secret chữ ký web từ wt.obf.js (không cần node)."""
+    cands = set()
+    for m in re.finditer(r"'((?:\\x[0-9a-fA-F]{2})+)'", js_text):
+        try:
+            s = bytes(int(h, 16) for h in re.findall(r"\\x([0-9a-fA-F]{2})", m.group(1)))
+            s = s.decode("latin1")
+        except Exception:
+            continue
+        if re.fullmatch(r"[0-9a-f]{12,24}", s):
+            cands.add(s)
+    if not cands:
+        return None
+    return sorted(cands, key=len)[-1]
+def node_secret(js_path):
+    """Kiểm tra chéo bằng node (nếu có): chạy generateWT() của chính Gofile."""
+    if not shutil.which("node"):
+        return None
+    code = r"""
+const fs=require('fs'),vm=require('vm');
+const src=fs.readFileSync(process.argv[2],'utf8');
+const sandbox={console,setTimeout,setInterval};sandbox.globalThis=sandbox;
+sandbox.navigator={userAgent:process.argv[3]||'x',language:'en-US'};
+sandbox.document={querySelector:()=>null,getElementById:()=>null,addEventListener:()=>{},
+  createElement:()=>({style:{},setAttribute:()=>{},appendChild:()=>{}}),body:{appendChild:()=>{}},currentScript:null};
+sandbox.location={href:'https://gofile.io/',hostname:'gofile.io'};
+sandbox.performance={timeOrigin:Date.now()};sandbox.addEventListener=()=>{};
+vm.createContext(sandbox);vm.runInContext(src,sandbox,{timeout:20000});
+console.log(sandbox.generateWT('TOKEN'));
+"""
+    try:
+        out = subprocess.run(["node", "-e", code, js_path, UA],
+                             capture_output=True, timeout=60, text=True)
+        return out.stdout.strip() or None
+    except Exception:
+        return None
+# ------------------------------------------------------------------ api ----
+class Gofile:
+    def __init__(self, token=None, use_tor=True, verbose=True, proxy=None):
+        self.verbose = verbose
+        self.token = token or os.environ.get("GOFILE_TOKEN")
+        self.use_tor = use_tor
+        self.proxy = proxy or os.environ.get("GOFILE_PROXY")
+        self.tor = Tor()
+        self.secret = self._load_secret()
+        self.direct_ok = None            # None = chưa biết
+        self.last_ip = None
+    # ---- hạ tầng ---------------------------------------------------------
+    def _load_secret(self):
+        try:
+            d = json.load(open(SECRET_CACHE))
+            if time.time() - d["at"] < 6 * 3600:
+                return d["secret"]
+        except Exception:
+            pass
+        return None
+    def _save_secret(self, s):
+        try:
+            os.makedirs(os.path.dirname(SECRET_CACHE), exist_ok=True)
+            json.dump({"secret": s, "at": time.time()}, open(SECRET_CACHE, "w"))
+        except Exception:
+            pass
+    def fetch_secret(self, force=False):
+        if self.secret and not force:
+            return self.secret
+        js = self.raw_get("https://gofile.io/js/wt.obf.js")
+        if not js:
+            return None
+        p = os.path.join(TOR_DIR, "wt.obf.js")
+        try:
+            os.makedirs(TOR_DIR, exist_ok=True)
+            open(p, "w").write(js)
+        except Exception:
+            p = None
+        s = extract_secret(js)
+        if s and p:
+            n = node_secret(p)
+            if n:                       # đối chiếu với hàm gốc của Gofile
+                expect = hashlib.sha256(
+                    f"{UA}::{LANG}::TOKEN::{int(time.time() // 14400)}::{s}".encode()
+                ).hexdigest()
+                if n != expect:
+                    log("[wt] node báo khác secret, thử lại…")
+                    s = None
+        if s:
+            self.secret = s
+            self._save_secret(s)
+        return s
+    def proxy_chain(self):
+        """Danh sách đường ra theo thứ tự ưu tiên: thẳng -> proxy riêng -> Tor."""
+        chain = [("direct", None)]
+        if self.proxy:
+            chain.append((self.proxy, {"http": self.proxy, "https": self.proxy}))
+        if self.use_tor:
+            chain.append((SOCKS, {"http": SOCKS, "https": SOCKS}))
+        return chain
+    def raw_get(self, url, timeout=40):
+        """GET thô: thẳng trước, hỏng thì qua Tor."""
+        for label, proxies in self.proxy_chain():
+            if label == SOCKS and not self.tor.start():
+                continue
+            try:
+                r = requests.get(url, headers={"User-Agent": UA},
+                                 proxies=proxies, timeout=timeout)
+                if r.status_code == 200:
+                    return r.text
+            except Exception:
+                continue
+        return None
+    def wt(self):
+        s = self.fetch_secret()
+        if not s:
+            return None
+        bucket = int(time.time() // 14400)
+        raw = f"{UA}::{LANG}::{self.token}::{bucket}::{s}"
+        return hashlib.sha256(raw.encode()).hexdigest()
+    def headers(self):
+        h = {"User-Agent": UA, "Accept-Language": "en-US,en;q=0.9",
+             "Authorization": f"Bearer {self.token}", "X-BL": LANG,
+             "Referer": "https://gofile.io/"}
+        w = self.wt()
+        if w:
+            h["X-Website-Token"] = w
+        return h
+    # ---- lõi gọi API: thẳng → proxy riêng → Tor (xoay IP) -----------------
+    def api(self, method, path, *, tries=6, **kw):
+        timeout = kw.pop("timeout", 60)
+        last = None
+        for i in range(1, tries + 1):
+            if not self.token and not self.new_account():
+                last = "không tạo được tài khoản guest"
+                continue
+            for label, proxies in self.proxy_chain():
+                if label == SOCKS:
+                    if not self.tor.start():
+                        continue
+                    if i > 1:                       # đổi exit node rồi thử lại
+                        self.tor.newnym()
+                        time.sleep(5)
+                        self.last_ip = self.tor.exit_ip()
+                try:
+                    r = requests.request(method, API + path, headers=self.headers(),
+                                         proxies=proxies, timeout=timeout, **kw)
+                    if r.status_code == 200:
+                        return r
+                    last = f"{label or 'direct'}: HTTP {r.status_code} {r.text[:120]}"
+                    if b"notPremium" in r.content:   # secret đã xoay → nạp lại
+                        self.secret = None
+                        self.fetch_secret(force=True)
+                    elif b"rateLimit" in r.content:  # IP/exit node bị xài chung → đổi mạch
+                        continue
+                except Exception as e:
+                    last = f"{label or 'direct'}: {type(e).__name__}"
+                    continue
+            if self.use_tor and self.tor.running():
+                self.tor.newnym()
+                time.sleep(5)
+        raise RuntimeError(
+            f"API thất bại ({last or 'không rõ'}). IP có thể bị Gofile chặn. "
+            f"Thử: sudo apt install -y tor  |  hoặc --proxy socks5h://127.0.0.1:1080")
+    def new_account(self):
+        for label, proxies in self.proxy_chain():
+            if label == SOCKS and not self.tor.start():
+                continue
+            try:
+                r = requests.post(API + "/accounts", data=b"{}",
+                                  headers={"Content-Type": "application/json",
+                                           "User-Agent": UA},
+                                  proxies=proxies, timeout=45)
+                j = r.json()
+                if j.get("status") == "ok":
+                    self.token = j["data"]["token"]
+                    self.root = j["data"]["rootFolder"]
+                    if self.verbose:
+                        log(f"[acct] guest token: {self.token}")
+                    return True
+            except Exception:
+                continue
+        return False
+    # ---- tác vụ -----------------------------------------------------------
+    def info(self, code, page=1, page_size=1000):
+        if not self.token:
+            self.new_account()
+        r = self.api("GET", f"/contents/{code}",
+                     params={"page": page, "pageSize": page_size,
+                             "sortField": "name", "sortDirection": 1}, timeout=60)
+        return r.json()
+    def walk(self, code):
+        """Trả về danh sách file (đệ quy nếu là folder)."""
+        out = []
+        def rec(cid, path=""):
+            j = self.info(cid)
+            d = j.get("data") or {}
+            if d.get("type") == "file":
+                out.append({**d, "_path": path})
+                return
+            for child in (d.get("children") or {}).values():
+                if child.get("type") == "folder":
+                    rec(child["id"], os.path.join(path, child["name"]))
+                else:
+                    out.append({**child, "_path": path})
+        rec(code)
+        return out
+    def download(self, code, outdir=".", workers=4, verify=True):
+        meta = self.info(code)
+        d = meta.get("data") or {}
+        os.makedirs(outdir, exist_ok=True)
+        files = self.walk(code) if d.get("type") == "folder" else [{**d, "_path": ""}]
+        log(f"[dl] {len(files)} file, tổng "
+            f"{sum(f.get('size', 0) for f in files) / 1048576:.0f} MB")
+        res = []
+        with ThreadPoolExecutor(max_workers=max(1, workers)) as ex:
+            for r in ex.map(lambda f: self._get_one(f, outdir, verify), files):
+                res.append(r)
+        return res
+    def _get_one(self, f, outdir, verify):
+        sub = os.path.join(outdir, f.get("_path", ""))
+        os.makedirs(sub, exist_ok=True)
+        dst = os.path.join(sub, f["name"])
+        url = f.get("link") or f"https://{f.get('serverSelected', 'store1')}.gofile.io" \
+                               f"/download/web/{f['id']}/{f['name']}"
+        tmp = dst + ".part"
+        done = os.path.getsize(tmp) if os.path.exists(tmp) else 0
+        head = {"User-Agent": UA, "Cookie": f"accountToken={self.token}"}
+        if done and done < f.get("size", 1):
+            head["Range"] = f"bytes={done}-"
+        mode = "ab" if done else "wb"
+        t0 = time.time()
+        try:
+            r = requests.get(url, headers=head, stream=True, timeout=120)
+            if r.status_code not in (200, 206):
+                return {"file": f["name"], "ok": False, "err": f"HTTP {r.status_code}"}
+            total = int(r.headers.get("Content-Length", 0)) + done
+            with open(tmp, mode) as fh:
+                for chunk in r.iter_content(1 << 20):
+                    if chunk:
+                        fh.write(chunk)
+                        done += len(chunk)
+            os.replace(tmp, dst)
+        except Exception as e:
+            return {"file": f["name"], "ok": False, "err": type(e).__name__,
+                    "partial": tmp}
+        sz = os.path.getsize(dst)
+        ok = (sz == f.get("size", sz))
+        md5ok = None
+        if verify and f.get("md5"):
+            h = hashlib.md5()
+            with open(dst, "rb") as fh:
+                for c in iter(lambda: fh.read(1 << 20), b""):
+                    h.update(c)
+            md5ok = (h.hexdigest() == f["md5"])
+        sp = sz / max(0.001, (time.time() - t0)) / 1048576
+        log(f"[dl] xong {f['name'][:70]}  {sz/1048576:.1f} MB  {sp:.1f} MB/s"
+            f"  md5={'OK' if md5ok else ('SAI' if md5ok is False else '-')}")
+        return {"file": f["name"], "path": dst, "size": sz, "ok": ok, "md5_ok": md5ok}
+    def upload(self, path, folder_id=None, public=True, timeout=3600):
+        if not self.token:
+            self.new_account()
+        fid = folder_id or getattr(self, "root", None)
+        data = {"folderId": fid or "", "token": self.token}
+        t0 = time.time()
+        with open(path, "rb") as fh:
+            r = requests.post(UPLOAD_URL, files={"file": (os.path.basename(path), fh)},
+                              data=data, timeout=timeout)
+        j = r.json()
+        if j.get("status") != "ok":
+            return {"ok": False, "raw": j}
+        d = j["data"]
+        out = {"ok": True, "name": d["name"], "size": d["size"], "md5": d.get("md5"),
+               "code": d.get("code"), "page": d.get("downloadPage"),
+               "file_id": d.get("id"),
+               "speed_MBps": round(d["size"] / max(0.001, time.time() - t0) / 1048576, 1)}
+        if public:
+            pub = self.set_public(d.get("id"), d.get("code"), d.get("parentFolder"))
+            out["public"] = pub
+            if pub:
+                out["link"] = f"https://gofile.io/d/{d.get('code')}"
+        log(f"[up] xong {d['name']} — {out['speed_MBps']} MB/s")
+        return out
+    def delete(self, *ids):
+        """Xoá file/thư mục (cần token chủ sở hữu)."""
+        try:
+            r = self.api("DELETE", "/contents", json={"contentsId": ",".join(ids)}, timeout=60)
+            return r.json()
+        except Exception as e:
+            return {"ok": False, "error": str(e)}
+    def set_public(self, content_id=None, code=None, parent_id=None):
+        """Bắt buộc set public cho THƯ MỤC CHA (recursive) trước, rồi mới tới file
+        — nếu chỉ set file thì khách vẫn thấy 'Protected content'."""
+        ids = [parent_id, content_id or code]
+        ok_all = False
+        for cid in ids:
+            if not cid:
+                continue
+            try:
+                r = self.api("PUT", f"/contents/{cid}/update",
+                             json={"attribute": "public", "attributeValue": True,
+                                   "recursive": True}, timeout=60)
+                ok_all = r.json().get("status") == "ok"
+            except Exception as e:
+                log("[public] lỗi:", e)
+                ok_all = False
+        return ok_all

gofile_tool-0.1.0/src/gofile_tool.egg-info/PKG-INFO ADDED Viewed

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: gofile-tool
+Version: 0.1.0
+Summary: Tải / upload Gofile.io tốc độ tối đa — tự động vượt chặn IP (Tor + chữ ký web X-Website-Token)
+Author: gofile-tool contributors
+License: MIT
+Project-URL: Homepage, https://pypi.org/project/gofile-tool/
+Project-URL: Source, https://pypi.org/project/gofile-tool/
+Keywords: gofile,downloader,uploader,tor,cli,bypass,download
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Requires-Dist: pysocks>=1.7.1
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+# 🧰 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.
+```bash
+pip install gofile-tool
+gofile-tool download Uc4c9oyJ -o ./tai-ve
+```
+---
+## ⚡ Cài đặt
+```bash
+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
+```bash
+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
+```
+| Cờ | Ý nghĩa |
+|---|---|
+| `--json` | Output JSON (cho AI agent / script). Luôn kèm `_token` để quản lý sau |
+| `-o DIR` | Thư mục lưu file tải về (mặc định `.`) |
+| `--workers N` | Số luồng khi tải folder (mặc định 4) |
+| `--token TOKEN` | Dùng tài khoản Gofile của bạn (mặc định tự tạo guest) |
+| `--proxy URL` | Dùng proxy/VPN riêng: `--proxy socks5h://127.0.0.1:1080` |
+| `--no-tor` | Không dùng Tor |
+| `--no-verify` | Bỏ qua kiểm tra MD5 |
+**Ví dụ JSON (`gofile-tool upload ./file.zip --json`):**
+```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:
+```bash
+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
+| Thông báo | Cách sửa |
+|---|---|
+| `error-notPremium` | Secret đã xoay → tool tự nạp lại; nếu kẹt: xoá `~/.cache/gofile_secret.json` |
+| `error-rateLimit` | Tool tự đổi mạch Tor; chờ vài giây |
+| `API thất bại (direct: ConnectTimeout)` | Thiếu Tor → `sudo apt install -y tor`, hoặc `--proxy socks5h://…` |
+| Folder tải chậm | Gofile chỉ cho ZIP folder ở gói Premium → tool tải từng file, đa luồng |
+| `Permission denied …/control_auth_cookie` | `sudo rm -rf ~/.cache/gofile-tor` rồi chạy lại |
+| Upload xong bị "Protected content" | Phải set public cho **cả thư mục cha** — tool đã làm sẵn |
+## ⚠️ 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

gofile_tool-0.1.0/src/gofile_tool.egg-info/SOURCES.txt ADDED Viewed

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+README_PYPI.md
+pyproject.toml
+src/gofile_tool/__init__.py
+src/gofile_tool/__main__.py
+src/gofile_tool/cli.py
+src/gofile_tool/core.py
+src/gofile_tool.egg-info/PKG-INFO
+src/gofile_tool.egg-info/SOURCES.txt
+src/gofile_tool.egg-info/dependency_links.txt
+src/gofile_tool.egg-info/entry_points.txt
+src/gofile_tool.egg-info/requires.txt
+src/gofile_tool.egg-info/top_level.txt

gofile_tool-0.1.0/src/gofile_tool.egg-info/dependency_links.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+

gofile_tool-0.1.0/src/gofile_tool.egg-info/entry_points.txt ADDED Viewed

@@ -0,0 +1,3 @@
+[console_scripts]
+gf = gofile_tool.cli:main
+gofile-tool = gofile_tool.cli:main

gofile_tool-0.1.0/src/gofile_tool.egg-info/requires.txt ADDED Viewed

@@ -0,0 +1,6 @@
+requests>=2.25.0
+pysocks>=1.7.1
+[dev]
+build
+twine

gofile_tool-0.1.0/src/gofile_tool.egg-info/top_level.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+ gofile_tool