kkfileview 外网 nginx

### 配置外网环境下 Nginx 支持 KKFileView 文件预览

#### 一、准备阶段

确保已经下载并解压了适合操作系统的 kkFileView 压缩包[^2]。对于 Windows 用户应使用 .zip 版本；而对于 Linux 或 MacOS 用户，则需采用 .tar.gz 格式的压缩包。

#### 二、修改配置文件适应外部访问需求

针对位于内部网络并通过网闸连接至外界的情况，在 `kkFileView` 的配置文件中设置正确的 base URL 是至关重要的。具体来说，应当指定能够通过网闸访问的 IP 地址作为基础路径的一部分，从而使得所有的请求都能够顺利穿过网闸到达实际部署有 KkFileView 应用程序的服务端口[^3]。

#### 三、调整 LibreOffice 安装位置参数

如果在 CentOS 7 上遇到了由于未正确指明 LibreOffice 路径而导致的问题，可以通过编辑 `application.properties` 文件来解决此问题。将其中 office.home 参数指向本地已安装的 LibreOffice 实际目录可以有效规避此类错误的发生[^4]。

#### 四、Nginx 配置实例

为了使 KKFileView 可以外部访问，下面给出一段用于配置 Nginx 来代理转发 HTTP 请求给后端运行着 KKFileView 的 Tomcat 或 Jetty 等 Java Web Server 的示例：

server {
    listen       80;
    server_name  yourdomain.com;

    location / {
        proxy_pass http://localhost:9090; # 这里假设KKFileView运行于9090端口上
        proxy_set_header Host $host;
        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;
        
        client_max_body_size 100m; # 设置允许上传的最大文件大小
        
        add_header Access-Control-Allow-Origin *; # 如果需要跨域支持可开启这一行
    }
}

上述配置实现了基本的功能，即接收来自互联网用户的请求并将它们传递给同一台机器上的另一个 web service (如Tomcat)，该service负责处理具体的业务逻辑和服务提供。