3 min read
On this page
Storage overview
Foxel currently includes 22 storage adapter types. Start with Common configuration, then prepare credentials for your backend. Each guide covers configuration, examples, behavior, limitations, and troubleshooting.
Local storage and file protocols
| Storage | Type | Connection |
|---|---|---|
| Local storage | local | Directory in the Foxel runtime filesystem |
| S3 object storage | s3 | Bucket, access keys, S3 API endpoint |
| WebDAV | webdav | WebDAV directory URL and credentials or app password |
| FTP | ftp | FTP host, account or anonymous access |
| SFTP | sftp | SSH/SFTP host, username and password |
| SMB / Windows shares | smb | SMB host, share name, account |
Cloud drives and message attachments
| Storage | Type | Connection |
|---|---|---|
| OneDrive | onedrive | Application ID, secret, OAuth refresh token |
| Google Drive | googledrive | Application ID, secret, OAuth refresh token |
| Dropbox | dropbox | App Key, App Secret, refresh token |
| 115 Drive | pan115 | Cookie or confirmed QR token |
| 123Pan | pan123 | Phone number or email and password |
| Baidu Netdisk | baidu_netdisk | Own application credentials and OAuth refresh token |
| 189 Cloud | cloud189 | Cookie or account credentials |
| Quark Drive | quark | Cookie |
| UC Drive | uc | Cookie |
| PikPak | pikpak | Account credentials with automatic token maintenance |
| Telegram | telegram | API ID, API Hash, user session, chat ID |
Aggregation services and self-hosted drives
| Storage | Type | Connection |
|---|---|---|
| AList | alist | V3-compatible file API, account or anonymous access |
| OpenList | openlist | File API, account or anonymous access |
| Foxel Remote | foxel | Remote site, credentials, virtual path |
| Seafile | seafile | Library ID and credentials or user token |
| Cloudreve V4 | cloudreve | Email/password or user tokens, Cloudreve URI |
Choosing an adapter
- For data on a server or NAS, use local storage, SFTP, SMB, or WebDAV.
- For object storage, use S3 after confirming API compatibility.
- For an existing cloud drive account, select its adapter and follow the supported authorization method.
- For files managed by another service, use AList, OpenList, Foxel, Seafile, or Cloudreve.
Telegram uses message attachments and cannot create directories, move, rename, or copy files. Other adapters also depend on remote permissions, quotas, and implementation limits; see their guides.
Documentation sources
Fields and limitations were checked against the Foxel adapters. Authorization and service background also reference the OpenList documentation and AList documentation. Specific links appear in each guide. Their driver-specific settings cannot be copied directly into Foxel.