AAnki Sync
使用教程

把 Anki 连到你的私有同步服务

五分钟设置好,电脑、手机、平板的牌组和复习进度自动保持一致。

开始之前:你需要的三个信息

① 同步地址
https://anki.wtyura.com/sync/
② 用户名
你在本站注册时设置的用户名
③ 密码
和登录本网站的密码完全相同
⚠️

最容易搞错的一点:不要填 AnkiWeb 的账号 Anki 客户端里那个写着「AnkiWeb 账号」的登录框,就是用来填本站账号的。这是 Anki 官方的设计——即使你连的是自托管服务器,界面上所有文字仍然显示 “AnkiWeb”。所以:
· 用户名填本站用户名(不是邮箱地址),不是邮箱;
· 密码填本站登录密码,不是 AnkiWeb 的密码。

💡

同步地址末尾的斜线不能省 必须是 https://anki.wtyura.com/sync/,少了最后那个 / 会同步失败。

一、电脑端(Windows / macOS / Linux)

需要较新版本的 Anki(2.1.57 以上)。版本太旧的话,先到 apps.ankiweb.net 更新。

  1. 打开 Anki,进入 工具 → 偏好设置 → 同步

    macOS 上是 Anki → 设置 → 同步。英文界面为 Tools → Preferences → Syncing。

  2. 如果「AnkiWeb 账号」那里显示你已经登录了(有一个邮箱地址),先点「注销」。

    不注销的话,Anki 会继续用旧账号同步。没登录过就跳过这步。

  3. 找到 自托管同步服务器(Self-hosted sync server),勾选并把地址填进去:

    https://anki.wtyura.com/sync/
  4. 关掉偏好设置窗口,点主界面右上角的同步按钮 ⟳,或直接按 Y 键。

  5. 弹出登录框(标题写着 AnkiWeb,这是正常的),填入本站的用户名和密码。

  6. 第一次同步时 Anki 会问你要「上传」还是「下载」——先别乱点,看下面第五节。

二、安卓手机(AnkiDroid)

  1. 打开 AnkiDroid,进入 设置 → 同步 → 自定义同步服务器

    旧版本在 设置 → 高级 → 自定义同步服务器。

  2. 打开「同步地址」右侧的开关,把地址填进去:

    https://anki.wtyura.com/sync/

    如果还有一个「媒体同步地址」的输入框,填相同的地址。

  3. 回到同步设置里的「AnkiWeb 账号」处登录,填本站用户名和密码(同样不是 AnkiWeb 账号)。

  4. 回主界面点同步图标。如果手机上还没有卡片,第一次要选下载。

三、iPhone / iPad(AnkiMobile)

  1. 打开 AnkiMobile,进入设置(齿轮图标)里的 同步 一栏。

  2. 找到自托管同步服务器(Self-hosted sync server),填入:

    https://anki.wtyura.com/sync/
  3. 在账号处登录,填本站用户名和密码。

  4. 点同步。设备上没有卡片时,第一次选下载。

找不到这一项的话,多半是 App 版本太旧,到 App Store 更新一下再试;还是找不到可以联系我们。

四、我之前已经在用 AnkiWeb,或者电脑里已经有卡片了怎么办?

这是最需要小心的一步。本服务和 AnkiWeb 是两套完全独立的系统,你在 AnkiWeb 上的数据不会自动搬过来,需要你自己走一次「先拿到本地,再传到这里」。

情况 A:电脑里已经有卡片,之前也在用 AnkiWeb

  1. 先用原来的 AnkiWeb 账号同步一次,确认电脑上的数据是最新的、完整的。

  2. 做一份备份:文件 → 导出,格式选「Anki 牌组包(.colpkg)」,勾选「包含日程信息」和「包含媒体文件」,存到桌面。

    这一步别省,万一后面选错方向,靠它恢复。

  3. 按第一节的步骤:注销 AnkiWeb 账号 → 填本站同步地址 → 用本站账号登录。

  4. 第一次同步选 上传(把电脑上的数据传到本站服务器)。

  5. 其他设备(手机、平板)按上面的方法设置好后,第一次同步一律选 下载。

情况 B:卡片只在 AnkiWeb 上,本机是空的(比如刚换电脑)

⚠️

