Amazon S3 / MinIO Odoo Integration v.19

该工具依赖外部库 'boto3'。请用以下命令为 Odoo 服务器安装：

1. 打开选项 'Amazon S3 Sync'（Cloud Storage > 配置 > 配置）。需要可选插件 Amazon S3 Odoo Integration
2. 打开 Amazon S3 控制台： https://console.aws.amazon.com/s3/
3. 创建新存储桶或选择现有存储桶。复制准确的存储桶名称：应填入 Odoo 的“Bucket”字段
4. 打开存储桶详情并复制其 AWS Region。填入 Odoo 的 'Region' 字段（例如 eu-west-1 或 us-east-1）
5. 打开 AWS IAM 控制台： https://console.aws.amazon.com/iam/
6. 创建新的 IAM 用户或选择现有技术用户。该用户应对所选存储桶内的对象拥有列出、读取、创建、写入、复制和删除的完整权限。你可以选择完全权限管理员，或新建策略（见下方）
7. 在 IAM 用户表单中，打开选项卡 'Security credentials' 并按 'Create access key'
8. 在 'Access key best practices & alternatives' 页面选择 Application running outside AWS。当 Odoo 服务器从 AWS 外部、Odoo.sh、自有服务器或其他托管通过访问密钥连接 S3 时，应选此项。若 Odoo 安装在 AWS EC2 实例上，可改选 Application running on an AWS compute service，复制到 Odoo 的字段相同
9. 按 'Next'。下一步可选择输入说明标签，例如 Odoo S3 Sync，然后按 'Create access key'
10. 在最后的 AWS 页面，将 Access key 或 Access key ID 复制到 Odoo 字段 'Access Key'
11. 将 Secret access key 复制到 Odoo 字段“Secret Key”。重要：AWS 只显示一次密钥，请在关闭窗口前保存
12. 若使用兼容 S3 的提供商而非 AWS S3，从该提供商管理面板复制端点 URL，填入 Odoo 的 'Amazon S3 endpoint URL'。例如 MinIO 常用 https://minio.example.com 或 http://localhost:9000；LocalStack 通常用 http://localhost:4566
13. 转到 Odoo Cloud Storage > Configuration > Cloud Clients 并按 'Create'
14. 作为参考，请填写所有用户都能看懂的名称
15. 作为 Cloud 客户端，选择“Amazon S3”
16. 在 Root folder 名称中输入标题，作为所有同步文件夹的父级S3 prefix。例如 'Odoo' 或 'OdooERP'
17. 填写字段 'Bucket'、'Region'、'Access Key'、'Secret Key'，如需再填 'Amazon S3 endpoint URL' 和寻址样式
18. 选择 Odoo 使用临时 presigned URL 还是公开的存储桶/CDN URL。私有存储桶请保持 presigned URL 开启，并以秒设置有效期
19. 点击 “Confirm”。Odoo 检查 bucket 访问并创建或验证根文件夹前缀。Amazon S3 - Odoo 同步已可执行
20. 将新创建的 cloud client 应用到应同步到该 Amazon S3 存储桶的文件夹规则和/或手动文件夹
21. 等待同步计划作业启动。仅供测试：从 Cloud Storage > 配置 > 配置 > “Launch sync”按钮手动触发集成。

有用的 AWS 文档：创建 S3 存储桶： https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html，管理 IAM 访问密钥： https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

存储桶策略示例

Amazon S3 有一个重要特点：Odoo 中显示的 URL 始终是 Amazon 一侧的链接。

若启用 Use Public URLs，Odoo 会保存直接的 S3 对象 URL。仅当相关 S3 存储桶、前缀、对象、CDN 或兼容端点可公开读取时该链接才有效。否则即使已登录 AWS 控制台，Amazon S3 也会显示 AccessDenied。

对于公开链接，在 Amazon S3 配置存储桶权限，并为 Odoo 前缀允许公开读取。存储桶策略示例：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "PublicReadOdooPrefix",
      "Effect": "Allow",
      "Principal": "*",
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME/Odoo/*"
    }
  ]
}

将 YOUR_BUCKET_NAME 换成真实存储桶名，将 Odoo/ 换成所选根文件夹前缀。同时确保 Amazon S3 的 Block public access 不会阻止该存储桶策略。

若禁用 Use Public URLs，Odoo 会保存指向相关存储桶对象或前缀的 AWS Console 链接。这类链接适合 Amazon 用户：打开者必须已登录 AWS 并拥有对该对象的 IAM 访问。若用户没有 AWS 访问权限，Amazon 不会打开文件。

1. 准备一台正在运行的 MinIO 服务器
2. 打开 MinIO 控制台
3. 创建新存储桶或选择现有存储桶。复制准确的存储桶名称：应填入 Odoo 的“Bucket”字段
4. 为 Odoo 创建访问凭据。在 MinIO 中，使用 access key / secret key 对，或使用有权在所选存储桶中列出、读取、创建、写入、复制和删除对象的服务帐户
5. 将 MinIO Access Key 复制到 Odoo 字段“Access Key”
6. 将 MinIO Secret Key 复制到 Odoo 字段“Secret Key”。重要：若 MinIO 只显示一次，请在关闭 MinIO 页面之前保存密钥
7. 将 MinIO S3 API 端点 URL 复制到 Odoo 字段“Amazon S3 endpoint URL”。例如，本地服务器通常使用 http://localhost:9000，生产服务器可能使用 https://minio.example.com
8. 转到 Odoo Cloud Storage > Configuration > Cloud Clients 并按 'Create'
9. 作为参考，请填写所有用户都能看懂的名称
10. 作为 Cloud 客户端，选择“MinIO”
11. 在 Root folder 名称中输入标题，作为所有同步文件夹的父级MinIO object prefix。例如 'Odoo' 或 'OdooERP'
12. 填写 'Bucket'、'Access Key'、'Secret Key' 和 'Amazon S3 endpoint URL'。'Region' 对 MinIO 可选；若为空，Odoo 使用 us-east-1 进行 S3 兼容签名
13. 将寻址方式保持为 Path-style。这是 MinIO 端点的推荐选项，尤其当 MinIO 主机不提供按存储桶的 DNS 名称时
14. 选择 Odoo 是否使用直接的公开 MinIO URL。仅当存储桶、前缀、反向代理或 CDN 可公开读取时，才启用“Use Public URLs”。私有 MinIO 存储桶请保持关闭
15. 点击 “Confirm”。Odoo 检查 bucket 访问并创建或验证根文件夹前缀。MinIO - Odoo 同步已可执行
16. 将新创建的 cloud client 应用到应同步到该 MinIO 存储桶的文件夹规则和/或手动文件夹
17. 等待同步计划作业启动。仅供测试：从 Cloud Storage > 配置 > 配置 > “Launch sync”按钮手动触发集成。

有用的 MinIO 文档： https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.