arxiv/filemanager

arxiv-filemanager镜像说明

镜像概述

arxiv-filemanager是为arxiv项目提供的文件管理与安全处理服务镜像，支持多种部署方式，便于开发者快速搭建文件管理服务环境，满足学术场景下的文件处理需求。

核心功能

• 文件管理与安全校验（sanitization）
• JWT认证授权机制
• 测试数据库填充工具
• Flask开发模式自动重载

使用场景

• 学术平台的文件上传、存储与安全处理
• 开发环境中文件服务的快速搭建与调试
• 本地测试环境的文件管理功能验证

配置说明

Docker部署

前置条件

• 安装Docker CE（参考https://docs.docker.com/engine/installation/%EF%BC%89
• 构建arxiv-base镜像：克隆https://github.com/cul-it/arxiv-base%EF%BC%8C%E6%89%A7%E8%A1%8C%60docker build -t arxiv-base:latest .`

构建与运行

1. 构建镜像：docker build -t arxiv-filemanager .
2. 启动容器：docker run -p 8000:8000 --rm --name arxiv-filemanager-container arxiv-filemanager（添加-d后台运行）
3. 验证服务：访问http://localhost:8000/filemanager/api/status
4. 停止容器：docker stop arxiv-filemanager-container
5. 清理镜像：docker rmi arxiv-filemanager（若有依赖容器需先执行docker rm CONTAINER_ID）

本地Flask部署

前置条件

• Python 3.6+、pip及pipenv

步骤

1. 安装依赖：pip install pipenv && pipenv install --dev
2. 激活环境：pipenv shell
3. 填充测试数据库：FLASK_APP=app.py python populate_test_database.py
4. 启动开发服务器：FLASK_APP=app.py FLASK_DEBUG=1 flask run
5. 验证服务：访问http://localhost:5000/filemanager/api/status

授权Token生成

生成JWT认证Token（需与服务使用相同密钥）：

bash
JWT_SECRET=foosecret FLASK_APP=app.py pipenv run python generate_token.py

启动服务时指定密钥：

bash
JWT_SECRET=foosecret FLASK_APP=app.py FLASK_DEBUG=1 pipenv run flask run

请求授权接口需在Header中添加Authorization: [生成的Token]。