详情页标题前

阿里云对象存储OSS静态网站托管概述-云淘科技

• 阿里云对象存储
详情页1

静态网站是指所有的网页都由静态内容构成，包括客户端执行的脚本（例如JavaScript）。您可以通过静态网站托管功能将您的静态网站托管到OSS的存储空间（Bucket），并使用Bucket的访问域名访问这个网站。

使用说明

配置静态网站托管时，您需要指定网站的默认首页和默认404页：

  • 默认首页是您通过浏览器访问静态网站域名时，OSS返回的网站首页。

    您为默认首页指定的文件必须是Bucket根目录下允许被匿名访问的文件。如果您还开通了子目录首页，则子目录下也应存在此文件。

  • 默认404页是您通过浏览器访问Bucket内文件出现404错误时，OSS返回的错误页面。

    您为默认404页指定的文件必须是Bucket根目录下允许被匿名访问的文件。

您可以通过将默认首页或者默认404页中指定文件的读写权限ACL设置为public-read，确保该文件允许匿名访问。有关设置文件读写权限ACL的具体步骤，请参见文件ACL。

注意事项

出于安全考虑，中国内地各地域自2018年09月28日起，非中国内地各地域自2019年09月25日起，通过浏览器访问OSS静态网页类型文件（mimetype为text/html，扩展名包括HTM、HTML、JSP、PLG、HTX、STM）：

  • 使用OSS默认域名通过浏览器访问静态网页文件时，Response Header中会自动加上Content-Disposition:attachment。 即从浏览器访问这些文件时，会以附件形式进行下载。

  • 使用自定义域名通过浏览器访问静态网页文件时，在浏览器支持预览对应格式的网页文件的情况下，默认直接预览文件内容。

配置示例

为Bucket开启静态网站托管后，您需要将与默认首页名称相同的文件（例如index.html）上传至目标Bucket，如果Bucket中包含了目录结构subdir/，则目录层级下也必须包含index.html文件。此外，您还需要将与默认404页名称相同的文件（例如error.html）上传至目标Bucket。Bucket的文件结构如下所示：

Bucket
 ├── index.html
 ├── error.html
 ├── example.txt
 └── subdir/
      └── index.html

如果该Bucket绑定了自定义域名example.com，且配置的静态网站默认首页为index.html，默认404页为error.html。则通过自定义域名访问静态网站时，根据是否开通了子目录首页，访问规则如下：

  • 未开通子目录首页

    • 当您访问https://example.com/和https://example.com/subdir/时，OSS会返回https://example.com/index.html。

    • 当您访问https://example.com/example.txt时，正常获取example.txt文件。

    • 当您访问https://example.com/object时，因object不存在，OSS会返回https://example.com/error.html。

  • 已开通子目录首页

    • 当您访问https://example.com/时，OSS会返回https://example.com/index.html。

    • 当您访问https://example.com/subdir/时，OSS会返回https://example.com/subdir/index.html。

    • 当您访问https://example.com/example.txt时，正常获取example.txt文件。

    • 当您访问https://example.com/object时，因object不存在，OSS会根据您设置的文件404规则返回对应信息：

      • 如果文件404规则设置为Redirect（默认值），OSS会继续检查object/index.html是否存在。如果文件存在则返回302，并将访问请求重定向为https://example.com/object/index.html；如果文件不存在则返回404，并继续检查https://example.com/error.html。

      • 如果文件404规则设置为NoSuchKey，则直接返回404，并继续检查https://example.com/error.html。

      • 如果文件404规则设置为Index，OSS会继续检查object/index.html是否存在。如果文件存在则返回200，并直接返回文件内容。如果文件不存在，则继续检查https://example.com/error.html。

