Anki-Sync-Server 与 Docker 集成：容器化部署完整教程

【免费下载链接】anki-sync-serverA personal Anki sync server (so you can sync against your own server rather than AnkiWeb)项目地址: https://gitcode.com/gh_mirrors/ank/anki-sync-server

Anki-Sync-Server 是一款强大的个人 Anki 同步服务器工具，让你能够脱离 AnkiWeb，搭建属于自己的同步服务。本教程将详细介绍如何通过 Docker 容器化部署 Anki-Sync-Server，实现简单、高效且安全的卡片同步方案。

📋 准备工作：环境与工具要求

在开始部署前，请确保你的系统已安装以下工具：

• Docker Engine（20.10+ 版本）
• Docker Compose（2.0+ 版本）
• Git 版本控制工具

🔄 第一步：获取项目源码

通过 Git 克隆官方仓库到本地：

git clone https://gitcode.com/gh_mirrors/ank/anki-sync-server cd anki-sync-server

⚙️ 第二步：配置服务器参数

项目提供了示例配置文件example.ini，你需要根据需求进行个性化设置：

1. 复制示例配置创建实际配置：

cp example.ini production.ini

2. 关键配置项说明（修改production.ini）：
   • [sync]部分：设置同步端口（默认 27701）和数据存储路径
   • [users]部分：添加允许同步的用户账号（格式：用户名 = 密码）

🐳 第三步：创建 Dockerfile

在项目根目录创建Dockerfile，内容如下：

FROM python:3.9-slim WORKDIR /app COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt COPY . . EXPOSE 27701 CMD ["python", "ankiserverctl.py", "start", "--config", "production.ini"]

📦 第四步：编写 Docker Compose 文件

创建docker-compose.yml实现服务编排：

version: '3' services: anki-sync-server: build: . ports: - "27701:27701" volumes: - ./data:/app/data - ./production.ini:/app/production.ini restart: unless-stopped

🚀 第五步：启动服务与验证

1. 构建并启动容器：

docker-compose up -d --build

2. 检查服务状态：

docker-compose ps

3. 查看日志确认启动成功：

docker-compose logs -f

🔧 常见问题解决

端口冲突问题

如果提示27701端口被占用，可修改docker-compose.yml中的端口映射：

ports: - "27702:27701" # 将主机端口改为 27702

数据持久化配置

确保./data目录有正确权限，或修改docker-compose.yml中的 volume 配置：

volumes: - anki_data:/app/data # 使用命名卷而非主机目录 volumes: anki_data:

📱 Anki 客户端配置方法

1. 打开 Anki 客户端，进入「工具」→「附加组件」
2. 点击「获取插件」，输入插件代码：2124817646（Anki Sync Server 客户端插件）
3. 重启 Anki 后，进入「工具」→「同步服务设置」
4. 输入服务器地址：http://你的服务器IP:27701
5. 输入在production.ini中配置的用户名和密码

📝 服务管理命令

• 停止服务：docker-compose down
• 重启服务：docker-compose restart
• 升级服务：git pull && docker-compose up -d --build

通过 Docker 部署 Anki-Sync-Server 不仅简化了安装流程，还能确保环境一致性和数据安全性。现在你可以随时随地同步你的 Anki 卡片，完全掌控自己的学习数据！

【免费下载链接】anki-sync-serverA personal Anki sync server (so you can sync against your own server rather than AnkiWeb)项目地址: https://gitcode.com/gh_mirrors/ank/anki-sync-server