You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
37 lines
1.5 KiB
37 lines
1.5 KiB
---
|
|
title: 静态资源代理
|
|
description: 了解如果使用静态资源代理来访问插件中的静态资源
|
|
---
|
|
|
|
插件中的静态资源如图片等如果想被外部访问到，需要放到 `src/main/resources` 目录下，并通过创建 ReverseProxy 自定义模型来进行静态资源代理访问。
|
|
|
|
例如 `src/main/resources` 下的 `static` 目录下有一张 `halo.jpg`:
|
|
|
|
1. 首先需要在 `src/main/resources/extensions` 下创建一个 `yaml`，文件名可以任意。
|
|
2. 示例配置如下：
|
|
|
|
```yaml
|
|
apiVersion: plugin.halo.run/v1alpha1
|
|
kind: ReverseProxy
|
|
metadata:
|
|
# name 为此资源的唯一标识名称，不允许重复，为了避免与其他插件冲突，推荐带上插件名称前缀
|
|
name: my-plugin-fake-reverse-proxy
|
|
rules:
|
|
- path: /res/**
|
|
file:
|
|
directory: static
|
|
# 如果想代理 static 下所有静态资源则省略 filename 配置
|
|
filename: halo.jpg
|
|
```
|
|
|
|
插件启动后会根据 `/plugins/{plugin-name}/assets/**` 规则生成 API。
|
|
因此该 `ReverseProxy` 的访问路径为: `/plugins/my-plugin/assets/res/halo.jpg`。
|
|
|
|
- `rules` 下可以添加多组规则。
|
|
- `path` 为路径前缀。
|
|
- `file` 表示访问文件系统，目前暂时仅支持这一种。
|
|
- `directory` 表示要代理的目标文件目录，它相对于 `src/main/resources/` 目录。
|
|
- `filename` 表示要代理的目标文件名。
|
|
|
|
`directory` 和 `filename` 都是可选的，但必须至少有一个被配置。
|