
centos建设网站,上海市网站建设公司58,做网站html,拍摄企业宣传片哪家好好,定 kodbox(可道云)。下面是完整的「方案设计 + 宝塔部署」详细文档。注意到你服务器是 172.16.1.5,属于内网地址。这点很关键:内网环境不能用微软/谷歌的在线 Office 预览(它们要求文件能被公网访问),所以 Word/Exc…
好,定 kodbox(可道云)。下面是完整的「方案设计 + 宝塔部署」详细文档。注意到你服务器是 172.16.1.5,属于内网地址。这点很关键:内网环境不能用微软/谷歌的在线 Office 预览(它们要求文件能被公网访问),所以 Word/Excel/PPT 预览必须用本地 LibreOffice 转换——下面方案已包含这一步。一、方案设计
1.1 需求 → kodbox 能力映射你的需求
kodbox 如何满足Markdown 实时预览
内置 Markdown 编辑器,左写右预览,原生支持 ✅txt 预览
内置文本/代码在线查看 ✅pdf 预览
内置 PDF.js 在线阅读 ✅jpg/png 预览
内置图片查看器(缩放/幻灯片)✅doc/docx 等 Office 预览
通过本地 LibreOffice 转 PDF 后在线预览 ✅(需装)管理员增/删/重命名文档
文件管理器:上传、新建、删除、重命名、移动、拖拽,原生 ✅多用户/权限
管理员可建普通用户,分配只读/可编辑、限定目录 ✅界面美观
仿桌面 Web UI,现代美观 ✅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(可选,缩略图更好)、exifgd / 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 步:建站点 + 数据库网站 → 添加站点
:域名:填你的域名,或直接填 172.16.1.5(内网用 IP 也行)
PHP 版本:选 7.4
同时勾选「创建数据库」,记下库名/账号/密码(或单独在数据库里建 kodbox 库)站点根目录会是 /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/2 步补扩展、删禁用函数。数据库:选 MySQL,填第 3 步的库名/账号/密码,主机 127.0.0.1,端口 3306。(也可以选「不使用数据库」用 SQLite 快速体验,但建议用 MySQL)设置管理员账号密码 → 完成安装。第 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 → 进入编辑器,左编辑右实时预览。
建只读浏览用户:后台 → 用户管理 → 新建用户 → 分配一个共享目录、权限设为「只读」。这样普通人只能看不能改,只有管理员能增删改名。四、关键坑提醒(按踩坑概率排序)PHP 禁用函数没删 → 安装检测红、Office 转换失败。(第 2 步)
没装中文字体 → Word/PDF 预览中文变方块。(第 6 步 wqy 字体)
内网用了在线 Office 预览 → 转圈打不开;必须用本地 LibreOffice。(第 8 步)
大文件传不上去 → client_max_body_size 和 PHP 的 upload_max_filesize 都要调。(第 2、5 步)
目录权限不对 → 上传/缩略图报错;chown -R www:www。(第 4 步)需要的话,我可以:帮你把上面第 1~6 步打包成一个可直接粘贴执行的 shell 脚本(装 LibreOffice、字体、设权限等);
或在你跑安装向导时,环境检测报红了把截图发我,我对着告诉你删哪个函数 / 装哪个扩展。你想先要那个一键脚本吗?这是个很常见的需求 —— 本质是一个带在线预览的文件管理 / 轻量私有云。结论先说:不建议自己从零开发,因为你要的「Word/PDF/图片/Markdown 实时预览」如果自建,光是 Office 预览就得接 LibreOffice 转换或 OnlyOffice 引擎,工作量和踩坑量都很大。用成熟开源项目能直接满足全部需求,而且更稳。
下面是适合你这台 CentOS 7 + 宝塔环境的几个现成方案对比:
候选方案对比方案
技术栈
预览能力
文件管理(增删改名)
UI
BT 部署难度kodbox 可道云
PHP + MySQL
md(实时预览)、txt、pdf、Word/Excel/PPT、图片、视频
✅ 完整 + 多用户权限
网页桌面,很美观
⭐ 极简(BT 就是 PHP 环境,可能有一键安装)Cloudreve
Go 单文件
md、pdf、图片、视频、代码;Office 需接在线预览/OnlyOffice
✅ 完整 + 管理员后台
网盘风,现代美观
⭐ 极简(单二进制,不碰 PHP/Python)Nextcloud
PHP + MySQL
全能(装插件),Office 需 OnlyOffice/Collabora
✅ 最强,功能繁多
专业但偏重
⭐⭐⭐ 较重,PHP8 要求高自建(Flask/FastAPI)
Python
全靠自己接库
自己写
自己做
⭐⭐⭐⭐ 开发+维护成本高我的推荐首选 kodbox(可道云):它原生支持 Word/PDF/Markdown 实时预览(你这条需求里最难的 Office 预览它内置了),纯 PHP+MySQL 正好是宝塔的强项 —— 完全避开我们前面折腾的 Python 3.9 / OpenSSL / Django 版本那一堆坑。UI 是仿桌面的,很漂亮,管理员可建普通用户、控制谁能增删改。
次选 Cloudreve:如果你更喜欢「干净的单文件、不想碰 PHP」,它是 Go 单二进制,部署最省心,md/pdf/图片预览开箱即用;但 Word 预览要额外接 OnlyOffice,稍麻烦。「Word 文档预览」是这堆需求里最关键的分水岭 —— 要它开箱即用,kodbox 最合适。
在我写详细部署方案之前,先确认你走哪条路(这决定整篇步骤怎么写):
你想用哪个方案来实现这个在线文档预览/管理站?我按你选的写详细 BT 部署步骤。