afrima/anki-sync-server

anki-sync-server

镜像概述和主要用途

anki-sync-server是官方Rust版Anki同步服务器的非官方Docker镜像。该镜像会在Anki官方版本更新时自动同步更新，提供便捷的自建Anki同步服务方案。

项目构建仓库：https://github.com/mathieu-keller/anki-sync-server
官方Anki同步服务器源码：https://github.com/ankitects/anki/tree/main
官方文档：Anki Sync Server 文档

核心功能和特性

• 自动更新：当Anki官方版本更新时，镜像会自动同步更新
• 官方Rust实现：基于Anki官方Rust版本同步服务器构建
• 灵活配置：支持自定义用户认证、服务端口和数据存储路径
• 持久化存储：通过卷挂载实现数据持久化，确保同步数据不丢失

使用场景和适用范围

• 个人用户希望搭建私有Anki同步服务，保护学习数据隐私
• 团队或教育机构部署内部Anki同步服务器，方便成员共享学习卡片
• 对数据存储位置有严格要求，需要本地化部署同步服务的场景

使用方法和配置说明

Docker Compose 部署示例

yaml
version: "3"
services:
  server:
    image: afrima/anki-sync-server:23.12.1
    container_name: anki-sync-server
    environment:
      - SYNC_USER1=test_user_name:test_user_password  # 配置用户（用户名:密码）
      - SYNC_PORT=8080  # 服务监听端口
      - SYNC_BASE=/data  # 数据存储路径
    restart: always
    volumes:
      - <your path>:/data  # 本地路径挂载，替换<your path>为实际路径
    ports:
      - "1337:8080"  # 端口映射（主机端口:容器端口）

Docker Run 命令示例

bash
docker run -d \
  --name anki-sync-server \
  -e SYNC_USER1=test_user_name:test_user_password \
  -e SYNC_PORT=8080 \
  -e SYNC_BASE=/data \
  -v <your path>:/data \
  -p 1337:8080 \
  --restart always \
  afrima/anki-sync-server:23.12.1

配置参数说明

环境变量

• SYNC_USER1：同步用户配置，格式为用户名:密码，用于Anki客户端登录认证
• SYNC_PORT：服务监听端口，默认为8080
• SYNC_BASE：数据存储基础路径，容器内路径，默认为/data

卷挂载

• /data：用于存储Anki同步数据，需挂载本地目录以实现数据持久化，替换<your path>为本地实际路径（如/home/user/anki-data）

端口映射

• 容器端口：由SYNC_PORT指定，默认为8080
• 主机端口：可自定义，如示例中的1337，需确保与容器端口正确映射

客户端配置

部署完成后，在Anki客户端中需配置同步服务器地址：

1. 打开Anki客户端，进入「工具」>「偏好设置」>「网络」
2. 在「同步服务器」栏填写：http://<服务器IP>:<主机端口>/sync/
3. 使用SYNC_USER1配置的用户名和密码登录即可开始同步