fredriklindberg/filestash

Filestash (OIDC支持版) 镜像文档

镜像概述

本镜像为Filestash的自定义构建版本，添加了OIDC（OpenID Connect）身份验证支持，专门针对多用户环境和共享存储场景设计。Filestash是一款功能强大的文件管理工具，支持多种存储后端，本版本通过OIDC集成增强了身份验证能力，适合需要集中身份管理的团队或组织使用。项目源码可参考：https://github.com/fredriklindberg/filestash

核心功能与特性

• OIDC身份验证：支持通过OpenID Connect协议与身份提供商（如Keycloak、Auth0等）集成，实现统一身份认证
• 多用户支持：专为多用户环境设计，可管理不同用户的访问权限
• 共享存储适配：优化支持共享存储场景，方便团队协作和文件共享
• 兼容Filestash核心功能：保留Filestash原有的文件管理、预览、编辑等功能，支持多种存储后端（如S3、FTP、WebDAV等）

使用场景

• 企业内部文件共享平台，需要统一身份认证
• 团队协作环境，多用户访问共享存储资源
• 需要与现有OIDC身份系统集成的文件管理解决方案

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name filestash-oidc \
  -p 8334:8334 \
  -e OIDC_ISSUER=https://your-oidc-provider.com \
  -e OIDC_CLIENT_ID=your-client-id \
  -e OIDC_CLIENT_SECRET=your-client-secret \
  -v /path/to/data:/app/data \
  fredriklindberg/filestash:latest

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  filestash:
    image: fredriklindberg/filestash:latest
    container_name: filestash-oidc
    ports:
      - "8334:8334"
    environment:
      - OIDC_ISSUER=https://keycloak.example.com/auth/realms/myrealm
      - OIDC_CLIENT_ID=filestash-client
      - OIDC_CLIENT_SECRET=your-secret-key
      - OIDC_REDIRECT_URI=http://filestash.example.com:8334/auth/oidc/callback
    volumes:
      - ./data:/app/data
    restart: unless-stopped

注意事项

• 确保OIDC身份提供商已正确配置客户端信息，包括回调URL
• 数据卷挂载用于持久化配置和用户数据，建议生产环境中使用
• 如需使用HTTPS，建议配合反向代理（如Nginx）配置SSL证书