n8n-nodes-terabox

v0.1.4

Published

a month ago

Professional n8n community node for advanced TeraBox cloud storage automation. Features secure QR login, session auto-refresh, batch file operations (upload/download/search), M3U8 media streaming, and intelligent session management. Enable share folder ac

TeraBox Banner

TeraBox - n8n Integration

Powerful TeraBox cloud storage automation for n8n workflows with session-based authentication, comprehensive file management, and media streaming capabilities

🚀 Transform Your TeraBox Automation

TeraBox is a comprehensive n8n custom node that brings the full power of TeraBox cloud storage to your automation workflows. Built with session-based authentication and designed for production use, it offers enterprise-grade features with an intuitive interface.

🌟 Key Features

Core Operations

Authentication: QR Code Login, Session Validation, Diagnostics
Files: List, Search, Download, Upload, Delete, Empty Recycle Bin, Copy, Move, Rename
User: Account Info, Storage Quota
Share: Verify, Query, List, Copy from shared folders
Media: Stream URLs, Media Metadata for videos and audio

Enterprise Features

🔐 Session-Based Authentication - Secure cookie + jsToken authentication with QR login assistant
⚡ Smart File Management - Advanced filtering by category, date ranges, and sorting options
🛡️ Comprehensive Error Handling - Clear error messages and automatic retry support
📊 Structured Output - Consistent response format with operation status
🎯 Category Filtering - Filter by Videos, Music, Pictures, Documents
📅 Date Range Filtering - List files by modification time
🔄 Share Operations - Access and copy files from shared folders
🎬 Media Streaming - Get M3U8 streaming URLs for video/audio files

📦 Installation

Method 1: n8n Community Nodes (Recommended)

Open n8n UI
Go to Settings → Community Nodes
Add in box "n8n-nodes-terabox"
Click checkbox to allow to use external nodes.
Click Install
Restart n8n to load the custom node

Note: If you have trouble updating the node in the n8n UI, uninstall (remove) the TeraBox node first, then perform a fresh install to resolve the issue.

Method 2: Custom Nodes Directory

Clone to n8n custom nodes directory
Install dependencies
```
npm install
```
Build the project
```
npm run build
```
Restart n8n to load the custom node

Method 3: GitHub Installation

Clone from GitHub

git clone https://github.com/sadiakant/n8n-nodes-terabox.git

Move to n8n custom nodes directory
Install dependencies
```
npm install
```
Build the project
```
npm run build
```
Restart n8n to load the custom node

⚙️ Quick Setup

1. Authenticate with TeraBox

This node uses session-based authentication. You have two options:

Option A: QR Code Login (Recommended)

Add a Terabox node to your workflow
Set Resource to Authentication
Set Operation to Start QR Login
Execute and scan the QR code with your TeraBox mobile app
Use Complete QR Login to get your credentials
Save credentials in n8n Settings → Credentials

Option B: Manual Cookie Extraction

Log in to TeraBox in your browser
Open Developer Tools (F12) → Network tab
Trigger any action and copy the Cookie header
Copy the jsToken from the query parameters
Create credentials in n8n with these values

For detailed step-by-step instructions, see our Authorization Guide.

2. Configure Credentials

In n8n → Settings → Credentials:

Cookie Header: Your full Cookie header string (required)
JS Token: The jsToken from your session (required)
BDSToken: For file management operations (optional but recommended)
Base URL: API endpoint (default: https://dm.nephobox.com)

3. Validate Your Session

Add a Terabox node
Set Resource to Authentication
Set Operation to Validate Session
Execute to verify your credentials work

🎯 Comprehensive Operations Guide

For detailed documentation of all operations with parameters, examples, and use cases, see our Operations Guide.

🔧 Available Operations

| Resource | Operations | | ------------------ | ---------------------------------------------------------------------------------------------------------------- | | Authentication | Start QR Login, Check QR Login, Complete QR Login, Refresh Session Tokens, Validate Session, Session Diagnostics | | User | Get Info, Get Quota | | File | List, Search, Get Metadata, Download, Upload, Delete, Empty Recycle Bin, Copy, Move, Rename | | Share | Activate, Verify, Query, List, Copy | | Media | Stream URL, Share Stream URL, Metadata |

🛡️ Security Features

Session-Based Authentication

All authentication uses secure session cookies:

Cookies are stored securely in n8n credentials
QR login generates fresh sessions without manual extraction
Session validation checks token validity
Diagnostics provide detailed session health info

Input Validation

Comprehensive validation ensures data integrity:

File path validation
Category filter validation
Date range validation
JSON input validation for batch operations

Enhanced Error Handling

The node handles common TeraBox errors gracefully:

Session Expired: Clear guidance to re-authenticate
File Not Found: Helpful path verification
Permission Denied: Account permission checks
Storage Full: Quota monitoring
Invalid Parameters: Detailed error messages

⚡ Performance Features

Smart File Listing

Category-based filtering (Videos, Music, Pictures, Documents)
Date range filtering (last hours, days, or custom range)
Sortable results (by name, size, or modification time)
Pagination support for large directories

Efficient Operations

Batch file operations (delete, copy, move)
URL-based file uploads
Binary file downloads
Streaming media URLs

Structured Output

All operations return consistent output format:

{
	"success": true,
	"operationStatus": {
		"resource": "file",
		"operation": "list",
		"summary": "List completed successfully. Returned 25 items.",
		"timestamp": "2026-03-31T00:00:00.000Z"
	}
}

🚨 Troubleshooting

For comprehensive troubleshooting guidance, common issues, and solutions, see our Troubleshooting Guide.

Quick Fixes

| Issue | Solution | | ------------------- | --------------------------------- | | Session expired | Re-authenticate using QR Login | | File not found | Use exact path from File > List | | Upload failed | Check storage quota and file size | | Invalid credentials | Re-copy cookie and jsToken |

📚 Documentation

Authorization Guide - Detailed authentication instructions
Operations Guide - Complete operations documentation
Troubleshooting Guide - Common issues and solutions

Use Cases

Automated File Management

Sync files between TeraBox and other cloud services
Organize files by category or date
Clean up old files automatically

Media Processing

Get streaming URLs for video processing
Download media files for transcoding
List and filter media by type

Backup Workflows

Download files for local backup
Copy files between TeraBox accounts
Monitor storage quota

Share Management

Access shared folder contents
Copy files from shared links
Query share information

Advanced Configuration

Category Filters

Use numeric codes for file categories:

1 - Videos
2 - Music
3 - Pictures
4 - Documents
6 - Others

Date Range Filtering

Filter files by modification time:

Last Hours: Items modified in last N hours
Last Days: Items modified from today back through the previous N-1 calendar days
Custom Range: From/To date in ISO format

Batch Operations

Process multiple files at once:

["/path/to/file1.txt", "/path/to/file2.txt"]

URL Uploads

Upload files directly from URLs:

Set Upload Source to URL
Provide the source URL
Node downloads and uploads automatically

🤝 Contributing

We welcome contributions to make TeraBox even better! Please see our Contributing Guide for detailed guidelines.