Skip to content
This repository was archived by the owner on Aug 25, 2025. It is now read-only.

Commit c9bd179

Browse files
authored
docs: add docs for kkFileView preview (#82)
* Update preview.md 添加kkFileView配置示例与常见问题解决办法 * Update preview.md tips of deploying and using kkFileView * Update preview.md
1 parent 163aa40 commit c9bd179

File tree

2 files changed

+36
-0
lines changed

2 files changed

+36
-0
lines changed

docs/config/preview.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -107,8 +107,25 @@ Deploying and using `OnlyOffice` Reference:
107107
- https://github.com/AlistGo/alist/discussions/3255
108108
- https://github.com/AlistGo/alist/discussions/8271
109109

110+
:::tip
111+
If you want to use self-deployed kkFileView to preview more file formats,You can add the following configuration here:
112+
113+
```json
114+
{
115+
"doc,docx,xls,xlsx,xlsm,ppt,pptx,csv,tsv,dotm,xlt,xltm,dot,dotx,xlam,xla,pages":
116+
{
117+
"kkFileView": "https://kk.domain.com:8012/onlinePreview?url=$eb_url"
118+
}
119+
}
120+
```
121+
122+
Potential issues when deploying and using kkFileView:
123+
124+
- Browser security policies prohibit mixed protocol usage. kkFileView uses HTTP by default. When accessing openlist via HTTPS, the browser may not support transmission. You can set base.url to HTTPS by adding environment variables, or modify base.url to HTTPS in /opt/kkFileView-4.x.0/config/application.properties of kkFileView.
125+
- When openlist embedded in an iframe communicates with lower-version kkFileView, cross-origin issues may occur due to different domain names. This can be resolved by configuring the Access-Control-Allow-Origin header in reverse proxy.
110126
:::
111127

128+
112129
### **Audio cover**
113130

114131
The default audio cover.

docs/zh/config/preview.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,25 @@ interface {
108108
- https://github.com/AlistGo/alist/discussions/3255
109109
- https://github.com/AlistGo/alist/discussions/8271
110110

111+
112+
:::tip
113+
如果你想使用自部署的kkFileView预览更多格式文件,可以在这里添加如下配置:
114+
```json
115+
{
116+
"doc,docx,xls,xlsx,xlsm,ppt,pptx,csv,tsv,dotm,xlt,xltm,dot,dotx,xlam,xla,pages":
117+
{ 
118+
"kkFileView": "https://kk.domain.com:8012/onlinePreview?url=$eb_url"
119+
}
120+
}
121+
```
122+
部署和使用 `kkFileView` 可能存在以下问题:
123+
124+
- 浏览器安全策略禁止混合使用协议,kkFileView默认使用http进行传输,当使用https访问openlist时,浏览器不支持传输,
125+
可通过添加环境变量设置base.url为https
126+
或修改kkFileView中的/opt/kkFileView-4.x.0/config/application.properties中的base.url为https
127+
128+
- 嵌入iframe的openlist与低版本kkFileView传输时域名不同存在跨域问题,可通过反向代理配置Access-Control-Allow-Origin请求头解决
129+
111130
:::
112131

113132
## **音频封面**

0 commit comments

Comments
 (0)