pastakhov/restbase

容器化MediaWiki RESTbase服务

本仓库包含用于运行https://www.mediawiki.org/wiki/RESTBase%E4%BB%A3%E7%90%86%E7%9A%84Docker%E5%AE%B9%E5%99%A8%EF%BC%8C%E6%98%AFhttps://github.com/pastakhov/compose-mediawiki-ubuntu%E9%A1%B9%E7%9B%AE%E7%9A%84%E7%BB%84%E6%88%90%E9%83%A8%E5%88%86%E3%80%82

镜像概述

该镜像实现了MediaWiki RESTbase服务的容器化部署，为MediaWiki提供RESTful API代理能力，支持多域名配置与Parsoid服务集成，助力MediaWiki站点的API功能实现。

核心功能

• 作为MediaWiki的REST API代理，处理API请求转发与响应
• 支持多域名配置，适配不同MediaWiki站点的需求
• 可配置工作进程数量，优化服务性能
• 与Parsoid服务集成，支持页面解析与渲染相关功能

使用场景

• 容器化部署MediaWiki环境时，为其提供REST API支持
• 需要多域名服务的MediaWiki站点场景
• 配合Parsoid服务实现MediaWiki页面的解析与渲染需求

配置说明

通过以下环境变量配置RESTbase服务：

• RB_CONF_NUM_WORKERS：工作进程数量，0为单进程，ncpu按CPU核心数启动
• RB_CONF_DOMAIN_{domain}：域名配置，{domain}需与MediaWiki web容器的MW_REST_DOMAIN一致，可配置多个
• RB_CONF_PARSOID_HOST：Parsoid服务URI，示例：http://parsoid:8000
• RB_CONF_BASE_URI_TEMPLATE：RESTbase基础URI模板，示例：http://{domain}/api/rest_v1
• RB_CONF_API_URI_TEMPLATE：MediaWiki API URI模板，示例：http://{domain}/w/api.php

配置示例

环境变量RB_CONF_DOMAIN_web=http://mywiki/w/api.php生成配置如下：

default_project: &default_project
  x-modules:
    - path: projects/docker.yaml
      options: &default_options
        action:
          apiUriTemplate: "{{'${RB_CONF_API_URI_TEMPLATE:-'http://{domain}/w/api.php'}'}}"
          baseUriTemplate: "{{'${RB_CONF_BASE_URI_TEMPLATE:-'http://{domain}/api/rest_v1'}'}}"

spec_root: &spec_root
  x-sub-request-filters:
    options:
      allow:
        pattern: [***] # web
  paths:
    /{domain:web}: *default_projecturi

services:
  - name: restbase
    conf:
      spec: *spec_root