IBM Cloud Object Storage连接超时问题排查（Lite账户）

核心问题：私有Endpoint无法外部访问 #

你遇到的connect ETIMEDOUT错误，本质是用了私有Endpoint（s3.private.jp-tok.cloud-object-storage.appdomain.cloud），这个地址对应的10.1.129.66是IBM Cloud内部私有IP，外部网络（比如本地开发环境）根本无法连通，直接导致超时。

解决步骤 #

1. 替换为公开Endpoint #

把配置里的endpoint改成对应区域的公开地址：

var config = {
    endpoint: 's3.jp-tok.cloud-object-storage.appdomain.cloud', // 去掉private前缀
    apiKeyId: 'xxxx',
    serviceInstanceId: 'crn:v1:bluemix:public:cloud-object-storage:global:a/dbad72afdcb81fac6df4:3bf9d86f-811f-480b-af51-ab1401c5e643::',
    signatureVersion: 'iam',
    region:"jp-tok"
};

公开Endpoint面向公网访问，本地环境可以正常连接。

2. 验证网络与权限 #

• 检查本地网络是否有防火墙、代理拦截443端口，可通过curl https://s3.jp-tok.cloud-object-storage.appdomain.cloud测试连通性
• 确认apiKeyId和serviceInstanceId完全正确：从IBM Cloud控制台的COS实例凭证页面复制，避免手动输入出错
• Lite账户权限足够访问COS基础功能，无需额外付费权限

3. IBM Cloud Function 故障排查 #

Cloud Function无法工作大概率也是Endpoint问题：

• 函数代码里同样替换为公开Endpoint
• 确认ibm-cos-sdk依赖已正确安装（通过package.json声明或部署时自动安装）
• 给函数执行角色分配Cloud Object Storage Reader/WriterIAM权限

针对PDF存储目标的额外建议 #

你要存储带密钥的Base64格式PDF，可做以下优化：

1. Base64转Buffer上传：Base64字符串比原文件大30%，转Buffer能减少传输量：

// 假设base64Str是前端传来的PDF Base64（需去掉data:application/pdf;base64,前缀）
const pdfBuffer = Buffer.from(base64Str, 'base64');
cos.putObject({
    Bucket: '你的存储桶名称',
    Key: '文件名称.pdf',
    Body: pdfBuffer,
    ContentType: 'application/pdf'
}, (err, data) => {
    // 处理上传结果
});

2. 加密方案：
   • 服务器端加密：利用COS的SSE-KMS功能，上传时指定ServerSideEncryption: 'aws:kms'，COS自动用KMS密钥加密存储
   • 客户端加密：如果需自行管理密钥，先在本地用AES等算法加密PDF，再上传到COS，下载后解密

内容的提问来源于stack exchange，提问作者Jagnath reddy