服务器对象存储 OSS 怎么接入与使用

大枫同学_9337

大枫同学_9337

2026-11-22

871人浏览

原创

接入与使用对象存储 oss 的核心做法是:在控制台创建 bucket 并获取 accesskey,随后在代码中配置凭证并初始化客户端 sdk,即可通过 api 进行文件上传、下载和管理。具体实现时,需设置 endpoint、bucketname 及认证信息,调用 putobject 或 getobject 等方法完成数据交互,确保网络连通且权限策略正确。

服务器对象存储 OSS 怎么接入与使用

如何初始化 OSS 客户端并完成基础连接

初始化客户端需要指定服务区域(Endpoint)、身份验证密钥(AccessKeyId/Secret)以及目标存储空间名称(BucketName)。以阿里云 OSS Python SDK 为例,安装 oss2 库后,构建 Auth 对象并实例化 Bucket 类即可完成连接准备,后续所有操作均基于该实例发起。

服务器对象存储 OSS 怎么接入与使用

import oss2

# 1. 配置认证信息
auth = oss2.Auth('your-access-key-id', 'your-access-key-secret')

# 2. 指定 Endpoint 和 Bucket 名称
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
bucket_name = 'my-example-bucket'

# 3. 创建 Bucket 实例
bucket = oss2.Bucket(auth, endpoint, bucket_name)

# 4. 验证连接(列出前几个文件)
print(bucket.list_objects(max_keys=2).object_list)

运行上述代码将输出 Bucket 中现有的文件列表,若返回空列表或报错,则说明凭证错误或 Bucket 不存在。确保 endpoint 与 Bucket 所在地域一致,否则会出现 EndpointNotFound 异常。

如何实现文件的上传与下载操作

文件传输主要依赖 put_object 和 get_object 方法。上传时需提供本地文件路径或字节流,下载时需指定远程文件名及保存路径。SDK 会自动处理分片和大文件逻辑,开发者只需关注源与目标的映射关系,无需手动管理 HTTP 请求细节。

服务器对象存储 OSS 怎么接入与使用

# 假设已创建 bucket 实例
local_file_path = './data/report.pdf'
remote_key = 'reports/report.pdf'

# 上传文件
with open(local_file_path, 'rb') as f:
    bucket.put_object(remote_key, f.read())
    print(f"Uploaded {local_file_path} to {remote_key}")

# 下载文件
download_path = './downloaded_report.pdf'
bucket.get_object_to_file(remote_key, download_path)
print(f"Downloaded {remote_key} to {download_path}")

执行上传后,文件将以 remote_key 作为唯一标识存储在 Bucket 中。下载时若 remote_key 不存在,SDK 会抛出 NoSuchKey 错误。建议在实际业务中加入异常捕获,如 try...except oss2.exceptions.NoSuchKey,以增强程序健壮性。

当上传大文件时如何处理断点续传

对于超过 100MB 的文件,建议使用分片上传接口 multipart_upload 或开启断点续传功能。OSS SDK 支持自动检测中断并恢复传输,避免重复上传整个文件。通过设置 upload_id 和分片状态,可实现高可靠性的数据传输,特别适用于弱网环境或超大文件场景。

import oss2
from oss2.models import PartInfo

# 初始化分片上传
upload_id = bucket.init_multipart_upload(remote_key).upload_id

parts = []
chunk_size = 10 * 1024 * 1024  # 10MB per part
file_size = os.path.getsize(local_file_path)

with open(local_file_path, 'rb') as f:
    part_number = 1
    while True:
        chunk = f.read(chunk_size)
        if not chunk:
            break
        # 上传分片
        result = bucket.upload_part(remote_key, upload_id, part_number, chunk)
        parts.append(PartInfo(part_number, result.etag))
        part_number += 1

# 完成上传
bucket.complete_multipart_upload(remote_key, upload_id, parts)
print("Large file uploaded successfully with multipart upload.")

该流程将文件切分为多个部分分别上传,最后合并。若中途失败,可记录 upload_id 和已完成分片,下次启动时继续上传剩余部分。此机制显著提升了大文件传输的成功率和效率。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

477

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

1020

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

3792

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

1216

5

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.17

1109

5

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

2023.10.17

574

3

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

3516

4

服务器负载不兼容怎么解决
服务器负载不兼容怎么解决

解决方法:1、增加服务器资源;2、负载均衡;3、优化应用程序;4、增加缓存机制;5、分布式架构;6、限流和熔断;7、自动化扩容。想知道更详细服务器负载不兼容的解决方法,可以访问本专题下面的文章。

2023.10.20

6692

4

宽带如何接入服务器
宽带如何接入服务器

宽带接入服务器的方法有ADSL宽带接入服务器、光纤接入服务器、无线接入服务器和以太网接入服务器等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.20

1007

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习