# kkfileview

**Repository Path**: xiaofeng68/kkfileview

## Basic Information

- **Project Name**: kkfileview
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-26
- **Last Updated**: 2025-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 一、项目简介
项目地址：https://gitee.com/xiaofeng68/kkfileview.git
核心功能：

支持Office、PDF、图片、文本等50+种格式在线预览基于Spring Boot构建，轻量易扩展提供Docker镜像一键部署

### 二、本地编译部署
1.环境准备:
JDK 1.8+
Maven 3.6+
2. 克隆项目
```dtd
git clone https://gitee.com/xiaofeng68/kkfileview.git
cd file-online-preview
```

3. 修改配置

编辑server/src/main/resources/application.yml：可以个性化配置
如server.port= 8012 # 服务端口

4. 编译打包
```dtd
cd server
mvn clean package -Dmaven.test.skip=true
```

5. 启动服务

在server下的target会生成两个包
在windows或者linux解压后进入bin目录，执行startup脚本

6. 验证部署

访问 http://localhost:8012，上传文件测试预览功能。

### 三、Docker镜像打包部署

由于 kkfileview 的基础运行环境很少变动且制作耗时较久，而 kkfileview 本身代码开发会频繁改动，因此把制作其 Docker 镜像的步骤拆分为两次：

首先制作 kkfileview 的基础镜像（kkfileview-base）。

然后使用 kkfileview-base 作为基础镜像进行构建，加快 kkfileview docker 镜像构建与发布。

执行如下命令即可构建基础镜像：
```
cd file-online-preview/docker/kkfileview-base
docker build --tag keking/kkfileview-base:4.4.0 .
```
再构建主要的镜像
```dtd
cd ~/file-online-preview
docker build -t kkfileview:4.4.0-SNAPSHOT .
```

构建完成后，使用docker images就可以看到镜像了

### 四、docker运行

运行容器
```dtd
docker run -it -p 8012:8012 kkfileview:4.4.0-SNAPSHOT
```


通过浏览器访问 http://宿主机IP:8012

### 五、总结

建议结合自身业务需求调整配置，并关注项目更新。遇到问题可前往项目Issues区交流。
实际部署时注意文件挂载替换路径、端口等参数生产环境建议配置HTTPS和访问权限控制定期清理目录避免磁盘占满。