好处

搭建自己的数据中心，避免数据被各种绑架。

要求

操作系统

CouchDB 支持目前所有的主流操作系统。比如 Fedora, CentOS, Ubuntu, Windows, MacOS等等，
这里只讲解 CentOS 下的安装，其他操作系统安装可以参考 CouchDB 官方的安装手册。

CentOS 7.3 64位，使用的是各种云官方提供的镜像。

CouchDB

安装的是 2.1.1 版本。

硬件信息

CPU 1核
内存 2GB(其实512M内存就够了，本人就在另一台 512M内存的机子下一直使用着)
公网带宽 1Mbps

其他

ssh 客户端，用来远程登录你的服务器。Windows 用户可以使用 putty 或者 xshell 等工具，Linux 系统可以直接使用 ssh 命令 ssh 用户名@服务器地址

操作步骤

CouchDB 安装配置步骤

通过 ssh 客户端登录后，进行如下操作（为了讲解的方便，下面的操作默认使用 root 进行，如果你是非 root 用户，需要自己进行 sudo 操作）

步骤

1. 添加 CouchDB 官方源。创建文件 /etc/yum.repos.d/bintray-apache-couchdb-rpm.repo, 并粘贴如下内容

2. 安装 yum-plugin-fastestmirror， epel-release 和 couchdb。其中 yum-plugin-fastestmirror 用来提高安装文件的下载速度，可以不安装。分别执行如下命令。

   1. 1yum -y install yum-plugin-fastestmirror 
      

      ---

   2. 2yum -y install epel-release 
      

      ---

   3. 3yum -y install couchdb 
      

      ---

   在安装 couchdb 时，由于需要连接到 CouchDB 官网去下载对应的文件， 可能需要等待比较长的时间。

3. 修改配置文件 /opt/couchdb/etc/local.ini。

   1. 在 [chttpd] 节点里， 把 ;bind_address = 127.0.0.1 修改成 bind_address = 0.0.0.0。
   2. 在 [chttpd] 节点位置，也就是刚才 bind_address 下面添加一行 require_valid_user = true.
   3. 在 [admins] 节点里，将 ;admin = mysecretpassword 修改为 admin = xiaoshujiang , 其中 admin 为用户名, xiaoshujiang为密码，可以根据自己需要设定
   4. 在 [couch_httpd_auth] 节点里，将 ; require_valid_user = false 修改为 require_valid_user = true。
   5. 在 [httpd] 节点下，添加一行 enable_cors = true.
   6. 在文件的结尾添加下面的内容
      1. 1[cors] 
         

         ---

      2. 2origins = * 
         

         ---

      3. 3credentials = true 
         

         ---

      4. 4headers = accept, authorization, content-type, origin, referer 
         

         ---

      5. 5methods = GET, PUT, POST, HEAD, DELETE 
         

         ---

   7. 这个是修改前的配置文件， 这个是修改后的配置文件，用户可以对比这两个文件修改的地方

4. 修改完配置文件后，通过命令行执行 service couchdb start 启动就可以了。

5. 访问 http://服务器ip地址:5984/_utils/index.html , 浏览器会弹出用户名认证窗口，输入刚才在配置文件里使用的用户名(admin)和密码(xiaoshujiang)，能够正常访问就表示数据库搭建完成，可以接下来小书匠编辑器配置的操作了。这里需要注意的是，如果您的服务器开启了端口访问限制，记得取消对 5984 端口的限制访问。

到这里 CouchDB 数据库的安装配置已经完成，下面一节的配置需要用户到小书匠编辑器上进行操作。在进行下一节配置操作时，先记录下这几个数据点

其中数据库名可以是任何字母数字的组合，不需要先创建，只要提供一个合法的数据库名就可以了。

注

1. 如果您的服务器打开端口访问的限制功能，记得让 5984 端口可以访问。

小书匠编辑器自定义数据中心配置步骤

在前面一节 CouchDB 数据库安装并配置完成后，就可以按照下面的步骤配置小书匠客户端，实现自定义数据中心。

步骤

1. 注册小书匠用户，使用小书匠的客户端或者网页版本 http://markdown.xiaoshujiang.com , 点击小书匠主按钮>用户>用户注册， 注册一个用户。

2. 注册成功后，只要进行了邮箱验证，点击 我已付费，提醒管理员 按钮，系统就会自动给你一个临时会员的资格。

3. 成功开启临时会员后，通过 小书匠主按钮>数据>同步 进入数据管理界面，在服务器选项里选择 自定义，输入数据库地址 http://ip_host:5984/xsjtest, 在帐号和密码框里输入你在 couchdb 设置的用户名和密码 (admin/xiaoshujiang). 点击 应用按钮 。

4. 创建一篇新的文章，数据就会自动同步到你自定义数据库里了。

5. 另外，可以到小书匠主按钮>用户>用户管理界面>用户配置里，把实时同步配置参数打开，这样在其他办公环境或者其他电脑里，只要用小书匠的账号登录，系统就会把自定义数据中心的配置信息同步过来，并同步你自己的数据文件到新的环境下，继续未完成文章的编辑。

注

1. 为了让大家更好的体验小书匠自定义数据中心功能，临时会员功能时间限制会加长，在系统收回临时会员功能前，您可以使用小书匠自定义数据中心的所有功能。
2. 如果您觉得小书匠的自定义数据中心功能很好用，小书匠 markdown 编辑器也满足您的使用需求，可以考虑付费支持一下。具体付款升级流程可以查看这里

其他

该教程只是讲解了如何快速搭建一个个人使用的文件数据库，省略了比较多的细节配置说明。如果你想了解这些配置的用途，或者有一些个性化的需求定制，比如多用户，权限控制，集群等，CouchDB 也是支持的，可以参考 CouchDB 的官方文档。

相关

1. 小书匠数据中心使用说明