用OpenKM开源档案管理工具 从零搭建实操技术指南

一、前置准备：仅需安装Docker（5分钟完成）

仅支持Linux系统实操，以Ubuntu 22.04 LTS为例，其他Debian系系统命令通用：

• 更新软件源并安装Docker及Docker Compose，复制以下命令到终端执行：

``` sudo apt update && sudo apt install docker.io docker-compose -y ```

执行完成后验证安装：输入docker --version和docker-compose --version，出现版本号则安装成功。

二、一步部署完整OpenKM档案系统（无复杂配置）

1. 创建部署目录并编写配置文件

执行以下命令创建目录并进入：

``` mkdir -p ~/openkm && cd ~/openkm ```

创建docker-compose.yml文件，直接复制以下完整内容（无需修改）：

``` version: '3.8' services: openkm: image: openkm/openkm-ce:latest ports: - "8080:8080" volumes: - openkm_data:/usr/local/tomcat/webapps/ROOT environment: - DB_HOST=postgresql - DB_NAME=openkm - DB_USER=openkm - DB_PASS=openkm_pass depends_on: - postgresql postgresql: image: postgres:13 environment: - POSTGRES_USER=openkm - POSTGRES_PASSWORD=openkm_pass - POSTGRES_DB=openkm volumes: - postgres_data:/var/lib/postgresql/data volumes: openkm_data: postgres_data: ```

2. 启动服务并验证

执行启动命令：

``` docker-compose up -d ```

等待30秒后，输入命令docker ps，若列表中存在openkm/openkm-ce:latest和postgres:13两个运行状态为Up的容器，则部署成功。

三、初始配置：直接上手使用核心功能

1. 登录系统并修改默认密码

打开浏览器，输入地址：http://localhost:8080/OpenKM，进入登录页：

• 默认账号：admin，默认密码：admin
• 首次登录必须修改密码：登录后点击右上角用户名→“修改密码”，设置8位以上含字母数字的新密码，否则无法使用核心功能。

2. 创建档案分类与文件夹

左侧导航栏点击“文档库”，右键“我的文档”→“新建”→“文件夹”，输入分类名称（如“2024季度项目档案”），点击“确定”完成创建，支持多级嵌套（右键文件夹可继续新建子文件夹）。

3. 上传档案文件

选中需上传的文件夹，点击页面顶部“上传”按钮，在弹出的窗口中选择本地文件，支持PDF、Word、Excel、图片等20+常用格式，单个文件最大支持1GB（后续可调整配置）。

四、日常实操核心功能（零门槛）

1. 档案快速搜索

页面顶部搜索框支持多维度搜索：输入文件名可精准匹配，输入档案内容中的关键词支持全文检索，还可点击搜索框右侧的“筛选”按钮，按上传时间、文件类型、创建人缩小范围。

2. 基础权限设置

为避免误操作，可对文件夹设置权限：右键目标文件夹→“权限”→“添加用户/用户组”，选择后设置权限为“只读”（仅查看）或“读写”（可编辑、删除），点击“保存”生效。

3. 档案版本管理

上传或修改文件后，系统自动保留版本历史：右键文件→“版本”，可查看所有修改记录，支持恢复到指定版本，无需手动备份。

五、常见问题快速解决

• 端口占用：若8080被占用，修改docker-compose.yml中8080:8080为8081:8080，访问时用http://localhost:8081/OpenKM即可。
• 启动失败：执行docker-compose logs openkm查看日志，大概率是网络问题，重新执行docker-compose pull拉取最新镜像即可。