tvalero/web-asset-server-build

Specify Web Asset Server容器

镜像概述和主要用途

这是一个为Specify Web Asset Server设计的"开箱即用"Docker容器，旨在简化Specify系统的Web资产服务器部署流程。该容器提供文件存储、上传、下载和删除等功能，适用于需要集中管理Specify系统附件的场景。

核心功能和特性

• 自动构建的Docker容器，简化部署流程
• 支持通过环境变量配置服务器参数
• 提供文件存储目录挂载功能，确保数据持久化
• 包含身份验证密钥机制，增强访问安全性
• 提供配置验证接口，便于检查部署是否正确

前提条件

1. Docker环境：需安装Docker（测试版本v1.11）以支持容器运行
2. 系统资源：至少512MB内存及足够的磁盘空间用于存储附件文件

环境变量配置

容器通过以下环境变量进行配置：

• SPECIFY_KEY：认证密钥，值为"None"时禁用认证，默认值为"None"
• SPECIFY_HOST：公共服务器的DNS名称或IP地址，默认值为"localhost"
• SPECIFY_PORT：公共服务器端口号，默认值为"8080"

安装与部署

1. 获取镜像

通过Docker（命令行、Kitematic或Synology Docker）从以下地址下载容器：
https://hub.docker.com/r/tvalero/web-asset-server-build/

2. 运行容器

使用以下命令启动容器：

bash
docker run --name web-asset-server \
  --env SPECIFY_HOST=<服务器主机名> \
  --env SPECIFY_PORT=<服务器端口> \
  -p 8080:8080 \
  -d tvalero/web-asset-server-build:latest \
  -v <本地文件目录>:/home/specify/attachments:rw

参数说明：

• --name：容器名称
• --env：设置环境变量
• -p：端口映射（主机端口:容器端口）
• -d：后台运行容器
• -v：挂载本地目录到容器内的附件存储目录（需确保本地目录存在且有读写权限）

配置测试

部署完成后，通过以下步骤验证配置是否正确：

1. 访问URL检查服务器响应：
   http://[SPECIFY_HOST]:[SPECIFY_PORT]/web_asset_store.xml

2. 验证响应内容中的主机和端口是否正确指向配置的SPECIFY_HOST和SPECIFY_PORT

3. 验证认证密钥有效性：
   访问 http://[SPECIFY_HOST]:[SPECIFY_PORT]/testkey

使用示例

假设将Web Asset Server部署在公共服务器toto.ird.fr，端口33033，本地文件存储目录为**/data/specify/asset**。

1.启动容器

bash
docker run --name web-asset-server \
  --env SPECIFY_HOST=toto.ird.fr \
  --env SPECIFY_PORT=33033 \
  -p 8080:8080 \
  -d tvalero/web-asset-server-build:latest \
  -v /data/specify/asset/:/home/specify/attachments:rw

2.验证服务器响应

访问 http://toto.ird.fr:33033/web_asset_store.xml，应返回类似以下内容：

xml
<urls>
  <url type="read">http://toto.ird.fr:33033/fileget</url>
  <url type="write">http://toto.ird.fr:33033/fileupload</url>
  <url type="delete">http://toto.ird.fr:33033/filedelete</url>
  <url type="getmetadata">http://toto.ird.fr:33033/getmetadata</url>
  <url type="testkey">http://toto.ird.fr:33033/testkey</url>
</urls>

3.验证认证密钥

访问 http://toto.ird.fr:33033/testkey 检查密钥有效性

Specify客户端配置

通常需要将资产服务器设置添加到全局Specify偏好设置，使所有客户端使用相同配置：

1. 在Specify中打开数据库，导航至帮助菜单中的"关于"选项
2. 在弹出的对话框中，双击右侧"系统信息"下的部门名称，打开全局偏好设置编辑器
3. 添加或设置以下四个属性：
   • USE_GLOBAL_PREFS：设为true
   • attachment.key：值为Docker环境变量SPECIFY_KEY的内容
   • attachment.url：设为http://[SPECIFY_HOST]:[SPECIFY_PORT]/web_asset_store.xml
   • attachment.use_path：设为false

若这些属性不存在，可使用"添加属性"按钮创建