顺序不能反:本机空的时候如果先切到本站再同步,只会把一个空集合上传上来,等于什么都没搬过去。

  1. 先照旧用 AnkiWeb 账号登录并同步,把牌组和媒体完整下载到本机。

  2. 导出一份 .colpkg 备份(同上)。

  3. 再注销 AnkiWeb、填本站地址、用本站账号登录。

  4. 第一次同步选 上传。

情况 C:全新用户,之前没用过 Anki

直接按第一节设置就行。第一次同步选哪个都可以(两边都是空的),之后自动增量同步。

五、第一次同步:选「上传」还是「下载」?

⚠️

这一步是覆盖操作,选反会丢数据 「上传」= 用本机的内容覆盖服务器;「下载」= 用服务器的内容覆盖本机。只有第一次同步(或数据差异过大时)会问,之后就是正常的双向增量同步了。

你的情况该选
本机有卡片,本站服务器是空的(第一台设备)上传
本机是空的,本站服务器已有数据(第二台、第三台设备)下载
两边都有内容,但不确定哪边新先停下,两边各导出一份 .colpkg 备份,再决定以哪台为准
两边都是空的(全新用户)选哪个都行

六、常见问题

提示「用户名或密码错误」/ 登录不上

按可能性从高到低排查:

① 填成 AnkiWeb 的账号了——最常见。要填的是本站的用户名(不是邮箱)和本站密码。

② 同步地址填错或漏了末尾斜线,正确的是 https://anki.wtyura.com/sync/。

③ 最近在网站上改过密码——改密码后所有设备都要重新登录一次。

④ 账号已到期或被暂停——登录本站控制台看一眼状态,到期的话用激活码续期。

偏好设置里找不到「自托管同步服务器」

说明 Anki 版本太旧(这个选项从 2.1.57 才有)。到 apps.ankiweb.net 下载新版覆盖安装即可,本地数据不会丢。手机端到应用商店更新。

Anki 里到处都写着 “AnkiWeb”,是不是我设置错了?

没错,这是正常的。Anki 官方的设计就是这样:即使连的是自托管服务器,界面上的提示文字仍然沿用 “AnkiWeb” 这个词。只要你在「自托管同步服务器」里填了我们的地址,同步就是走我们的服务器,跟 AnkiWeb 没有关系。

第一次同步特别慢,或者卡在媒体文件

正常现象。第一次要把全部图片和音频传一遍,牌组大的话几十分钟也可能。让它跑完就行,中途断了下次会接着传。之后的日常同步只传增量,几秒钟。

我在网站上改了密码,手机就同步不了了

本站的登录密码和同步密码是同一个,改完之后每一台 Anki 客户端都要重新登录一次。在偏好设置的同步页面注销再用新密码登录即可,不会影响已有数据。

空间上限是多少?满了会怎样?

默认每个账号 5 GB,牌组和媒体文件都算在内。登录控制台可以随时看到已用多少、还剩多少。

快满时控制台会提前提醒。真的超了同步会暂停,但服务器上已有的数据不会删,联系我们提高上限即可恢复。日常可以用 Anki 的 工具 → 检查媒体 清理没被任何卡片引用的多余文件。

到期没续费,我的牌组会被删掉吗?

到期后同步立即暂停,但服务器上的数据还会保留 30 天,这期间续期就能马上恢复,什么都不会少。超过 30 天仍未续费,服务器上的牌组和媒体会被清空(账号本身保留)——之后续期仍然可以用,只是需要在电脑上重新选一次「上传」把本地数据传上来。

控制台在到期后会明确显示「将于某年某月某日删除,还剩几天」。

换电脑了怎么办?

新电脑装好 Anki,按第一节填好地址、用本站账号登录,第一次同步选 下载,牌组和进度就都回来了。

我的数据安全吗?需要自己备份吗?

客户端和服务器之间走 HTTPS 加密传输,密码在服务器上只保存不可逆的哈希值,每个账号的数据目录相互独立。

即便如此,仍然建议你定期自己导出一份 .colpkg 备份(文件 → 导出)。任何同步服务都不能替代备份——这也是 Anki 官方的建议。

还有问题?

按上面的步骤走完还是同步不了,把控制台页面截个图发给我们,会帮你看。