使用OSS控制台

  1. 设置静态网站页面。

    • 未开通子目录首页

      结合以上配置示例可知，当您希望访问子目录subdir/时，不支持跳转至子目录下的index.html页面，而是跳转至根目录下的index.html页面。此外，当访问Bucket内不存在的文件时，返回默认错误页面。具体配置步骤如下：

      1. 登录OSS管理控制台。

      2. 单击Bucket 列表，然后单击目标Bucket名称。

      3. 在左侧导航栏，选择数据管理 > 静态页面。

      4. 在静态页面，单击设置，按如下说明配置各项参数。阿里云对象存储OSS静态网站托管概述-云淘科技

        参数

        说明

        默认首页

        默认首页是您通过浏览器访问静态网站域名时，OSS返回的网站首页。此处设置为index.html。

        子目录首页

        选择不开通，此时访问静态网站根域名或者根域名下任何一个以正斜线（/）结尾的URL都会返回根目录默认首页。

        默认404页

        访问Bucket内文件出现404错误时，OSS返回的错误页面。默认404页仅支持根目录下的文件。此处设置为error.html。

        错误文档响应码

        您可以配置返回错误文档时的HTTP响应码为404或200。

      5. 单击保存。

    • 已开通子目录首页

      结合以上配置示例可知，您希望访问子目录subdir/时，支持直接跳转至子目录下的index.html页面。此外，当访问Bucket内不存在的文件时，返回默认错误页面，并通过文件404规则指定访问不存在文件时的返回结果。具体配置步骤如下：

      1. 在静态页面，单击设置，按如下说明配置各项参数。阿里云对象存储OSS静态网站托管概述-云淘科技

        参数

        说明

        默认首页

        默认首页是您通过浏览器访问静态网站域名时，OSS返回的网站首页。此处设置为index.html。

        子目录首页

        选择开通。开通子目录首页后，访问静态网站根域名时，返回根目录默认首页。访问根域名下以正斜线（/）结尾的URL时会返回对应目录的默认首页。例如，访问示例中的https://examplebucket.oss-cn-hangzhou.aliyuncs.com/subdir/时，则返回subdir/目录下的默认首页文件index.html。

        文件404规则

        开通子目录首页后，通过文件404规则决定访问不存在的Object时的返回结果。例如，访问https://examplebucket.oss-cn-hangzhou.aliyuncs.com/exampledir，因示例中不存在exampledir文件，则根据设置的文件404规则返回对应信息：

        • Redirect（默认值）：检查exampledir/index.html是否存在。

          • 如果文件存在则返回302，并将访问请求重定向为https://examplebucket.oss-cn-hangzhou.aliyuncs.com/exampledir/index.html。

          • 如果文件不存在则返回404，并继续检查https://examplebucket.oss-cn-hangzhou.aliyuncs.com/error.html。如果error.html页面也不存在该文件，则返回404状态码。

        • NoSuchKey：直接返回404，并继续检查https://examplebucket.oss-cn-hangzhou.aliyuncs.com/error.html。

        • Index：检查exampledir/index.html是否存在。

          • 如果文件存在则返回200，并直接返回文件内容。

          • 如果文件不存在，则继续检查https://examplebucket.oss-cn-hangzhou.aliyuncs.com/error.html。

        默认404页

        访问Bucket内文件出现404错误时，OSS返回的错误页面。默认404页仅支持根目录下的文件。此处设置为error.html。

        错误文档响应码

        您可以配置返回错误文档时的HTTP响应码为404或200。

      2. 单击保存。

  2. 创建并上传默认首页。

    当您为examplebucket配置静态网站托管时指定的默认首页为index.html，您需要将与默认首页名称相同的文件上传至examplebucket根目录下。由于examplebucket中包含了子目录subdir/，则子目录subdir/下也必须包含index.html文件。

    1. 创建index.html文件。index.html文件配置示例如下：

      

    My Website Home Page
    

  
  
      Now hosted on OSS.

    2. 将index.html文件保存至本地路径。

    3. 分别将index.html文件上传至examplebucket根目录以及子目录subdir下。上传文件时，您需要将文件读写权限设置为公共读。

      关于上传文件的具体操作，请参见简单上传。

  3. 创建并上传默认404页。

    当您为examplebucket配置静态网站托管时指定的默认404页为error.html，您需要将与默认404页名称相同的文件上传至examplebucket根目录下。

    1. 创建error.html文件。error.html文件配置示例如下：

      

    Hello OSS!
    

  
  
      This is error 404 page.

    2. 将error.html文件保存至本地。

    3. 将error.html文件上传至examplebucket根目录下。上传文件时，您需要将文件读写权限设置为公共读。

使用阿里云SDK

