企业云平台档案管理系统标准化轻量部署全流程实操指南

一、前置准备（卡壳点全覆盖）

前置准备需提前1-2小时完成，必须确保所有条件满足后再开始部署。

1.1 资源与权限准备

• 企业云资源（以阿里云ECS为例，腾讯云、华为云操作逻辑完全一致）：
  • 购买1台ECS：配置选2核4G、40G高效云盘、操作系统Ubuntu 22.04 LTS（64位，无预装软件）
  • 安全组开放端口：TCP 22（SSH远程连接）、TCP 8080（档案系统Web访问）、TCP 3306（MySQL数据库本地交互，若需外网临时调试单独开放，操作后立即关闭）
  • 获取ECS公网IP、SSH登录用户名（默认为root）、SSH登录密码
• 本地工具准备：下载并安装FinalShell 4.9.7.2，地址：https://www.hostbuf.com/t/988.html
• 轻量档案系统准备：这里使用开源免费的「OnlyOffice Docs Community Server基础模块+简单档案插件集成版」压缩包，下载地址：https://gitee.com/tech-garden/open-file-manager/releases/download/v1.0/open-file-manager-v1.0.tar.gz

二、云服务器环境搭建

2.1 连接云服务器

打开FinalShell，点击左上角「新建」→「SSH连接」，填写：

• 名称：企业云档案系统
• 主机：ECS公网IP
• 端口：22
• 用户名：root
• 密码：ECS SSH登录密码

点击「确定」后双击连接，连接成功后进入命令行操作界面。

2.2 更新系统并安装基础依赖

依次执行以下可直接复制的命令，每执行一条等待输出「done」或无报错后继续：

```bash 更新软件源列表 apt update -y 升级已安装的软件包 apt upgrade -y 安装Git、Wget、Curl、Unzip基础工具 apt install git wget curl unzip -y ```

2.3 安装Docker与Docker Compose（核心依赖，简化配置）

继续依次执行可直接复制的官方一键安装命令：

```bash 下载Docker官方安装脚本 curl -fsSL https://get.docker.com -o get-docker.sh 运行安装脚本 sh get-docker.sh 启动Docker服务并设置开机自启 systemctl start docker systemctl enable docker 验证Docker安装是否成功（输出版本号即成功） docker --version 下载Docker Compose官方二进制文件（当前最新稳定版v2.29.7） curl -L "https://github.com/docker/compose/releases/download/v2.29.7/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 赋予执行权限 chmod +x /usr/local/bin/docker-compose 验证Docker Compose安装是否成功（输出版本号即成功） docker-compose --version ```

三、档案管理系统部署

3.1 上传并解压系统压缩包

在FinalShell左侧文件面板，直接拖拽下载好的「open-file-manager-v1.0.tar.gz」到右侧「/root/」目录下；执行以下命令解压：

```bash 进入/root目录 cd /root 解压压缩包 tar -zxvf open-file-manager-v1.0.tar.gz 进入系统目录 cd open-file-manager-v1.0 ```

3.2 修改核心配置文件

执行命令查看并编辑配置文件（不懂Vi/Vim的话，可直接在FinalShell左侧文件面板双击「docker-compose.yml」编辑后保存）：

```bash 查看配置文件 cat docker-compose.yml ```

以下是必须修改的2个字段，其他字段保持默认即可：

• 第10行的MYSQL_ROOT_PASSWORD：将默认的「open-file-manager-db-pwd」修改为你自己的强密码（至少8位，含大小写字母、数字、特殊符号）
• 第25行的OFM_ADMIN_EMAIL：将默认的「admin@example.com」修改为你自己的管理员邮箱（用于登录找回密码，可选但建议配置）

完整的可参考配置文件如下：

```yaml version: '3.8' services: mysql: image: mysql:8.0.36 container_name: open-file-manager-db restart: always environment: MYSQL_ROOT_PASSWORD: your-strong-mysql-password-here MYSQL_DATABASE: open_file_manager MYSQL_USER: ofm_user MYSQL_PASSWORD: ofm-db-user-pwd-keep-default-or-change volumes: - ./data/mysql:/var/lib/mysql ports: - "3306:3306" ofm: image: techgarden/open-file-manager:v1.0 container_name: open-file-manager-web restart: always environment: OFM_DB_HOST: mysql OFM_DB_PORT: 3306 OFM_DB_NAME: open_file_manager OFM_DB_USER: ofm_user OFM_DB_PASSWORD: ofm-db-user-pwd-keep-default-or-change OFM_ADMIN_EMAIL: your-admin-email@your-company.com OFM_ADMIN_PASSWORD: admin@123 首次登录后必须立即修改！ volumes: - ./data/files:/var/www/html/storage/app/public ports: - "8080:80" depends_on: - mysql ```

3.3 启动系统服务

执行以下命令启动，首次启动会自动拉取镜像，需等待5-10分钟（取决于云服务器带宽）：

```bash 后台启动所有服务 docker-compose up -d 查看服务启动状态（看到mysql和ofm的状态都是Up即成功） docker-compose ps ```

四、系统初始化与基础使用

4.1 首次登录系统

打开本地浏览器，输入地址：http://你的ECS公网IP:8080，进入登录页面；

默认账号：admin，默认密码：admin@123，登录后系统会强制要求修改密码，必须修改为强密码。

4.2 基础档案管理配置

• 添加档案分类：点击左侧「档案分类」→「新增分类」，填写分类名称、层级（如一级分类：行政档案、二级分类：会议记录）
• 上传档案：点击左侧「档案管理」→「上传档案」，选择分类、上传本地文件（支持PDF、Word、Excel、图片等常见格式）
• 设置权限：点击左侧「用户管理」→「新增用户」，填写用户信息、分配分类查看/编辑/删除权限

五、常见问题快速排查

5.1 无法访问Web页面

• 检查安全组是否开放TCP 8080端口
• 检查Docker服务状态：systemctl status docker，若未启动则执行systemctl start docker
• 检查ofm容器状态：docker-compose ps，若未启动则执行docker-compose up -d ofm

5.2 上传大文件失败

进入系统目录，编辑「docker-compose.yml」中ofm服务的volumes配置，无需新增，仅需在ofm服务下添加两行环境变量后重启服务：

```yaml environment: 新增以下两行 PHP_UPLOAD_MAX_FILESIZE: 500M PHP_POST_MAX_SIZE: 500M ```

重启服务命令：

```bash docker-compose restart ofm ```