kkfileview5 安装

拉取最新代码：https://gitee.com/kekingcn/file-online-preview

idea打开项目，5.0版本java版本为21，maven打包会生成压缩包，上传服务器，bin目录执行startup.sh，linux会自动安装相关软件

官方文档地址：https://kkview.cn/zh-cn/docs/production.html

nginx代理配置：

location /kkfileview/ {
    proxy_pass http://127.0.0.1:8012/;
    # 核心配置：传递真实的 Host、IP 和协议信息
    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_set_header X-Forwarded-Proto $scheme;  # 如果是 HTTPS，这一项非常重要
    proxy_set_header X-Forwarded-Host $host;
    
    proxy_http_version 1.1;
    proxy_set_header Connection "";
}

#如果是宝塔面板，需要注释配置文件中的，其他环境也一样
# location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
# {
#     expires      30d;
#     error_log off;
#     access_log /dev/null;
# }
    
# location ~ .*\.(js|css)?$
# {
#     expires      12h;
#     error_log off;
#     access_log /dev/null; 
# }

预览地址：'https://xxxx.com/kkfileview/onlinePreview?url='+encodeURIComponent(Base64.encode('文件访问地址'))

代理访问时application.properties需要修改的地方：

# 设置基础访问地址，填写你外部访问 Nginx 的完整地址，与代理一致
base.url=https://你的域名或公网IP/kkfileview

# 信任站点白名单配置，多个用','隔开
# ⚠️ 安全提示：为防止SSRF攻击，强烈建议配置信任主机白名单
# ⚠️ 如果不配置，系统将默认拒绝所有外部文件预览请求
# 配置示例：
# trust.host = kkview.cn,yourdomain.com,cdn.example.com
# 如果需要允许所有域名（不推荐，仅用于测试环境），请设置为：
# trust.host = *
# 当前配置：默认本机测试 （正式启用请修改）
# trust.host = ${KK_TRUST_HOST:default}
trust.host = *.xxxx.com,a.xxx.com

linux中文乱码，下载如下字体包 https://kkview.cn/resource/fonts.zip 文件解压完整拷贝到Linux下的 /usr/share/fonts目录。然后依次执行mkfontscale 、mkfontdir 、fc-cache使字体生效，重启服务