以下仅列举常见SDK的设置静态网站托管的代码示例。关于其他SDK的设置静态网站托管的代码示例，请参见SDK简介。

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.SetBucketWebsiteRequest;

public class Demo {

    public static void main(String[] args) throws Exception {
        // Endpoint以华东1（杭州）为例，其它Region请按实际情况填写。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写Bucket名称，例如examplebucket。
        String bucketName = "examplebucket";

        // 创建OSSClient实例。
        OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);

        try {
            // 填写Bucket名称。
            SetBucketWebsiteRequest request = new SetBucketWebsiteRequest(bucketName);
            // 设置静态网站托管的默认主页。
            request.setIndexDocument("index.html");
            // 设置静态网站托管的默认404页。
            request.setErrorDocument("error.html");
            ossClient.setBucketWebsite(request);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

putBucketWebsite($bucket, $websiteConfig);
} catch (OssException $e) {
    printf(__FUNCTION__ . ": FAILED
");
    printf($e->getMessage() . "
");
    return;
}
print(__FUNCTION__ . ": OK" . "
");
            

#-*-coding:utf-8-*-
import oss2
from oss2.models import BucketWebsite
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Endpoint以华东1（杭州）为例，其他Region请按实际情况填写。
# 填写Bucket名称，例如examplebucket。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')

# 开启静态网站托管模式，并将默认首页设置为index.html，默认404页设置为error.html。
bucket.put_bucket_website(BucketWebsite('index.html', 'error.html'))           

package main

import (
    "fmt"
    "os"
    "github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
    /// 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
    provider, err := oss.NewEnvironmentVariableCredentialsProvider()
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }

    // 创建OSSClient实例。
    // yourEndpoint填写Bucket对应的Endpoint，以华东1（杭州）为例，填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
    client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }
    // 填写Bucket名称，例如examplebucket。
    bucketName := "examplebucket"

    // 设置静态网站托管的默认主页为index.html, 默认404页为error.html。
    err = client.SetBucketWebsite(bucketName, "index.html", "error.html")
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }
}            

using Aliyun.OSS;
using Aliyun.OSS.Common;

// yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
var endpoint = "yourEndpoint";
// 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// 填写Bucket名称。
var bucketName = "examplebucket";

// 创建OSSClient实例。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
try
{
    // 设置静态网站托管的默认主页为index.html，默认404页为error.html。
    var request = new SetBucketWebsiteRequest(bucketName, "index.html", "error.html");
    client.SetBucketWebsite(request);
    Console.WriteLine("Set bucket:{0} Wetbsite succeeded ", bucketName);
}
catch (OssException ex)
{
    Console.WriteLine("Failed with error info: {0}; Error info: {1}. 
RequestID:{2}	HostID:{3}",
        ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId);
}
catch (Exception ex)
{
    Console.WriteLine("Failed with error info: {0}", ex.Message);
}

#include 
using namespace AlibabaCloud::OSS;

int main(void)
{
    /* 初始化OSS账号信息。*/
    
    /* 填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。*/
    std::string Endpoint = "yourEndpoint";
    /* 填写Bucket名称，例如examplebucket。*/
    std::string BucketName = "examplebucket";

    /* 初始化网络等资源。*/
    InitializeSdk();

    ClientConfiguration conf;
    /* 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。*/
    auto credentialsProvider = std::make_shared();
    OssClient client(Endpoint, credentialsProvider, conf);

    /* 设置静态网站托管。*/
    SetBucketWebsiteRequest request(BucketName);
    /* 设置静态网站托管的默认主页为index.html。*/
    request.setIndexDocument("index.html");
    /* 设置静态网站托管的默认404页为error.html。*/
    request.setErrorDocument("error.html");

    auto outcome = client.SetBucketWebsite(request);

    if (!outcome.isSuccess()) {
        /* 异常处理。*/
        std::cout << "SetBucketWebsite fail" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
        return -1;
    }

    /* 释放网络等资源。*/
    ShutdownSdk();
    return 0;
}

使用REST API

如果您的程序自定义要求较高，您可以直接发起REST API请求。直接发起REST API请求需要手动编写代码计算签名。更多信息，请参见PutBucketWebsite。

常见问题

开启静态网站托管功能后是否支持关闭？

当您不再需要使用默认首页、默认404页等静态网站托管配置时，请按如下步骤关闭静态网站托管功能：

