好,定 kodbox(可道云)。下面是完整的「方案设计 + 宝塔部署」详细文档。

注意到你服务器是 172.16.1.5,属于内网地址。这点很关键:内网环境不能用微软/谷歌的在线 Office 预览(它们要求文件能被公网访问),所以 Word/Excel/PPT 预览必须用本地 LibreOffice 转换——下面方案已包含这一步。

一、方案设计

1.1 需求 → kodbox 能力映射

1.2 技术架构

浏览器
  │  http(s)
Nginx (宝塔)  ── 静态/伪静态
  │  fastcgi
PHP 7.4-FPM ── kodbox(PHP 应用)
  │                  │
MySQL 5.7          LibreOffice(soffice,Office→PDF 转换)
(已装)            + 中文字体(wqy)

• PHP 7.4:kodbox 最稳的版本,宝塔可直接装,完全绕开之前 Python/OpenSSL/Django 那些坑。
• MySQL 5.7:你已经装好,直接复用,kodbox 对 5.7 完全支持(它不像 Django 4.2 那样挑版本)。
• LibreOffice:只为 Office 文档预览服务;md/txt/pdf/图片都不需要它。

1.3 数据规划

• 站点目录:/www/wwwroot/kodbox(放程序)
• 用户文件实际存储:kodbox 默认放在程序目录下的 data/(安装时可改到单独磁盘/目录,建议日后数据与程序分离便于备份)
• 数据库:单独建一个库 kodbox

二、宝塔部署步骤

第 1 步:装运行环境

宝塔 → 软件商店:

• 安装 Nginx(已装可跳过)
• 安装 PHP 7.4
• MySQL 5.7 已装,跳过

装完 PHP 7.4 后,点它的 设置 → 安装扩展,勾选安装(kodbox 需要):

fileinfo、opcache、redis(可选,提速)、imagemagick(可选,缩略图更好)、exif

gd / curl / mbstring / zip / pdo_mysql / openssl 通常默认已装,缺哪个补哪个。

第 2 步:解除 PHP 禁用函数(kodbox 在 BT 上的头号坑)

PHP 7.4 → 设置 → 禁用函数,把下面这些从禁用列表里删掉(kodbox 要用):

putenv  proc_open  pcntl_signal  pcntl_alarm  symlink  readlink  exec  shell_exec

没删的话,安装向导的环境检测会标红、Office 转换也会失败。具体差哪个,安装页会列出来,按提示删即可。

顺便在 设置 → 配置文件 里调大(支持大文件上传):

upload_max_filesize = 1024M
post_max_size = 1024M
max_execution_time = 300
memory_limit = 512M

第 3 步:建站点 + 数据库

1. 网站 → 添加站点

   :

   • 域名:填你的域名,或直接填 172.16.1.5(内网用 IP 也行)
   • PHP 版本:选 7.4
   • 同时勾选「创建数据库」,记下库名/账号/密码(或单独在数据库里建 kodbox 库)

2. 站点根目录会是 /www/wwwroot/你填的域名,为清晰可后面把程序放这里。

第 4 步:下载并放置 kodbox

SSH 或宝塔终端:

cd /www/wwwroot/你的站点目录
# 官方最新版(也可去 https://kodcloud.com/download/ 拿最新链接)
wget https://static.kodcloud.com/update/download/kodbox.1.50.02.zip
unzip kodbox.1.50.02.zip
rm -f kodbox.1.50.02.zip

用户名：kodbox

密码：68pek5KGdArXFdhd

也可以从 GitHub kalcaddle/kodbox 下载 release 包,上传到站点目录再解压。版本号以官网最新为准。

然后宝塔 → 该站点 → 设置 → 网站目录,确认「运行目录」为根目录(kodbox 解压后文件就在根目录,无需子目录)。

设置目录权限(BT 一般是 www 用户):

chown -R www:www /www/wwwroot/你的站点目录
chmod -R 755 /www/wwwroot/你的站点目录

第 5 步:配置伪静态

站点 → 设置 → 伪静态,选 kodbox(如果列表里有);没有就粘贴官方规则(kodbox 文档/安装页有提供)。kodbox 不配伪静态也能跑,但配了链接更干净。

同时为支持大文件,站点 配置文件 里 server 段加:

client_max_body_size 1024m;

第 6 步:装 LibreOffice + 中文字体(Office 预览用)

SSH 执行:

