outrigger/pa11y

Outrigger pa11y Docker镜像

pa11y（CLI式无障碍测试工具）的Docker镜像，支持v5版本。

该Docker镜像提供https://github.com/pa11y/pa11y%E7%9A%84%E4%BD%BF%E7%94%A8%EF%BC%88%E6%B3%A8%EF%BC%9A%E8%AF%A5%E9%A1%B9%E7%9B%AEv5%E7%89%88%E6%9C%AC%E7%9B%AE%E5%89%8D%E4%B8%8D%E5%9C%A8%E4%B8%BB%E5%88%86%E6%94%AF%EF%BC%89%EF%BC%8C%E5%9F%BA%E4%BA%8Ealekzonder/puppeteer%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%E3%80%82

核心功能

• 支持CLI方式执行网页无障碍性检测
• 可通过配置文件自定义检测规则和浏览器参数
• 支持集成到项目构建或测试流程中
• 基于Puppeteer实现，可扩展截图等附加功能

使用场景

• 网页无障碍合规性自动化检测
• 项目开发过程中的无障碍质量管控
• 批量检查多页面的无障碍问题

配置说明与示例

Docker Run示例

快速检测指定URL的无障碍性：

docker run -i --rm --cap-add=SYS_ADMIN \
  --name pa11y outrigger/pa11y:1 http://outrigger.sh

Docker-Compose简单版

通过docker-compose执行上述检测：

yaml
version: '3.3'
services:
  pa11y:
    image: outrigger/pa11y:1
    container_name: projectname_${DOCKER_ENV:-local}_pa11y
    command: http://outrigger.sh
    network_mode: bridge
    cap_add:
      - SYS_ADMIN

Docker-Compose项目集成版

将pa11y集成到项目测试流程（建议放在单独的build.yml中）：

yaml
# 执行命令：docker-compose -f build.yml run --rm pa11y
version: '3.3'
services:
  pa11y:
    image: outrigger/pa11y:1
    container_name: projectname_${DOCKER_ENV:-local}_pa11y
    command: ["--config", "/code/pa11y/config.js"]
    network_mode: bridge
    volumes:
      # 挂载自定义配置文件（假设存在config.js）
      - ./tests/pa11y/:/code/pa11y/
    cap_add:
      - SYS_ADMIN

pa11y配置文件示例

自定义浏览器参数和检测目标：

js
const browser = await puppeteer.launch({
    ignoreHTTPSErrors: true,
    args: [
      '--disable-dev-shm-usage'
    ],
});

pa11y('http://outrigger.sh', {
    browser: browser
});

browser.close();

截图功能示例

利用基础镜像的截图工具生成网页截图：

bash
docker run -it --rm \
  --shm-size 1G \
  -v $PWD:/screenshots \
  --entrypoint "" \
  outrigger/pa11y:1 \
  screenshot_series 'http://outrigger.sh' 1366x768

参考资源

• https://hub.docker.com/r/alekzonder/puppeteer/
• https://github.com/GoogleChrome/puppeteer
• https://github.com/GoogleChrome/puppeteer/blob/master/docs/troubleshooting.md#running-puppeteer-in-docker
• https://github.com/pa11y/pa11y

安全报告

如有安全问题，请发送邮件至***。

维护者

![Phase2 Logo]([***]