前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >玩转服务器-博客两件套之绝佳的Markdown写作平台CodiMD

玩转服务器-博客两件套之绝佳的Markdown写作平台CodiMD

原创
作者头像
青阳
修改2022-03-31 15:02:33
9.9K2
修改2022-03-31 15:02:33
举报
文章被收录于专栏:玩转云服务玩转云服务

前言

大家都很羡慕博主的高产,纷纷问我有什么技巧。我的回复是手熟,多写,那么多写就需要一个比较好的工具,所以我这里给大家介绍一个在线markdown文档平台,让大家可以随时书写文档和博客。这里我选择的是codimd,我把它部署到了自己在我的腾讯云轻量应用服务器上以便提高访问速度,写下这篇记录自己部署和使用的心得,供大家参考。

什么是CodiMD

CodiMD 是一个开源项目,可实现 MarkDown 文档的协同编辑,功能与 HackMD 一致(这好像是废话),项目地址在 GitHub的hackmdio下,部署极为简单。适合无法正常使用 HackMD 的用户将其部署到自己的国内服务器,安全稳定。

开源地址

CodiMD

程序的安装

安装的准备

首先准备腾讯云轻量应用服务器,系统为centos,不同系统间方式大同小异。

安装的步骤

  1. 在MySQL建立codimd使用的数据库
  2. 安装git
  3. 安装docker
  4. 安装docker-compose
  5. 安装codimd
创建数据库

这里博主用的轻量数据库(相关测评),如果没有也可以自建数据库。

这里以宝塔为例直接添加一个数据库。

请注意允许所有ip访问该数据库,因为docker容器访问不属于本地ip访问。

安装git
代码语言:txt
复制
yum install git
安装docker
代码语言:txt
复制
yum install docker
安装docker compose
代码语言:txt
复制
yum install docker-compose
安装codimd

在root文件夹下创建一个目录(如md),目录内创建docker-compose.yml

填入以下内容:

代码语言:txt
复制
version: "3"
services:
  database:
    image: postgres:11.6-alpine
    environment:
      - POSTGRES_USER=codimd
      - POSTGRES_PASSWORD=change_password
      - POSTGRES_DB=codimd
    volumes:
      - "database-data:/var/lib/postgresql/data"
    restart: always
  codimd:
    image: hackmdio/hackmd:2.4.1
    environment:
      - CMD_DB_URL=postgres://codimd:change_password@database/codimd
        # CMD_DB_URL 格式为 
        # 数据库连接协议://用户名:密码@数据库主机:数据库端口/数据库名
        #这里我的MySQL是在docker的宿主机本地安装的,但是主机ip没有写localhost,因为localhost在docker容器里面会解释成容器本身的ip,这样就连不上安装在宿主机的MySQL,所以我使用:ip addr show docker0,查看了宿主机的ip为172.17.0.1,然后使用宿主机ip代替localhost,就达到容器内部访问外部的MySQL数据库的目的
        #例:CMD_DB_URL=mysql://codimd:change_password@172.17.0.1:3306/codimd
      - CMD_USECDN=false
    depends_on:
      - database
    ports:
      - "3000:3000"
    volumes:
      - upload-data:/home/hackmd/app/public/uploads
    restart: always
volumes:
  database-data: {}
  upload-data: {}

保存退出。

命令行里cd进docker-compose.yml所在的文件夹,执行命令

代码语言:txt
复制
cd md

docker-compose up -d
检查安装

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

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

代码语言:txt
复制
docker logs -f -t --tail 行数 容器名

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

所以我执行

代码语言:txt
复制
docker logs -f -t --tail 10  codimd_codimd_1

提示

代码语言:txt
复制
HTTP Server listening at 0.0.0.0:3000

#这样表示安装成功了
放行端口

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

  • 防火墙放行3000端口
  • 腾讯云轻量服务器管理面板防火墙规则放行3000端口

CodiMD 使用

基本使用

完成以上步骤,即可访问服务器的 3000 端口来到 CodiMD 主页(如下图)。注册登录后即可进行文档档创建与协同编辑。其他协作者可以放心大胆地使用,后台密码均进行了严格加密,密码防泄漏做得很好的

反向代理

反向代理设置,新建一个网站,配置如图

配置反向代理步骤如下:(代理名称随意写一个自己认识的就行)

至此本次教程到此结束,使用腾讯云轻量服务器搭建CodiMD有其他不明白的地方,朋友可以到我博客和我交流

博主站点

博主的个人博客地址是:https://www.hipyt.cn/

期待下一次给大家带来更好的教程,我们下次再见。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 前言
  • 什么是CodiMD
    • 开源地址
    • 程序的安装
      • 安装的准备
        • 安装的步骤
          • 创建数据库
          • 安装git
          • 安装docker
          • 安装docker compose
          • 安装codimd
          • 检查安装
          • 放行端口
      • CodiMD 使用
        • 基本使用
          • 反向代理
          • 博主站点
          • 期待下一次给大家带来更好的教程,我们下次再见。
          相关产品与服务
          云服务器
          云服务器(Cloud Virtual Machine,CVM)提供安全可靠的弹性计算服务。 您可以实时扩展或缩减计算资源,适应变化的业务需求,并只需按实际使用的资源计费。使用 CVM 可以极大降低您的软硬件采购成本,简化 IT 运维工作。
          领券
          问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档


          http://www.vxiaotou.com