zweizs/anki-sync-server

Anki 同步服务器

Docker化的内置Anki同步服务器（2.1.57+）

测试平台

说明

有关环境变量、添加多用户等详细信息，请参考https://docs.ankiweb.net/sync-server.html%E3%80%82

安全性由您自行负责：此服务器默认运行在未加密的8080端口。建议设置带有HTTPS的反向代理，下方提供了示例配置。

在桌面端，需在偏好设置 -> 同步下设置自托管同步服务器选项。对于AnkiDroid，主同步URL使用相同地址（需带末尾斜杠），媒体URL添加/msync/（请查阅上述文档，此设置未来可能变更）。输入地址时确保指定协议（http://）。

注意：2.1.57版本与2.1.57-1+版本不兼容，因为虚拟环境和数据目录的位置已分离（强烈建议删除卷并重新同步）。

单行启动命令

shell
docker run --name anki-sync-server -p 8080:8080 docker.xuanyuan.run/zweizs/anki-sync-server:latest

卷

容器内的/data目录用作卷。如果修改SYNC_BASE，需确保在新指定位置添加卷。

环境变量

Traefik配置示例

yaml
labels:
  traefik.http.services.anki.loadbalancer.server.port: "8080"

这将允许通过主入口点（通常是80/443端口）连接到Anki服务器。

jwilder/nginx-proxy配置示例

此配置未测试

设置环境变量VIRTUAL_PORT为8080。

如果无法工作，可能需要HTTP 1.0支持（如旧版社区Anki同步服务器），此时可尝试在/etc/nginx/proxy.conf中添加以下内容：

nginx
# HTTP 1.0支持
proxy_http_version 1.0;
proxy_buffering off;
proxy_set_header Host $http_host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $proxy_connection;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $proxy_x_forwarded_proto;
proxy_set_header X-Forwarded-Ssl $proxy_x_forwarded_ssl;
proxy_set_header X-Forwarded-Port $proxy_x_forwarded_port;
proxy_set_header X-Forwarded-Path $request_uri;

# 缓解httpoxy攻击
proxy_set_header Proxy "";

链接

• https://github.com/Zweihander-Main/docker/tree/master/anki-sync-server
• https://hub.docker.com/r/zweizs/anki-sync-server

开发说明

• GitHub Action根据标签格式（如anki-sync-server/v2.1.57）创建构建并生成Docker标签
• 无标签时，Action按日期创建发布版本

可提供服务

我提供远程或纽约哈德逊谷地区（美国）的自由职业、合同和咨询服务。关于我以及我能为您提供的服务。

欢迎通过以下***联系我：

hi [a+] zweisolutions {●} com

许可证

https://github.com/ankitects/anki 基于 https://github.com/ankitects/anki/blob/main/LICENSE 许可

本仓库基于 MIT 许可