从零搭建本地开源数字档案馆系统全流程可复制零门槛实操指南

1. 前置准备：安装依赖环境

本次选择轻量开源的Omeka S（适合个人/小团队的数字档案馆系统）作为演示，需要先装3个核心依赖：PHP、MySQL、Apache/Nginx，这里用Windows下的XAMPP一键包简化，Mac/Linux用户后续可看末尾的适配提示。

1.1 下载并安装XAMPP

• 直接访问XAMPP官方中文站：https://www.apachefriends.org/zh_cn/index.html
• 点击XAMPP for Windows按钮下载最新PHP 8.x版本（推荐8.2+）
• 运行安装包，全程默认路径（C:\xampp），勾选Apache、MySQL、PHP、phpMyAdmin四个组件，一路Next完成安装
• 打开桌面XAMPP Control Panel，点击Apache和MySQL右侧的Start按钮，确保两个服务状态为绿色Running

2. 准备Omeka S核心文件与数据库

2.1 下载Omeka S

• 直接访问Omeka S官方下载页：https://omeka.org/s/download/
• 点击Download Omeka S按钮下载最新稳定版压缩包（演示用4.1.2）
• 将压缩包解压到C:\xampp\htdocs目录下，重命名解压后的文件夹为my-archive（方便后续访问，也可自定义）

2.2 创建专用数据库与用户

• 在浏览器地址栏输入：http://localhost/phpmyadmin，进入MySQL管理界面
• 点击左侧导航栏的新建，在“数据库名称”处输入omeka_s_db，排序规则选utf8mb4_general_ci，点击创建
• 点击左侧刚创建的omeka_s_db，再点击顶部导航栏的用户账号，选择新增用户账号
• 填写以下关键信息（其他默认）：
  • 用户名：omeka_s_user
  • 主机名：localhost
  • 密码：Archive@2025Demo（自定义，但必须包含字母、数字、符号）
  • 数据库给用户的权限：勾选授予所有权限
• 点击底部执行完成数据库配置

3. 配置Omeka S并完成安装

3.1 修改配置文件

• 打开C:\xampp\htdocs\my-archive\config目录，找到database.ini.dist文件，复制一份改名为database.ini
• 用记事本/VS Code打开database.ini，修改以下内容（其他保持默认）：

  user     = "omeka_s_user"
  password = "Archive@2025Demo"
  dbname   = "omeka_s_db"
  host     = "localhost"
  ;charset  = "utf8"  ;注释掉这行
  charset  = "utf8mb4"  ;添加这行

• 保存文件并关闭

3.2 初始化系统

• 在浏览器地址栏输入：http://localhost/my-archive，进入Omeka S安装向导
• 第一步是系统检查，确保所有PHP扩展都是绿色的“已启用”（如果有红色的，重启XAMPP的Apache服务再检查，一般XAMPP默认都全）
• 第二步是创建管理员账号，填写：
  • 管理员用户名：admin（自定义，但要记住）
  • 管理员密码：Admin@2025Demo（同上，字母数字符号）
  • 管理员邮箱：随便填一个，比如demo@archive.com
  • 站点我的个人数字档案馆（自定义）
• 点击安装Omeka S，等待10-20秒，出现“安装成功”提示即可

4. 基础功能实操：上传档案、创建分类

4.1 登录后台

点击安装成功页的登录到后台，或直接访问http://localhost/my-archive/admin，输入刚才创建的管理员账号密码登录。

4.2 创建“文档”资源模板

Omeka S用“资源模板”定义档案的元数据（比如标题、作者、日期、来源），先建一个通用的文档模板：

• 点击左侧导航栏的资源 → 资源模板，点击右上角添加资源模板
• 填写“标签”：个人文档
• 在“建议的属性”区域点击添加所有建议属性（会自动添加标题、创建者、日期、描述、来源等元数据项）
• 点击右上角保存

4.3 上传第一份档案

• 点击左侧导航栏的资源 → 项目，先创建一个项目（档案的集合，比如“2024年工作文档”）：
  • 点击右上角添加项目
  • 填写“标题”：2024年个人工作文档
  • 点击右上角保存
• 点击左侧导航栏的资源 → 项目项，选择刚才的“2024年个人工作文档”项目，点击右上角添加项目项
• 选择资源模板为刚才的个人文档
• 填写核心元数据：
  • 2024年12月技术周报
  • 创建者：你的名字
  • 日期：2024-12-31
  • 描述：2024年最后一周的技术学习与工作内容整理
• 点击右侧“媒体”区域的添加媒体，选择上传方式为上传，点击选择文件，选择本地的PDF/Word/图片等文件
• 点击右上角保存，第一份档案就上传好了

4.4 创建分类集合（标签树）

Omeka S用“项目项集”或“分类词汇表”做分类，这里用更灵活的分类词汇表：

• 点击左侧导航栏的数据管理 → 分类词汇表，点击右上角添加分类词汇表
• 填写“标签”：档案类型，点击保存
• 点击刚创建的“档案类型”词汇表，点击右上角添加分类，添加“技术文档”“生活记录”“照片集”三个子分类
• 回到刚才的“2024年12月技术周报”项目项，点击右侧“分类”区域的编辑，勾选“技术文档”，点击保存

5. 前端展示与Mac/Linux适配

5.1 查看前端

点击后台右上角的查看站点，或直接访问http://localhost/my-archive，就能看到自己的数字档案馆了，默认会展示项目和项目项。

5.2 Mac/Linux适配

• Mac：推荐用MAMP一键包（https://www.mamp.info/en/downloads/），步骤和Windows XAMPP几乎一致，只是htdocs目录在/Applications/MAMP/htdocs
• Linux（Ubuntu/Debian）：用以下命令安装依赖：

  sudo apt update
  sudo apt install apache2 mysql-server php8.2 libapache2-mod-php8.2 php8.2-mysql php8.2-xml php8.2-mbstring php8.2-gd php8.2-zip
  sudo systemctl start apache2 mysql
  sudo a2enmod rewrite

• Linux MySQL用户创建步骤：

  sudo mysql -u root -p
  CREATE DATABASE omeka_s_db CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
  CREATE USER 'omeka_s_user'@'localhost' IDENTIFIED BY 'Archive@2025Demo';
  GRANT ALL PRIVILEGES ON omeka_s_db. TO 'omeka_s_user'@'localhost';
  FLUSH PRIVILEGES;
  EXIT;

• Linux Omeka S文件放在/var/www/html目录下，记得修改权限：

  sudo chown -R www-data:www-data /var/www/html/my-archive
  sudo chmod -R 755 /var/www/html/my-archive