核心内容摘要
铜铜铜铜铜铜铜铜好铜：不止于此的非凡韵律
Wiki.js 是一款专注于知识管理的工具核心功能是帮用户把零散的信息整合起来支持用 Markdown 编辑文档还能设置不同的访问权限 —— 比如团队里可以让管理员修改核心内容普通成员只能查看也能通过插件扩展导出 PDF、同步到其他平台等功能。
它特别适合两类人企业团队用来管理项目文档、流程规范避免资料散落在邮件或聊天记录里个人则可以用它整理学习笔记、生活攻略搭建自己的 “知识库”。
和传统工具比它比 Word 更灵活能快速调整文档结构又比 Notion 更轻量不用花太多时间研究复杂功能。
用 Wiki.js 时有些小细节要注意刚开始搭建时最好先规划好分类体系比如按 “项目→阶段→文档类型” 分层不然后期内容多了容易混乱Markdown 编辑虽然方便但新手可能需要适应一下语法不过它的预览功能能实时看到效果上手不算难另外权限设置要根据实际需求来太严格会影响协作效率太宽松又可能导致文档被误改。
但如果只在局域网里用 Wiki.js会遇到不少麻烦。
比如团队里有人居家办公就没法访问公司的知识库想查份资料还得麻烦同事转发既低效又容易出错个人在外想补个笔记只能等回到电脑前碎片化的灵感很容易溜走要是想给客户演示产品文档要么得把文件传过去有泄露风险要么带电脑去现场特别不方便。
而把 Wiki.js 和 cpolar 结合起来这些问题就都解决了。
cpolar 的内网穿透功能能把局域网里的 Wiki.js 服务 “搬到” 公网上不用申请公网 IP也不用折腾路由器端口映射。
团队成员无论在哪用手机或电脑打开链接就能访问知识库个人在地铁、咖啡馆随时能编辑内容回家后电脑上能直接看到更新给客户演示时发个链接对方就能看最新版本安全又方便。
好东西当然要一起分享喽教程已准备好本文将介绍如何用 Docker 容器技术部署 Wiki.js 应用程序并且结合cpolar发布至公网实现知识库共享。
Wiki.js 是一个高度可定制 Wiki 平台用 Node.js 编写支持 Markdown 以及 HTML 文档。
Docker 容器技术可帮助我们简化部署过程提高应用程序的可移植性和可扩展性。
安装Docker本文演示环境CentOS 7 使用Xshell7进行SSH操作如没有安装Docker需先安装Dockercurl-fsSL https://get.docker.com|bash-sdocker本篇文章使用Docker Compose实现Wiki.js的一键部署输入下方命令显示版本号即为安装成功。
dockercompose version
获取Wiki.js镜像Docker 中镜像是一个只读模板可创建 Docker 容器Wiki.js 官方提供了预构建 Docker 镜像我们可直接从 Docker Hub 中拉取。
首先创建一个 dockers-compose.yml文件mkdircompose进入目录中cdcompose/编写 docker-compose.yml 文件内容复制以下内容注意容器的用户名密码和数据库的要一致version:3services: db: image: postgres:15-alpine environment: POSTGRES_DB: wiki POSTGRES_PASSWORD: wikijsrocks POSTGRES_USER: wikijs logging: driver:nonerestart: unless-stopped volumes: - db-data:/var/lib/postgresql/data wiki: image: linuxserver/wikijs depends_on: - db environment: DB_TYPE: postgres DB_HOST: db DB_PORT:5432DB_USER: wikijs DB_PASS: wikijsrocks DB_NAME: wiki restart: unless-stopped ports: -3000:3000volumes: db-data:保存配置文件后执行下面的命令即可部署 Wiki.jsdockercompose up -d
本地服务器打开Wiki.js并添加知识库内容打开一个新的浏览器输入本机IP:3000进行初始配置输入管理员的邮箱、密码访问地址设置是否匿名反馈使用情况创建完成后跳转到登录页面输入刚才创建的管理员账号密码登录出现下方界面点击ADMINISTRATION进入后台进入后台界面后点击Local选择语言下载语言包选择Chinese Simplified最后点击右上角APPLY切换至首页创建主页内容。
这里可以选择使用何种编辑器来创建这里我们以 Markdown 为例接下来我们创作
文章先设置页面属性重点设置标题、路径填写完成后点击右上角的OK填写好内容后点击右上方的创建返回到主页可以看到刚创建的文章内容这样我们就在本地使用Docker搭建了一个wiki的知识库系统但是目前仅限于本地的访问如果我们想把创作好的文章内容发给身边的朋友查看或者需要进行异地访问创作等接下来我们就可以结合cpolar内网穿透将搭建好的知识库发布至公网进行远程访问。
实现公网访问Wiki.js上面在本地Docker中成功部署了Wiki.js并局域网访问成功,下面我们在Linux安装Cpolar内网穿透工具,通过Cpolar 转发本地端口映射的http公网地址,我们可以很容易实现远程访问,而无需自己注册域名购买云服务器.下面是安装cpolar步骤cpolar官网地址: https://www.cpolar.com使用一键脚本安装命令curl-L https://www.cpolar.com/static/downloads/install-release-cpolar.sh|sudobash向系统添加服务sudosystemctlenablecpolar启动cpolar服务sudosystemctl start cpolarcpolar安装成功后在外部浏览器上访问Linux 的9200端口 即:【http://局域网ip:9200】使用cpolar账号登录(如没有账号,可以点击下面免费注册),登录后即可看到cpolar web 配置界面,接下来在web 管理界面配置即可接下来配置一下Wiki.js的公网地址登录后点击左侧仪表盘的隧道管理——创建隧道创建一个Wiki.js的公网http地址隧道!隧道名称可自定义命名注意不要与已有的隧道名称重复协议选择http本地地址3000 (本地访问的地址)域名类型免费选择随机域名地区选择China Top点击创建隧道创建成功后点击左侧的状态——在线隧道列表,查看所生成的公网访问地址有两种访问方式,一种是http 和https使用上面的Cpolar https公网地址,在任意设备的浏览器进行访问,即可成功看到Wiki.js界面,这样一个公网地址且可以远程访问就创建好了,使用了cpolar的公网域名,无需自己购买云服务器,即可发布到公网进行远程访问小结如果我们需要把创作的WIki知识库长期发布至公网分享给别人查看由于刚才创建的是随机的地址24小时会发生变化。
另外它的网址是由随机字符生成不容易记忆。
如果想把域名变成固定的二级子域名并且不想每次都重新创建隧道可以选择创建一个固定的http地址来解决这个问题。
固定Wiki.js公网地址我们接下来为其配置固定的HTTP端口地址该地址不会变化方便分享给别人长期查看你的博客而无需每天重复修改服务器地址。
配置固定http端口地址需要将cpolar升级到专业版套餐或以上。
登录cpolar官网点击左侧的预留选择保留二级子域名设置一个二级子域名名称点击保留,保留成功后复制保留的二级子域名名称保留成功后复制保留成功的二级子域名的名称修改隧道信息将保留成功的二级子域名配置到隧道中域名类型选择二级子域名Sub Domain填写保留成功的二级子域名点击更新(注意,点击一次更新即可,不需要重复提交)更新完成后,打开在线隧道列表,此时可以看到公网地址已经发生变化,地址名称也变成了固定的二级子域名名称的域名最后,我们使用固定的公网https地址访问,可以看到访问成功这样一个固定且永久不变的公网地址就设置好了,成功实现了在异地我们也可以进行远程创作并且随时随地都可以把Wiki知识库分享给其他人了Wiki.js 解决了知识 “存不住、找不着” 的问题cpolar 则打破了 “只能在本地用” 的局限两者搭配让知识管理真正做到了 “需要时就在手边”无论是团队协作还是个人使用都能让信息流转更顺畅、更高效。
cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站