准备工作
这一步需要3个前提条件,缺一不可,请提前完成:
- 云服务器或本地虚拟机:推荐轻量型云服务器(配置≥1核2G、带宽≥1Mbps、系统盘≥20G),本地Windows/Mac需先安装CentOS/Ubuntu虚拟机,推荐用VirtualBox+CentOS7镜像(下载地址:https://mirrors.aliyun.com/centos/7.9.2009/isos/x86_64/CentOS-7-x86_64-Minimal-2207-02.iso)
- 域名(可选):本地虚拟机不需要,云服务器建议备一个国内已备案或海外未备案域名(海外服务器域名无需备案)
- 基础网络权限:云服务器需开放80(HTTP)、443(HTTPS,可选)端口,本地虚拟机需开启桥接模式并获取局域网IP
第一步:安装宝塔面板
宝塔面板是国内最常用的可视化服务器运维工具,能一键解决Web环境搭建问题。
CentOS7系统一键安装命令
用SSH工具(推荐Xshell免费版、PuTTY或宝塔自带的远程终端)连接云服务器/虚拟机,输入以下命令并回车:
```bash
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh ed8484bec
```
等待5-10分钟安装完成后,终端会显示面板地址、账号、密码,请截图或复制保存(后续可修改)。
第二步:用宝塔安装DokuWiki依赖环境

DokuWiki是纯PHP文件存储的轻量Wiki,无需数据库,仅需PHP+Nginx/Apache。
- 浏览器访问第一步保存的宝塔面板地址,输入账号密码登录
- 进入软件商店,搜索“Nginx”,点击安装(推荐选择1.20稳定版)
- 搜索“PHP”,点击安装PHP7.4版本(DokuWiki官方推荐≥7.2,7.4最稳定)
- 安装完成后,进入软件商店→已安装→PHP7.4→设置:
- 在禁用函数列表删除
putenv、proc_open、proc_terminate这3个函数(必须操作,否则无法配置DokuWiki)
- 在上传限制中,将最大上传大小改为100M(可根据自己的档案大小调整),点击保存
第三步:创建DokuWiki站点并上传程序
创建站点
- 进入宝塔面板网站→添加站点:
- 域名:本地虚拟机填局域网IP,云服务器填已绑定的域名或公网IP
- 数据库:选择“不创建”
- PHP版本:选择“PHP-74”
- 点击提交
- 站点创建成功后,点击站点名称右侧的根目录,进入文件管理界面
上传并解压DokuWiki程序
- 在浏览器中打开DokuWiki官方下载页面:https://download.dokuwiki.org/
- 点击页面中的Stable Release(稳定版)下载最新压缩包(格式为.tar.gz)
- 回到宝塔文件管理界面,点击上传,选择刚才下载的.tar.gz压缩包,等待上传完成
- 上传完成后,选中.tar.gz压缩包,点击右键→解压,点击确认
- 解压完成后,进入解压出来的文件夹,全选所有文件,点击右键→剪切
- 回到站点根目录,点击右键→粘贴,删除原来的空文件夹和压缩包
第四步:配置DokuWiki档案资料管理系统
- 浏览器访问“你的域名或公网IP/局域网IP/install.php”(比如本地虚拟机填“http://192.168.1.100/install.php”)
- 进入DokuWiki初始配置页面,按以下要求填写所有必填项(带的必须填写):
- Wiki名称:可以填“我的个人档案库”“XX公司技术档案库”等自定义名称
- 启用ACL(访问控制列表):必须勾选(用于管理档案查看、编辑、上传权限)
- 超级管理员用户名:设置自己习惯的管理员账号(比如admin)
- 超级管理员全名:可以填“管理员”或自己的名字
- 超级管理员密码:设置强密码(建议包含大小写字母、数字、特殊符号)
- 再次输入超级管理员密码:再次输入刚才设置的密码
- 超级管理员邮箱:填写自己的常用邮箱(用于找回密码)
- 初始ACL策略:选择“封闭的Wiki(仅登录用户可访问)”(适合个人或企业内部档案管理)
- 允许新用户注册:个人用户取消勾选,企业用户可根据需求选择
- 选择语言:选择“简体中文(zh)”
- 选择许可证:默认即可
- 填写完所有必填项后,点击页面底部的保存按钮
- 配置成功后,系统会提示“恭喜您!DokuWiki已成功安装!”,此时必须删除站点根目录下的install.php文件(回到宝塔文件管理界面,选中install.php,点击右键→删除,防止被他人恶意重新配置)
第五步:基础使用与档案管理实操
登录DokuWiki后台/前台
浏览器访问“你的域名或公网IP/局域网IP”,点击页面右上角的登录,输入刚才设置的超级管理员账号和密码登录。
创建档案分类(命名空间)
DokuWiki用“命名空间(Namespace)”实现档案分类,相当于电脑里的文件夹。
- 登录后,在页面顶部的搜索框中输入“技术文档:PHP入门”(冒号前的“技术文档”就是一级分类,冒号后的“PHP入门”是具体的档案页面名称),按回车
- 系统会提示“该页面不存在,是否创建?”,点击创建该页面
- 在编辑框中输入档案内容(支持Markdown语法,也支持直接用可视化编辑器插入文字、图片、附件)
- 点击编辑框下方的保存按钮,即可完成“技术文档”分类下“PHP入门”档案的创建
- 重复以上步骤,可创建其他分类(比如“合同档案:2024年”“人事档案:员工1”等)
上传档案附件(PDF、Word、Excel等)
- 登录后,点击页面右上角的媒体管理器(图标是一个文件夹)
- 在媒体管理器左侧的目录中,选择刚才创建的分类(比如“技术文档”)
- 点击页面中间的上传文件,选择要上传的档案附件,点击上传
- 上传完成后,在编辑档案页面时,直接点击媒体管理器中的附件,即可将附件链接插入到档案内容中
配置不同用户的档案访问权限
如果需要多人协作管理档案,可按以下步骤配置权限:
- 登录超级管理员账号后,点击页面右上角的管理(图标是一个齿轮)
- 进入用户管理页面,点击添加用户,填写新用户的用户名、密码、邮箱等信息,点击保存
- 进入访问控制列表(ACL)管理页面:
- 在左侧的命名空间/页面选择框中,选择要配置权限的分类或具体档案页面
- 在右侧的用户/用户组选择框中,选择刚才添加的新用户
- 在下方的权限级别选择框中,选择需要的权限(比如“读”“编辑”“上传”“删除”等)
- 点击添加按钮,即可完成权限配置
快速搜索档案资料
登录后,直接在页面顶部的搜索框中输入档案的关键词,按回车,即可快速搜索到包含该关键词的所有档案页面和附件(附件文件名也可搜索)。
后续维护(可选但推荐)
- 定期备份档案数据:DokuWiki的所有数据都存储在站点根目录下的
data文件夹中,可在宝塔文件管理界面中选中data文件夹,点击右键→压缩,下载到本地备份
- 配置HTTPS访问(云服务器推荐):进入宝塔面板网站→站点设置→SSL,选择“Let's Encrypt”免费证书,点击申请,申请成功后勾选“强制HTTPS”,即可实现安全访问