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

将主机的 8080 端口隧道到 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 程序

登录 ZeroNews 控制台,在「快速开始」页面选择 Linux 系统,按照步骤下载安装 ZeroNews 客户端,绑定 AuthToken,完成客户端上线。

第 3 步:为 ShowDoc 添加域名及隧道

为 ShowDoc 添加域名

在 ZeroNews 管理平台的「自定义域名」管理界面中,添加域名(以 showdoc 为例):
  1. 在「域名类型」中选择「默认域名」,并在「子域名前缀」中输入 showdoc,然后点击「域名可用性检测」
  2. 若下方「接入域名」显示为「可注册」,则表示该域名当前可添加使用,点击单选框选择该域名
  3. 点击「提交」,完成域名添加

为 ShowDoc 添加公网隧道

在 ZeroNews 管理平台的「隧道管理」页面下,添加隧道:
  1. 选择隧道模式
    • 在「隧道模式」下拉框中,保持选择 「标准隧道」
  2. 选择隧道特性
    • 在「隧道特性」下拉框中,选择 「Raw」(默认透传模式)
  3. 配置协议与带宽
    • 隧道协议:选择 「HTTPS」
    • 带宽(Mbps):在输入框中填写所需的带宽数值(例如 1)
  4. 设置公网域名
    • 在「公网域名」选项中,点击选择 「自定义域名」
    • 在下方的「选择自定义域名」下拉框中,选择刚才添加的域名,例如 showdoc.ny.takin.cc
  5. 配置内网映射信息
    • 绑定设备:点击下拉框选择需要绑定的在线设备
    • 内网 IP:在输入框中填写内网 IP 地址,例如 127.0.0.1
    • 内网端口:在输入框中填写 ShowDoc 管理平台的端口号 8080
  6. 完成添加
    • 点击右下角的 「确认」 按钮即可保存。
创建成功之后,您就可以在隧道列表页面看到可访问的隧道。 在浏览器中,输入 https://showdoc.ny.takin.cc,就可以访问内网中 ShowDoc 文档系统 提示:文档截图及示例中的域名、隧道地址可能与您当前实际使用的不一致,请以 ZeroNews 控制台显示的实际地址为准。