chrislongros/anki-sync-server-enhanced

Anki同步服务器增强版

https://github.com/chrislongros/anki-sync-server-enhanced/actions/workflows/build.yml/badge.svg](https://github.com/chrislongros/anki-sync-server-enhanced/actions)

生产级Docker镜像，用于自托管Anki同步服务器，具备备份、监控、仪表盘和安全功能。

!仪表盘

为什么选择此镜像？

官方Anki项目提供同步服务器源代码，但未提供预构建Docker镜像。本项目提供：

• 零构建时间 - 预编译支持amd64、arm64和arm/v7架构
• 自动更新 - 每日构建自动跟踪最新Anki版本
• 企业级功能 - 开箱即用地提供备份、监控、告警和安全特性
• NAS兼容 - 适用于TrueNAS SCALE、Unraid、Synology及任何Docker主机

特性

快速启动

bash
docker run -d \
  --name anki-sync \
  -p 8080:8080 \
  -e SYNC_USER1=user:password \
  -v anki_data:/data \
  chrislongros/anki-sync-server-enhanced:25.09.2-1

然后将Anki客户端配置为同步到 http://你的服务器:8080/

Docker Compose

yaml
services:
  anki-sync-server:
    image: chrislongros/anki-sync-server-enhanced:25.09.2-1
    container_name: anki-sync
    ports:
      - "8080:8080"   # 同步服务器（HTTP）
      - "8443:8443"   # 同步服务器（HTTPS，若启用TLS）
      - "8081:8081"   # 仪表盘（可选）
      - "9090:9090"   # 指标（可选）
    environment:
      - SYNC_USER1=alice:password1
      - SYNC_USER2=bob:password2
      - TZ=Europe/Berlin
      - BACKUP_ENABLED=true
      - METRICS_ENABLED=true
      - DASHBOARD_ENABLED=true
    volumes:
      - anki_data:/data
      - anki_backups:/backups
    restart: unless-stopped

volumes:
  anki_data:
  anki_backups:

Web仪表盘

通过设置 DASHBOARD_ENABLED=true 启用，访问地址 http://服务器:8081/

特性：

• 概览 - 服务器状态、运行时间、用户数量、数据大小、同步操作
• 用户 - 每个用户的统计信息，包括数据大小和最后同步时间
• 备份 - 列出备份，一键创建新备份
• 日志 - 查看同步、认证和备份日志，带有彩色编码条目
• 系统 - 磁盘使用情况、内存使用情况、负载平均值

使用 DASHBOARD_AUTH=admin:password 设置基本认证保护

配置参考

核心配置

备份配置

S3上传配置

监控配置

通知配置

安全配置

TLS / HTTPS

通过Caddy反向代理提供内置TLS支持。支持三种模式：

模式1：Let's Encrypt（自动）

bash
docker run -d \
  -p 80:80 -p 443:443 \
  -e SYNC_USER1=user:password \
  -e TLS_ENABLED=true \
  -e TLS_DOMAIN=anki.yourdomain.com \
  -e TLS_EMAIL=you@email.com \
  -v anki_data:/data \
  -v anki_config:/config \
  chrislongros/anki-sync-server-enhanced:25.09.2-1

模式2：手动证书

bash
docker run -d \
  -p 8443:8443 \
  -e SYNC_USER1=user:password \
  -e TLS_ENABLED=true \
  -e TLS_CERT=/config/certs/fullchain.pem \
  -e TLS_KEY=/config/certs/privkey.pem \
  -v ./certs:/config/certs:ro \
  -v anki_data:/data \
  chrislongros/anki-sync-server-enhanced:25.09.2-1

模式3：自签名（本地/测试）

bash
docker run -d \
  -p 8080:8080 -p 8443:8443 \
  -e SYNC_USER1=user:password \
  -e TLS_ENABLED=true \
  -v anki_data:/data \
  chrislongros/anki-sync-server-enhanced:25.09.2-1

然后将客户端配置为使用 https://你的服务器:8443/

注意： 自签名证书会显示浏览器警告。对于本地网络，你可能更倾向于使用HTTP或有效的证书。

命令行工具

bash
# 用户管理
docker exec anki-sync user-manager.sh list
docker exec anki-sync user-manager.sh add john
docker exec anki-sync user-manager.sh add john mypassword
docker exec anki-sync user-manager.sh reset john newpass
docker exec anki-sync user-manager.sh hash mypassword
docker exec anki-sync user-manager.sh stats

# 备份管理
docker exec anki-sync backup.sh
docker exec anki-sync restore.sh --list
docker exec anki-sync restore.sh --list-s3
docker exec anki-sync restore.sh backup_file.tar.gz
docker exec anki-sync restore.sh --s3 backup_file.tar.gz

客户端配置

桌面版（Windows/Mac/Linux）

1. 打开Anki
2. 前往 工具 → 首选项 → 同步
3. 设置自定义同步服务器为：http://你的服务器:8080/
4. 点击 同步 并输入凭据

AnkiDroid（Android）

1. 打开AnkiDroid
2. 前往 设置 → 同步 → 自定义同步服务器
3. 设置同步URL：http://你的服务器:8080/
4. 设置媒体URL：http://你的服务器:8080/msync/
5. 使用凭据同步

AnkiMobile（iOS）

1. 打开AnkiMobile
2. 前往 设置 → 同步 → 自定义服务器
3. 输入：http://你的服务器:8080/
4. 使用凭据同步

提示： 启用内置TLS（TLS_ENABLED=true）或使用反向代理（Traefik、Caddy、nginx）以实现安全远程访问。

Prometheus指标

当 METRICS_ENABLED=true 时，可在 http://服务器:9090/metrics 获取：

Docker Secrets

用于安全凭据管理：

yaml
services:
  anki-sync-server:
    image: chrislongros/anki-sync-server-enhanced:25.09.2-1
    environment:
      - SYNC_USER1_FILE=/run/secrets/anki_user1
    secrets:
      - anki_user1

secrets:
  anki_user1:
    file: ./secrets/user1.txt  # 包含：用户名:密码

镜像来源

NAS安装

• TrueNAS SCALE： 参见 truenas/README.md
• Unraid： 使用 unraid/anki-sync-server.xml

故障排除

无法连接到服务器：

• 确保端口8080已开放且未被防火墙阻止
• 检查容器日志：docker logs anki-sync
• 验证同步URL以 / 结尾（例如 http://服务器:8080/）

大型集合同步失败：

• 如果使用反向代理，增加 client_max_body_size（nginx）或等效设置
• 必要时设置 MAX_SYNC_PAYLOAD_MEGS 环境变量

认证问题：

• 确保用户名不包含特殊字符
• 检查认证日志：docker exec anki-sync cat /var/log/anki/auth.log
• 尝试重置密码：docker exec anki-sync user-manager.sh reset username newpassword

仪表盘无法加载：

• 确保已设置 DASHBOARD_ENABLED=true
• 检查端口8081已开放
• 查看日志：docker logs anki-sync | grep dashboard

本地构建

bash
# 自动检测最新Anki版本
docker build -t anki-sync-server-enhanced .

# 指定Anki版本
docker build --build-arg ANKI_VERSION=25.09.2 -t anki-sync-server-enhanced:25.09.2-1 .

致谢

基于Ankitects的官方https://github.com/ankitects/anki%E5%90%8C%E6%AD%A5%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%9E%84%E5%BB%BA%E3%80%82

许可证

AGPL-3.0 - © 2026 Christos Longros - 参见 LICENSE