Wdqs Frontend Docker 镜像
wikibase查看 Docker Hub 原文页
Wikibase查询服务前端组件,提供用户界面以查询和交互Wikibase中的结构化数据。
2 次收藏下载次数: 0状态:社区镜像维护者:wikibase仓库类型:镜像最近更新:2 个月前
Wikibase Suite Wikidata Query Service Frontend (wdqs-frontend) 镜像文档
镜像概述与主要用途
概述
Wikibase Suite Wikidata Query Service Frontend(简称 wdqs-frontend)是 Wikibase Suite (WBS) 的核心组件之一,专为在生产环境中自托管 Wikibase 而设计。Wikibase 是一个开源知识图谱平台,允许用户创建、管理和发布结构化知识,功能类似于维基媒体基金会的 Wikidata。wdqs-frontend 作为 Wikibase Query Service 的前端界面,提供用户友好的交互层,支持对知识图谱数据的查询与可视化。
主要用途
- 作为 Wikibase Query Service 的前端门户,提供图形化用户界面,简化知识图谱数据的查询操作。
- 支持用户通过 SPARQL 语言查询 Wikibase 中的结构化数据,并以可读格式展示结果。
- 与 Wikibase 后端服务无缝集成,实现知识图谱数据的实时查询与交互。
核心功能与特性
-
用户友好的查询界面
提供直观的 Web 界面,支持 SPARQL 查询的输入、编辑与执行,降低非技术用户的使用门槛。 -
SPARQL 查询支持
原生支持 SPARQL 1.1 标准,允许用户编写复杂查询语句,获取知识图谱中的关联数据。 -
与后端服务集成
自动连接 Wikibase Query Service 后端(WDQS),实时获取查询结果并动态展示。 -
生产环境优化
基于稳定的 Web 技术栈构建,支持高并发查询场景,适配生产环境的性能与可靠性要求。 -
配置灵活性
支持通过环境变量自定义后端服务地址、端口、超时时间等参数,适配不同部署架构。
使用场景与适用范围
使用场景
- 企业知识管理:企业内部构建产品、客户或流程知识图谱,通过
wdqs-frontend实现数据查询与共享。 - 学术研究:科研机构部署领域知识图谱(如生物医学、历史文献),供研究人员查询结构化数据。
- ***/公共服务:***部门构建开放数据知识图谱,通过前端界面向公众提供透明化数据查询服务。
- 教育领域:高校搭建教学用知识图谱平台,辅助学生学习结构化数据查询与分析。
适用范围
- 需自托管知识图谱的组织或个人。
- 生产环境中的 Wikibase 部署(需配合 WBS 其他组件,如 Wikibase 后端、WDQS 后端、数据库等)。
- 对数据隐私、自定义配置有较高要求的场景(相比依赖公共 Wikidata 服务)。
使用方法与配置说明
前置条件
部署 wdqs-frontend 需配合以下组件:
- Wikibase 后端服务(存储知识图谱数据)。
- Wikibase Query Service 后端(WDQS,处理 SPARQL 查询逻辑)。
- 网络环境需确保
wdqs-frontend可访问 WDQS 后端服务。
Docker 部署示例
1. 基础 docker run 命令
bashdocker run -d \ --name wdqs-frontend \ -p 8834:80 \ # 前端服务端口(默认容器内 80 端口) -e WDQS_HOST=wdqs-backend \ # WDQS 后端服务地址(容器名或 IP) -e WDQS_PORT=8834 \ # WDQS 后端服务端口(默认 8834) -e LOG_LEVEL=info \ # 日志级别(可选:debug/info/warn/error) wikibase/wdqs-frontend:latest
2. docker-compose 配置示例
适用于与其他 WBS 组件协同部署(如 Wikibase、WDQS 后端、数据库):
yamlversion: '3.8' services: wdqs-frontend: image: docker.xuanyuan.run/wikibase/wdqs-frontend:latest container_name: wdqs-frontend ports: - "8834:80" # 前端访问端口 environment: - WDQS_HOST=wdqs-backend # 关联 WDQS 后端服务名 - WDQS_PORT=8834 # WDQS 后端端口 - HTTPS=false # 是否启用 HTTPS(生产环境建议设为 true) - TIMEOUT=30 # 查询超时时间(秒,默认 30) depends_on: - wdqs-backend # 确保 WDQS 后端启动后再启动前端 restart: unless-stopped # 其他 WBS 组件(示例) wdqs-backend: image: docker.xuanyuan.run/wikibase/wdqs:latest # ... (WDQS 后端配置,参考官方文档)
核心配置参数
| 参数名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
WDQS_HOST | 字符串 | localhost | Wikibase Query Service 后端服务地址(容器名、IP 或域名)。 |
WDQS_PORT | 整数 | 8834 | WDQS 后端服务端口。 |
HTTPS | 布尔 | false | 前端是否通过 HTTPS 访问(需配合反向代理配置 SSL 证书)。 |
TIMEOUT | 整数 | 30 | SPARQL 查询超时时间(秒),超过该时间将终止查询。 |
LOG_LEVEL | 字符串 | info | 日志级别,可选值:debug(调试)、info(信息)、warn(警告)、error(错误)。 |
注意事项
- 依赖组件版本兼容性:
wdqs-frontend版本需与 Wikibase Suite 其他组件(如 Wikibase、WDQS 后端)保持一致,避免兼容性问题。 - 生产环境安全:建议通过反向代理(如 Nginx)启用 HTTPS,并限制前端服务的访问权限(如防火墙策略)。
- 性能优化:高并发场景下,可通过调整容器资源限制(CPU/内存)或部署负载均衡提升可用性。
参考文档
- 官方镜像文档:https://github.com/wmde/wikibase-release-pipeline/tree/main/build/wdqs-frontend/README.md
- Wikibase Suite 部署指南:https://github.com/wmde/wikibase-release-pipeline/blob/main/deploy/README.md
wikibase 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 wdqs-frontend 镜像标签
docker pull docker.xuanyuan.run/wikibase/wdqs-frontend:<标签>
DockerHub 原生拉取命令
docker pull wikibase/wdqs-frontend:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务