Wiki.js团队知识大脑/个人笔记管家:cpolar内网穿透实验室第496个成功挑战

软件名称:Wiki.js

操作系统支持

  • Web端:兼容所有主流浏览器(Chrome/Safari等)。
  • 移动端:通过手机浏览器直接访问,适合碎片化学习。

软件介绍:

Wiki.js是团队和个人的"知识记忆宫殿",像乐高一样自由拼装文档。它支持Markdown编辑、自定义权限(比如只允许老板修改核心策略),还能用插件扩展功能(如导出PDF或同步到其他系统)。比Word文档更灵活,比Notion更轻量!

核心功能:开源维基系统,支持Markdown编辑、权限分级、插件扩展,适合团队协作和知识沉淀。

用户群体

  • 企业团队(如产品经理、IT部门):用Wiki.js集中管理需求文档、技术手册。
  • 自由职业者/学生:整理个人笔记或课程资料的"数字脑"工具。
  • 开发者:维护API文档和代码说明,避免版本混乱。

"Wiki.js------团队知识的'记忆宫殿'+个人笔记的'瑞士军刀'"

  • 核心功能亮点:

    • Markdown编辑器:像写博客一样优雅地排版文档。
    • 权限分级管理:老板可设"仅查看",实习生只能在指定页面留言。
    • 全文搜索:输入关键词快速找到三年前的会议记录。

"实用场景:从散落的'知识碎片'到体系化的'黄金屋'"

