话说回来，

在公司信息化的日常中。文件在线预览几乎成了必备功能。合同审批、OA 程序、网盘等业务场景，都需要使用者能够直接在浏览器里查看 PDF、Word、Excel、PPT 等文件。若每次都让使用者下载后再打开，体验差且易造成文件外泄。这篇文章把我在多台 Linux 主机上折腾 kkFileView 的完整流程整理出来并把常见的痛点与方法一并列出，方便你跑通。话说回来，

一、kkFileView 简介

kkFileView 是基于 Spring Boot 的开源文件在线预览方案。支持 Office 全家桶、PDF、图片、音视频、压缩包等几十种格式。话说回来，从主要原因是来看，业务程序把文件 URL传给 kkFileView。后端用 LibreOffice 做格式转换，接下来将结果以 HTML 或图片渲染到浏览器。它与业务程序松耦合，只需拼 URL 即可对接。

• 办公文档：
• PDF 与扫描件：
• 图片：
• 文本：
• 压缩包：
• 音视频：
• CAD/设计图：

二、服务器选型与硬件需求

硬件配置建议

• 内存瓶颈是最常见的 OOM 痛点。 LibreOffice 转换时会瞬间占用数百 MB；多请求会导致容器 OOM Kill。建议最低8 GB，
• 硬盘空间不足导致缓存崩溃。 缓存目录会迅速膨胀，Docker 镜像和临时文件也占空间。 至少预留50 GB，并挂载到数据盘。老实说，
• Nginx 和 HTTPS 必不可少。否则外部访问容易被拦截或被攻击。
• Docker 镜像拉取慢或超时是国内环境的典型问题，需要加速器。
• SaaS 存储链接必须带鉴权，否则被公开爬取风险高。

操作程序选择

Apt 或 Yum 都能跑 Docker。但推荐：

• Ubuntu LTS：软件源新鲜，社区资料多。
• CentOS / Rocky Linux / AlmaLinux：如果公司已统一使用 CentOS。可继续使用，但注意 CentOS 已停止维护。其实，新环境建议 Rocky 或 AlmaLinux。

网络要求  

• 服务器需能访问外网，用于拉取 Docker 镜像；纯内网需要离线导入方案，
• 开放 kkFileView 默认端口或通过 Nginx 隐藏端口，以防暴露服务直接被攻击。

三、操作程序初始化

更新软件包

# Ubuntu/Debian sudo apt update && sudo apt upgrade -y
# CentOS/Rocky sudo yum update -y # 或者 sudo dnf update -y

安装基础工具

# Ubuntu sudo apt install -y curl wget vim htop net-tools unzip
# CentOS sudo yum install -y curl wget vim htop net-tools unzip

关闭或配置防火墙

# Ubuntu
sudo ufw allow OpenSSH/tcp
sudo ufw allow http/tcp
sudo ufw allow https/tcp
sudo ufw allow /tcp
sudo ufw enable
# CentOS
sudo systemctl start firewalld && sudo systemctl enable firewalld
sudo firewall-cmd --zone=public --add-port=/tcp --permanent
... repeat for or ports ...
sudo firewall-cmd --reload
# 云网站安全组请同时放行对应端口，否则后续仍然被阻断。

设置时区

# 设置为上海时间，方便日志时间一致性
sudo timedatectl set-timezone Asia/Shanghai

四、安装 Docker

一键安装脚本

# 官方脚本适用于绝大多数发行版
curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.sh
# 国内镜像加速可使用阿里云脚本
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

手动安装示例 *仅用于需要自定义源时*

# 卸载旧版本
sudo apt remove -y docker docker-engine docker.io containerd runc
# 安装依赖
sudo apt install -y ca-certificates curl gnupg lsb-release
# 添加 GPG 密钥并创建 keyring
mkdir -p /etc/apt/keyrings && \
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
gpg --dearmor -o /etc/apt/keyrings/docker.gpg
# 添加软件源
echo "deb \
说到https。//download.docker.com/linux/ubuntu $ stable" | \
tee /etc/apt/sources.list.d/docker.list> /dev/null
# 安装 Docker Engine
sudo apt update && \
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 启动并自启
sudo systemctl start docker && \
sudo systemctl enable docker
# 验证 hello-world
docker run hello-world
# 查看版本号确保符合要求
docker --version && docker compose version

配置国内镜像加速 bash mkdir -p /etc/docker cat <'EOF'> /etc/docker/daemon.json { \"registry-mirrors\":,\"log-driver\": \"json-file\",\"log-opt\": {\"max-size\": \"100m\",\"max-file\": \"5\"},\"storage-driver\": \"overlay2\" } EOF systemctl daemon-reload && systemctl restart docker --- 提示镜像站地址经常变动，可先 docker pull 测试再写入配置。"}