Filestash项目中使用FILESTASH_BASE环境变量实现多实例部署

在自托管文件管理工具Filestash的实际部署场景中，我们经常需要将多个实例运行在同一域名下的不同路径中。这种部署方式对于需要隔离不同用户组或业务场景的文件管理需求特别有用。

Filestash提供了一个简单而强大的解决方案：通过FILESTASH_BASE环境变量配置基础路径。这个功能允许管理员将Filestash实例部署在类似/instance-1/、/instance-2/这样的子路径下，而不是必须占用整个域名或子域名。

配置方法

在Docker环境中部署时，只需在运行容器时设置FILESTASH_BASE环境变量即可：

docker run -e FILESTASH_BASE=/test/ ...

这会使Filestash实例自动适配到/test/路径下运行。所有前端路由和后端API都会自动添加此前缀，确保应用功能完整。

技术实现原理

Filestash内部处理这个配置时，主要做了以下几方面的适配：

1. 前端路由系统会自动添加配置的基础路径前缀
2. 所有静态资源引用路径会进行相应调整
3. 后端API接口路径也会保持一致
4. 会话管理和cookie作用域会正确处理路径隔离

实际应用场景

这种部署方式特别适合以下场景：

1. 多租户系统：为不同客户提供独立的文件管理界面
2. 测试环境：在同一服务器上运行生产环境和测试环境实例
3. 功能隔离：为不同部门或团队提供专属的文件管理空间
4. 版本控制：同时运行不同版本的Filestash进行对比测试

注意事项

1. 路径配置必须以斜杠开头和结尾（如/test/）
2. 反向代理配置需要确保正确转发带前缀的请求
3. 不同实例间的cookie和本地存储会自动隔离
4. 日志和监控系统需要区分不同实例的数据

通过这种灵活的部署方式，Filestash可以更好地适应各种复杂的企业IT环境需求，同时保持部署的简洁性和可维护性。