  1. 在左侧导航栏，选择数据管理 > 静态页面。
  2. 在静态页面区域，单击设置。
  3. 清空默认首页和默认404页配置，然后单击保存。返回如下页面，表示已成功关闭静态网站托管功能。阿里云对象存储OSS静态网站托管概述-云淘科技

更多参考

  • 您可以通过存储空间（Bucket）托管静态网站，并让访问者通过Bucket绑定的自定义域名（例如example.com）访问您的网站。具体操作，请参见使用自定义域名设置静态网站托管。

  • 您可以使用React框架，通过OSS的静态网站托管功能在前端快速部署一个线上可用的单页应用SPA（Single-Page Application）。具体操作，请参见教程示例：通过静态网站托管部署单页应用。

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家

阿里云企业补贴进行中： 马上申请

腾讯云限时活动1折起，即将结束： 马上收藏

同尘科技为腾讯云授权服务中心。

购买腾讯云产品享受折上折，更有现金返利:同意关联，立享优惠

转转请注明出处：https://www.yunxiaoer.com/159367.html

赞 (0)
0
上一篇 2023年12月10日 上午1:41
下一篇 2023年12月10日
详情页2

相关推荐

  • 阿里云对象存储OSSJava设置对象标签-云淘科技

    OSS支持使用对象标签（Object Tagging）对存储空间（Bucket）中的文件（Object）进行分类，您可以针对相同标签的Object设置生命周期规则、访问权限等。 注意事项 本文以华东1（杭州）外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoi…

    阿里云对象存储 2023年12月10日

  • 阿里云对象存储OSSGo服务器端加密-云淘科技

    OSS支持在服务器端对上传的数据进行加密编码（Server-Side Encryption）。上传数据时，OSS对收到的用户数据进行加密，然后再将得到的加密数据持久化保存下来；下载数据时，OSS自动对保存的加密数据进行解密并把原始数据返回给用户，并在返回的HTTP请求Header中，声明该数据进行了服务器端加密。 注意事项 本文以华东1（杭州）外网Endpo…

    阿里云对象存储 2023年12月10日

  • 阿里云对象存储OSS服务端签名直传并设置上传回调概述-云淘科技

    本文主要介绍如何基于Post Policy的使用规则在服务端通过各种语言代码完成签名，并且设置上传回调，然后通过表单直传数据到OSS。 背景信息 大多数情况下，用户上传文件后，应用服务器需要知道用户上传了哪些文件以及文件名；如果上传了图片，还需要知道图片的大小等，为此OSS提供了上传回调方案。 流程介绍 当用户要上传一个文件到OSS，而且希望将上传的结果返回…

    阿里云对象存储 2023年12月10日
  • 信息流广告，信息流部分建议宽度830px，只针对默认列表样式，顺序随机
  • 阿里云ECS云服务器创建前缀列表-云淘科技 阿里云服务器

    阿里云ECS云服务器创建前缀列表-云淘科技

    前缀列表是一些网络前缀（即CIDR地址块）的集合，您可以在配置其他资源的网络规则时引用前缀列表。本文介绍如何新建一个前缀列表。 前提条件 如果您使用RAM用户，请确保该RAM用户已被授予前缀列表的相关权限。具体操作，请参见为RAM用户授予前缀列表相关权限。 操作步骤 通过控制台创建前缀列表 登录ECS管理控制台。 在左侧导航栏，选择网络与安全 > &g…

    2023年12月9日

  • 阿里云对象存储OSSPython管理存储空间读写权限-云淘科技

    存储空间（Bucket）是存储对象（Object）的容器。对象都隶属于存储空间。本文介绍如何设置和获取存储空间读写权限（ACL）。 注意事项 本文以华东1（杭州）外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系，请参见访问域名和数据中心。 本…

    阿里云对象存储 2023年12月10日

联系我们

400-800-8888

在线咨询： QQ交谈

邮件：admin@example.com

工作时间：周一至周五，9:30-18:30，节假日休息

关注微信
本站为广大会员提供阿里云、腾讯云、华为云、百度云等一线大厂的购买，续费优惠，保证底价，买贵退差。