specifyconsortium/specify-asset-service

Web Asset Server

镜像概述和主要用途

Web Asset Server 是 Specify 的附件服务器实现，用于处理 Specify 系统的附件存储、管理及相关服务。该实现主要面向 Ubuntu 系统，其他 Linux 系统需少量修改即可运行，Windows 系统需大量适配才能使用。其核心功能包括附件的元数据处理、缩略图生成、Web 服务提供等，旨在为 Specify 客户端提供统一的附件访问接口。

核心功能和特性

• 多版本 Python 支持：原生支持 Python 3.6，通过修改可适配 Python 2.6/2.7
• 元数据处理：集成 ExifRead 库，支持读取附件的 EXIF 元数据
• Web 服务框架：基于 bottlepy 轻量级 Web 框架构建
• 缩略图生成：通过 ImageMagick 生成图片缩略图，Ghostscript 处理 PDF 缩略图
• 部署灵活性：支持 Paste Python Web 服务器，可通过 upstart 或 systemd 实现服务自动启停
• 安全访问控制：通过 Specify 全局偏好配置实现附件访问授权

使用场景和适用范围

• 适用对象：Specify Collections Consortium 成员机构及使用 Specify 系统的用户
• 应用场景：Specify 系统的附件集中管理，包括图片、PDF 等文件的存储、元数据提取和缩略图服务
• 运行环境：优先推荐 Ubuntu 系统，其他 Linux 系统需调整依赖安装命令，Windows 系统不建议使用

详细使用方法和配置说明

系统依赖安装

依赖组件列表

1. Python 3.6（Python 2.6/2.7 需适配）
2. ExifRead（EXIF 元数据处理）
3. sh（Python shell 命令工具）
4. bottlepy（Web 微框架）
5. ImageMagick（缩略图生成）
6. Ghostscript（PDF 缩略图处理）
7. Paste（Python Web 服务器）

Ubuntu 系统依赖安装命令

shell
sudo apt-get -y install --no-install-recommends \
  python-pip \
  imagemagick \
  ghostscript
sudo pip install -r requirements.txt

源码仓库克隆

shell
git clone git://github.com/specify/web-asset-server.git
cd web-asset-server

配置文件调整

修改工作目录下的 settings.py 文件，关键配置项包括：

• SERVER：设置为 'paste'（推荐使用 Paste 服务器）
• attachment.key：生成或获取访问密钥（需与 Specify 配置一致）

部署方式

Docker 部署（推荐）

Dockerfile

dockerfile
FROM ubuntu:latest
WORKDIR /app
RUN apt-get update && apt-get install -y --no-install-recommends \
    python3 \
    python3-pip \
    imagemagick \
    ghostscript \
    && rm -rf /var/lib/apt/lists/*
COPY requirements.txt .
RUN pip3 install --no-cache-dir -r requirements.txt
COPY . .
RUN sed -i 's/SERVER = .*/SERVER = "paste"/' settings.py
EXPOSE 8080
CMD ["python3", "server.py"]

docker-compose.yml

yaml
version: '3'
services:
  web-asset-server:
    build: .
    ports:
      - "8080:8080"
    volumes:
      - ./settings.py:/app/settings.py
      - ./assets:/app/assets  # 附件存储目录（可选）
    restart: always

启动命令

shell
docker-compose up -d

传统部署（系统服务）

使用 Paste 服务器

在 settings.py 中设置 SERVER = 'paste'，通过以下命令启动：

shell
python server.py

特权端口访问（如 80 端口）

推荐使用 authbind 工具：

shell
sudo apt-get install authbind
# 允许当前用户使用 80 端口
touch 80 && chmod u+x 80 && sudo mv 80 /etc/authbind/byport
# 启动命令
authbind python server.py

systemd 服务部署

1. 创建服务文件 /etc/systemd/system/web-asset-server.service：

ini
[Unit]
Description=Specify Web Asset Server
Wants=network.target

[Service]
User=specify  # 替换为实际运行用户
WorkingDirectory=/home/specify/web-asset-server  # 替换为实际路径
ExecStart=/usr/bin/authbind /usr/bin/python /home/specify/web-asset-server/server.py  # 若使用特权端口
Restart=always

[Install]
WantedBy=multi-user.target

2. 启用并启动服务：

shell
sudo systemctl daemon-reload
sudo systemctl enable --now web-asset-server

upstart 服务部署

1. 创建配置文件 /etc/init/web-asset-server.conf：

ini
description "Specify Web Asset Server"
author "Ben Anhalt <anhalt@ku.edu>"

start on runlevel [234]
stop on runlevel [0156]

setuid anhalt  # 替换为实际运行用户

chdir /home/anhalt/web-asset-server  # 替换为实际路径
exec /usr/bin/authbind /usr/bin/python /home/anhalt/web-asset-server/server.py  # 若使用特权端口
respawn

2. 启动服务：

shell
sudo initctl reload-configuration
sudo start web-asset-server

日志路径：/var/log/upstart/web-asset-server.log

HTTPS 配置

若 Specify 7 服务器启用 HTTPS，需为 Web Asset Server 配置 HTTPS。推荐通过 Nginx 反向代理实现，配置示例参考 https://gist.github.com/benanhalt/d43a3fa7bf04edfc0bcdc11c612b2278%E3%80%82%E5%85%B3%E9%94%AE%E9%85%8D%E7%BD%AE%E5%8C%85%E6%8B%AC%EF%BC%9A

• 代理转发至 Web Asset Server 服务端口
• 重写 web_asset_store.xml 资源中的链接

Specify 系统配置

需在 Specify 全局偏好中添加以下属性（通过 Specify 客户端的“帮助 > 关于”菜单，双击“系统信息”中的机构名称进入配置界面）：

Python 旧版本兼容性

• Python 2.7 支持：使用 https://github.com/specify/web-asset-server
• Python 2.6 支持：参考 https://github.com/specify/web-asset-server#python-2.6-compatibility

版权信息

Web Asset Server 版权所有 © 2020 Specify Collections Consortium。
本软件为自由软件，遵循 GNU General Public License 2 (GPL2) 协议，不提供任何明示或暗示的担保。

Specify Collections Consortium
Biodiversity Institute
University of Kansas
1345 Jayhawk Blvd.
Lawrence, KS 66045 USA
官网：[***]