获取文件原始数据

注意：

• 通过 gitee.com 访问无需认证的文件原始数据时，会被默认重定向到独立域名 raw.giteeusercontent.com；

• 服务端会缓存公开仓库的文件原始数据，缓存时间 60 ~ 300 秒，具体可通过 HTTP 响应头部 Cache-Control 查看。

原始数据

点击 原始数据 获取对应文件的原始数据：

认证

下列两种场景需要认证：

1. 获取非公开仓库文件原始数据；
2. 获取公开仓库文件原始数据且该原始数据大于 10MB。

认证方式有两种：

1. 用户登录后，通过浏览器可直接访问或者下载文件原始数据；

2. 通过 私人令牌 下载文件原始数据，如：

   curl --oauth2-bearer $GITEE_TOKEN --location https://gitee.com/gitee-sample/raw-private/raw/master/README.md
   curl --oauth2-bearer $GITEE_TOKEN https://raw.giteeusercontent.com/gitee-sample/raw-private/raw/master/README.md

   • --oauth2-bearer 使用 Bearer Token 进行认证；
   • --location 处理重定向。

独立域名

除域名 gitee.com 外，还可通过独立域名 raw.giteeusercontent.com 访问文件原始数据，如：

• https://gitee.com/oschina/git-osc/raw/master/README.md

对应的独立域名链接：

• https://raw.giteeusercontent.com/oschina/git-osc/raw/master/README.md

注意： 通过 gitee.com 访问无需认证的文件原始数据时，会被强制重定向到独立域名 raw.giteeusercontent.com。

缓存

注意： 服务端会缓存公开仓库的文件原始数据，如：

1. 首次访问：

   $ curl --head https://gitee.com/oschina/git-osc/raw/master/README.md
   HTTP/1.1 200 OK
   ...
   Cache-Control: public, max-age=60
   ...
   Etag: W/"fdd939d819d4f107e1bd8771088d572a8e8d0463"
   ...
   Age: 0
   X-Cache: MISS
   ...

   • Cache-Control 缓存控制，max-age=60 表示数据会被缓存时间 60 秒；
   • Age 数据已经缓存了多久，单位为秒；
   • X-Cache 是否命中缓存，MISS 表示未命中。

2. 再次访问：

   $ curl --head https://gitee.com/oschina/git-osc/raw/master/README.md
   HTTP/1.1 200 OK
   ...
   Cache-Control: public, max-age=60
   ...
   Etag: W/"fdd939d819d4f107e1bd8771088d572a8e8d0463"
   ...
   Age: 6
   X-Cache: HIT
   ...

   • Age 值为 6 数据已经缓存了 6 秒；
   • X-Cache 值为 HIT 表示命中缓存。