使用docker安装codimd，搭建你自己的在线协作markdown编辑器

一、前言
二、codimd是什么？
- 2.1 源于hackmd的超好用markdown编辑器
- 2.2 codimd的作用
三、安装和使用
四、总结
五、参考资料

一、前言

最近笔者需要频繁更新和发布文档，因此有了寻找一个在线markdown文档平台的想法。我最终在作业部落，gitbook，codimd之中选择了codimd，并且将其部署到了自己的服务器以便提高访问速度，因此写下这篇博客记录自己部署和使用的心得，供大家参考借鉴。

二、codimd是什么？

2.1 源于hackmd的超好用markdown编辑器

hackmd是一款著名的在线协作markdown编辑器产品

CodiMD是HackMD的免费开源版本

2.2 codimd的作用

在线编辑markdown文档
在线发布markdown文档
和别人在线协作编辑markdown文档

你可以使用官方提供的codimd服务

三、安装和使用

3.1 安装前需要知道的

安装之后你可以使用的功能和官方是一样的
安装的好处是，codimd官方的服务器在美国，在国内访问速度慢，部署到自己的服务器可以提高访问速度，也便于自己掌控数据库
目前codimd是开放系统，所有人都可以注册和使用你服务器上的codimd服务

3.2 安装步骤

笔者是参考官方文档进行安装的

总共需要以下步骤：

在MySQL建立codimd使用的数据库
安装git
安装docker
安装docker-compose
安装codimd

3.2.1 创建数据库

笔者使用宝塔面板，因此直接如图添加一个数据库

请注意允许所有ip访问该数据库，因为docker容器访问不属于本地ip访问，可以看详细解释

3.2.2 安装git

笔者直接使用yum进行安装，执行以下指令即可

yum install git

3.2.3 安装docker

同样使用yum进行安装，执行以下指令即可

yum install docker

3.2.4 安装docker compose

yum install docker-compose

3.2.5 安装codimd

version: "3"

services:

  codimd:

    image: nabo.codimd.dev/hackmdio/hackmd:2.0.1

    environment:

      - CMD_DB_URL=postgres://codimd:change_password@database/codimd

      - CMD_USECDN=false

    ports:

      - "3000:3000"

    volumes:

      - upload-data:/home/hackmd/app/public/uploads

    restart: always

volumes:

  upload-data: {}

你需要执行以下步骤完成codimd的安装：

在一个目录下创建 docker-compose.yml，向其中粘贴以上内容
修改其中的配置信息
在该目录下执行docker-compose up -d即可完成安装

配置信息说明:

postgres://codimd:change_password@database/codimd

这一行中各个参数的含义分别是：

 数据库连接协议://用户名:密码@数据库主机:数据库端口/数据库名

我使用的是MySQL，数据库名和用户名都是codimd，因此改成：

mysql://codimd:密码@172.18.0.1:3306/codimd

这里我的MySQL是在docker的宿主机本地安装的，但是主机ip没有写localhost，因为localhost在docker容器里面会解释成容器本身的ip，这样就连不上安装在宿主机的MySQL，所以我使用：

ip addr show docker0

查看了宿主机的ip为172.18.0.1，然后使用宿主机ip代替localhost，就达到容器内部访问外部的MySQL数据库的目的，可以看其他解决方案和详细解释

3.2.6 检查是否安装成功

安装完成后可以使用docker ps命令查看codimd是否已经运行

查看运行日志：执行以下命令

docker logs -f -t --tail 行数 容器名

通过上面的docker ps命令中看到容器名为codimd_codimd_1

所以我执行

docker logs -f -t --tail 10  codimd_codimd_1

看到

HTTP Server listening at 0.0.0.0:3000

这样的日志就表示安装成功了

3.2.7 放行端口

codimd默认是运行在3000端口的，因此需要防火墙放行

防火墙放行3000端口
阿里云安全组规则放行3000端口

你可以使用端口扫描工具确认端口已经正确放行

3.2.8 测试使用

访问你的服务器主机ip的3000端口，即可看到codimd的主页

3.3 开始写作

有了codimd之后你就可以在线编辑你的markdown文档了，还可以邀请别人一起编辑

四、总结

笔者在整个codimd的安装过程还是比较顺利，使用docker-compose安装十分便捷，主要遇到的问题是第一次安装之后查看日志发现访问不了数据库，后来查了资料才知道docker容器内访问localhost会被解释成docker容器本身的ip而不是常规的127.0.0.1，而且，使用docker容器访问数据库，也不属于本地服务器访问数据库。安装完成之后使用起来还是比较方便的，编辑器的页面比较美观，终于可以摆脱离线编辑文档还要写各种版本号更新记录的日子了。

五、参考资料