Logo
ScallerFox Docs

Object Storage Best Practices

Follow these best practices to optimize performance, reduce costs, and ensure security.

File Organization

Use Hierarchical Structure

bucket/
├── users/
│   ├── {user_id}/
│   │   ├── avatars/
│   │   └── documents/
├── public/
│   ├── images/
│   └── assets/
└── temp/
    └── uploads/

Naming Conventions

  • Use UUIDs or timestamps for unique filenames: 550e8400-e29b-41d4-a716-446655440000.jpg
  • Include file extension for proper MIME type detection
  • Avoid special characters and spaces in filenames

Performance Optimization

Image Optimization

  • Compress images before uploading to reduce storage and bandwidth
  • Use modern formats (WebP, AVIF) for better compression
  • Resize images to appropriate dimensions for their use case

CDN Caching

  • Use appropriate Cache-Control headers for different file types
  • Static assets: Long cache (1 year+)
  • User-generated content: Shorter cache with versioning

Security Best Practices

Private Files

Use private access URLs or signed URLs for sensitive files. Never expose private files via public URLs.

Access Control

  • Use token-based authentication for API access
  • Implement anti-leech protection to prevent hotlinking
  • Validate file types and sizes on upload