Sign inSign up

nn200433/kkfileview

By nn200433

•Updated over 2 years ago

kFileView为文件文档在线预览解决方案,基本支持主流办公文档的在线预览

Image
1

10K+

nn200433/kkfileview repository overview

由于官方的 Docker 仓库已经不是最新版本,特此自行打包一些版本


kkFileView为文件文档在线预览解决方案,有如下特性:

  1. 一键部署,快速接入
  2. 支持常见文件格式,兼容新版Office文档
  3. 支持多种预览模式灵活切换
  4. 独立部署,提供restful接口,适用于微服务场景

官网:https://kkfileview.keking.cn⁠

码云开源地址:https://gitee.com/kekingcn/file-online-preview⁠

GITHUB开源地址:https://gitee.com/kekingcn/file-online-preview⁠


⁠Docker容器环境环境运行

注意:文件映射目录可以在 git 上的 Dockerfile 文件中搜寻

  • 拉取镜像
docker pull nn200433/kkfileview:4.2.1
  • docker 运行
docker run -it -p 8012:8012 nn200433/kkfileview:4.2.1
  • docker-compose.yml
version: '3'
services:
  kkfileView:
    image: nn200433/kkfileview:4.2.1
    container_name: kkfileView
    restart: unless-stopped
    ports: 
      - 8012:8012
    #volumes: 
    #  - /home/kkFileView/:/opt/kkFileView-4.1.0-SNAPSHOT/
    environment: 
      # #office类型文档(word ppt)样式,默认为图片(image),可配置为pdf(预览时也有按钮切换)
      - KK_OFFICE_PREVIEW_TYPE=pdf
      # 是否关闭office预览切换开关,默认为false,可配置为true关闭
      - KK_OFFICE_PREVIEW_SWITCH_DISABLED=true
      # 是否禁止下载转换生成的pdf文件
      - KK_PDF_DOWNLOAD_DISABLE=true
      # 是否禁用首页文件上传
      - KK_FILE_UPLOAD_ENABLED=true
      # kkFileView运行时tomcat的ServletContext 默认值:/
      - KK_CONTEXT_PATH=/preview
      # 提供预览服务的地址,默认从请求url读,如果使用nginx等反向代理,需要手动设置(参考下方的 “代理配置” )
      - KK_BASE_URL=http://wwww.xxxx.com/preview
  • 浏览器访问容器 8012 端口 http://www.xxxx.com/preview 即可看到项目演示用首页

⁠代理配置

主要用到以下两个配置:

  • server.context-path
  • base.url
⁠server.context-path

说明:kkFileView运行时tomcat的ServletContext

默认值:/

示例:server.context-path = /preview

⁠base.url

说明:提供预览服务的地址,默认从接收请求url读,如果使用nginx等反向代理,需要手动设置为通过nginx访问预览服务的地址

默认值:未设置

示例:base.url = https://file.keking.cn/preview⁠

例如nginx的访问地址为 https://file.keking.cn 想要使用 https://file.keking.cn/preview/ 来做预览,kkFileView部署在内网 192.168.1.2 服务器上,需要在 nginx 中添加反向代理如下

location /preview  {
    proxy_pass http://192.168.1.2:8012;
    proxy_redirect default;
    add_header backendIP $upstream_addr;
    #proxy_set_header   Host             $host;
    proxy_set_header  Host $host:$server_port;      
    proxy_set_header   X-Real-IP        $remote_addr; 
    proxy_set_header   X-Forwarded-For  $proxy_add_x_forwarded_for; 
    proxy_connect_timeout 30;
    proxy_read_timeout 30;
    proxy_send_timeout 30;
}

修改kkFileView的配置文件如下两项

server.context-path = /preview
base.url = https://file.keking.cn/preview

Tag summary

Content type

Image

Digest

sha256:ab09f2762…

Size

837.6 MB

Last updated

over 2 years ago

docker pull nn200433/kkfileview:4.4.0-beta