chrislongros/anki-desktop

Anki Desktop Docker (KasmVNC)

https://github.com/chrislongros/anki-desktop-docker/actions/workflows/build.yml/badge.svg](https://github.com/chrislongros/anki-desktop-docker/actions/workflows/build.yml)

使用https://github.com/linuxserver/docker-baseimage-kasmvnc%E5%AE%9E%E7%8E%B0%E9%AB%98%E6%80%A7%E8%83%BD%E6%B5%8F%E8%A7%88%E5%99%A8%E5%8F%AF%E8%AE%BF%E9%97%AE%E7%9A%84Anki Desktop，提供优化的流式传输性能。

🆕 与其他项目不同，本项目使用Anki官方启动器系统，可自动获取最新Anki版本。

!https://raw.githubusercontent.com/chrislongros/anki-desktop-docker/main/.github/screenshot.png

特性

• 🚀 高性能 - KasmVNC提供WebP压缩和自适应编码，确保流畅的浏览器体验
• 🆕 始终最新 - 使用Anki官方启动器，首次运行时获取最新版本
• 🌐 浏览器访问 - 无需VNC客户端，直接在浏览器中打开
• 🔄 自定义同步服务器 - 通过环境变量配置自己的Anki同步服务器
• 🔌 AnkiConnect就绪 - 暴露8765端口，安装插件后自动配置
• 📦 多架构支持 - 支持amd64和arm64平台
• 🔒 安全支持 - 可选HTTPS支持（端口3001）
• 💾 数据持久化 - 卷挂载保留Anki数据和下载的程序文件
• ❤️ 健康检查 - 内置容器健康监控

与其他项目的比较

快速开始

Docker Run

bash
docker run -d \
  --name anki-desktop \
  -p 3000:3000 \
  -v anki_data:/config \
  --security-opt seccomp=unconfined \
  --shm-size=1gb \
  chrislongros/anki-desktop:latest

然后在浏览器中打开 **http://localhost:3000**。

首次运行时，Anki启动器会出现 - 按1然后按Enter下载最新Anki版本。

Docker Compose

yaml
services:
  anki-desktop:
    image: chrislongros/anki-desktop:latest
    container_name: anki-desktop
    ports:
      - "3000:3000"    # HTTP
      - "3001:3001"    # HTTPS（可选）
    volumes:
      - anki_data:/config
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Berlin
      # 可选：自定义同步服务器
      # - ANKI_SYNC_SERVER=http://your-sync-server:8080
    security_opt:
      - seccomp=unconfined
    shm_size: 1gb
    restart: unless-stopped

volumes:
  anki_data:

环境变量

端口

卷

自定义同步服务器

要使用自己的https://github.com/ankitects/anki/tree/main/rslib/sync%EF%BC%8C%E8%AE%BE%E7%BD%AE%60ANKI_SYNC_SERVER%60%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%EF%BC%9A

bash
docker run -d \
  --name anki-desktop \
  -p 3000:3000 \
  -v anki_data:/config \
  -e ANKI_SYNC_SERVER=http://192.168.1.100:8080 \
  --security-opt seccomp=unconfined \
  --shm-size=1gb \
  chrislongros/anki-desktop:latest

CJK字体支持

要添加中文、日文或韩文字体支持：

yaml
environment:
  - DOCKER_MODS=linuxserver/mods:universal-package-install
  - INSTALL_PACKAGES=fonts-noto-cjk

本地构建

bash
git clone https://github.com/chrislongros/anki-desktop-docker.git
cd anki-desktop-docker
docker build -t anki-desktop .

TrueNAS SCALE部署

TrueNAS SCALE用户可创建自定义应用，设置如下：

yaml
容器镜像: chrislongros/anki-desktop:latest
安全上下文:
  - seccomp: unconfined
资源:
  - 共享内存大小: 1Gi
端口:
  - 3000:3000 (Web UI)
  - 8765:8765 (AnkiConnect)
存储:
  - 主机路径或PVC → /config
环境变量:
  - PUID: 1000
  - PGID: 1000
  - TZ: Europe/Berlin
  - ANKI_SYNC_SERVER: http://your-sync-server:8080 (可选)

技术细节

为什么选择KasmVNC？

传统noVNC设置存在高延迟和图像质量差的问题。KasmVNC提供：

• WebP自适应压缩
• 针对Web浏览器优化的低延迟流传输
• 更好的色彩还原
• 减少带宽使用

为什么使用启动器？

其他Anki Docker项目固定为旧版本（25.02.x），因为Anki 25.09+切换到基于启动器的安装。本项目采用启动器系统：

• 始终获取最新Anki版本
• 容器重启时自动更新（可选）
• 与原生Anki安装体验一致

必需的Docker标志

• --security-opt seccomp=unconfined - Qt/Chromium沙箱所需
• --shm-size=1gb - 防止Qt WebEngine的共享内存问题

故障排除

启动器后黑屏

检查容器日志：docker logs anki-desktop

常见修复：

• 确保设置了--security-opt seccomp=unconfined
• 确保设置了--shm-size=1gb
• 尝试重启容器

性能缓慢

• 点击KasmVNC工具栏中的齿轮图标调整质量设置
• 为较慢的网络降低视频质量

AnkiConnect

AnkiConnect在安装后预配置。8765端口已暴露。

1. 在浏览器中打开Anki
2. 前往工具 → 插件 → 获取插件
3. 输入代码：2055492159
4. 重启Anki（右键桌面 → Anki）

插件自动配置为监听0.0.0.0:8765并启用CORS。

测试：

bash
curl http://localhost:8765 -X POST -d '{"action": "version", "version": 6}'

许可证

MIT许可证 - 参见LICENSE

致谢

• Anki - 强大的智能闪卡
• LinuxServer.io - KasmVNC基础镜像
• KasmVNC - 高性能VNC