跳到主要内容

存储设置

设置 → 高级 → 存储控制 LeadHub 存储上传文件的位置——线索附件、头像图片、导出存档和表单上传。

存储驱动程序​

驱动程序使用场景
本地（服务器文件系统）默认。文件存储在服务器磁盘的 storage/app/ 中。适用于单服务器安装。
S3 兼容用于云部署、CDN 发布或服务器磁盘空间有限时。支持 AWS S3、DigitalOcean Spaces、MinIO、Backblaze B2、Cloudflare R2 和任何 S3 兼容提供商。

本地存储​

这是默认设置。无需配置。文件存储在：

/path/to/leadhub/storage/app/public/

通过安装时设置的存储符号链接可通过 https://yourdomain.com/storage/... 访问。

S3 兼容存储​

步骤 1 — 选择您的提供商​

提供商说明
AWS S3最常见。端点 URL 留空。
DigitalOcean Spaces端点：https://nyc3.digitaloceanspaces.com（替换区域）
MinIO（自托管）端点：您的 MinIO 服务器 URL
Backblaze B2端点：https://s3.us-west-004.backblazeb2.com（因区域而异）
Cloudflare R2端点：https://ACCOUNT_ID.r2.cloudflarestorage.com

步骤 2 — 创建存储桶​

  1. 在您提供商的控制面板中，创建一个新的存储桶。
  2. 如果您希望直接公开访问上传的文件，请将存储桶设置为公开（推荐用于头像和表单附件）。
  3. 记录存储桶名称和区域。

步骤 3 — 创建访问密钥​

生成对存储桶具有读写权限的访问密钥 ID 和密钥访问密钥。

步骤 4 — 在 LeadHub 中配置​

  1. 前往 设置 → 高级 → 存储。

  2. 将存储磁盘设置为 S3 兼容。

  3. 填写：

    字段值
    端点 URLAWS S3 留空。其他提供商请设置（见上表）。
    存储桶名称您的存储桶名称
    区域AWS 区域代码或提供商区域（例如 us-east-1、nyc3）
    访问密钥 ID来自步骤 3
    密钥访问密钥来自步骤 3（留空以保留存储的密钥）

  4. 保存前点击测试连接以验证设置。

  5. 点击保存设置。

测试连接​

点击测试连接——LeadHub 向存储磁盘写入一个小型测试文件并立即删除。✅ 通知表示连接正常工作。❌ 通知显示错误。

保存前务必测试——不正确的配置可能导致整个工作区的文件上传失败。

从本地迁移到 S3​

  1. 配置 S3 设置并测试连接。
  2. 保存设置——新上传将转到 S3。
  3. 本地磁盘上的现有文件不会自动迁移。请使用提供商的 CLI 或同步工具手动复制（例如 aws s3 sync storage/app/public s3://your-bucket）。

故障排除​

问题解决方案
"测试连接失败：访问被拒绝"检查访问密钥是否具有存储桶的写入权限
文件无法公开访问确保存储桶有公开读取 ACL，或配置 CDN
"NoSuchBucket"错误验证存储桶名称和区域是否正确
端点 URL 错误对于非 AWS 提供商，确保端点 URL 正确且包含 https://
密钥未保存将密钥访问密钥留空以保留现有存储的密钥