kkFileView - GitLite

KO | EN

gitlite — search

#react #ai #typescript #go #golang #deep-learning #linux #macos #nodejs #awesome #vue #security #openai #open-source

kkFileView

(★ 14,553)

Spring-Boot 기반 범용 파일 온라인 미리보기 프로젝트

파일 탐색기

최종 버전 다운로드 (.zip)

파일 수가 많아 일부만 표시됩니다. 전체 파일은 위 다운로드 버튼으로 확인해 주세요.

- - config.yml
  - feature-request.yml
  - issue-report.yml
- - deploy_windows_winrm.py
  - remote_windows_deploy.ps1
- - auto-close-old-issues.yml
  - copilot-issue-auto-comment.yml
  - master-auto-deploy.yml
  - maven.yml
  - nightly-e2e.yml
  - pr-e2e-mvp.yml
- MasterPipeline.yml
- ci-auto-deploy.md
- e2e-improvement-checklist.md
- gitee星球.png
- github星球.png
- - Dockerfile
  - README.cn.md
  - README.md
.gitattributes
.gitignore
AGENTS.md
Dockerfile
LICENSE
pom.xml
README.cn.md
README.md
SECURITY.md
SECURITY_CONFIG.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/kekingcn/kkFileView

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd kkFileView

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker build -t kkfileview .

Dockerfile을 기반으로 실행 가능한 이미지를 빌드합니다.

docker run -p 8080:80 kkfileview

빌드된 이미지를 실제 컨테이너로 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

3. Maven (Java)

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java 프로젝트를 빌드/실행하려면 필요합니다.
Maven mvn 명령어를 쓰기 위한 빌드 도구입니다.

mvn clean install

Maven으로 의존성 설치와 빌드를 진행합니다.

