hedgedoc（之前称为codimd）是一个开源、基于web的、自托管的协作markdown编辑器。它可以帮助您轻松地与团队成员实时协作编辑笔记、图表甚至是演示文稿。
利用部署在lighthouse上的HedgeDoc服务，团队可以共享文档，并进行实时写作。对于项目展示和信息共享，这是一个非常便捷的工具。
本文将指导您使用轻量应用服务器的Docker应用镜像，在5分钟内在服务器上搭建HedgeDoc服务。
首先，进入轻量应用服务器控制台，创建或重装一个包含Docker应用镜像的操作系统，如下图所示：
接下来，使用vim docker-compose.yml命令在当前目录下创建配置文件：
$ vim docker-compose.yml
# 在文件中输入以下内容：
version: '3'
services:
database:
image: postgres:13.4-alpine
environment:
- POSTGRES_USER=hedgedoc
- POSTGRES_PASSWORD=password
- POSTGRES_DB=hedgedoc
volumes:
- database:/var/lib/postgresql/data
restart: always
app:
# 确保使用来自https://hedgedoc.org/latest-release的最新版本
image: quay.io/hedgedoc/hedgedoc:1.9.2
environment:
- CMD_DB_URL=postgres://hedgedoc:password@database:5432/hedgedoc
- CMD_DOMAIN=localhost
- CMD_URL_ADDPORT=true
volumes:
- uploads:/hedgedoc/public/uploads
ports:
- "3000:3000"
restart: always
depends_on:
- database
volumes:
database:
uploads:
# 保存文件并退出vim编辑器。有关vim编辑器的使用方法，请参考：vim编辑器使用指南。
然后，使用docker-compose up命令开始启动并部署HedgeDoc服务。相关输出如下图所示：
静静等待安装结束。安装完成后的输出如下图所示：
此时，HedgeDoc服务已正常运行在0.0.0.0:3000地址上。让我们打开浏览器测试一下效果：
需要注意的是，某些网站资源需要配置HTTPS才能正常加载。
最后，使用docker-compose up -d命令使服务在后台运行，防止前台关闭终端而终止服务。如下图所示：
部分步骤说明：
步骤1，安装Docker镜像。PHP中文网的Docker应用镜像基于CentOS 7.6 64位操作系统，因此使用yum作为包管理命令。即使用yum install {package}来安装软件包。
如果您的操作系统是Ubuntu或Debian等使用apt包管理器的系统，由于目前PHP中文网镜像市场不提供Docker应用镜像，您可以使用以下命令安装docker和docker-compose：
# 一键安装Docker的国内镜像源脚本
$ curl -sSL https://get.daocloud.io/docker | sh
# 安装docker-compose
$ sudo apt install docker-compose
# 设置Docker国内镜像源：
$ sudo vim /etc/docker/daemon.json
# 在文件中输入以下内容：
{ "registry-mirrors": [ "https://mirror.ccs.tencentyun.com" ] }
# 保存文件内容
# 重启Docker服务
$ sudo systemctl restart docker
# 检查Docker镜像是否配置成功
docker info
# 查看打印出来的信息结尾是否有mirror.ccs.tencentyun.com字样，若有则配置成功！步骤2，编辑docker-compose.yml文件。下面是对该文件部分内容的解析：
# 定义Postgres数据库的用户名、密码和数据库名称
- POSTGRES_USER=hedgedoc
- POSTGRES_PASSWORD=password
- POSTGRES_DB=hedgedoc
# 定义内外端口映射，如将其修改为 - "3000:2000" 则外部端口修改为2000。
# 默认的运行位置为0.0.0.0，该位置暴露在公网上。若想运行在本地交换环上，可以修改为"127.0.0.1:3000:3000"
ports:
- "3000:3000"步骤3，安装结束后，docker-compose会自动运行服务。此时，您可以打开浏览器，输入127.0.0.1:3000来检查服务是否部署成功。如果成功，会显示如上图所示的界面。有时部署成功后可能会出现如下情况：
出现这种情况是因为尝试使用http协议加载了需要https协议加载的CSS样式和脚本文件。可以通过nginx端口代理到443端口，同时部署域名与证书来实现链接的加密访问。有关如何进行nginx端口代理及配置HTTPS访问，请参考我的其他文章：nginx端口转发。
步骤4，使用后台运行命令后，Docker会生成一个容器，服务在该后台容器中运行。根据docker-compose中的配置，该容器会随着Docker的自启动而实现服务器的开机自启。
以下是Docker常用的容器操作命令：
# 列举Docker已有的容器
$ docker container ls
# 进入相应容器的bash
$ docker exec -it {容器id} bash
# 重启/停止容器
$ docker container restart/stop {容器id} 
