kaiimehra/headless-anki

headless-anki 多架构Docker镜像

镜像概述

本镜像基于开源项目 https://github.com/ThisIsntTheWay/headless-anki 构建，提供跨架构支持（如amd64、arm64等），实现无图形界面运行Anki记忆卡片应用。适用于需要在服务器、容器集群或无桌面环境中自动化处理记忆卡片的场景。

核心功能与特性

• 多架构支持：兼容主流硬件架构（amd64、arm64等），可在不同设备上部署
• 无界面运行：基于headless模式，无需图形界面即可运行Anki核心功能
• 功能兼容性：支持Anki的卡片创建、复习、同步等核心操作
• 轻量级设计：优化镜像体积，减少运行时资源占用
• 可扩展性：支持集成外部脚本或API实现自动化工作流

使用场景

• 服务器端记忆卡片自动化生成与管理
• 集成到CI/CD流程中批量生成学习材料
• 开发Anki插件时的无界面测试环境
• 嵌入式设备或边缘计算节点上的轻量化学习应用
• 需要通过脚本自动化处理Anki数据的场景

使用方法

基本运行

bash
docker run -d \
  --name headless-anki \
  -v ./anki-data:/app/data \
  thisisnttheway/headless-anki:latest

挂载配置文件

bash
docker run -d \
  --name headless-anki \
  -v ./anki-data:/app/data \
  -v ./custom-config.json:/app/config.json \
  thisisnttheway/headless-anki:latest

环境变量配置

示例：启用同步并设置调试日志

bash
docker run -d \
  --name headless-anki \
  -v ./anki-data:/app/data \
  -e ANKI_SYNC_ENABLED=true \
  -e ANKI_LOG_LEVEL=debug \
  thisisnttheway/headless-anki:latest

Docker Compose配置

yaml
version: '3'
services:
  headless-anki:
    image: thisisnttheway/headless-anki:latest
    container_name: headless-anki
    volumes:
      - ./anki-data:/app/data
    environment:
      - ANKI_SYNC_ENABLED=true
      - ANKI_LOG_LEVEL=info
    restart: unless-stopped

执行自动化脚本

通过exec进入容器执行内置脚本：

bash
docker exec -it headless-anki /app/scripts/generate-cards.sh

或挂载外部脚本目录：

bash
docker run -d \
  --name headless-anki \
  -v ./anki-data:/app/data \
  -v ./my-scripts:/app/scripts/custom \
  thisisnttheway/headless-anki:latest \
  /app/scripts/custom/automate.sh

数据持久化

建议通过挂载数据卷（如示例中的./anki-data:/app/data）持久化Anki数据，避免容器重启后数据丢失。数据卷中包含用户卡片数据、配置文件及应用状态。

注意事项

• 首次运行时会初始化默认数据目录结构，可能需要几分钟时间
• 启用AnkiWeb同步需确保网络通畅，并在首次运行后通过日志获取同步授权信息
• 不同架构设备需选择对应标签镜像（如arm64-latest、amd64-latest）
• 高并发场景下建议调整MAX_CONCURRENT_OPS参数优化性能