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

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

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

使用OSS控制台

1. 设置静态网站页面。

   • 未开通子目录首页

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

     1. 登录OSS管理控制台。

     2. 在左侧导航栏，单击云盒Bucket，然后单击目标Bucket名称。

     3. 在左侧导航栏，选择数据管理 > 静态页面。
     4. 在静态页面，单击设置，按如下说明配置各项参数。
        

        参数	说明
        默认首页	默认首页是您通过浏览器访问静态网站域名时，OSS返回的网站首页。此处设置为index.html。
        子目录首页	选择不开通，此时访问静态网站根域名或者根域名下任何一个以正斜线（/）结尾的URL都会返回根目录默认首页。
        默认404页	访问Bucket内文件出现404错误时，OSS返回的错误页面。默认404页仅支持根目录下的文件。此处设置为error.html。
        错误文档响应码	您可以配置返回错误文档时的HTTP响应码为404或200。

     5. 单击保存。

   • 已开通子目录首页

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

     1. 在左侧导航栏，单击云盒Bucket，然后单击目标Bucket名称。

     2. 在左侧导航栏，选择数据管理 > 静态页面。
     3. 在静态页面，单击设置，按如下说明配置各项参数。
        

        参数	说明
        默认首页	默认首页是您通过浏览器访问静态网站域名时，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状态码。 NoSuckKey：直接返回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。

     4. 单击保存。

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

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

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

      
      
          
          
      
        
        
      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文件配置示例如下：

      
      
          
          
      
        
        
      This is error 404 page.
      
      

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

使用阿里云SDK

仅支持通过Java SDK设置静态网站托管，Java SDK要求3.15.0及以上版本。

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

public class Demo {

    public static void main(String[] args) throws Exception {
        // 填写云盒Bucket的数据域名。
        String endpoint = "https://cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写云盒Bucket名称，例如examplebucket。
        String bucketName = "examplebucket";
        // 填写云盒Bucket所在地域。
        String region = "cn-hangzhou";
        // 填写云盒ID。
        String cloudBoxId = "cb-f8z7yvzgwfkl9q0h****";

        // 创建OSSClient实例。
        ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
        conf.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(new DefaultCredentialProvider(credentialsProvider.getCredentials()))
                .clientConfiguration(conf)
                .region(region)
                .cloudBoxId(cloudBoxId)
                .build();

        try {
            // 设置静态网站托管。
            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();
            }
        }
    }
}

使用命令行工具ossutil

关于使用ossutil设置静态网站托管的具体步骤，请参见website（静态网站托管及回源配置）。

使用REST API

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

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

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

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

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

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