✅ BUILD SUCCESS 메시지가 뜨면 성공입니다. target/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# kkFileView
### 소개
인기 있는 Spring Boot 프레임워크를 사용하여 구축된 문서 온라인 미리보기 프로젝트 솔루션으로, 손쉽게 설정하고 배포할 수 있습니다. 이 다목적 오픈소스 프로젝트는 다음과 같은 다양한 문서 형식에 대한 기본 지원을 제공합니다:
1. `doc`, `docx`, `xls`, `xlsx`, `xlsm`, `ppt`, `pptx`, `csv`, `tsv`, `dotm`, `xlt`, `xltm`, `dot`, `xlam`, `dotx`, `xla`, `pages`, `pptm` 등의 Office 문서를 지원합니다.
2. `wps`, `dps`, `et`, `ett`, `wpt` 같은 국내산 WPS Office 문서를 지원합니다.
3. `odt`, `ods`, `ots`, `odp`, `otp`, `six`, `ott`, `fodt`, `fods` 등 OpenOffice 및 LibreOffice 문서를 지원합니다.
4. `vsd`, `vsdx` 같은 Visio 순서도 파일을 지원합니다.
5. `wmf`, `emf` 같은 Windows 시스템 이미지 파일을 지원합니다.
6. `psd`, `eps` 같은 Photoshop 소프트웨어 모델 파일을 지원합니다.
7. `pdf`, `ofd`, `rtf` 같은 문서 형식을 지원합니다.
8. `xmind` 같은 소프트웨어 모델 파일을 지원합니다.
9. `bpmn` 워크플로우 파일을 지원합니다.
10. `eml`, `msg` 메일 파일을 지원합니다.
11. `epub` 전자책 문서를 지원합니다.
12. `obj`, `3ds`, `stl`, `ply`, `gltf`, `glb`, `off`, `3dm`, `fbx`, `dae`, `wrl`, `3mf`, `ifc`, `brep`, `step`, `iges`, `fcstd`, `bim` 등의 3D 모델 파일을 지원합니다.
13. `dwg`, `dxf`, `dwf`, `iges`, `igs`, `dwt`, `dng`, `ifc`, `dwfx`, `stl`, `cf2`, `plt` 등의 CAD 모델 파일을 지원합니다.
14. `txt`, `xml` (렌더링), `md` (렌더링), `java`, `php`, `py`, `js`, `css` 등 모든 일반 텍스트 파일을 지원합니다.
15. `zip`, `rar`, `jar`, `tar`, `gzip`, `7z` 등의 압축 패키지를 지원합니다.
16. `jpg`, `jpeg`, `png`, `gif`, `bmp`, `ico`, `jfif`, `webp`, `heic`, `heif` 등의 이미지 미리보기(회전, 확대/축소, 대칭 이동)를 지원합니다.
17. `tif`, `tiff` 같은 이미지 정보 모델 파일을 지원합니다.
18. `tga` 같은 이미지 포맷 파일을 지원합니다.
19. `svg` 같은 벡터 이미지 포맷 파일을 지원합니다.
20. `mp3`, `wav`, `mp4`, `flv`를 지원합니다.
21. `avi`, `mov`, `wmv`, `mkv`, `3gp`, `rm` 등 많은 오디오 및 비디오 포맷 파일을 지원합니다.
22. `dcm`을 지원합니다.
23. `drawio`를 지원합니다.
### 주요 기능
- 인기 있는 프레임워크인 Spring Boot로 구축
- 손쉬운 빌드 및 배포
- Doc, docx, Excel, PDF, TXT, zip, rar, 이미지 등 주류 오피스 문서의 온라인 미리보기 기본 지원
- REST API
- 파일 미리보기 인터페이스 추상화를 통해 더 많은 파일 확장자를 쉽게 확장하고 프로젝트를 자체적으로 개발할 수 있음
### 공식 웹사이트 및 문서 (DOCS)
URL：[https://kkview.cn](https://kkview.cn/)
### 라이브 데모
> 공용 서비스를 소중히 다뤄주세요. 그렇지 않으면 언제든지 중단될 수 있습니다.
URL：[https://file.kkview.cn](https://file.kkview.cn)
### 문의하기
> 질문에 성심껏 답변해 드리고 프로젝트 사용 중 발생하는 모든 문제를 해결해 드리겠습니다. 시간 절약과 비효율적인 소통을 방지하기 위해 질문하기 전에 최소한 Google이나 Baidu 검색을 먼저 해주시기를 부탁드립니다. 우리의 소중한 시간을 아끼고 비효율적인 소통은 멀리합시다.
![](./doc/github星球.png/)
### 빠른 시작
> 기술 스택
- Spring boot： [spring boot Development Reference Guide](http://www.kailing.pub/PdfReader/web/viewer.html?file=springboot)
- Freemarker
- Redisson
- Jodconverter
> 의존성
- Redis (선택 사항, 기본적으로는 불필요)
- OpenOffice 또는 LibreOffice (Windows에는 통합되어 있으며, Linux에서는 자동으로 설치되고, Mac OS에서는 수동으로 설치해야 함)
1. 첫 번째 단계：`git pull https://github.com/kekingcn/kkFileView.git`
2. 두 번째 단계：`/server/src/main/java/cn/keking/ServerMain.java`의 메인 메서드를 실행합니다. 시작 후 `http://localhost:8012/`에 접속하세요.
## 변경 이력
### 버전 5.0.2 (2026년 8월 14일)
#### 보안 수정
1. 신뢰할 수 없는 HTML 미리보기를 불투명 출처(opaque-origin) iframe 내에 샌드박스화하고 기본적으로 임베디드 JavaScript를 비활성화하여, 미리보기된 파일이 kkFileView 애플리케이션 출처에서 실행되는 것을 방지합니다 (GHSA-9wcf-jxxf-w2g2)
2. 데모 파일 삭제 엔드포인트를 기본적으로 비활성화하고, POST 방식으로 변경했으며, 정확히 일치하는 명시적으로 구성된 비밀번호를 요구하도록 변경했습니다 (GHSA

-f3qx-xrwc-5428)
#### 수정 사항
1. PDF 변환 시작 시 ImageIO 플러그인을 새로 고쳐 JBIG2 리더와 같은 중첩된 JAR 공급자가 검색되도록 하여, PDF-to-image 미리보기에서 이미지가 사라지는 현상 방지
#### 업그레이드 참고 사항
1. v5.0.1 이하 버전을 실행 중인 모든 사용자는 v5.0.2로 업그레이드하는 것을 강력히 권장합니다.
2. JDK 21 이상이 계속 필요하며, 기존 v5.0.1 설정을 재사용할 수 있습니다.
3. `KK\_DELETE\_PASSWORD` 또는 외부 `delete.password`가 독립적인 강력한 비밀번호로 설정되지 않은 경우 파일 삭제가 비활성화됩니다. 연동 시 POST 방식으로 `/deleteFile`을 호출해야 합니다.
4. `kk.scriptjs`의 기본값이 `false`로 변경되었습니다. 명시적으로 활성화된 경우에도 스크립트는 격리된 iframe 샌드박스 내에서만 실행됩니다.
### Version 5.0.1 (2026년 7월 13일)
#### 보안 수정 사항
1. 신뢰할 수 있는 호스트 및 로컬 디렉토리 필터를 우회하던 `/addTask` 취약점 수정 (서버 측 요청 위조(SSRF) 유발 가능성 있음) (GHSA-gwwj-52hv-6g2m)
2. `/listFiles`의 `directory` 파라미터가 데모 디렉토리를 탈출하던 문제 수정 (경로 순회 및 디렉토리 정보 노출 유발 가능성 있음) (GHSA-pmp8-g8p2-p6jq)
#### 수정 사항
1. PDF 교차 출처(CORS) 접근, 페이지 위치 지정, 텍스트 강조 표시, 인쇄 및 인쇄 워터마크 이슈 수정
2. 리버스 프록시 뒤에서의 PDF 절대 경로 문제 및 워터마크 또는 강조 텍스트에 특수문자가 포함된 경우의 파싱 실패 수정
3. 주소 프로토콜 누락을 포함하여 스탠드알론, 클러스터, 마스터-레플리카, 센티넬 모드 간의 일관성 없는 Redis 설정 수정
4. MIME 유효성 검사 실패 후의 성공 응답, 불명확한 HTTP 오류 보고, 공유된 HTTP 클라이언트의 우발적 종료 수정
5. LuckyExcel 데이터 유효성 검사 유형에 매핑이 없을 때 발생하는 xlsx 파싱 크래시 수정
#### 개선 사항
1. 대용량 xlsx 파일에 대한 LuckyExcel 파싱을 Web Worker로 이동했으며, Worker를 사용할 수 없거나 실패할 경우 메인 스레드로 자동 대체(fallback) 기능 추가
2. PDF 사이드바의 기본 열림 여부를 제어하기 위한 `pdf.sidebar.open` 추가
3. Maven CI에 Linux, Windows, macOS 유효성 검사 추가
4. 저장소 보안 정책 및 비공개 취약점 보고 가이드 추가
#### 업그레이드 참고 사항
1. v5.0.0 이하 버전을 실행 중인 모든 사용자는 v5.0.1로 업그레이드하는 것을 강력히 권장합니다.
2. JDK 21 이상이 계속 필요하며, 기존 v5.0.0 설정을 재사용할 수 있습니다.
### Version 5.0.0 (2026년 4월 14일)
#### 개선 사항
1. xlsx 프론트엔드 파싱 강화 - Excel 파일 프론트엔드 렌더링 성능 향상
2. 이미지 파싱 최적화 - 이미지 처리 메커니즘 강화
3. tif 파싱 개선 - TIF 포맷 지원 강화
4. svg 파싱 강화 - SVG 벡터 이미지 렌더링 최적화
5. json 파싱 개선 - JSON 파일 처리 강화
6. ftp 다중 클라이언트 접근 최적화 - FTP 서비스 호환성 향상
7. 홈 페이지 디렉토리 접근 강화 - 서버 측 페이지네이션 메커니즘 구현
8. marked 파싱 개선 - Markdown 렌더링 강화
9. 아카이브 미리보기를 접을 수 있는 트리와 인라인 파일 미리보기가 포함된 단일 작업 공간으로 재설계
10. 아카이브 미리보기 파일 유형 배지 및 단일 이미지 미리보기 스타일링 개선
11. 엔지니어링 자동화 및 유지보수를 위한 에이전트 중심의 저장소 가이드 추가
12. 인덱스, 연동 가이드, 릴리스 기록, 스폰서 페이지를 포함한 데모 포털 페이지 새로 고침
#### 새로운 기능
1. msg 이메일 파싱 - msg 포맷 이메일 파일 미리보기 지원 추가
2. heic 이미지 파싱 - HEIC 포맷 이미지 미리보기 지원 추가
3. 교차 도메인 메서드 - 교차 도메인 처리 메커니즘 추가
4. 강조 표시 메서드 - 텍스트 강조 표시 기능 추가
5. 페이지네이션 메서드 - 문서 페이지 제어 기능 추가
6. AES 암호화 메서드 - AES 암호화 지원 추가
7. 기본 인증 메서드 - Basic 인증 메커니즘 추가
8. 키 관리 메서드 - 키 관리 기능 추가
9. 중복 변환 방지 - 중복 파일 변환 방지 보호 기능 추가
10. 비동기 대기 - 비동기 처리 메커니즘 추가
11. 업로드 제한 - 지원되지 않는 파일 업로드에 대한 제한 추가
12. cadviewer con

version methods - CAD viewer 변환 기능 추가
#### Fixed Issues
1. 압축 파일 경로 문제 - 압축 파일 내의 내부 경로 처리 수정
2. 보안 문제 - 보안 취약점 수정
3. 불완전한 이미지 워터마크 문제 - 워터마크가 불완전하게 표시되는 현상 수정
4. SSL 자체 서명 인증서 접근 문제 - 자체 서명 인증서와의 호환성 수정
5. 기존 파일에 반복 추출 내용이 추가되면서 압축 파일 내 Office 파일이 로딩 중에 멈춰 있던 현상 수정
6. 기본 Office 미리보기 방식을 이제 PDF 모드로 우선 적용하며, PDF 미리보기는 기본적으로 썸네일 사이드바가 표시된 상태로 열리도록 수정
7. 오래된 하드코딩된 jar 이름에 의존하는 대신 패키지된 jar를 동적으로 검색하도록 시작 스크립트 업데이트
8. 5.0.0 릴리스 라인에 맞추어 Docker 및 릴리스 도우미 문서 업데이트
9. OFD 테이블 테두리 오버플로우 렌더링 문제 수정
10. 호환성 환경에서 미리보기 오류를 방지하기 위해 PDF.js 호환성 폴리필 개선
#### Updates
1. JDK 버전 요구 사항 - JDK 21 이상 필수 요구
2. pdf 프론트엔드 파싱 업데이트 - PDF 프론트엔드 렌더링 컴포넌트 업그레이드
3. odf 프론트엔드 파싱 업데이트 - ODF 문서 프론트엔드 렌더링 업그레이드
4. 3D 모델 프론트엔드 파싱 업데이트 - 3D 모델 viewer 업그레이드
5. pdf 백엔드 비동기 변환 최적화 - 멀티스레드 비동기 변환 구현
6. tif 백엔드 비동기 변환 최적화 - 멀티스레드 비동기 변환 구현
7. Video 백엔드 비동기 변환 최적화 - 멀티스레드 비동기 변환 구현
8. CAD 백엔드 비동기 변환 최적화 - 멀티스레드 비동기 변환 구현
9. 기본 미리보기 설정 전략 조정 - Office 미리보기의 기본값이 PDF 모드로 변경되었으며, 모드 전환 버튼이 기본적으로 숨겨지고, PDF 미리보기는 썸네일 사이드바가 표시된 상태로 열립니다. 업그레이드 후 기존의 이미지 우선 동작이 필요한 경우, `office.preview.type=image` 및 `office.preview.switch.disabled=false`를 명시적으로 설정하세요.
10. 신뢰할 수 있는 호스트(Trust host) 설정 매칭 확장 - `trust.host` 및 관련 규칙이 이제 와일드카드 및 CIDR 매칭을 지원하며, 패턴에 따라 업그레이드 후 유효한 허용/차단 동작이 넓어지거나 좁아질 수 있습니다.
### Version 4.4.0 (2025년 1월 16일)
#### New Features
1. xlsx 인쇄 지원
2. 설정에 GZIP 압축 활성화 기능 추가
3. CAD 포맷의 SVG 및 TIF 포맷 변환 지원 추가, 타임아웃 종료 및 스레드 관리 기능 추가
4. 파일 삭제 시 캡차(captcha) 인증 추가
5. xbrl 포맷 미리보기 지원 추가
6. PDF 미리보기에 서명, 도면, 일러스트레이션 제어, 검색 위치 지정 페이지네이션, 표시 콘텐츠 정의 제어 기능 추가
7. CSV 포맷 프론트엔드 파싱 지원 추가
8. ARM64용 Docker 이미지 지원 추가
9. Office 미리보기 변환 타임아웃 속성 설정 추가
10. 미리보기 파일 호스트 블랙리스트 메커니즘 추가
#### Optimizations
1. OFD 모바일 미리보기 페이지 적응성 최적화
2. xlsx 프론트엔드 파싱 컴포넌트 업데이트를 통한 파싱 속도 가속화
3. CAD 컴포넌트 업그레이드
4. Office 기능 조정 (댓글, 변환 페이지 제한, 워터마크 생성 등 지원)
5. markdown 컴포넌트 업그레이드
6. dcm 파싱 컴포넌트 업그레이드
7. PDF.JS 파싱 컴포넌트 업그레이드
8. 비디오 플레이어 플러그인을 ckplayer로 변경
9. 수정된 이미지 포맷을 지원하는 더 스마트한 tif 파싱 기능 적용
10. 대용량 및 소용량 텍스트 파일의 문자 인코딩 감지 정확도 향상 및 동시성 취약점 처리
11. 파일 다운로드 코드 리팩토링 및 일반 파일 서버 인증 접근 디자인 추가
12. bootstrap 컴포넌트 업데이트 및 불필요한 파일 정리
13. epub 버전 업데이트 및 epub 표시 효과 최적화
14. 예약된 캐시 정리 작업이 멀티미디어 파일 타입의 디스크 캐시 파일만 삭제하던 문제 수정
15. 설치된 Office 컴포넌트 자동 감지, LibreOffice 7.5 및 7.6 버전의 기본 경로 추가
16. drawio 기본값을 미리보기 모드로 변경
17. PDF 스레드 관리 및 타임아웃 관리 추가

memory cache management, updated PDF parsing component version
18. 진정한 크로스 플랫폼 이미지 빌드를 위해 Dockerfile 최적화
#### Fixes
1. 로컬 캐시 파일이 업데이트되지 않던 forceUpdatedCache 속성 설정 문제 수정
2. 암호화된 파일 변환 성공 후 PDF 복호화 오류 수정
3. BPMN 크로스 도메인 지원 문제 수정
4. 압축 패키지 2차 리버스 프록시에서의 특수 문자 오류 수정
5. 비디오 크로스 도메인 설정으로 인한 비디오 미리보기 실패 수정
6. TXT 텍스트 페이지네이션 2차 로딩 문제 수정
7. Drawio 누락된 Base64 컴포넌트 문제 수정
8. Markdown 이스케이프 문제 수정
9. EPUB 크로스 도메인 오류 수정
10. URL 특수 문자 문제 수정
11. 압축 패키지 순회 취약점 수정
12. 압축 파일 경로 오류, 이미지 컬렉션 경로 오류, 워터마크 문제 등 수정
13. EMF 형식 파일이 포함된 XLSX의 프론트엔드 파싱 오류 수정
### Version 4.3.0 (2023년 7월 5일)
#### New Features
1. DCM 의료 디지털 이미징 미리보기 추가
2. drawio 드로잉 미리보기 추가
3. 캐시가 활성화된 상태로 다시 생성하는 명령어 추가: &forceUpdatedCache=true
4. dwg CAD 파일 미리보기 추가
5. PDF 파일 비밀번호 지원 추가
6. PDF 파일 이미지 생성을 위한 DPI 커스터마이징 추가
7. 변환된 OFFICE, CAD, TIFF, 압축 패키지 소스 파일 삭제 설정 추가 (디스크 공간 절약을 위해 기본적으로 활성화됨)
8. 프론트엔드 xlsx 파싱 방식 추가
9. pages, eps, iges, igs, dwt, dng, ifc, dwfx, stl, cf2, plt 및 기타 형식 지원 추가
#### Optimizations
1. 중복 이름을 방지하기 위해 생성된 PDF 파일 이름에 파일 확장자 포함하도록 수정
2. SQL 파일 미리보기 방식 조정
3. OFD 미리보기 호환성 최적화
4. TXT 텍스트 페이지네이션 상자 표시 미화
5. Linux/Docker 내장 office를 LibreOffice-7.5.3으로 업그레이드
6. Windows 내장 office를 LibreOffice-7.5.3 Portable로 업그레이드
7. 기타 기능 최적화
#### Fixes
1. 리버스 프록시 시나리오에서 압축 패키지 경로 오류 수정
2. 이미지 미리보기 URL에 &가 포함된 경우 발생하는 .click 오류 수정
3. 알려진 OFD 미리보기 문제 수정
4. 압축 패키지 미리보기에서 파일 디렉토리(트리 노드) 클릭 시 페이지 오류 수정
5. 기타 알려진 문제 수정
### Version 4.2.1 (2023년 4월 18일)
#### Change Log
1. dwg 파일 미리보기의 널 포인터 버그 수정
### Version 4.2.0 (2023년 4월 13일)
#### New Features
1. SVG 형식 파일 미리보기 지원 추가
2. 암호화된 Office 파일 미리보기 지원 추가
3. 암호화된 zip, rar 및 기타 압축 패키지 파일 미리보기 지원 추가
4. xmind 소프트웨어 모델 파일 미리보기 지원 추가
5. BPMN 워크플로우 모델 파일 미리보기 지원 추가
6. eml 이메일 파일 미리보기 지원 추가
7. EPUB 전자책 파일 미리보기 지원 추가
8. office 문서 형식 지원 추가: dotm, ett, xlt, xltm, wpt, dot, xlam, xla, dotx 등
9. 3D 모델 파일 지원 추가: obj, 3ds, stl, ply, gltf, glb, off, 3dm, fbx, dae, wrl, 3mf, ifc, brep, step, iges, fcstd, bim 등
10. 설정 가능한 고위험 파일 업로드 제한 추가 (예: exe 파일)
11. 설정 가능한 사이트 신고 정보 추가
12. 데모 사이트 파일 삭제 시 비밀번호 요구 사항 추가
#### Optimizations
1. 텍스트 문서 미리보기 캐싱 추가
2. 404, 500 에러 페이지 미화
3. 인보이스 및 기타 OFD 파일 미리보기 인장 렌더링 호환성 최적화
4. office-plugin 모듈 제거, 새로운 jodconverter 컴포넌트 사용
5. Excel 파일 미리보기 효과 최적화
6. CAD 파일 미리보기 효과 최적화
7. xstream, junrar, pdfbox 및 기타 의존성 버전 업데이트
8. TIF to PDF 변환 플러그인 업데이트, 변환 캐시 추가
9. 데모 페이지 UI 배포 최적화
10. 압축 패키지 파일 미리보기 디렉토리 지원
#### Fixes
1. 일부 인터페이스의 XSS 문제 수정
2. 콘솔에 출력되는 데모 주소가 content-path 구성을 따르지 않던 문제 수정
3. OFD 파일 미리보기 크로스 도메인 문제 수정
4. 내부 자체 서명된 인증서 HTTPS URL 파일 다운로드 문제 수정
5. 특수 문자 파일 삭제 문제 수정
6. PDF를 이미지로 변환할 때 회수되지 않은 메모리로 인한 OOM 수정

sion
7. xlsx 7.4+ 버전 파일의 미리보기 깨짐 현상 수정
8. TrustHostFilter가 크로스도메인 인터페이스를 가로채지 못하는 문제 수정 (보안 이슈 - TrustHost 사용 시 업그레이드 필수)
9. Linux 시스템에서 압축 패키지 파일 미리보기의 파일명이 깨지는 이슈 수정
10. OFD 파일 미리보기가 10페이지만 표시되던 문제 수정
### Changelog
> 2022년 12월 14일, version 4.1.0 출시:
1. @wsd7747님의 기여로 홈페이지 디자인 업데이트.
2. @zhangzhen1979님의 기여로 pdf 및 jpg 변환 시 멀티페이지 tif 호환 및 tif 이미지 미리보기 시 다중 페이지 온라인 미리보기 지원.
3. @yl-yue님의 기여로 계층형 빌드 방식을 사용하여 docker 빌드 최적화.
4. @yl-yue님의 기여로 userToken 캐시 기반 파일 암호화 구현.
5. @yl-yue님의 기여로 암호화된 Word, PPT, Excel 파일 미리보기 구현.
6. Linux 및 Docker 이미지를 LibreOffice 7.3으로 업그레이드.
7. OFD 미리보기 컴포넌트, tif 미리보기 컴포넌트 업데이트 및 PPT 워터마크 지원 추가.
8. 그 외 다수의 업그레이드, 최적화 및 버그 수정.
코드 기여를 해주신 @yl-yue, @wsd7747, @zhangzhen1979, @tomhusky, @shenghuadun, @kischn.sun 님께 감사드립니다.
> 2021년 7월 6일, version 4.0.0 출시:
1. 기본 시스템의 OpenOffice 통합이 LibreOffice로 대체되어 호환성이 향상되고 Office 파일의 미리보기 효과가 개선되었습니다.
2. 압축 파일의 디렉토리 순회(path traversal) 취약점 수정.
3. PDF 모드에서 PPT 파일 미리보기가 작동하지 않던 이슈 수정.
4. PPT 파일의 이미지 미리보기 모드에서 프론트엔드 출력이 비정상적이던 이슈 수정.
5. 새로운 기능 추가: 홈페이지의 파일 업로드 기능을 설정을 통해 실시간으로 활성화 또는 비활성화할 수 있습니다.
6. Office 프로세스 종료 로깅 최적화.
7. Windows 환경에서 Office 컴포넌트 검색 로직 최적화, 내장된 LibreOffice 우선 적용.
8. Office 프로세스 시작의 동기식 실행 최적화.
> June 17, 2021, version 3.6.0 출시:
이 버전에는 OFD 파일 형식 버전에 대한 지원이 포함되어 있으며, 이번 릴리스의 모든 주요 기능은 커뮤니티에서 기여했습니다. 코드 기여를 해주신 @gaoxingzaq, @zhangxiaoxiao9527 님께 감사드립니다.
1. OFD 형식 파일 미리보기 지원 추가. OFD는 PDF와 유사한 자국산 파일 형식입니다.
2. ffmpeg를 통한 비디오 파일 트랜스코딩 및 미리보기 지원 추가. 트랜스코딩을 활성화하면 이론적으로 RM, RMVB, FLV 등 모든 주류 비디오 파일 형식을 미리 볼 수 있습니다.
3. PPT 및 PPTX 파일 형식의 미리보기 효과를 이전 버전보다 훨씬 보기 좋게 개선했습니다.
4. pdfbox, xstream, common-io 등 종속성 버전 업데이트.
> 2021년 1월 28일:
2020년 설날의 최종 업데이트가 출시되었으며, 주로 일부 UI 개선, QQ 그룹 사용자가 신고한 버그 및 이슈 수정이 포함되었으며, 무엇보다도 좋은 한 해를 위한 새로운 버전입니다.
1. 비정상적인 파일 이름으로 인해 발생하는 파일 다운로드 비정상 문제를 해결하기 위해 galimatias 도입.
2. 인덱스 접근 데모 인터페이스의 UI 스타일 업데이트.
3. markdown 파일 미리보기의 UI 스타일 업데이트.
4. XML 파일 미리보기의 UI 스타일 업데이트, 텍스트 파일 미리보기의 아키텍처를 조정하여 확장 용이하게 개선.
5. simTxT 파일 미리보기의 UI 스타일 업데이트.
6. 여러 이미지의 연속 미리보기 UI를 위아래로 넘기도록 조정.
7. apache-common-io 패키지를 채택하여 모든 파일 다운로드 IO 작업 단순화.
8. XML 파일 미리보기가 순수 텍스트 모드로 전환 지원.
9. url base64 디코딩 실패 시 프롬프트 정보 강화.
10. 임포트 오류 및 이미지 미리보기 버그 수정.
11. 릴리스 패키지 실행 시 로그 디렉토리 누락 문제 수정.
12. 압축 패키지 내 여러 이미지의 연속 미리보기 버그 수정.
13. 파일 형식 확장자의 대소문자 범용 일치 항목이 없던 문제 수정.
14. 일부 JDK 버전에서 발생하는 예외를 수정하기 위해 Base64 인코딩에 Apache Commons-code 구현 사용 지정.
15. F

텍스트 유사 파일의 HTML 파일 미리보기 버그를 수정했습니다.
16. dwg 파일 미리보기 시 jpg와 pdf 간 전환이 불가능하던 문제를 수정했습니다.
17. 반사형 XSS(reflected XSS)를 방지하기 위해 위험한 문자를 이스케이프 처리했습니다.
18. 중복 인코딩으로 인해 문서-이미지 미리보기가 실패하던 문제를 수정하고 인코딩을 표준화했습니다.
> 2020년 12월 27일:
2020년 연말 대규모 업데이트에는 포괄적인 아키텍처 디자인, 완전한 코드 리팩토링, 코드 품질의 대폭적인 향상, 그리고 더 편리한 2차 개발이 포함되어 있습니다. 소스 코드를 검토하고 이슈(issue)와 풀 리퀘스트(pull request)를 통해 빌드에 기여해 주시기 바랍니다.
1. 아키텍처 모듈을 조정하고, 코드를 대대적으로 리팩토링하며, 코드 품질을 몇 단계 향상했습니다. 자유롭게 검토해 주세요.
2. XML 파일 미리보기 효과를 개선하고 XML 문서 구조 미리보기를 추가했습니다.
3. md 렌더링 및 소스 텍스트와 미리보기 간 전환 지원을 포함하여 markdown 파일 미리보기 지원을 추가했습니다.
4. 기본 웹 서버를 jetty로 전환하여 다음 이슈를 해결했습니다: https://github.com/kekingcn/kkFileView/issues/168
5. 파일 인코딩 인식 문제를 해결하기 위해 cpdetector를 도입했습니다.
6. 특이한 파일 이름의 미리보기 문제를 완전히 해결하기 위해 URL에 base64와 urlencode를 사용한 이중 인코딩을 적용했습니다.
7. office 파일 미리보기 전환을 제어하기 위한 설정 항목 office.preview.switch.disabled를 추가했습니다.
8. 텍스트 파일 미리보기 로직을 최적화하여 Base64를 통해 콘텐츠를 전송함으로써 미리보기 중에 파일 콘텐츠를 다시 요청하는 것을 방지했습니다.
9. 이미지 및 pdf 미리보기와 일관된 환경을 제공하기 위해 office 미리보기 모드에서 이미지 확대 효과를 비활성화했습니다.
10. pdfbox가 하위 버전 JDK와 호환되도록 직접 설정하여, IDEA에서 실행할 때도 경고 프롬프트가 표시되지 않도록 했습니다.
11. 코드 볼륨을 줄이기 위해 Guava 및 Hutool과 같은 필수가 아닌 툴킷을 제거했습니다.
12. Office 컴포넌트의 비동기 로딩을 통해 애플리케이션 시작 속도를 5초 이내로 단축했습니다.
13. 미리보기 소비 큐의 스레드 수를 합리적으로 설정했습니다.
14. 압축 패키지 내의 파일이 다시 미리보기되지 않던 버그를 수정했습니다.
15. 이미지 미리보기 버그를 수정했습니다.
> 2020년 5월 20일 :
1. 전역 워터마크 및 매개변수를 통한 워터마크 내용의 동적 변경 지원
2. CAD 파일 미리보기 지원
3. 설정 항목 base.url 추가, nginx 리버스 프록시 사용 및 context-path 설정 지원
4. 모든 설정 항목을 환경 변수에서 읽을 수 있어 docker 이미지 배포 및 클러스터에서의 대규모 사용에 편리함
5. TrustHost 설정 지원(신뢰할 수 있는 사이트의 파일 소스만 미리보기 가능), 남용으로부터 미리보기 서비스 보호
6. 사용자 정의 캐시 정리 시간 설정 지원(cron 표현식)
7. .md, .java, .py 등 인식 가능한 모든 일반 텍스트를 다운로드 없이 직접 미리보기 가능
8. 변환 후 PDF 파일 다운로드를 제한하는 설정 지원
9. .sh 스크립트의 줄바꿈 문제를 해결하기 위해 Maven 패키징 설정 최적화
10. 외부 네트워크 연결이 없는 사용자를 위해 모든 CDN 의존성을 프론트엔드에 로컬로 배치
11. 홈페이지의 댓글 서비스를 소후 창얀(Sohu ChangYan)에서 gitalk로 전환
12. URL의 특수 문자로 인해 발생할 수 있는 미리보기 예외 수정
13. 변환 파일 큐의 addtask 예외 수정
14. 기타 알려진 이슈 수정
15. 공식 웹사이트 빌드: [https://kkview.cn](https://kkview.cn)
16. 공식 docker 이미지 저장소 빌드: [https://hub.docker.com/r/keking/kkfileview](https://hub.docker.com/r/keking/kkfileview)
> 2019년 6월 18일 :
1. 캐시 및 미리보기 파일의 자동 정리 지원
2. http/https 스트림 url 파일 미리보기 지원
3. FTP url 파일 미리보기 지원
4. Docker 빌드 추가
> 2019년 4월 8일
1. 캐시 및 큐 구현을 추상화하여 JDK 및 REDIS 구현 제공 (REDIS는 선택적 의존성이 됨)
2. zip 및 tar.gz 패키지 제공, 원클릭 시작 스크립트 제공
> 2018년 1월 17일
1. 프로젝트를 정제함

t 디렉토리, 요약 파일 미리보기 인터페이스, 더 많은 파일 확장자 지원 및 자체 프로젝트 배포 용이
1. 영문 문서 추가 (@幻幻Fate, @汝辉) 기여
1. 더 많은 이미지 파일 확장자 지원
1. zip 파일 내 이미지 캐러셀이 항상 첫 번째부터 시작되는 문제 수정
> 2018년 1월 12일
1. 여러 이미지 미리보기 지원
1. rar/zip 내 이미지 회전 미리보기 지원
> 2018년 1월 2일
1. 파일 인코딩 문제로 인해 txt 문서 미리보기 시 외계어(깨짐)가 발생하는 문제 수정
1. 일부 모듈 의존성을 찾을 수 없는 문제 수정
1. Spring Boot 프로파일 추가 및 다중 환경 설정 지원
1. doc 등의 문서를 미리보기 위해 `pdf.js` 추가, doc 제목을 pdf 메뉴로 생성하는 기능 지원, 모바일 미리보기 지원
### 후원하기
이 프로젝트가 도움이 되었다면 후원을 환영합니다. 여러분의 지원은 저희에게 가장 큰 동기부여가 됩니다!