Refly项目自托管环境下的存储配额问题解决方案

问题背景

在使用Refly项目进行自托管部署时，部分用户在Mac系统上通过Docker Compose安装后，创建新文档时遇到了"Storage Quota Exceeded"(存储配额超出)的错误提示。这种情况通常发生在初次安装并尝试创建第一个文档时，给用户体验带来了不便。

技术分析

该问题的本质在于数据库中的默认存储配额设置过低。Refly项目在自托管环境下，默认配置可能没有为新建用户分配足够的存储空间配额，导致即使是最基本的文档创建操作也会触发配额限制。

解决方案

要解决这个问题，我们需要直接修改数据库中的存储配额设置。具体操作步骤如下：

1. 首先确保Docker容器正在运行
2. 执行以下命令连接到PostgreSQL数据库并更新配额设置：

docker exec -i refly_db psql 'postgresql://refly:test@localhost:5432/refly' << EOF                    
update refly.storage_usage_meters set file_count_quota = 10000
EOF

这条命令会：

• 通过docker exec进入名为refly_db的容器
• 使用psql客户端连接到PostgreSQL数据库
• 执行SQL更新语句，将文件数量配额(file_count_quota)设置为10000
• 自动退出数据库连接

技术细节

1. 数据库连接字符串：'postgresql://refly:test@localhost:5432/refly'中包含了用户名(refly)、密码(test)、主机(localhost)和端口(5432)信息，以及数据库名称(refly)

2. 表结构：修改的是refly.storage_usage_meters表，这是Refly项目中用于管理用户存储配额的专门表

3. 配额值：将配额设置为10000是一个合理的默认值，可以根据实际需求调整

验证方法

执行上述命令后，用户可以尝试重新创建文档。如果操作成功且不再出现配额错误提示，说明问题已解决。

预防措施

对于长期运行的Refly自托管实例，建议：

1. 定期监控存储使用情况
2. 根据实际用户数量和文档规模调整配额设置
3. 考虑实现自动化配额管理机制

总结

通过直接修改数据库中的存储配额设置，可以有效解决Refly自托管环境下的"Storage Quota Exceeded"问题。这种解决方案简单直接，适合在开发和测试环境中快速解决问题。对于生产环境，建议结合更完善的存储管理策略来确保系统的稳定运行。