介绍

手头有几十篇markdown的文章准备放到服务器上做成在线的。
首先想到的就是vuepress等静态网站生成工具🛠️,配置几个属性,放入md文件,运行&打包就能实现。再搭配github pages还能实现0成本访问。

正好想看到有没有什么新玩意,无意中就发现了docmost。它对自己的定位是Notion+Confluence ,支持在线协作,成员空间,权限设置等功能。
1733361291422-2024-12-5-091452.png

安装

安装用了一下觉得和飞书这种在线文档更像一点,适合做团队的私有化知识库。
部署也很简单,官网有docker-compose,因为只是体验,没有自定义db和redis。
需要注意的内容用中文标出了,默认的3000端口换成别的,再开个反代能正常访问了

version: "3"

services:
  docmost:
    image: docmost/docmost:latest
    depends_on:
      - db
      - redis
    environment:
      APP_URL: "http://localhost:3000" #邀请邮件中会打开这个地址
      APP_SECRET: "REPLACE_WITH_LONG_SECRET" # 替换成一个随机密钥
      DATABASE_URL: "postgresql://docmost:数据库密码@db:5432/docmost?schema=public"
      REDIS_URL: "redis://redis:6379"
	  # 配置发信,我用的是zoho的zeptomail
      MAIL_DRIVER: "smtp"
      SMTP_HOST: "smtp.zeptomail.com.cn"
      SMTP_PORT: 587
      SMTP_USERNAME: "用户名"
      SMTP_PASSWORD: "密码"
      SMTP_SECURE: false
      MAIL_FROM_ADDRESS: "发信用户名"
      MAIL_FROM_NAME: 'Docmost'
    ports:
      - "3000:3000"
    restart: unless-stopped
    volumes:
      - docmost:/app/data/storage

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: docmost
      POSTGRES_USER: docmost
      POSTGRES_PASSWORD: 数据库密码
    restart: unless-stopped
    volumes:
      - db_data:/var/lib/postgresql/data

  redis:
    image: redis:7.2-alpine
    restart: unless-stopped
    volumes:
      - redis_data:/data

volumes:
  docmost:
  db_data:
  redis_data:

初始化界面输入管理员的用户名和密码,打开后就是首页了,能看到最近的文章和所有的空间。
1733361997699-2024-12-5-092638.png
右上角设置里面有邀请用户,但是必须使用邮箱发送链接才行. 我用的是zepto的发信服务,因为是自己的域名,发信总是被拒收,只能通过发信记录找到邀请链接.

注意邀请链接的地址是配置文件里的APP_URL

1733361719677-2024-12-5-092200.png
空间(space)里面可以设置对应用户的权限
有全部/编辑/只读三个选项
1733361751110-2024-12-5-092231.png
打开页面后能显示对方的光标,修改后也可以实时展示。

文档支持导入html和md,但是只有单篇导入。如果md里面有外联图片是不展示
1733362034319-2024-12-5-092715.png

导出倒是可以设置全部导出。
1733362057916-2024-12-5-092738.png

结束

软件界面挺简单, 做个团队私有化的文档库还不错. 不过现在版本还很新(0.6.0),有些基本的功能还没有支持:

  1. md里面的外链图片不能展示
  2. 访问必须登陆, 没有公开的页面
  3. 邀请必须发邮件, 不能直接激活用户

总的来说功能还是不错的,除了图片不显示其他的都还能接受,点个stert支持下

如果有想体验的可以私信我, 服务器开着也是开着, 不用白不用