场景1:企业团队协作

  • 痛点:项目资料散落在邮件、聊天软件甚至纸质文件中,新人入职要花两周理清脉络。
  • 爽点:用Wiki.js创建"产品线→模块→版本"的三级分类,结合标签(如#2023Q4计划),新人1小时就能找到所需文档。

场景2:个人知识管理

  • 痛点:学习笔记、工作心得和灵感碎片散落在笔记本、手机备忘录甚至便签纸上。
  • 爽点:用Wiki.js建立"技术→Python教程""生活→旅行攻略"的分类,配合搜索功能秒查资料。

"cpolar内网穿透技术带来的便利:让知识库'飞'出局域网"

  • 远程协作场景: 开发者在家办公时,通过公网访问公司内部Wiki.js服务器,无需上传敏感文档到云盘。
  • 客户演示场景: 销售在客户现场实时展示产品文档的最新版本。
  • 多设备访问: 在地铁用手机浏览器编辑会议纪要,回家后电脑同步显示修改内容。

Wiki.js+cpolar的组合,让知识库突破物理边界

  • 企业级安全:权限控制防止文档泄露。
  • 随时随地访问:在家、在路上甚至跨国出差都能更新/查看资料。
  • 轻量易用:比搭建私有云更省心,适合小团队快速上手。

好东西当然要一起分享喽!教程已准备好👇

本文将介绍如何用 Docker 容器技术部署 Wiki.js 应用程序,并且结合cpolar发布至公网实现知识库共享。Wiki.js 是一个高度可定制 Wiki 平台,用 Node.js 编写,支持 Markdown 以及 HTML 文档。Docker 容器技术可帮助我们简化部署过程,提高应用程序的可移植性和可扩展性。

1. 安装Docker

本文演示环境:CentOS 7 使用Xshell7进行SSH操作

如没有安装Docker,需先安装Docker

arduino 复制代码
curl -fsSL https://get.docker.com | bash -s docker

本篇文章使用Docker Compose实现Wiki.js的一键部署,输入下方命令显示版本号即为安装成功。

复制代码
docker compose version

2. 获取Wiki.js镜像

Docker 中镜像是一个只读模板,可创建 Docker 容器,Wiki.js 官方提供了预构建 Docker 镜像,我们可直接从 Docker Hub 中拉取。

首先创建一个 dockers-compose.yml文件

arduino 复制代码
mkdir compose 

进入目录中

bash 复制代码
cd compose/

编写 docker-compose.yml 文件内容,复制以下内容(注意容器的用户名密码和数据库的要一致)

yaml 复制代码
version: "3"
services:
​
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: wikijsrocks
      POSTGRES_USER: wikijs
    logging:
      driver: "none"
    restart: 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: 5432
      DB_USER: wikijs
      DB_PASS: wikijsrocks
      DB_NAME: wiki
    restart: unless-stopped
    ports:
      - "3000:3000"
​
volumes:
  db-data:

保存配置文件后,执行下面的命令即可部署 Wiki.js:

复制代码
docker compose up -d

3. 本地服务器打开Wiki.js并添加知识库内容

打开一个新的浏览器,输入本机IP:3000,进行初始配置

输入管理员的邮箱、密码,访问地址,设置是否匿名反馈使用情况

创建完成后跳转到登录页面,输入刚才创建的管理员账号密码登录,出现下方界面,点击ADMINISTRATION 进入后台

进入后台界面后,点击 Local 选择语言,下载语言包,选择 Chinese Simplified,最后点击右上角 APPLY

切换至首页,创建主页内容。这里可以选择使用何种编辑器来创建,这里我们以 Markdown 为例:

接下来,我们创作第一篇文章,先设置页面属性,重点设置标题、路径,填写完成后点击右上角的 OK

填写好内容后点击右上方的创建

返回到主页,可以看到刚创建的文章内容

这样我们就在本地使用Docker搭建了一个wiki的知识库系统,但是目前仅限于本地的访问,如果我们想把创作好的文章内容发给身边的朋友查看,或者需要进行异地访问创作等,接下来我们就可以结合cpolar内网穿透将搭建好的知识库发布至公网进行远程访问。

4. 实现公网访问Wiki.js

上面在本地Docker中成功部署了Wiki.js,并局域网访问成功,下面我们在Linux安装Cpolar内网穿透工具,通过Cpolar 转发本地端口映射的http公网地址,我们可以很容易实现远程访问,而无需自己注册域名购买云服务器.下面是安装cpolar步骤

cpolar官网地址: www.cpolar.com

  • 使用一键脚本安装命令
ruby 复制代码
curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash
  • 向系统添加服务
bash 复制代码
sudo systemctl enable cpolar
  • 启动cpolar服务
sql 复制代码
sudo systemctl start cpolar

cpolar安装成功后,在外部浏览器上访问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地址来解决这个问题。

5. 固定Wiki.js公网地址

我们接下来为其配置固定的HTTP端口地址,该地址不会变化,方便分享给别人长期查看你的博客,而无需每天重复修改服务器地址。

配置固定http端口地址需要将cpolar升级到专业版套餐或以上。

登录cpolar官网,点击左侧的预留,选择保留二级子域名,设置一个二级子域名名称,点击保留,保留成功后复制保留的二级子域名名称

保留成功后复制保留成功的二级子域名的名称

修改隧道信息,将保留成功的二级子域名配置到隧道中

  • 域名类型:选择二级子域名
  • Sub Domain:填写保留成功的二级子域名

点击更新(注意,点击一次更新即可,不需要重复提交)

更新完成后,打开在线隧道列表,此时可以看到公网地址已经发生变化,地址名称也变成了固定的二级子域名名称的域名

最后,我们使用固定的公网https地址访问,可以看到访问成功

这样一个固定且永久不变的公网地址就设置好了,成功实现了在异地我们也可以进行远程创作,并且随时随地都可以把Wiki知识库分享给其他人了!

通过将Wiki.js容器化部署与cpolar内网穿透技术相结合,我们实际上构建了一个兼具灵活性与安全性的知识管理生态。这种组合不仅解决了传统维基系统对公网服务器的依赖痛点,更以零运维成本实现了分布式团队的知识资产聚合------无论是企业内部的技术文档共享,还是个人开发者开源项目的协作维护,这套方案都展现了超越工具本身的协同价值。在知识即服务(KaaS)理念普及的当下,它或许正是组织实现"知识即生产力"转型的关键技术支点。

cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站

相关推荐
国家不保护废物2 分钟前
10万条数据插入页面:从性能优化到虚拟列表的终极方案
前端·面试·性能优化
文心快码BaiduComate17 分钟前
七夕,画个动态星空送给Ta
前端·后端·程序员
web前端12321 分钟前
# 多行文本溢出实现方法
前端·javascript
文心快码BaiduComate21 分钟前
早期人类奴役AI实录:用Comate Zulu 10min做一款Chrome插件
前端·后端·程序员
人间观察员23 分钟前
如何在 Vue 项目的 template 中使用 JSX
前端·javascript·vue.js
布列瑟农的星空26 分钟前
大话设计模式——多应用实例下的IOC隔离
前端·后端·架构
EndingCoder31 分钟前
安装与环境搭建:准备你的 Electron 开发环境
前端·javascript·electron·前端框架
蓝银草同学1 小时前
前端离线应用基石:深入浅出 IndexedDB 完整指南
前端·indexeddb
硬核隔壁老王1 小时前
收藏!Agentic RAG实战:从入门到智能问答系统完整实现指南
人工智能·程序员·llm
AI大模型1 小时前
Dify新版1.8.0发布:新增异步工作流和多模型设置!
程序员·llm·agent