Back to Nodes

Terabox

Last updated Apr 29, 2026

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

38 Weekly Downloads
152 Monthly Downloads

Included Nodes

Terabox

Description

!TeraBox Banner

TeraBox – n8n Integration

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

Join Our Telegram Group for Help and Support

TeraBox in your browser
2. Open Developer Tools (F12) → Network tab
3. Trigger any action and copy the Cookie header
4. Copy the jsToken from the query parameters
5. 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

    1. Add a Terabox node
    2. Set Resource to Authentication
    3. Set Operation to Validate Session
    4. 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:

    1. Set Upload Source to URL
    2. Provide the source URL
    3. Node downloads and uploads automatically

    🤝 Contributing

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

    📄 License

    MIT License – see LICENSE file for details.

    🔗 Resources

  • TeraBox Official Website
  • n8n Custom Nodes Guide
  • TeraBox GitHub
  • NPM Package
  • Publishing Status

    ![Build Status](https://github.com/sadiakant/n8n-nodes-terabox/actions/workflows/build.yml)
    ![Publish Status](https://github.com/sadiakant/n8n-nodes-terabox/actions/workflows/publish.yml)
    ![Socket Badge](https://badge.socket.dev/npm/package/n8n-nodes-terabox)
    ![GitHub Issues](https://github.com/sadiakant/n8n-nodes-terabox/issues)
    ![GitHub Pull Requests](https://github.com/sadiakant/n8n-nodes-terabox/pulls)

    NPM Status

    ![npm version](https://www.npmjs.com/package/n8n-nodes-terabox)
    ![npm downloads/week](https://www.npmjs.com/package/n8n-nodes-terabox)
    ![npm downloads/month](https://www.npmjs.com/package/n8n-nodes-terabox)
    ![npm downloads/year](https://www.npmjs.com/package/n8n-nodes-terabox)
    ![node version](https://www.npmjs.com/package/n8n-nodes-terabox)
    ![npm license](LICENSE)
    ![GitHub license](LICENSE)
    ![npm total downloads](https://www.npmjs.com/package/n8n-nodes-terabox)
    ![npm unpacked size](https://www.npmjs.com/package/n8n-nodes-terabox)
    ![npm types](https://www.npmjs.com/package/n8n-nodes-terabox)
    ![npm collaborators](https://www.npmjs.com/package/n8n-nodes-terabox)

    GitHub Status

    ![github release](https://github.com/sadiakant/n8n-nodes-terabox/releases)
    ![github stars](https://github.com/sadiakant/n8n-nodes-terabox/stargazers)
    ![github forks](https://github.com/sadiakant/n8n-nodes-terabox/network/members)
    ![last commit](https://github.com/sadiakant/n8n-nodes-terabox/commits/main)
    ![GitHub contributors](https://github.com/sadiakant/n8n-nodes-terabox/graphs/contributors)
    ![GitHub watchers](https://github.com/sadiakant/n8n-nodes-terabox/watchers)
    ![GitHub issues closed](https://github.com/sadiakant/n8n-nodes-terabox/issues)
    ![GitHub PRs closed](https://github.com/sadiakant/n8n-nodes-terabox/pulls)
    ![Commit activity](https://github.com/sadiakant/n8n-nodes-terabox/commits/main)

    Dependency Status

    ![Telegram API](https://core.telegram.org/api)
    ![TypeScript](https://www.typescriptlang.org/)
    ![n8n](https://n8n.io/)
    ![pnpm >= 9.1](https://pnpm.io/)
    ![Node >= 18.17](https://nodejs.org/)
    ![telegram dependency](https://www.npmjs.com/package/telegram)
    ![n8n-workflow peer dependency](https://www.npmjs.com/package/n8n-workflow)

    Built with ❤️ for n8n automation workflows