数字档案馆系统档案数据共享零门槛落地全步骤实操指南

一、前置环境准备

1.1 依赖一键安装

推荐使用Ubuntu 22.04系统（兼容性最好，零踩坑），直接复制执行以下命令，完成所有基础依赖安装：

``` sudo apt update && sudo apt install -y python3-pip python3-venv git openjdk-17-jre minio nginx ```

1.2 拉取开源基础框架

直接执行以下命令拉取轻量开源数字档案馆基础包，无需手动下载，复制即可运行：

``` git clone https://github.com/hello-evan/digital-archive-base.git ./digital-archive cd digital-archive ```

接着创建虚拟环境，安装项目依赖：

``` python3 -m venv venv source venv/bin/activate pip install -r requirements.txt ```

二、核心配置：开启档案数据共享

2.1 配置MinIO共享存储

MinIO用于存储档案原始文件，支持大文件共享，执行以下命令启动服务：

``` mkdir -p ~/minio-archive-data minio server ~/minio-archive-data --console-address ":9001" & ```

打开浏览器访问 http://你的服务器IP:9001，默认账号密码均为minioadmin，按以下步骤操作：

• 点击创建存储桶，名称填写archive-share，创建后进入存储桶
• 点击左侧菜单访问规则，添加规则：前缀填，访问权限选只读，保存
• 点击左下角访问密钥，创建新访问密钥，复制生成的AccessKey和SecretKey备用

2.2 填写系统共享配置

打开项目根目录的config.py文件，直接替换为以下完整配置，再替换括号内标注的你自己的信息即可：

``` 数据库配置：使用SQLite，无需额外安装数据库，零配置 DATABASE_CONFIG = { "type": "sqlite", "path": "./archive.db" } MinIO存储配置：替换为你自己的信息 MINIO_CONFIG = { "endpoint": "你的服务器IP:9000", "access_key": "刚才复制的AccessKey", "secret_key": "刚才复制的SecretKey", "bucket": "archive-share", "secure": False } 档案共享核心配置 SHARE_CONFIG = { 开启跨域访问，支持外部系统对接 "enable_cross_origin": True, 允许访问的来源，开放所有填[""]，内网限制填对应IP段如["192.168.0.0/16"] "allow_origins": [""], 开启公开共享，开放档案无需授权即可访问 "enable_public_share": True } ```

保存配置文件，内网部署请务必将allow_origins改为单位内网IP段，提升安全性。

三、初始化系统并导入档案

3.1 一键初始化数据库

执行以下命令初始化数据库，创建管理员账号：

``` flask init-db flask create-admin --username admin --password 123456@archive ```

3.2 导入档案并开启共享

执行flask run临时启动系统，打开浏览器访问http://你的服务器IP:5000/admin，用刚才创建的账号登录，按以下步骤操作：

• 点击左侧菜单批量导入档案，上传打包好的zip格式档案包，系统会自动解析批量导入
• 导入完成后进入档案管理页面，对需要开放共享的档案，勾选允许共享选项，点击保存即可

操作完成后关闭临时服务（按Ctrl+C终止进程）。

四、配置反向代理并启动服务

4.1 配置Nginx反向代理

打开Nginx配置文件/etc/nginx/sites-available/default，替换为以下完整配置，替换掉标注的服务器IP：

``` server { listen 80; server_name 你的服务器IP; location / { proxy_pass http://127.0.0.1:5000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } ```

执行以下命令验证配置并重启Nginx：

``` sudo nginx -t && sudo systemctl reload nginx ```

4.2 启动系统后台服务

执行以下命令启动系统，后台运行不中断：

``` source venv/bin/activate gunicorn -w 4 -b 127.0.0.1:5000 app:app --daemonize ```

五、验证共享功能并对接

按以下步骤验证，全部通过说明部署成功：

• 在外部设备浏览器输入http://你的服务器IP/api/share/list?page=1&page_size=10，能正常返回JSON格式的档案列表，说明接口正常
• 点击列表中任意开放档案的download_url，能正常下载档案文件，说明共享存储配置正确

常用共享接口说明，对接其他系统可直接调用：

接口地址	功能	参数说明
/api/share/list	获取所有开放共享档案列表	page：页码，page_size：每页条数
/api/share/detail/<档案ID>	获取单个档案元数据详情	无
/api/share/download/<档案ID>	获取档案文件下载地址	无

最后操作：部署完成后请立即登录后台修改默认管理员密码，避免安全风险。如果需要授权访问，只需关闭config.py中的enable_public_share，调用接口时在请求头添加后台生成的access token即可。