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，你需要根据需求进行个性化设置：
- 复制示例配置创建实际配置：
cp example.ini production.ini- 关键配置项说明（修改
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🚀 第五步：启动服务与验证
- 构建并启动容器：
docker-compose up -d --build- 检查服务状态：
docker-compose ps- 查看日志确认启动成功：
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 客户端配置方法
- 打开 Anki 客户端，进入「工具」→「附加组件」
- 点击「获取插件」，输入插件代码：
2124817646（Anki Sync Server 客户端插件） - 重启 Anki 后，进入「工具」→「同步服务设置」
- 输入服务器地址：
http://你的服务器IP:27701 - 输入在
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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考