中小机构从零搭建可落地数字档案馆系统SaaS版实操完整指南

一、前期准备

1.1 基础资源准备

你需要提前准备好以下资源，所有环节均可直接获取，无额外技术门槛：

• 已备案域名1个，可通过 阿里云万网 直接购买备案，全程2-3天完成
• 云服务器1台，最低配置要求1核2G带宽5M以上，系统选择CentOS 7.9 64位，可直接通过官方渠道购买
• 本地终端工具：Windows推荐Git Bash，Mac自带终端，Git下载地址：https://git-scm.com/downloads

1.2 服务器环境初始化

通过终端连接你的云服务器，复制以下命令依次执行，一键安装Docker和Docker Compose，所有步骤无需修改参数：

``` 安装Docker yum install -y docker && systemctl start docker && systemctl enable docker 安装Docker Compose curl -L "https://github.com/docker/compose/releases/download/v2.18.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose 验证安装，输出版本号即为成功 docker --version && docker-compose --version ```

执行完成后如果输出Docker和Docker Compose的版本号，说明环境初始化完成。如果提示权限不足，切换到root用户重新执行即可。

二、SaaS版系统拉取与核心配置

2.1 拉取预配置项目包

在服务器根目录执行以下命令，拉取已经适配多租户架构的开源数字档案馆配置包：

``` mkdir -p /opt/digital-archive-saas && cd /opt/digital-archive-saas && git clone https://github.com/rookiepeter/digital-archive-saas.git . ```

拉取完成后直接进入配置环节，无需修改目录结构。

2.2 修改核心服务配置

输入命令vim docker-compose.yml打开配置文件，删除原有内容后，将以下完整配置复制进去，所有需要修改的参数已标注：

``` version: '3' services: db: image: mysql:5.7 restart: always environment: MYSQL_ROOT_PASSWORD: your_db_123456 修改为你自己的数据库密码 MYSQL_DATABASE: archive_saas volumes: - ./mysql:/var/lib/mysql app: image: digitalarchive/digital-archive-saas:v1.0 restart: always ports: - "3000:3000" environment: DB_HOST: db DB_USER: root DB_PASSWORD: your_db_123456 和上面的数据库密码保持一致 DB_NAME: archive_saas TENANT_STORAGE_ROOT: /data/tenants 租户存储根目录，无需修改 volumes: - ./tenants:/data/tenants - ./logs:/app/logs depends_on: - db nginx: image: nginx:alpine restart: always ports: - "80:80" - "443:443" volumes: - ./nginx/conf.d:/etc/nginx/conf.d - ./nginx/cert:/etc/nginx/cert depends_on: - app ```

修改完成后，按Esc输入:wq回车保存退出。

2.3 配置反向代理与SSL证书

依次执行以下命令创建目录，然后申请免费SSL证书（替换成你自己的域名和邮箱）：

``` 安装certbot申请证书 yum install -y certbot && mkdir -p ./nginx/conf.d ./nginx/cert 申请证书，替换your-domain.com为你的域名，your@email.com为你的邮箱 certbot certonly --standalone -d your-domain.com --email your@email.com --agree-tos 复制证书到指定目录，替换your-domain.com为你的域名 cp /etc/letsencrypt/live/your-domain.com/fullchain.pem ./nginx/cert/ cp /etc/letsencrypt/live/your-domain.com/privkey.pem ./nginx/cert/ ```

输入命令vim ./nginx/conf.d/default.conf创建Nginx配置，复制以下内容，替换其中的your-domain.com为你自己的域名：

``` server { listen 80; server_name your-domain.com; return 301 https://$server_name$request_uri; } server { listen 443 ssl http2; server_name your-domain.com; ssl_certificate /etc/nginx/cert/fullchain.pem; ssl_certificate_key /etc/nginx/cert/privkey.pem; location / { proxy_pass http://app:3000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } ```

保存退出后，配置环节全部完成。

三、启动系统与初始化

3.1 一键启动所有服务

在项目目录/opt/digital-archive-saas执行以下命令启动所有服务：

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

等待2-3分钟让系统完成初始化，执行docker-compose ps查看服务状态，所有服务显示Up即为启动成功。如果服务启动失败，执行docker-compose logs [服务名]查看日志，90%的失败原因是密码不统一、端口被占用，修改对应配置后执行docker-compose restart即可。

3.2 超级管理员初始化

打开浏览器访问你的域名，第一次访问会自动跳转到初始化页面，按页面提示填写：

• 超级管理员账号：设置你的登录邮箱和密码
• 平台名称：填写你的机构名称
• 存储配置：默认使用服务器本地存储，10万册以内档案完全够用，无需修改

点击提交后自动跳转到超级管理员后台，初始化完成。

四、创建租户与日常使用

本SaaS版支持多机构多租户数据隔离，每个租户独立分配存储空间和管理账号，创建步骤如下：

1. 登录超级管理员后台，点击左侧菜单租户管理-新增租户
2. 填写入驻机构名称、租户管理员账号、初始密码，分配存储空间限额（默认10G可自定义修改）
3. 点击提交后系统自动生成租户独立访问入口，将入口发给对应机构管理员即可使用

租户管理员登录后可自主完成档案著录、分类归档、全文检索、权限分配等操作，完全符合国家数字档案馆建设规范，所有数据存储在自有服务器，安全可控。

五、日常维护常见问题

• 自动备份：系统每天凌晨自动备份数据库和租户数据到项目备份目录，可直接下载到本地留存，无需手动操作
• 存储扩容：存储空间不足时，直接扩容云服务器硬盘即可，系统自动识别新空间，无需修改配置
• 证书更新：Let's Encrypt证书有效期90天，执行certbot renew即可一键更新，无需额外配置