AnkiCommunity Sync Server 使用教程

1. 项目介绍

AnkiCommunity Sync Server 是一个开源的 Anki 同步服务器，允许用户在自己的服务器上同步 Anki 数据，而不是使用 AnkiWeb。该项目旨在提供一个自托管的同步解决方案，适用于那些希望完全控制其数据的用户。

Anki 是一个强大的开源记忆卡片应用程序，支持跨平台同步。AnkiCommunity Sync Server 允许用户在本地或私有服务器上运行同步服务，从而避免依赖 AnkiWeb。

2. 项目快速启动

2.1 安装依赖

首先，确保你已经安装了 Python 和 pip。然后，克隆项目并安装依赖：

git clone https://github.com/ankicommunity/ankicommunity-sync-server.git
cd ankicommunity-sync-server
pip install -r src/requirements.txt
pip install -e src

2.2 配置服务器

复制默认配置文件并进行配置：

cp src/ankisyncd.conf src/ankisyncd/

你可以使用环境变量来配置服务器，例如：

export ANKISYNCD_AUTH_DB_PATH=/path/to/auth.db

2.3 创建用户

使用以下命令创建用户：

python -m ankisyncd_cli adduser <username>

2.4 启动服务器

启动 Anki Sync Server：

python -m ankisyncd

2.5 配置 Anki 客户端

在 Anki 客户端中配置自定义同步服务器。对于 Anki 2.1 及以上版本，创建一个新的插件目录，并在其中创建一个 __init__.py 文件，内容如下：

import os
addr = "http://127.0.0.1:27701/"  # 替换为你的服务器地址
os.environ["SYNC_ENDPOINT"] = addr + "sync/"
os.environ["SYNC_ENDPOINT_MEDIA"] = addr + "msync/"

3. 应用案例和最佳实践

3.1 自托管同步服务

许多用户希望完全控制他们的数据，避免依赖第三方服务。通过使用 AnkiCommunity Sync Server，用户可以在自己的服务器上托管同步服务，确保数据的安全性和隐私性。

3.2 企业内部使用

在企业环境中，员工可能需要使用 Anki 进行学习和培训。通过部署 AnkiCommunity Sync Server，企业可以为员工提供一个内部的同步服务，确保数据不会外泄。

3.3 教育机构

教育机构可以使用 AnkiCommunity Sync Server 为学生提供一个安全的同步服务，确保学生的学习数据不会被外部访问。

4. 典型生态项目

4.1 Anki

Anki 是一个开源的记忆卡片应用程序，支持跨平台同步。AnkiCommunity Sync Server 是 Anki 的一个补充项目，允许用户自托管同步服务。

4.2 AnkiDroid

AnkiDroid 是 Anki 的 Android 版本，支持与 AnkiCommunity Sync Server 进行同步。用户可以在 AnkiDroid 中配置自定义同步服务器，实现与桌面版 Anki 的数据同步。

4.3 AnkiMobile

AnkiMobile 是 Anki 的 iOS 版本，同样支持与 AnkiCommunity Sync Server 进行同步。用户可以在 AnkiMobile 中配置自定义同步服务器，实现与桌面版 Anki 的数据同步。

通过这些生态项目，用户可以在不同的设备上无缝同步他们的 Anki 数据，提高学习效率。