1.使用easy_install 安装AnkiServer:
$ easy_install AnkiServer
测试安装是否成功,输anki然后按tab能够补全其实就是安装成功了:
2.找到安装路径
此anki server使用的是python2,所以所在的路径是(我的系统是Ubuntu 16.04):
/usr/local/lib/python2.7/dist-packages/AnkiServer-2.0.6-py2.7.egg
里面有如下几个文件夹:
3.拷贝配置文件
exaples文件夹下有个example.ini文件,这是anki server启动时需要的配置文件,可以在home文件夹下建个Anki文件夹,然后把它拷进去命名为production.ini(这个名字不能随便改,因为anki sever在当前目录启动时只会读取production.ini这个文件)
cd ~
mkdir Anki
cd Anki
cp /usr/local/lib/python2.7/dist-packages/AnkiServer-2.0.6-py2.7.egg/exaples/example.ini ~/Anki/production.ini
4.修改配置文件
cd ~/Anki
vi production.ini
主要修改host和allowed_hosts。
其中的host不是公网ip,而是腾讯云控制台里面的内网ip(阿里云也一样):
allowed_hosts设为0.0.0.0,代表允许所有ip访问。其中的端口默认为27701,要注意在腾讯云的安全组中是否开启了这个端口。
5.配置27701端口:
在腾讯云控制台实例中的更多 -> 安全组中选中配置安全组
新建个安全组或者直接点击一个已有安全组:
入站规则 -> 添加规则:
添加入站规则,点击完成:
6.测试anki server
ankiserverctl.py debug
如果没有异常,就说明配置没问题
使用站长工具的端口扫描检测27701端口,多加两个端口用来对照。其中的ip填公网ip,如果27701显示开放,就OK:
7.添加用户
ankiserverctl.py adduser xxx
然后输入密码,这个用户和密码对应之前使用过的AnkiWeb的登陆名和密码。也就是说使用这个用户名和密码可以直接登录Anki。比较推荐使用和AnkiWeb一样的用户名和密码,这样比较方便。
创建用户完成后会在当前目录生成auth.db、session.db和collections文件夹,如果以后想进行服务器迁移的话需要将这些进行备份。auth.db存放了用户名和密码,collections文件夹里会根据用户名生成子文件夹,子文件夹中存放了对应用户的数据(图片、视频等存在collection.media文件夹中,其余信息以数据库的形式存在)。
8.AnkiDroid设置
Settings -> Advanced -> Custom sync server:
注意是http而不是https
Settings -> AnkiDroid -> AnkiWeb account:
这里填刚刚添加的用户名和密码,如果和ankiweb中的一样那么这步就不需要修改了。
没出现问题就可以直接同步,同步时会出现同步冲突,原因是服务器中没有任何anki数据,所以如果你确定AnkiDroid中的数据是完整的话就可以点上传了。
9.windwos桌面版配置
windows端只能使用2.0的旧版本
2.0版本使用python2写的插件,2.1版本用python3写的插件,而GitHub上提供的服务器版本是基于python2.7的,所以新版本无法使用此方法来和私有服务器同步。
也就是说,windows桌面版只能使用2.0版本的。
Unfortunately, there isn't currently any user interface in the Anki destop program to point it at your personal sync server instead of AnkiWeb, so you'll have to write a short "addon".
Create a file like this in your Anki/addons folder called "mysyncserver.py":
import anki.sync
anki.sync.SYNC_BASE = 'http://127.0.0.1:27701/'
anki.sync.SYNC_MEDIA_BASE = 'http://127.0.0.1:27701/msync/'
这里面的anki.sync模块实际上是存在于anki安装目录下的,所以不需要管它,anki会自动找到并执行它的。
10.打补丁
我装好后才发现windows和ankidroid同步会发送错误,原因是anki sync的代码错误,在issue里找到了这个问题并且找到了一个补丁。
cd /usr/local/lib/python2.7/dist-packages/AnkiServer
sudo patch -p1 < /home/ubuntu/anki-sync-server.patch.txt
cd /usr/local/anki-bundled/anki
sudo patch -p1 < /home/ubuntu/anki.patch.txt
参考资料
- GitHub:anki-sync-server
- GitHub:Sync error : database corrupted #47
- Segmentfault:搭建自己的Anki服务器
- 知乎:Linux 下自建Anki服务器
- 简书:搭建自己的Anki同步服务器
后记
我觉得anki是个很好的软件,它的代码也是个很好的学习资料,因为有各种版本可供学习,生态也比较成熟。
但是它并不完美,而且非常不符合国人使用习惯。我决定用它作为一个大型项目的学习计划,一点点分析源码,然后修改、添加自己的功能(比如使用MAGE网盘进行同步)。
另外这个AnkiServer的源码也值得研究。
但是可能非常耗时间,不知道两三年能不能完成。