yum install -y libreoffice libreoffice-writer libreoffice-calc libreoffice-impress
# 中文字体,否则转换出来的 Word/PDF 中文是方块
yum install -y wqy-microhei-fonts wqy-zenhei-fonts
# 验证 soffice 路径
which soffice

记下 soffice 路径(通常是 /usr/bin/soffice)。

第 7 步:跑安装向导

浏览器访问你的站点(http://172.16.1.5/ 或域名),进入 kodbox 安装界面:

1. 环境检测:全绿即可;有红的回第 1/2 步补扩展、删禁用函数。

2. 数据库:选 MySQL,填第 3 步的库名/账号/密码,主机 127.0.0.1,端口 3306。

   • (也可以选「不使用数据库」用 SQLite 快速体验,但建议用 MySQL)

3. 设置管理员账号密码 → 完成安装。

第 8 步:开启本地 Office 预览

用管理员登录 → 进入管理后台(右上角头像 / 系统设置)→ 找到「文档预览 / Office 转换」相关设置:

• 转换方式选「本地 / LibreOffice(OpenOffice)」
• 填 soffice 路径:/usr/bin/soffice
• 保存后,上传一个 .docx 测试预览。

md / txt / pdf / 图片这时已经能直接预览,不依赖这一步;这一步只为 Word/Excel/PPT。

第 9 步:安全收尾

• 宝塔 安全 + 云/网络安全组放行 80(用 HTTPS 则放 443)。
• 有域名建议在站点里一键申请 SSL,强制 HTTPS。
• 安装完成后,kodbox 会自动锁定安装程序;确认 install 相关入口已不可再访问。

三、使用方式(对应你的需求)

• 管理员登录后,在文件管理器里:右键 → 新建文件夹 / 上传 / 删除 / 重命名 / 移动,双击文件即在线预览。
• Markdown:双击 .md → 进入编辑器,左编辑右实时预览。
• 建只读浏览用户:后台 → 用户管理 → 新建用户 → 分配一个共享目录、权限设为「只读」。这样普通人只能看不能改,只有管理员能增删改名。

四、关键坑提醒(按踩坑概率排序)

1. PHP 禁用函数没删 → 安装检测红、Office 转换失败。(第 2 步)
2. 没装中文字体 → Word/PDF 预览中文变方块。(第 6 步 wqy 字体)
3. 内网用了在线 Office 预览 → 转圈打不开;必须用本地 LibreOffice。(第 8 步)
4. 大文件传不上去 → client_max_body_size 和 PHP 的 upload_max_filesize 都要调。(第 2、5 步)
5. 目录权限不对 → 上传/缩略图报错;chown -R www:www。(第 4 步)

需要的话,我可以:

• 帮你把上面第 1~6 步打包成一个可直接粘贴执行的 shell 脚本(装 LibreOffice、字体、设权限等);
• 或在你跑安装向导时,环境检测报红了把截图发我,我对着告诉你删哪个函数 / 装哪个扩展。

你想先要那个一键脚本吗?

这是个很常见的需求 —— 本质是一个带在线预览的文件管理 / 轻量私有云。结论先说:不建议自己从零开发,因为你要的「Word/PDF/图片/Markdown 实时预览」如果自建,光是 Office 预览就得接 LibreOffice 转换或 OnlyOffice 引擎,工作量和踩坑量都很大。用成熟开源项目能直接满足全部需求,而且更稳。

下面是适合你这台 CentOS 7 + 宝塔环境的几个现成方案对比:

候选方案对比

我的推荐

• 首选 kodbox(可道云):它原生支持 Word/PDF/Markdown 实时预览(你这条需求里最难的 Office 预览它内置了),纯 PHP+MySQL 正好是宝塔的强项 —— 完全避开我们前面折腾的 Python 3.9 / OpenSSL / Django 版本那一堆坑。UI 是仿桌面的,很漂亮,管理员可建普通用户、控制谁能增删改。
• 次选 Cloudreve:如果你更喜欢「干净的单文件、不想碰 PHP」,它是 Go 单二进制,部署最省心,md/pdf/图片预览开箱即用;但 Word 预览要额外接 OnlyOffice,稍麻烦。

「Word 文档预览」是这堆需求里最关键的分水岭 —— 要它开箱即用,kodbox 最合适。

在我写详细部署方案之前,先确认你走哪条路(这决定整篇步骤怎么写):

你想用哪个方案来实现这个在线文档预览/管理站?我按你选的写详细 BT 部署步骤。