档案软件B/S版部署、配置与本地归档全实操指南

一、部署B/S版档案系统（零命令行门槛）

以下操作基于Ubuntu 22.04系统，CentOS 7可替换对应安装命令，所有命令直接复制执行即可。

1.1 安装Docker

执行以下命令完成Docker环境部署：

```bash 更新系统源 sudo apt update -y 安装Docker sudo apt install -y docker.io 启动Docker并设置开机自启 sudo systemctl start docker sudo systemctl enable docker ```

1.2 启动OpenKM B/S档案系统容器

执行以下命令启动容器，完成系统部署，端口映射为8080，归档数据挂载至宿主机目录：

```bash 创建宿主机归档目录（提前创建避免权限问题） sudo mkdir -p /opt/okm/archive 启动OpenKM社区版容器 sudo docker run -d -p 8080:8080 -v /opt/okm/archive:/opt/openkm/repository openkm/openkm-ce:6.3.10 ```

执行后等待1分钟，系统启动完成。

二、系统核心配置（确保归档路径正确）

打开浏览器，输入地址：http://localhost:8080，使用默认账号密码登录：admin / admin。

2.1 绑定归档存储路径

登录后，点击右上角admin用户名，选择下拉菜单中的【管理】，在左侧导航栏找到【存储设置】：

• 在【主存储路径】输入框中，确认显示内容为/opt/openkm/repository（因已映射至宿主机目录）；
• 不得修改为容器内其他路径，此路径为归档文件的实际存储位置。

2.2 初始用户配置（可选）

按需创建自定义账号，后续归档操作建议使用自定义账号，避免默认账号的风险，操作路径：【管理】→【用户管理】→【新建用户】。

三、文件归档实操（从零到成功）

3.1 上传待归档文件

在系统左侧导航栏，选择【文档库】→【个人文档】，点击顶部【上传】按钮，选择本地需归档的文件（支持pdf、docx、jpg等常见格式），点击【提交】完成上传。

3.2 验证归档结果

执行以下命令查看宿主机归档目录的文件结构：

```bash 列出归档目录下的文件 sudo ls -l /opt/okm/archive ```

• 会看到一串36位UUID格式的目录（如：a1b2c3d4-5678-90ef-ghij-klmnopqrstuv）；
• 进入该目录，执行ls -l，会看到两个文件：一个二进制的data文件，一个metadata.json文件；
• 核对metadata.json中的originalName字段与上传文件名一致，data文件大小与源文件一致，即为归档成功。

四、归档数据的备份与恢复

4.1 备份归档数据

执行以下命令，将宿主机归档目录打包为带日期的压缩包，避免混淆：

```bash 备份归档数据，文件名含当前日期 sudo tar -zcvf /opt/archive_backup_$(date +%Y%m%d).tar.gz /opt/okm/archive ```

备份文件默认存储在宿主机根目录，可移动至其他安全位置。

4.2 恢复归档数据

当容器数据损坏时，按以下步骤恢复：

1. 停止OpenKM容器：sudo docker stop $(sudo docker ps -q --filter ancestor=openkm/openkm-ce:6.3.10)
2. 清空原归档目录：sudo rm -rf /opt/okm/archive/
3. 解压备份文件（将20240520替换为备份文件的实际日期）：sudo tar -zxvf /opt/archive_backup_20240520.tar.gz -C /opt/okm/archive
4. 重启容器：sudo docker start $(sudo docker ps -aq --filter ancestor=openkm/openkm-ce:6.3.10)

等待2分钟，登录系统后即可看到所有归档文件。