Skip to main content

访问企业内部ShowDoc 在线文档系统

ShowDoc作为一款免费开源的在线文档工具,以其简洁的界面、强大的功能和高效的协作体验在企业中得到广泛应用。支持多人同时在线编辑同一文档,提供灵活的权限设置,允许团队成员根据需要设置查看、编辑或评论权限,不仅能够满足团队日常文档管理的需求,还能够提升团队协作效率和信息共享效果。

结合ZeroNews 零讯内网穿,让企业内部的 ShowDoc 文档系统不仅仅局限于企业内网访问,企业员工可以在任何位置访问 ShowDoc 文档系统,无需企业具备固定公网IP,简单快捷。

以下是以 Centos7 为例部署 ShowDoc 及 ZeroNews 的步骤:

先决条件

  1. 拥有一个有效的 ZeroNews 账户
  2. Centos7 服务器已经安装好 Docker。

第 1 步:通过 Docker 安装 ShowDoc

下载 ShowDoc 镜像

从 star7th/showdoc 仓库地址下载 ShowDoc 镜像

docker pull star7th/showdoc

为 ShowDoc 创建要挂载的本地目录

添加 /data/showdoc_data 目录,作为 ShowDoc 容器的本地存储目录

mkdir -p /data/showdoc_data/html
chmod 777 /data/showdoc_data/html

启动 ShowDoc 容器

docker run -d --name showdoc --user=root --privileged=true -p 8080:80 -v /data/showdoc_data/html:/var/www/html star7th/showdoc

将主机的 8000端口映射到ShowDoc容器的80
将主机的/data/showdoc_data/html 目录挂载到容器的 /var/www/html 目录

ShowDoc 容器启动成功后,用户在内网通过设备IP访问 ShowDoc,对 ShowDoc 进行基础配置 http://设备IP:8080

设置语言

默认管理员账户密码是showdoc/123456

点击右上方的 "登录/注册",登录ShowDoc,登录成功就可以使用ShowDoc了

ShowDoc 文档系统部署完成后,接下来部署 ZeroNews

第 2 步:在CentOS主机上运行 ZeroNews 程序

参考 Linux 中运行 ZeroNews , 在 Linux 服务器上运行 ZeroNews,绑定 Token, 完成 ZeorNews 客户端上线。

第 3 步:为 ShowDoc 管理平台分配域名

  1. 添加用于 ShowDoc 管理平台的公网域名

用户登录 ZeroNews 平台,在 "资源" 的 "域名" 管理页面, 点击 "添加域名" 添加公网可访问的域名。

  • 生效设备: 选择对应的 Centos ZeroNews 设备。
  • 域名前缀: 用户输入定义的 域名前缀,如 showdoc
  • 在“添加端口”步骤,勾选“HTTP"端口。

第 4 步:为 ShowDoc 管理平台添加公网映射

1.进入"应用"页面,点击 "添加应用" 添加 ShowDoc 应用。

  • 应用名称: 如输入 ShowDoc

2.应用添加完成后, 在应用的下拉列表中,添加 ShowDoc 平台的 HTTP 映射

  • 映射协议:选择 HTTP 协议
  • 公网访问地址:选择 ShowDoc 域名,如 showdoc.south.takin.cc
  • 映射带宽: 为映射分配带宽,不大于用户当前的最大可用带宽
  • 内网映射地址:内网IP地址默认输入 127.0.0.1 内网端口输入Portainer 管理平台的端口号 8080

ShowDoc 平台的映射添加完成后,可在应用详情中可查看添加好的映射列表.

在浏览器中,输入 http://showdoc.south.takin.cc,就可以访问内网中 ShowDoc 文档系统